Struttura del File
Il file è strutturato e, in base alla compilazione del record di dettaglio, può avere diverse finalità.
Il file è codificato con caratteri ASCII, ciascun record termina con CRLF (CR = codice ASCII 13 decimale; LF = codice ASCII 10 decimale).
I record del tracciato di Conferma Contabile hanno lunghezza fissa a 126 caratteri e terminano con i due caratteri CRLF (lunghezza totale del record 128).
I record del tracciato dei Pagamenti Rata e delle Autorizzazioni a mezzo file hanno lunghezza fissa a 190 caratteri e terminano con i due caratteri CRLF (lunghezza totale del record 192).
I campi alfanumerici (Tipo = A) vanno allineati a sinistra e riempiti a destra con spazi vuoti, mentre i campi numerici (Tipo = N) vanno allineati a destra e riempiti a sinistra con zeri.
Ogni blocco contabile (COINIZ-COFINE) può contenere al massimo 9999 transazioni, in quanto il progressivo transazione è lungo 4 caratteri. Al superamento della soglia di 9999 transazioni è necessario creare un nuovo blocco contabile.
La struttura del file prevede: l'apertura del record TRINIZ, l'apertura del record COINIZ, la scrittura dei record di dettaglio, la scrittura del record COFINE, la chiusura del flusso con record TRFINE.
Dettaglio della struttura
| Record | Prefisso Record | Descrizione |
|---|---|---|
| Inizio trasmissione | TRINIZ | Record di apertura del file. |
| Inizio contabile | COINIZ | Record di apertura blocco contabile |
| Dettaglio | - | Record di dettaglio |
| Fine contabile | COFINE | Record di apertura blocco contabile |
| Fine trasmissione | TRFINE | Record di chiusura del file. |
MSG TRINIZ – inizio trasmissione
| Nr. | Posizione | Lunghezza | Tipo | Descrizione |
|---|---|---|---|---|
| 1 | 01 | 6 | A | “TRINIZ” |
| 2 | 07 | 5 | N | Codice Cliente (generato e comunicato da Nexi) |
| 3 | 12 | 6 | N | Data creazione file (ggmmaa, es. 16 per l'anno 2016) |
| 4 | 18 | 6 | N | Ora creazione file (hhmmss) |
| 5 | 24 | 1 | A | “T” |
| 6 | 25 | 3 | A | “E45” |
| 7 | 28 | 3 | N | Numero progressivo della trasmissione del file batch (parte da 001, fino a 999 e poi riparte da 001, deve essere sempre diverso da 000 ed esiste il vincolo della consecutività, in modo da riscontrare eventuali mancate trasmissioni) |
| 8 | 31 | 1 | A | “A” |
| 9 | 32 | 1 | A | Spazi vuoti |
| 10 | 33 | 1 | A | “D” (solo per clienti che gestiscono il MultiCurrency) altrimenti spazi vuoti |
| 11 | 34 | 1 | A | “R” (solo per clienti che gestiscono i pagamenti ricorrenti) altrimenti spazi vuoti |
| 12 | 35 | 92 per il tracciato di
Conferma Contabile 156 per il tracciato dei Pagamenti Rata e delle Autorizzazioni a mezzo file |
A | Spazi vuoti |
MSG COINIZ – inizio contabile
| Nr. | Posizione | Lunghezza | Tipo | Descrizione |
|---|---|---|---|---|
| 1 | 01 | 6 | A | “COINIZ” |
| 2 | 07 | 5 | N | Codice Cliente (generato e comunicato da Nexi) |
| 3 | 12 | 6 | N | Data creazione file (ggmmaa, es. 16 per l'anno 2016) |
| 4 | 18 | 6 | N | Ora creazione file (hhmmss) |
| 5 | 24 | 1 | N | Impostato con l’ultima cifra dell’anno (es: 2 per il 2012) |
| 6 | 25 | 3 | N | Numero progressivo della contabile all’interno del file (parte da 001 e deve essere incrementato di uno, creando un nuovo blocco contabile COINIZ-COFINE, solo al raggiungimento di 9999 transazioni nel record di dettaglio) |
| 7 | 28 | 2 | N | “50” (euro) |
| 8 | 30 | 97 per il tracciato di
Conferma Contabile 161 per il tracciato dei Pagamenti Rata e delle Autorizzazioni a mezzo file |
A | Spazi vuoti |
MSG DETAIL – Record di dettaglio
Comporre il record di dettaglio in base allo scopo del file, successivamente vengono descritte alcune tipologie di MSG DETAIL ( per contabilizzazione via file, pagamenti rata, ecc... ).
MSG COFINE – fine contabile
| Nr. | Posizione | Lunghezza | Tipo | Descrizione |
|---|---|---|---|---|
| 1 | 01 | 6 | A | “COFINE” |
| 2 | 07 | 5 | N | Codice Cliente (generato e comunicato da Nexi) |
| 3 | 12 | 1 | N | “0” |
| 4 | 13 | 3 | N | Numero progressivo della contabile corrispondente (Deve essere riportato lo stesso progressivo indicato nel COINIZ, vedi inizio contabile numero 6) |
| 5 | 16 | 5 | N | Totale record da COINIZ a COFINE (inclusi) |
| 6 | 21 | 12 | N | Totale importi contabilizzazioni (le ultime 2 cifre corrispondono ai decimali) |
| 7 | 33 | 12 | N | Zeri |
| 8 | 45 | 12 | N | Totale importi storni (le ultime 2 cifre corrispondono ai decimali) |
| 9 | 57 | 6 | N | Data creazione file (ggmmaa, es. 16 per l'anno 2016) |
| 10 | 63 | 6 | N | Data contabile (ggmmaa, es. 16 per l'anno 2016) [coincide con data creazione file] |
| 11 | 69 | 58 per il tracciato di
Conferma Contabile 122 per il tracciato dei Pagamenti Rata e delle Autorizzazioni a mezzo file |
A | Spazi vuoti |
MSG TRFINE – Fine trasmissione
| Nr. | Posizione | Lunghezza | Tipo | Descrizione |
|---|---|---|---|---|
| 1 | 01 | 6 | A | “TRFINE” |
| 2 | 07 | 5 | N | Codice Cliente (generato e comunicato da Nexi) |
| 3 | 12 | 5 | N | Totale record da TRINIZ a TRFINE (inclusi) |
| 4 | 17 | 110 per il tracciato di Conferma Contabile 174 per il tracciato dei Pagamenti Rata e delle Autorizzazioni a mezzo file |
A | Spazi vuoti |
MSG DETAIL – Record di dettaglio per conferme contabili per contabilizzazione a mezzo file
Gli esercenti che utilizzano questo metodo richiedono la contabilizzazione inviando un archivio contenente le operazioni autorizzate da contabilizzare. Per ciascun movimento di dettaglio autorizzato contenuto nell’archivio si procederà alla relativa contabilizzazione (addebito/accredito).
| Nr. | Posizione | Lunghezza | Tipo | Descrizione |
|---|---|---|---|---|
| 1 | 01 | 1 | N | “0” |
| 2 | 02 | 9 | N | Codice Commerciante (generato e comunicato da Nexi) |
| 3 | 11 | 8 | N | Codice Terminale (generato e comunicato da Nexi) |
| 4 | 19 | 3 | N | Numero progressivo della contabile corrispondente (Deve essere riportato lo stesso progressivo indicato nel COINIZ di appartenenza, vedi inizio contabile numero 6) |
| 5 | 22 | 4 | N | Numero progressivo della transazione (parte da 0001 fino a 9999, a seguito del quale occorre creare un altro blocco contabile COINIZ-COFINE con il progressivo incrementato di 1) |
| 6 | 26 | 6 | N | Data transazione (ggmmaa, es. 16 per l'anno 2016) |
| 7 | 32 | 4 | N | Ora transazione (hhmm) |
| 8 | 36 | 23 | A | Spazi vuoti |
| 9 | 59 | 9 | N | Importo (le ultime 2 cifre corrispondono ai decimali) |
| 10 | 68 | 6 | A | Codice Autorizzazione = al campo “Auth” presente nel messaggio di risposta da Nexi |
| 11 | 74 | 3 | A | Spazi vuoti |
| 12 | 77 | 1 | A | “1” |
| 13 | 78 | 1 | A | “0” (contabilizzazione) “7” (storno) |
| 14 | 79 | 12 | A | Retrieval Reference Number = al campo “rrn” presente nel messaggio di risposta da Nexi |
| 15 | 91 | 18 | A | Riferimento Operazione (può contenere solo lettere e numeri e deve essere univoco in assoluto) |
| 16 | 109 | 18 | A | Spazi vuoti |
MSG DETAIL – Record di dettaglio per Pagamenti Rata
Gli esercenti possono richiedere di effettuare addebiti succcesivi all'attivazione, inviando un archivio elettronico. Per ciascun record di dettaglio, si procederà alla richiesta di addebito.
| Nr. | Posizione | Lunghezza | Tipo | Descrizione |
|---|---|---|---|---|
| 1 | 01 | 1 | N | “0” |
| 2 | 02 | 9 | N | Codice Commerciante (generato e comunicato da Nexi) |
| 3 | 11 | 8 | N | Codice Terminale (generato e comunicato da Nexi) |
| 4 | 19 | 3 | N | Numero progressivo della contabile corrispondente (Deve essere riportato lo stesso progressivo indicato nel COINIZ di appartenenza, vedi inizio contabile numero 6) |
| 5 | 22 | 4 | N | Numero progressivo della transazione (parte da 0001 fino a 9999, a seguito del quale occorre creare un altro blocco contabile COINIZ-COFINE con il progressivo incrementato di 1) |
| 6 | 26 | 6 | N | Data creazione file (ggmmaa, es. 16 per l'anno 2016) |
| 7 | 32 | 4 | N | Ora creazione file (hhmm) |
| 8 | 36 | 23 | A | Spazi vuoti |
| 9 | 59 | 9 | N | Importo (le ultime 2 cifre corrispondono ai decimali) |
| 10 | 68 | 6 | A | Codice Autorizzazione In fase di richiesta dal Cliente:
|
| 11 | 74 | 3 | A | Spazi vuoti |
| 12 | 77 | 1 | A | “1” |
| 13 | 78 | 1 | A | Tipo operazione
|
| 14 | 79 | 12 | A | RRN (Retrieval Reference Number) In fase di richiesta dal Cliente:
|
| 15 | 91 | 18 | A | Riferimento Operazione (può contenere solo lettere e numeri e deve essere univoco in assoluto - per la vecchia gestione dei pagamenti ricorrenti è il codice contratto) |
| 16 | 109 | 18 | A | Spazi vuoti |
| 17 | 127 | 30 | A | A disposizione del cliente |
| 18 | 157 | 3 | A | Response Code In fase di richiesta dal Cliente:
|
| 19 | 160 | 8 | A | Data autorizzazione (aaaammgg) In fase di richiesta dal Cliente:
|
| 20 | 168 | 18 | A | Walletid creato dai Commercianti e utilizzato al posto del PAN |
| 21 | 186 | 5 | A | Spazi vuoti |
MSG DETAIL – Record di dettaglio per Autorizzazioni a mezzo file
Gli esercenti che utilizzano questo metodo richiedono l'autorizzazione inviando un archivio contenente le operazioni da autorizzare.
Per ciascun movimento di dettaglio contenuto nell’archivio si procederà alla relativa autorizzazione. Per poter richiedere questo servizio, occorre essere in possesso della certificazione PCI-DSS.
| Nr. | Posizione | Lunghezza | Tipo | Descrizione |
|---|---|---|---|---|
| 1 | 01 | 1 | N | “0” |
| 2 | 02 | 9 | N | Codice Commerciante (generato e comunicato da Nexi) |
| 3 | 11 | 8 | N | Codice Terminale (generato e comunicato da Nexi) |
| 4 | 19 | 3 | N | Numero progressivo della contabile corrispondente (Deve essere riportato lo stesso progressivo indicato nel COINIZ di appartenenza, vedi inizio contabile numero 6) |
| 5 | 22 | 4 | N | Numero progressivo della transazione (parte da 0001 fino a 9999, a seguito del quale occorre creare un altro blocco contabile COINIZ-COFINE con il progressivo incrementato di 1) |
| 6 | 26 | 6 | N | Data transazione (ggmmaa, es. 16 per l'anno 2016) |
| 7 | 32 | 4 | N | Ora transazione (hhmm) |
| 8 | 36 | 19 | A | Numero carta (Solo per clienti che gestiscono l’archivio carte) Altrimentri spazi vuoti |
| 9 | 55 | 4 | N | Data scadenza (aamm, es. 16 per l'anno 2016) (Solo per clienti che gestiscono l’archivio carte) Altrimentri spazi vuoti |
| 10 | 59 | 9 | N | Importo (le ultime 2 cifre corrispondono ai decimali) |
| 11 | 68 | 6 | A | Codice Autorizzazione In fase di richiesta dal Cliente:
|
| 12 | 74 | 3 | A | Spazi vuoti |
| 13 | 77 | 1 | A | “1” |
| 14 | 78 | 1 | A | Tipo operazione
|
| 15 | 79 | 12 | A | RRN (Retrieval Reference Number) In fase di richiesta dal Cliente:
|
| 16 | 91 | 18 | A | Riferimento Operazione (può contenere solo lettere e numeri e deve essere univoco in assoluto) |
| 17 | 109 | 3 | A | Response code In fase di richiesta dal Cliente:
|
| 18 | 112 | 2 | A | Spazi vuoti |
| 19 | 114 | 3 | A | Codice valuta (solo per clienti che gestiscono il multicurrency) Altrimenti spazi vuoti |
| 20 | 117 | 9 | N | Importo in valuta – le ultime 2 cifre corrispondono ai decimali (solo per clienti che gestistono il multicurrency) Altrimenti spazi vuoti |
| 21 | 126 | 65 | A | Spazi vuoti |