Formato di default del tracciato CSV di caricamento pendenze

Il tracciato CSV standard di GovPay per il caricamento pendenze prevede una prima linea di intestazione con i nomi delle campi ed una linea per ciascuna pendenza da caricare, utilizzando come separatore la virgola e come carattere di escape il doppio apice.

Il tracciato è il risultato della de-strutturazione della richiesta di caricamento pendenze prevista dalle API Pendenze in formato JSON, alla quale specifica si rimanda per un maggior formalismo nella definzione dei vincoli sintattici e semantici.

Tabella 46 Descrizione dei campi CSV

#	Nome	Descrizione	Vincoli
1	idA2A	Identificativo del gestionale responsabile della pendenza, come censito in anagrafica	Obbligatorio
2	idPendenza	Identificativo della pendenza, univoco per gestionale responsabile	Obbligatorio, max 35 caratteri
3	idDominio	Codice fiscale dell’ente creditore, come censito in anagrafica	Obbligatorio
4	numeroAvviso	Identificativo dell’avviso di pagamento. Se non fornito, viene assegnato da GovPay.	Opzionale, sintassi AgID.
5	tipoPendenza	Tipologia della pendenza, come censito in anagrafica	Opzionale, default LIBERO
6	idUnitaOperativa	Identificativo dell’unità interna all’ente creditore beneficiaria del pagamento, come censita in anagrafica	Opzionale
7	causale	Descrizione della pendenza	Obbligatoria, max 140 caratteri
8	annoRiferimento	Anno di riferimento della pendenza	Opzionale, numerico 4 cifre
9	cartellaPagamento	Identificativo della cartella di pagamento a cui afferisce la pendenza	Opzionale, max 35 caratteri
10	datiAllegati	Dati applicativi allegati dal gestionale secondo un formato proprietario	Opzionale
11	direzione	Identificativo della direzione interna all’ente creditore	Opzionale, max 35 caratteri
12	divisione	Identificativo della divisione interna all’ente creditore	Opzionale, max 35 caratteri
13	importo	Importo della pendenza	Obbligatorio, deve corrispondere alla somma degli importi delle voci. Max 10 cifre compresi due decimali separati dal punto (.)
14	dataValidita	Data di validità dei dati della pendenza, decorsa la quale la pendenza può subire variazioni	Opzionale, data nella forma yyyy-MM-dd
15	dataScadenza	Data di scadenza della pendenza, decorsa la quale la pendenza non è più pagabile	Opzionale, data nella forma yyyy-MM-dd
16	tassonomiaAvviso	Macro categoria della pendenza secondo la classificazione Agid	Opzionale, enumerazione: [ Cartelle esattoriali, Diritti e concessioni, Imposte e tasse, IMU, TASI e altre tasse comunali, Ingressi a mostre e musei, Multe e sanzioni amministrative, Previdenza e infortuni, Servizi erogati dal comune, Servizi erogati da altri enti, Servizi scolastici, Tassa automobilistica, Ticket e prestazioni sanitarie, Trasporti, mobilità e parcheggi ]
17	tipoSoggettoPagatore	Tipologia del soggetto pagatore	Obbligatorio, Enumerazione: [ F, G ] per Fisica o Giuridica
18	identificativoPagatore	Identificativo del soggetto pagatore. Codice fiscale, Partita iva o ANONIMO se non identificato	Obbligatorio, max 35 caratteri
19	anagraficaPagatore	Anagrafica del soggetto pagatore. Nome e Cognome, Ragione sociale o ANONIMO se non identificato	Obbligatorio, max 70 caratteri
20	indirizzoPagatore	Indirizzo di residenza del soggetto pagatore	Opzionale, max 70 caratteri
21	civicoPagatore	Numero civico di residenza del soggetto pagatore	Opzionale, max 16 caratteri
22	capPagatore	Codice di avviamento postale di residenza del soggetto pagatore	Opzionale, max 16 caratteri
23	localitaPagatore	Località di residenza del soggetto pagatore	Opzionale, max 35 caratteri
24	provinciaPagatore	Provincia di residenza del soggetto pagatore	Opzionale, max 35 caratteri
25	nazionePagatore	Nazione di residenza del soggetto pagatore	Opzionale, 2 caratteri
26	emailPagatore	Email del soggetto pagatore	Opzionale
27	cellularePagatore	Numero di cellulare del soggetto pagatore	Opzionale, nella forma +39 000 1234567
–	idVoce*	Identificativo della i-esima voce di pagamento della pendenza, univoco per pendenza.	Obbligatorio, max 35 caratteri
–	importoVoce*	Importo della i-esima voce di pagamento della pendenza	Obbligatorio, max 10 cifre compresi due decimali separati dal punto (.)
–	descrizioneVoce*	Descrizione della i-esima voce di pagamento della pendenza	Obbligatorio, max 140 caratteri
–	ibanAccreditoVoce*	Identificativo del conto di accredito della i-esima voce di pagamento della pendenza, censito in anagrafica	Obbligatorio in alternativa a tipoEntrataVoce* o tipoBolloVoce*
–	ibanAppoggioVoce*	Identificativo del conto di appoggio della i-esima voce di pagamento della pendenza, censito in anagrafica	Opzionale se valorizzato ibanAccreditoVoce*, altrimenti ignorato
–	tipoContabilitaVoce*	Tipologia di codifica del capitolo di bilancio della i-esima voce di pagamento della pendenza	Obbligatorio se valorizzato ibanAccreditoVoce*, enumerazione: [ CAPITOLO, SPECIALE, SIOPE, ALTRO ], altrimenti ignorato
–	codiceContabilitaVoce*	Codice del capitolo di bilancio della i-esima voce di pagamento della pendenza	Obbligatorio se valorizzato ibanAccreditoVoce*, altrimenti ignorato
–	tipoEntrataVoce*	Riferimento alla tipologia di entrata della i-esima voce di pagamento della pendenza, censita in anagrafica	Obbligatorio in alternativa a ibanAccreditoVoce* o tipoBolloVoce*
–	tipoBolloVoce*	Tipologia di bollo della i-esima voce di pagamento della pendenza	Obbligatorio in alternativa a ibanAccreditoVoce* o tipoEntrataVoce*, enumerazione: [ 01 ] dove 01 è la Marca da Bollo Telemarica
–	hashBolloVoce*	Digest in base64 del documento informatico associato alla marca da bollo della i-esima voce di pagamento della pendenza	Obbligatorio se valorizzato tipoBolloVoce*, altrimenti ignorato
–	provinciaBolloVoce*	Sigla automobilistica della provincia di residenza del soggetto pagatore della i-esima voce di pagamento della pendenza	Obbligatorio se valorizzato tipoBolloVoce*, altrimenti ignorato. Due caratteri maiuscoli.
82	dataAvvisatura	Data di spedizione dell’avvisatura, se prevista dalla configurazione.	Opzionale, se non impostata si intende immediata. Se valorizzato con MAI l’avvisatura viene inibilita
83	idDocumento	Identificativo del documento a cui afferisce la pendenza, se ne esiste uno.	Opzionale, da usare in caso di rateizzazioni.
84	descrizioneDocumento	Titolo del documento. Verra” utilizzato per la stampa dell’avviso pagoPA.	Opzionale, se non valorizzato sarà usata la causale della pendenza.
85	numeroRata	Numero di rata in caso di pagamento rateale. In caso di pagamenti con soglia temporale, usare la sintassi ENTROxxx o OLTRExxx dove xxx è il numero di giorni previsto.	Opzionale, non valorizzare per il pagamento in soluzione unica.
86	linguaSecondaria	Indica la seconda lingua da affiancare all’italiano nella stampa dell’avviso di pagamento, le lingue supportate sono Sloveno (sl), Inglese (en), Tedesco (de) e Francese (fr). Il valore speciale false forza la stampa nella sola lingua italiana. Opzionalmente è possibile indicare anche la traduzione della causale separandola con il carattere | (pipe).	Opzionale, Enumerazione: [ de, en, fr, sl, false ], non valorizzare per gli avvisi di pagamento stampati solo in italiano.

I campi che determinano una voce di pagamento della pendenza si ripetono sostituendo l’asterisco con la posizione della voce, ovvero: idVoce1, importoVoce1, …., idVoce2, importoVoce2, … etc…

Si suggerisce di valorizzare il parametro dataAvvisatura in modo tale da avere l’opportunità di intervenire prima dell’avvisatura al cittadino in caso di caricamenti indesiderati

Si precisa che, per vincoli pagoPA, sono consentite un massimo di 5 voci di pagamento per una pendenza e che sono pagabili ad iniziativa PSP solo pendenze con una sola voce di pagamento.

Annullamento di una pendenza

Il tracciato CSV descritto in precedenza può essere utilizzato anche per effettuare l’annullamento di una pendenza. Per farlo è sufficiente valorizzare i campi idA2A e idPendenza con i valori della pendenza da annullare e l’importo a 0. Tutti gli altri campi sono ignorati dal parser.