Tracciato record "Formato a sezioni"
Versione aggiornata con la gestione del numero di protocollo di origine per l'importazione dei documenti di vendita e di acquisto. Le modifiche rispetto alla versione precedente sono evidenziate in giallo.
Di seguito viene descritto il tracciato del file testo da preparare per la contabilizzazione nel nostro programma dei documenti di vendita e di acquisto (Versione a sezioni).
Il file deve essere un classico file testo composto quindi da righe terminate con CR-LF (ascii 13 + 10), i dati sono divisi in sezioni, le sezioni iniziano alle righe che contengono un nome tra parentesi quadra (es. [TESTA]).
Ogni sezione è composta da una serie di righe nella forma XXX=YYY dove XXX è il nome del campo, YYY è il contenuto del campo.
Nel file, per ogni documento devono essere presenti:
- Una sezione [TESTA]
- Una o più sezioni [IVA] (castelletto IVA)
- Una o più sezioni [COGE] (movimenti contabili da generare)
- Una o più sezioni [SCAD] (scadenze dei pagamenti)
Tutte le sezioni che seguono la sezione [TESTA] sono considerate "ad essa relative".
Opzionalmente, all'inizio del file può essere presente una sezione (una soltanto) con i dati relativi alla ditta su cui devono essere contabilizzati i documenti. Solitamente non è necessario predisporre tale sezione ma se viene inserita, tutti i relativi campi devono essere presenti.
Le righe vuote o inizianti con ";" (punto e virgola) non vengono considerate.
Sotto sono riportati i nomi dei campi accettati nelle varie sezioni, tenere presente che:
- O/F: O=Obbligatorio, F=Facoltativo
- Tipo: A=Alfanumerico, N=Numerico.
I campi di tipo numerico possono contenere solo i caratteri 0..9, l'eventuale segno "-" (sulla sinistra del numero), l'eventuale separatore decimale (virgola).
Esempi validi: 123456,00 -456,23
Esempi NON validi: 123.456,00 456,23- 345.00
- Lun Max: Lunghezza massima del campo (compreso segno e virgola per i campi numerici)
- Dec: Numero di decimali ammessi
Gestione del numero di protocollo (novità)
Il tracciato consente di importare i documenti di vendita e di acquisto provenienti da gestionali esterni mantenendo il numero di protocollo già attribuito dal gestionale di origine, senza che la procedura ne generi uno proprio.
Documenti di vendita (TIPOREG=1 e TIPOREG=5). Il numero di protocollo coincide con il numero del documento indicato nel campo NUMDOC. Affinché la procedura assuma tale numero e non ne generi uno automatico, nell'anagrafica DITTE CONTABILI il campo "ATTIVA PROTOCOLLAZIONE AUTOMATICA DEI DOCUMENTI DI VENDITA" NON deve essere flaggato. Se il campo risulta flaggato, la procedura attribuisce comunque una propria numerazione progressiva di protocollo e il valore di NUMDOC viene mantenuto come solo numero documento.
Documenti di acquisto (TIPOREG=3). Il numero di protocollo non può coincidere con il numero del documento, che è attribuito dal fornitore. Viene pertanto introdotto nella sezione [TESTA] il campo facoltativo NUMPROT, di tipo numerico, lunghezza massima 6 caratteri, 0 decimali, nel quale indicare il protocollo già assegnato dal gestionale del cliente. Il campo accoglie il solo numero progressivo, senza barra e senza indicazione dell'anno: al protocollo 125/2026 corrisponde quindi NUMPROT=125, essendo l'anno desumibile dalla data di registrazione. Se il campo non è valorizzato, la procedura protocolla il documento secondo la numerazione automatica del registro acquisti.
Formato del rigo: | NUMPROT | F (facoltativo) | N (numerico) | 6 (lunghezza) | 0 (decimali) |
Posizionamento. Il campo NUMPROT è collocato nella sezione di testata immediatamente dopo il campo TOTDOC. All'interno della sezione le righe nella forma XXX=YYY non sono posizionali, per cui l'ordine indicato risponde a esigenze di leggibilità e di allineamento ai file attualmente generati dai gestionali di origine.
Nomenclatura delle sezioni. Nei file di scambio prodotti dai gestionali le sezioni possono essere denominate con il prefisso DOC_, quindi [DOC_TESTA], [DOC_IVA] e [DOC_COGE], e possono essere presenti anche le sezioni [MOV_TESTA] e [MOV_RIGA] per i movimenti di prima nota. In tal caso il campo NUMPROT va inserito nella sezione [DOC_TESTA], dopo TOTDOC.
Indicazioni per il gestionale di origine. Il software che produce il file deve scrivere in NUMPROT il solo progressivo del protocollo, eliminando il separatore e la parte relativa all'anno: dal protocollo 125/2026 deve essere generata la riga NUMPROT=125. Devono essere omessi eventuali spazi e qualsiasi carattere non numerico; gli zeri non significativi sono ammessi ma non necessari. Se il protocollo non è disponibile, la riga NUMPROT va omessa anziché scritta con valore vuoto o pari a zero. Il campo non deve essere valorizzato per i documenti di vendita. Protocolli di lunghezza superiore a sei cifre non sono rappresentabili nel campo e devono essere segnalati in fase di generazione del file.
Sezione [DITTA] (facoltativa, usata in casi molto particolari)
| NOME CAMPO | O/F | Tipo | Lun Max | Dec | Descrizione | Note |
| DI_PIVA | O | A | 20 | Partita iva | ||
| DI_CODFISC | O | A | 20 | Codice fiscale | ||
| DI_RAGSOC1 | O | A | 50 | Ragione sociale 1 (oppure Cognome) | ||
| DI_RAGSOC2 | O | A | 50 | Ragione sociale 2 (oppure Nome) | ||
| DI_INDIRIZZO | O | A | 35 | Indirizzo | ||
| DI_CAP | O | A | 5 | Cap | ||
| DI_COMUNE | O | A | 35 | Comune | ||
| DI_PROVINCIA | O | A | 2 | Provincia |
Sezione [TESTA]
| NOME CAMPO | O/F | Tipo | Lun Max | Dec | Descrizione | Note |
| CF_COD | F | N | 6 | 0 | Codice cliente/fornitore (è Cli o For in base al tipo registro) | (4) |
| CF_RAGSOC1 | O | A | 50 | Ragione sociale 1 (oppure Cognome) | ||
| CF_RAGSOC2 | F | A | 50 | Ragione sociale 2 (oppure Nome) | ||
| CF_INDIRIZZO | O | A | 35 | Indirizzo | ||
| CF_CAP | O | A | 5 | Cap | ||
| CF_COMUNE | O | A | 35 | Comune | ||
| CF_PROVINCIA | O | A | 2 | Provincia | ||
| CF_CODFISC | O | A | 20 | Codice fiscale | ||
| CF_PIVA | O | A | 20 | Partita iva | ||
| CF_CODPAG | O | A | 6 | Codice pagamento (da tabella EosTb_CondPag) | (1) | |
| CF_NATGIU | F | A | 2 | Natura giuridica | (1) | |
| CF_INTEST | F | A | 30 | Intestazione | ||
| CF_DATANASC | F | D | 10 | Data di nascita in forma GG/MM/AAAA, se non indicata, viene recuperata dall'eventuale Codice Fiscale | ||
| CF_COMNASC | F | A | 4 | Codice comune o stato estero di nascita (G888, Z507 ecc). Se non indicato viene recuperato dall'eventuale Codice Fiscale | ||
| CF_SESSO | F | A | 1 | Sesso (M/F), se non indicato, viene recuperato dall'eventuale Codice Fiscale | ||
| BANCA_ABI | F | A | 10 | Banca appoggio (ABI) | ||
| BANCA_CAB | F | Banca appoggio (CAB) | ||||
| DITTA | F | A | 4 | Codice ditta | (1) (8) | |
| ATTIVITA | F | A | 2 | Codice attivita | (1) (8) | |
| TIPOREG | O | N | 2 | 0 | Tipo registro (1=vendite, 3=acquisti, 5=vendite usati) | (1) |
| NUMREG | O | N | 3 | 0 | Numero registro (solitamente 1) | |
| CAUSALE | O | A | 4 | Causale coge (solitamente VE01 per fattura, NC01 per nota accredito, AC01 per fattura di acquisto, come da EosTb_CauCont) | (1) | |
| NUMDOC | O | N | 6 | 0 | Numero documento | (10) |
| DATADOC | O | A | 10 | Data documento in forma GG/MM/AAAA | ||
| DIVISA | F | N | 4 | 0 | Valuta (default=Euro) | (1)(3) |
| CAMBIO | F | N | 11 | 5 | Cambio | (3) |
| TOTDOC | O | N | 12 | 2 | Totale documento (con iva) | |
| NUMPROT | F | N | 6 | 0 | Numero di protocollo del documento già assegnato dal gestionale di origine. Va indicato il solo numero progressivo, senza barra e senza anno (es. 125, non 125/2026). Campo utilizzato per i documenti di acquisto (TIPOREG=3): se valorizzato, il documento viene protocollato con tale numero e non viene attribuito un protocollo automatico. Per i documenti di vendita (TIPOREG=1 e 5) il protocollo coincide con NUMDOC. | (10) (11) |
| ACCONTO | F | N | 12 | 2 | Importo acconto | (3) |
| ABBUONO | F | N | 12 | 2 | Importo abbuono | (3) |
| AGENTE | F | A | 5 | Codice agente (per scadenzario) | (1) | |
| DATAREG | F | A | 10 | Data registrazione in forma GG/MM/AAAA (se indicata, ha precedenza su quella fornita in fase di contabilizzazione) |
Sezione [IVA] (castelletto iva)
| NOME CAMPO | O/F | Tipo | Lun Max | Dec | Descrizione | Note |
| CODIVA | O | A | 3 | Codice IVA | (1) | |
| IMPONIBILE | O | N | 12 | 2 | Imponibile IVA | |
| IVA | O | N | 12 | 2 | Importo IVA |
Sezione [COGE] (movimenti contabili da generare)
| NOME CAMPO | O/F | Tipo | Lun Max | Dec | Descrizione | Note |
| CONTO | O | N | 6 | 0 | Conto | (1) (2) |
| IMPORTO | O | N | 12 | 2 | Importo | |
| TIPORIGA | O | N | 1 | 0 | Tipo riga (1=Cliente/Fornitore 2=Sconto 3=Spese 4=Righe 5=Iva) | (5) |
| SEGNO | O | A | 1 | Segno (D=Dare, A=Avere) | (6) | |
| CDC | F | A | 8 | Centro di costo (per contab. analitica) | ||
| COMMESSA | F | A | 14 | Commessa (per contab. analitica) | (9) | |
| DESAGG | F | A | 25 | Descrizione aggiuntiva |
Sezione [SCAD] (scadenze dei pagamenti)
| NOME CAMPO | O/F | Tipo | Lun Max | Dec | Descrizione | Note |
| TIPORATA | O | A | 3 | Tipo rata (come da tabella EosTb_TipiPag) | (1) (7) | |
| DATASCAD | O | A | 10 | Data scadenza in forma GG/MM/AAAA | ||
| IMPORTO | O | N | 12 | 2 | Importo scadenza |
Note
(1) E' il codice conosciuto dalla procedura Studio2 / Amico2
(2) Va indicato il codice del conto (piano dei conti). Nel caso di Tipo Riga = 1 può essere messo ZERO
(3) Questi campi non sono attualmente gestiti.
(4) Questo campo è facoltativo, può eventualmente contenere il codice con cui il cli/for è conosciuto dalla procedura che prepara il file. La ricerca del cliente/fornitore viene fatta utilizzando la partita iva o il codice fiscale. Se trovato viene utilizzato quello, viceversa ne viene creato uno nuovo.
(5) Tipo Riga
Il caso classico per una fattura di vendita è:
· una sezione con Tipo Riga 1 segno Dare per il totale fattura
· una o più sezioni con Tipo Riga 4 segno Avere per i ricavi (merci c/vendita)
· una o più sezioni con Tipo Riga 5 segno Avere per l'iva (iva c/vendite).
Il caso classico per una nota di accredito è:
· una sezione con Tipo Riga 1 segno Avere per il totale nota credito
· una o più sezioni con Tipo Riga 4 segno Dare per i ricavi (merci c/vendita)
· una o più sezioni con Tipo Riga 5 segno Dare per l'iva (iva c/vendite).
Il caso classico per una fattura di acquisto è:
· una sezione con Tipo Riga 1 segno Avere per il totale fattura
· una o più sezioni con Tipo Riga 4 segno Dare per i costi (merci c/acquisti)
· una o più sezioni con Tipo Riga 5 segno Dare per l'iva (iva c/acquisti).
(6) La somma degli importi dei righi Dare deve essere uguale alla somma degli importi dei righi Avere
(7) Solitamente RD=Rimessa diretta, RB=Ric.Banc, BON=Bonifico, TRA=Tratta
(8) Questo campo non è obbligatorio in quanto è possibile forzarlo al momento dell'importazione in Amico/Studio2
(9) Formato XXXXXXXXX/YYYY dove X = commessa e Y = anno
(10) Per i documenti di vendita (TIPOREG=1 e 5) il numero di protocollo assunto dalla procedura è quello indicato in NUMDOC, a condizione che nell'anagrafica DITTE CONTABILI NON sia flaggato il campo "ATTIVA PROTOCOLLAZIONE AUTOMATICA DEI DOCUMENTI DI VENDITA". In presenza del flag, il protocollo viene generato automaticamente dalla procedura.
(11) Il campo NUMPROT è riferito ai documenti di acquisto (TIPOREG=3), è collocato nella sezione di testata dopo il campo TOTDOC (sezione [DOC_TESTA] nei file con sezioni prefissate DOC_) e accoglie il numero di protocollo già attribuito dal gestionale di origine. Il valore è costituito dal solo numero progressivo, senza barra e senza anno: non sono ammessi caratteri diversi dalle cifre 0..9, per cui un protocollo espresso nella forma 125/2026 va riportato come NUMPROT=125. L'anno di protocollazione è quello della data di registrazione. Il valore deve essere univoco nell'ambito del registro (NUMREG) e dell'anno della data di registrazione; in caso di protocollo già presente il documento viene scartato e segnalato nel log di importazione. Se il campo è assente o pari a zero, la procedura attribuisce il primo protocollo disponibile della numerazione automatica. Per i documenti di vendita il campo, se presente, non viene considerato.
Esempio di file testo
La sezione [DITTA] è facoltativa, usata in casi molto particolari
[DITTA]
DI_PIVA=01234567890
DI_CODFISC=NREGCM60B15G888P
DI_RAGSOC1=ACME SNC
DI_RAGSOC2=di NERI GIACOMO
DI_INDIRIZZO=Piazzale Roma, 12
DI_CAP=33100
DI_COMUNE=UDINE
DI_PROVINCIA=UD
---------------------------
esempio di fattura di vendita
---------------------------
[TESTA]
CF_COD=000002
CF_RAGSOC1=ROSSI
CF_RAGSOC2=MARIO
CF_INDIRIZZO=VIA SPILIMBERGO, 56
CF_CAP=10100
CF_COMUNE=TORINO
CF_PROVINCIA=TO
CF_CODFISC=RSSMRA60E16L483D
CF_PIVA=01234567897
CF_CODPAG=RB006
CF_NATGIU=0
CF_INTEST=Bar "Da Mario"
BANCA_ABI=01000
BANCA_CAB=02400
DITTA=0001
ATTIVITA=1
TIPOREG=01
NUMREG=001
CAUSALE=VE01
NUMDOC=000001
; il protocollo coincide con NUMDOC (flag di protocollazione
; automatica dei documenti di vendita NON attivo in Ditte contabili)
DATADOC=16/01/2009
DIVISA=
CAMBIO=0
TOTDOC=536,34
ACCONTO=0
ABBUONO=0
AGENTE=AG3
[IVA]
CODIVA=20
IMPONIBILE=353,63
IVA=70,73
[IVA]
CODIVA=FCI
IMPONIBILE=111,98
IVA=0
[COGE]
CONTO=0
IMPORTO=536,34
TIPORIGA=1
SEGNO=D
[COGE]
CONTO=680075
IMPORTO=10
TIPORIGA=3
SEGNO=A
[COGE]
CONTO=800010
IMPORTO=215,14
TIPORIGA=4
SEGNO=A
[COGE]
CONTO=800011
IMPORTO=240,47
TIPORIGA=4
SEGNO=A
[COGE]
CONTO=350030
IMPORTO=70,73
TIPORIGA=5
SEGNO=A
[SCAD]
TIPORATA=RB
DATASCAD=16/03/2009
IMPORTO=268,17
[SCAD]
TIPORATA=RB
DATASCAD=16/04/2009
IMPORTO=268,17
---------------------------
esempio di nota credito
---------------------------
[TESTA]
CF_COD=000003
CF_RAGSOC1=ROSSI
CF_RAGSOC2=SANDRO
CF_INDIRIZZO=VIA CONEGLIANO, 2
CF_CAP=31100
CF_COMUNE=TREVISO
CF_PROVINCIA=TV
CF_CODFISC=RSSSDR42R31L407J
CF_PIVA=00123456782
CF_CODPAG=RD000
CF_INTEST=Acconciature "SANDRO"
CF_DATANASC=31/10/1942
CF_COMNASC=L407
CF_SESSO=M
BANCA_ABI=05000
BANCA_CAB=01600
DITTA=0001
ATTIVITA=1
TIPOREG=01
NUMREG=001
CAUSALE=NC01
NUMDOC=000002
DATADOC=16/01/2009
DIVISA=
CAMBIO=0
TOTDOC=200,64
ACCONTO=0
ABBUONO=0
AGENTE=
[IVA]
CODIVA=20
IMPONIBILE=167,2
IVA=33,44
[COGE]
CONTO=0
IMPORTO=200,64
TIPORIGA=1
SEGNO=A
[COGE]
CONTO=800011
IMPORTO=167,2
TIPORIGA=4
SEGNO=D
[COGE]
CONTO=350030
IMPORTO=33,44
TIPORIGA=5
SEGNO=D
[SCAD]
TIPORATA=RD
DATASCAD=16/01/2009
IMPORTO=200,64
---------------------------
esempio di fattura di acquisto (con protocollo di origine)
---------------------------
[TESTA]
CF_COD=000015
CF_RAGSOC1=FORNITURE INDUSTRIALI SRL
CF_RAGSOC2=
CF_INDIRIZZO=VIA DEI MILLE, 24
CF_CAP=63100
CF_COMUNE=ASCOLI PICENO
CF_PROVINCIA=AP
CF_CODFISC=01987654321
CF_PIVA=01987654321
CF_CODPAG=BON030
DITTA=0001
ATTIVITA=1
TIPOREG=03
NUMREG=001
CAUSALE=AC01
NUMDOC=004512
; numero documento attribuito dal fornitore
DATADOC=10/03/2026
DATAREG=31/03/2026
DIVISA=
CAMBIO=0
TOTDOC=1220,00
NUMPROT=37
; numero di protocollo attribuito dal gestionale del cliente
ACCONTO=0
ABBUONO=0
[IVA]
CODIVA=22
IMPONIBILE=1000,00
IVA=220,00
[COGE]
CONTO=0
IMPORTO=1220,00
TIPORIGA=1
SEGNO=A
[COGE]
CONTO=700010
IMPORTO=1000,00
TIPORIGA=4
SEGNO=D
[COGE]
CONTO=250010
IMPORTO=220,00
TIPORIGA=5
SEGNO=D
[SCAD]
TIPORATA=BON
DATASCAD=09/04/2026
IMPORTO=1220,00
---------------------------
esempio con sezioni denominate con il prefisso DOC_
fattura di acquisto integrata con NUMPROT
---------------------------
[DOC_TESTA]
CF_RAGSOC1=ALFA COMPONENTI S.R.L.
CF_INDIRIZZO=VIA DELLE INDUSTRIE, 10
CF_CAP=00100
CF_COMUNE=ROMA
CF_PROVINCIA=RM
CF_CODFISC=01234567890
CF_PIVA=01234567890
DITTA=1
ATTIVITA=1
TIPOREG=3
NUMREG=1
DATAREG=31/07/2026
CAUSALE=AA01
NUMDOC=1679
DATADOC=15/07/2026
TOTDOC=13372,18
NUMPROT=125
; solo il numero: il protocollo 125/2026 si riporta come 125