Flusso di Rendicontazione
Per consentire agli EC la riconciliazione dei riversamenti avvenuti (rif. Riconciliazione del flusso di riversamento), il PSP che ha effettuato l’operazione provvede ad inviare al Nodo dei Pagamenti-SPC un flusso di rendicontazione (FdR) predisposto secondo lo schema riportato nella Tabella 6.
Tale flusso deve essere inviato entro, e non oltre, le ore 24 della seconda giornata lavorativa successiva alla ricezione dell’ordine di pagamento (D+2).
Le colonne Liv, Gen, Occ e Len della citata Tabella 6 assumono il seguente significato:
Tabella 5 - Flusso per la rendicontazione - Descrizione colonne
Liv
indica il livello di indentazione del dato al fine di rendere evidenti le strutture che contengono ulteriori informazioni (colonna "Gen" uguale ad s): esempio, le strutture di livello 1 sono formate da tutti i dati di livello superiore ad 1, quelle di livello 2 sono formate da tutti i dati di livello superiore a 2, e così via.
Gen
indica il genere (tipo) del dato da utilizzare; può assumere i seguenti valori:
s - struttura che può contenere altre strutture o dati,
an - dato alfanumerico
n - dato numerico.
Occ
indica le “occorrenze” del dato nel formato min..max.
Len
indica la lunghezza massima del dato nel formato min..max; nel caso si tratti di una lunghezza fissa comparirà solo il dato len, nel caso di lunghezze fisse in alternativa la notazione sarà len1 / len2.
Tabella 6 - Flusso per la rendicontazione - Schema dati
versioneOggetto
1
an
1..1
1..16
Versione che identifica l’oggetto scambiato.
Valori ammessi: “1.0” e “1.1”
identificativoFlusso
1
an
1..1
1..35
Identificativo legato alla generazione e trasmissione del flusso di riversamento.
Deve essere univoco nell’ambito dell’anno di riferimento delle operazioni di pagamento cui si riferisce il flusso.
dataOraFlusso
1
an
1..1
19
Indica la data e ora di creazione del flusso, secondo il formato ISO 8601
[YYYY]-[MM]-[DD]T[hh]:[mm]:[ss]
identificativoUnivocoRegolamento
1
an
1..1
1..35
Riferimento assegnato dal PSP all’operazione di trasferimento fondi con la quale viene regolato contabilmente il riversamento delle somme incassate ovvero l’accumulo degli accrediti disposti dai clienti.
dataRegolamento
3
an
o
10
Indica la data di esecuzione dell’operazione di trasferimento fondi con la quale viene regolato contabilmente il riversamento delle somme incassate, nel formato ISO 8601 [YYYY]-[MM]-[DD].
istitutoMittente
1
s
1..1
Aggregazione relativa al PSP mittente che genera il presente flusso.
identificativoUnivocoMittente
2
s
1..1
Aggregazione che riporta le informazioni concernenti l’identificazione dell’Istituto mittente del flusso.
tipoIdentificativoUnivoco
3
an
1..1
1
Campo alfanumerico che descrive la codifica utilizzata per individuare l’Istituto Mittente; se presente può assumere i seguenti valori:
‘G’ = persona giuridica
‘A’ = Codice ABI
‘B’ = Codice BIC (standard ISO 9362)
codiceIdentificativoUnivoco
3
an
1..1
1..35
Campo alfanumerico che può contenere il codice fiscale o la partita IVA, il codice ABI o il codice BIC del PSP mittente, in funzione del dato tipoIdentificativoUnivoco.
denominazioneMittente
2
an
0..1
1..70
Contiene la denominazione del PSP mittente che genera il flusso.
codiceBicBancaDiRiversamento
2
an
0..1
1..35
Contiene il codice BIC del PSP che ha generato il SEPA Credit Transfer di riversamento. Corrisponde al dato AT-09 del SCT.
istitutoRicevente
1
s
1..1
Aggregazione relativa all’EC destinatario del flusso.
identificativoUnivocoRicevente
2
s
1..1
Aggregazione che riporta le informazioni concernenti l’identificazione fiscale dell’EC che riceve il flusso.
tipoIdentificativoUnivoco
3
an
1..1
1
Campo alfanumerico che indica la natura dell’EC; se presente deve assumere il valore ‘G’, Identificativo fiscale Persona Giuridica.
codiceIdentificativoUnivoco
3
an
1..1
1..35
Campo alfanumerico contenente il codice fiscale dell’EC destinatario del flusso.
denominazioneRicevente
2
an
0..1
1..70
Contiene la denominazione dell’EC che riceve il flusso.
numeroTotalePagamenti
1
n
1..1
1..15
Numero dei pagamenti presenti nel flusso.
importoTotalePagamenti
1
n
1..1
1..18
Importo totale dei pagamenti presenti nel flusso. Deve coincidere con la somma dei dati singoloImportoPagato presenti nel flusso.
Deve essere maggiore di 0.
datiSingoliPagamenti
1
s
1 n
Aggregazione con un numero di occorrenze pari all’elemento numeroTotalePagamenti
identificativoUnivocoVersamento
2
an
1..1
1..35
Riporta il dato codice IUV cui si riferisce il pagamento rendicontato nel flusso.
identificativoUnivocoRiscossione
2
an
1..1
1..35
Riferimento univoco dell’operazione, è rappresentato dal payment token.
indiceDatiSingoloPagamento
2
n
0..1
1
Indice dell’occorrenza del pagamento all’interno della struttura transfer, campo idTransfer.
singoloImportoPagato
2
an
1..1
3..12
Campo numerico indicante l’importo relativo alla somma pagata o revocata. Deve essere diverso da 0.
Qualora il singolo importo pagato è riferito ad un pagamento revocato (dato codiceEsitoSingoloPagamento =3) deve assumere un valore negativo.
codiceEsitoSingoloPagamento
2
n
1..1
1
Campo numerico indicante l’esito del pagamento. Può assumere i seguenti valori:
0 = Pagamento eseguito
3 = Pagamento revocato
4 = Pagamento gestito in Stand In
9 = Pagamento eseguito senza riscontro di "Ricevuta Telematica" per il PSP
dataEsitoSingoloPagamento
2
an
1..1
10
Indica la data in cui è stato disposto o revocato il pagamento, nel formato ISO 8601 [YYYY]-[MM]-[DD].
Per quanto riguarda gli EC, tali flussi omogenei di dati sono messi a loro disposizione attraverso l’infrastruttura di cui all’articolo 5, comma 2 del CAD alla quale sono tenuti a collegarsi i PSP che effettuano il riversamento, con le modalità riportate nelle SANP (Allegato B alle Linee guida).
Lo schema XML (XSD) descrittivo del contenuto dei file XML utilizzati per trasferire le informazioni del flusso di rendicontazione è fornito in formato elettronico nel repository GitHub pagopa-api (https://github.com/pagopa/pagopa-api/blob/master/general/FlussoRiversamento_1_0_4.xsd).
Si sottolinea infine che, essendo il flusso di rendicontazione associato ad un singolo SCT di riversamento, detto flusso è ovviamente sempre correlato ad un unico codice IBAN di accredito.
La predisposizione di più di un FdR con lo stesso identificativoFlusso è un evento eccezionale, che può essere motivato da errori presenti nel precedente flusso, tale operazione deve essere gestita con le modalità descritte nella sezione "Gestione sovrascritture Flussi di Rendicontazione" presente nelle SANP.
Precisazioni sulla colonna “contenuto” della Tabella 6 - Flusso per la rendicontazione - Schema dati
Tenuto presente che il significato dei dati richiesti per il flusso di rendicontazione è riportato nella colonna “contenuto” della Tabella 6, di seguito sono riportate alcune precisazioni utili agli EC sui dati presenti nel flusso di rendicontazione:
identificativoFlusso: deve essere lo stesso riportato nel componente <identificativoFlusso> della causale del SEPA Credit Transfer di Riversamento (dato “Remittance Information” - attributo AT-05, Operazione di trasferimento fondi);
identificativoUnivocoRegolamento: Transaction Reference Number (TRN) AT-43 Originator Bank’s Reference del SEPA Credit Transfer di Riversamento;
identificativoUnivocoRiscossione: rappresenta l’identificativo con il quale il PSP individua la singola operazione, è contenuto all'interno della receipt elemento receiptId;
indiceDatiSingoloPagamento: dato facoltativo che rappresenta la i-esima occorrenza di versamento all’interno della receipt rendicontata;
Standardizzazione del dato identificativoFlusso
Al fine di rendere omogenea la modalità di composizione del dato identificativoFlusso presente nella causale standardizzata del SEPA Credit Transfer ed anche nel flusso di rendicontazione è adottata la seguente struttura:
<data regolamento><istituto mittente>”-“<flusso>
dove i componenti sopra indicati assumono il seguente significato:
<data regolamento> contiene le stesse informazioni dell’elemento dataRegolamento del file XML;
<istituto mittente> contiene il codice di identificazione all'interno della piattaforma del PSP che predispone il flusso;
"-" dato fisso;
<flusso> stringa alfanumerica che, insieme alle informazioni sopra indicate, consente di individuare univocamente il flusso stesso. I caratteri ammessi all’interno della stringa sono: cifre da 0 a 9, lettere dell’alfabeto latino maiuscole e minuscole ed i caratteri della Tabella 7.
Tabella 7 - Caratteri ammessi
ASCII
Simbolo
Nome
Dec | Hex
45
2D
-
minus sign - hyphen
95
5F
_
underscore
Esempi:
2015-07-15xxxxxxxx-0000000001
2015-07-15xxxxxxxx-hh_mm_ss_nnn
Last updated