Quando Konga genera il file XML di una fattura elettronica, ogni elemento del tracciato viene riempito con il contenuto di un campo preciso di un archivio preciso. Sapere quale è la differenza fra correggere un dato in trenta secondi e passare mezz’ora a caccia dell’informazione sbagliata — soprattutto quando è lo SdI a scartare il file, e il codice di errore parla il linguaggio del tracciato e non quello di Konga.

Questo articolo è pensato come documento di riferimento: per ogni elemento del tracciato trovate l’archivio e il campo di Konga da cui l’informazione arriva. Il tracciato di riferimento è la Rappresentazione tabellare della fattura ordinaria (B2B e B2G), versione 1.9.1, in vigore dal 31 marzo 2026.

Konga copre quasi per intero il tracciato: gli elementi che non vengono valorizzati sono una ventina su oltre 260, e riguardano casi marginali (peso netto, data e ora di ritiro e consegna, cessioni intracomunitarie di mezzi di trasporto nuovi, alcuni dettagli dei termini di pagamento).

Come leggere le tabelle

Ogni tabella ha quattro colonne:

• ID — il numero dell’elemento nel tracciato, quello che compare anche nei messaggi di scarto dello SdI;
• Elemento XML — il nome del tag;
• Occ. — obbligatorietà e occorrenze secondo il tracciato: 1.1 obbligatorio e unico, 0.1 facoltativo e unico, 0.N facoltativo e ripetibile, 1.N obbligatorio e ripetibile;
• Origine in Konga — archivio, etichetta del campo e, fra parentesi, il nome tecnico con cui il campo compare nel data dictionary. Il nome tecnico serve a chi scrive query, script o layout di stampa; chi lavora solo dall’interfaccia può ignorarlo.

Gli archivi che ricorrono più spesso

Archivio	Cosa contiene
Aziende	I dati dell’azienda di lavoro: anagrafica, sede, regime fiscale, rappresentante fiscale
Codici Fissi	I dati del soggetto trasmittente e dell’eventuale terzo intermediario
Stato degli Archivi	Le preferenze aziendali che governano la generazione del documento elettronico
Clienti/Fornitori	L’anagrafica del cliente intestatario del documento
Documenti Fiscali	La testata del documento
Righe dei documenti fiscali	Le righe del documento
Aliquote IVA	Percentuale, natura e riferimento normativo

Le autofatture ribaltano cedente e cessionario

Per i tipi documento TD16, TD17, TD18, TD19, TD20, TD28 e TD29 cedente e cessionario si scambiano di posto: nel blocco CedentePrestatore finiscono i dati dell’archivio Clienti/Fornitori (il fornitore estero o il soggetto da autofatturare) e nel blocco CessionarioCommittente quelli dell’archivio Aziende. In questo caso il regime fiscale è forzato a RF01 e il codice destinatario è letto da Aziende → Codice SDI destinatario.

Nelle tabelle che seguono la colonna «Origine in Konga» descrive sempre il caso normale; il comportamento con il ribaltamento è segnalato nelle note.

Valuta e decimali

Il tracciato vuole gli importi del corpo e del riepilogo espressi nella valuta di conto, mentre l’elemento Divisa riporta la valuta reale del documento. Se il documento non è in valuta di conto, Konga usa i campi «in valuta di conto» delle righe e aggiunge a ogni riga due blocchi AltriDatiGestionali di tipo VALUTA UN e VALUTA TOT con gli importi originali.

I decimali seguono queste regole: due per gli importi e per le percentuali, mentre per le quantità e i valori unitari valgono le preferenze in Stato degli Archivi → Numero decimali quantità (val_NumDecimaliQta, minimo 2) e Numero decimali valori unitari (val_ValoriUnitari).

1. FatturaElettronicaHeader

1.1 DatiTrasmissione

ID	Elemento XML	Occ.	Origine in Konga
1.1.1.1	IdPaese	1.1	Codici Fissi → Codice nazione trasmittente (IdPaeseTrasmittente); se vuoto, Aziende → Codice ISO nazione (val_CodiceISO)
1.1.1.2	IdCodice	1.1	Codici Fissi → Codice identificativo trasmittente (CodiceTrasmittente); se vuoto, Aziende → Codice Fiscale (CodiceFiscale)
1.1.2	ProgressivoInvio	1.1	Progressivo assegnato dalla procedura di generazione, riempito di zeri a 10 caratteri. Non è un campo di archivio
1.1.3	FormatoTrasmissione	1.1	Clienti/Fornitori → Pubblica Amministrazione (val_PubblicaAmministrazione): FPA12 se sì, FPR12 altrimenti
1.1.4	CodiceDestinatario	1.1	Documenti Fiscali → Codice SDI destinatario (CodUnivocoUfficio); se vuoto, Clienti/Fornitori → Codice SDI destinatario (CodUnivocoUfficio); in mancanza di entrambi, 0000000
1.1.5.1	Telefono	0.1	Codici Fissi → Telefono trasmittente (TelefonoTrasmittente); se vuoto, Aziende → Telefono (Telefono)
1.1.5.2	Email	0.1	Codici Fissi → Email trasmittente (EmailTrasmittente); se vuoto, Aziende → Indirizzo email (Email)
1.1.6	PECDestinatario	0.1	Clienti/Fornitori → Indirizzo PEC (IndirizzoPEC)

Konga controlla la lunghezza del codice destinatario — sei caratteri per la Pubblica Amministrazione, sette per i privati — e segnala nel registro delle elaborazioni se non corrisponde. Con il ribaltamento delle autofatture il codice destinatario è letto da Aziende → Codice SDI destinatario.

1.2 CedentePrestatore

1.2.1 DatiAnagrafici

ID	Elemento XML	Occ.	Origine in Konga
1.2.1.1.1	IdPaese	1.1	Aziende → Codice ISO nazione (val_CodiceISO)
1.2.1.1.2	IdCodice	1.1	Aziende → Partita IVA (PartitaIVA). Se manca viene segnalato errore
1.2.1.2	CodiceFiscale	0.1	Aziende → Codice Fiscale (CodiceFiscale). Se manca viene segnalato errore
1.2.1.3.1	Denominazione	0.1	Aziende → Ragione sociale (RagioneSociale), solo se Persona fisica (val_PersonaFisica) è No
1.2.1.3.2	Nome	0.1	Aziende → Nome (Nome), solo se Persona fisica è Sì e la ragione sociale coincide con «Cognome Nome»
1.2.1.3.3	Cognome	0.1	Aziende → Cognome (Cognome), alle stesse condizioni
1.2.1.3.4	Titolo	0.1	Aziende → Titolo (Titolo), solo se lungo almeno due caratteri
1.2.1.3.5	CodEORI	0.1	Aziende → Codice EORI (CodiceEORI)
1.2.1.4	AlboProfessionale	0.1	Aziende → Albo professionale (AlboProfessionale)
1.2.1.5	ProvinciaAlbo	0.1	Aziende → Provincia albo (ProvinciaAlbo)
1.2.1.6	NumeroIscrizioneAlbo	0.1	Aziende → Numero iscrizione albo (NumeroIscrizioneAlbo)
1.2.1.7	DataIscrizioneAlbo	0.1	Aziende → Data iscrizione albo (DataIscrizioneAlbo)
1.2.1.8	RegimeFiscale	1.1	Aziende → Regime fiscale (val_RegimeFiscale), tradotto nel codice RFxx

Persona fisica. Se l’azienda è una persona fisica, Konga confronta la ragione sociale con la stringa «Cognome Nome»: se coincidono emette Nome e Cognome, altrimenti emette la ragione sociale come Denominazione. È il motivo per cui, su una ditta individuale, conviene tenere la ragione sociale allineata ai due campi anagrafici.

1.2.2 Sede

ID	Elemento XML	Occ.	Origine in Konga
1.2.2.1	Indirizzo	1.1	Aziende → Indirizzo sede legale (Indirizzo)
1.2.2.2	NumeroCivico	0.1	Estratto dalla coda di Indirizzo sede legale, se riconoscibile
1.2.2.3	CAP	1.1	Aziende → CAP sede legale (CAP), troncato a cinque caratteri
1.2.2.4	Comune	1.1	Aziende → Località sede legale (Localita)
1.2.2.5	Provincia	0.1	Aziende → Provincia sede legale (Provincia), solo per nazione IT
1.2.2.6	Nazione	1.1	Aziende → Nazione (val_Nazione), convertita nel codice ISO

1.2.3 StabileOrganizzazione

Il blocco è emesso solo se esiste una riga dell’archivio Sedi aziendali con Tipo sede (val_TipoSede) uguale a «Stabile organizzazione». Con il ribaltamento delle autofatture la fonte è invece l’archivio Indirizzi del cliente, con Tipo di indirizzo (val_TipoIndirizzo) uguale a «Stabile organizzazione».

ID	Elemento XML	Occ.	Origine in Konga
1.2.3.1	Indirizzo	1.1	Sedi aziendali → Indirizzo (Indirizzo)
1.2.3.2	NumeroCivico	0.1	Estratto dalla coda dell’indirizzo
1.2.3.3	CAP	1.1	Sedi aziendali → CAP (CAP)
1.2.3.4	Comune	1.1	Sedi aziendali → Località (Localita)
1.2.3.5	Provincia	0.1	Sedi aziendali → Provincia (Provincia)
1.2.3.6	Nazione	1.1	Costante IT; con il ribaltamento, Indirizzi → Nazione (val_Nazione)

1.2.4 IscrizioneREA

Il blocco è emesso solo se Aziende → Iscrizione camera di commercio è valorizzato, e solo quando non c’è ribaltamento.

ID	Elemento XML	Occ.	Origine in Konga
1.2.4.1	Ufficio	1.1	Aziende → Provincia della camera di commercio (ProvinciaREA)
1.2.4.2	NumeroREA	1.1	Aziende → Iscrizione camera di commercio (REA)
1.2.4.3	CapitaleSociale	0.1	Aziende → Capitale sociale (CapitaleSociale), solo per SpA, SRL, SRLS e SApA
1.2.4.4	SocioUnico	0.1	Aziende → Socio unico (val_SocioUnico): SU o SM; solo per SRL, SRLS e SpA
1.2.4.5	StatoLiquidazione	1.1	Aziende → Stato di liquidazione (val_StatoLiquidazione): LS o LN

La forma societaria che discrimina gli elementi 1.2.4.3 e 1.2.4.4 è Aziende → Tipo società (val_TipoSocieta).

1.2.5 Contatti e 1.2.6 RiferimentoAmministrazione

ID	Elemento XML	Occ.	Origine in Konga
1.2.5.1	Telefono	0.1	Aziende → Telefono (Telefono), troncato a 12 caratteri
1.2.5.2	Fax	0.1	Aziende → Fax (Fax), troncato a 12 caratteri
1.2.5.3	Email	0.1	Codici Fissi → Email trasmittente (EmailTrasmittente); se vuoto, Aziende → Indirizzo email (Email)
1.2.6	RiferimentoAmministrazione	0.1	Documenti Fiscali → Riferimento (Riferimento)

Per retrocompatibilità, se il riferimento è vuoto Konga cerca il marcatore *RA* in Documenti Fiscali → Riferimento aggiuntivo 1 (RifAggiuntivo1) e ne usa i venti caratteri successivi.

1.3 RappresentanteFiscale del cedente

Il blocco è emesso se Aziende → Uso del rappresentante fiscale (val_RappresentanteFiscale) è Sì.

ID	Elemento XML	Occ.	Origine in Konga
1.3.1.1.1	IdPaese	1.1	Aziende → Codice ISO nazione del rappresentante fiscale (val_CodiceISORF)
1.3.1.1.2	IdCodice	1.1	Aziende → Partita IVA rappresentante fiscale (PartitaIVARF)
1.3.1.2	CodiceFiscale	0.1	Aziende → Codice Fiscale rappresentante fiscale (CodiceFiscaleRF)
1.3.1.3.1	Denominazione	0.1	Aziende → Denominazione rappresentante fiscale (DenominazioneRF), se Persona fisica rappresentante fiscale (val_PersonaFisicaRF) è No
1.3.1.3.2	Nome	0.1	Aziende → Nome rappresentante fiscale (NomeRF)
1.3.1.3.3	Cognome	0.1	Aziende → Cognome rappresentante fiscale (CognomeRF)
1.3.1.3.4	Titolo	0.1	Aziende → Titolo rappresentante fiscale (TitoloRF)
1.3.1.3.5	CodEORI	0.1	Aziende → Codice EORI rappresentante fiscale (CodiceEORIRF)

1.4 CessionarioCommittente

ID	Elemento XML	Occ.	Origine in Konga
1.4.1.1.1	IdPaese	1.1	Clienti/Fornitori → Codice ISO nazione (val_CodiceISO); se non impostato, derivato da Nazione (val_Nazione)
1.4.1.1.2	IdCodice	1.1	Clienti/Fornitori → Partita IVA (PartitaIVA), emesso solo se Soggetto privato (val_SoggettoPrivato) è No
1.4.1.2	CodiceFiscale	0.1	Clienti/Fornitori → Codice Fiscale (CodiceFiscale). Se mancano sia partita IVA sia codice fiscale viene segnalato errore
1.4.1.3.1	Denominazione	0.1	Clienti/Fornitori → Ragione sociale (RagioneSociale), se Persona fisica (val_PersonaFisica) è No
1.4.1.3.2	Nome	0.1	Clienti/Fornitori → Nome (Nome), se Persona fisica è Sì
1.4.1.3.3	Cognome	0.1	Clienti/Fornitori → Cognome (Cognome), se Persona fisica è Sì
1.4.2.1	Indirizzo	1.1	Clienti/Fornitori → Indirizzo (Indirizzo)
1.4.2.2	NumeroCivico	0.1	Estratto dalla coda dell’indirizzo
1.4.2.3	CAP	1.1	Clienti/Fornitori → CAP (CAP), forzato a 00000 se la nazione non è IT
1.4.2.4	Comune	1.1	Clienti/Fornitori → Località (Localita)
1.4.2.5	Provincia	0.1	Clienti/Fornitori → Provincia (Provincia), solo per nazione IT
1.4.2.6	Nazione	1.1	Clienti/Fornitori → Nazione (val_Nazione), convertita nel codice ISO
1.4.3.x	StabileOrganizzazione	0.1	Indirizzi → riga con Tipo di indirizzo uguale a «Stabile organizzazione»
1.4.4.1.1	IdPaese	1.1	Clienti/Fornitori → Codice ISO nazione del rappresentante fiscale (val_CodiceISORF)
1.4.4.1.2	IdCodice	1.1	Clienti/Fornitori → Partita IVA rappresentante fiscale (PartitaIVARF)
1.4.4.2	Denominazione	0.1	Clienti/Fornitori → Denominazione rappresentante fiscale (DenominazioneRF)
1.4.4.3	Nome	0.1	Clienti/Fornitori → Nome rappresentante fiscale (NomeRF)
1.4.4.4	Cognome	0.1	Clienti/Fornitori → Cognome rappresentante fiscale (CognomeRF)

Con il ribaltamento delle autofatture tutte le righe qui sopra si leggono sull’archivio Aziende, nei campi omonimi.

1.5 TerzoIntermediarioOSoggettoEmittente e 1.6 SoggettoEmittente

I due blocchi sono emessi insieme, quando nell’archivio Codici Fissi è compilata la denominazione del terzo intermediario (persona giuridica) oppure nome e cognome (persona fisica).

ID	Elemento XML	Occ.	Origine in Konga
1.5.1.1.1	IdPaese	1.1	Codici Fissi → Codice nazione terzo intermediario (IdPaeseTerzoInt)
1.5.1.1.2	IdCodice	1.1	Codici Fissi → Codice identificativo terzo intermediario (CodiceTerzoInt)
1.5.1.2	CodiceFiscale	0.1	Codici Fissi → Codice fiscale terzo intermediario (CodiceFiscaleTerzoInt)
1.5.1.3.1	Denominazione	0.1	Codici Fissi → Denominazione terzo intermediario (DenominazioneTerzoInt)
1.5.1.3.2	Nome	0.1	Codici Fissi → Nome terzo intermediario (NomeTerzoInt)
1.5.1.3.3	Cognome	0.1	Codici Fissi → Cognome terzo intermediario (CognomeTerzoInt)
1.5.1.3.4	Titolo	0.1	Codici Fissi → Titolo terzo intermediario (TitoloTerzoInt)
1.5.1.3.5	CodEORI	0.1	Codici Fissi → Codice EORI terzo intermediario (CodEORITerzoInt)
1.6	SoggettoEmittente	0.1	Costante TZ

2. DatiGenerali

2.1.1 DatiGeneraliDocumento

ID	Elemento XML	Occ.	Origine in Konga
2.1.1.1	TipoDocumento	1.1	Documenti Fiscali → Tipologia del documento elettronico (val_TipoDocumentoDE). Se vale TD01 e il documento proviene da fatturazione differita (val_FatturaDifferita) viene forzato a TD24
2.1.1.2	Divisa	1.1	Documenti Fiscali → Valuta (ref_Valuta) → Valute → Codice (Codice). È la valuta reale del documento, anche quando gli importi sono espressi in valuta di conto
2.1.1.3	Data	1.1	Documenti Fiscali → Data documento (DataDocumento)
2.1.1.4	Numero	1.1	Documenti Fiscali → Numero del documento (NumeroProgressivo) più Suffisso (Suffisso)
2.1.1.5.1	TipoRitenuta	1.1	Documenti Fiscali → Tipo di ritenuta (val_TipoRitenuta e val_TipoRitenuta2)
2.1.1.5.2	ImportoRitenuta	1.1	Documenti Fiscali → Importo ritenuta (ImportoRitenuta e ImportoRitenuta2)
2.1.1.5.3	AliquotaRitenuta	1.1	Documenti Fiscali → Percentuale ritenuta (PercRitenuta e PercRitenuta2)
2.1.1.5.4	CausalePagamento	1.1	Documenti Fiscali → Causale pagamento ritenuta (val_CausalePagamentoRit e val_CausalePagamentoRit2)
2.1.1.6.1	BolloVirtuale	1.1	Costante SI; il blocco è emesso se l’imposta di bollo è maggiore di zero
2.1.1.6.2	ImportoBollo	0.1	Documenti Fiscali → Importo dell’imposta di bollo (ImportoImpostaBollo)
2.1.1.7.1	TipoCassa	1.1	Documenti Fiscali → Tipo di cassa (val_TipoCassa1 e val_TipoCassa2), tradotto nel codice TCxx
2.1.1.7.2	AlCassa	1.1	Documenti Fiscali → Aliquota contributo cassa (AlCassa1 e AlCassa2)
2.1.1.7.3	ImportoContributoCassa	1.1	Calcolato da Konga
2.1.1.7.4	ImponibileCassa	0.1	Documenti Fiscali → Imponibile cassa previdenziale (ImponibileCassa1 e ImponibileCassa2)
2.1.1.7.5	AliquotaIVA	1.1	Aliquote IVA → Percentuale IVA (PercentualeIVA) dell’aliquota della cassa
2.1.1.7.6	Ritenuta	0.1	Costante SI
2.1.1.7.7	Natura	0.1	Aliquote IVA → Natura (val_Natura), solo se l’aliquota è zero
2.1.1.7.8	RiferimentoAmministrazione	0.1	Documenti Fiscali → Riferimento (Riferimento)
2.1.1.8.1	Tipo	1.1	Documenti Fiscali → Sconto globale (ScontoGlobale): SC per sconto, MG per maggiorazione
2.1.1.8.2	Percentuale	0.1	Percentuale risultante dallo sconto globale
2.1.1.8.3	Importo	0.1	Somma degli sconti risultanti dal castelletto IVA
2.1.1.9	ImportoTotaleDocumento	0.1	Documenti Fiscali → Totale documento (TotaleDocumento)
2.1.1.11	Causale	0.N	Documenti Fiscali → Causale del documento (CausaleDocumento), spezzata in più elementi da 200 caratteri
2.1.1.12	Art73	0.1	Documenti Fiscali → Gestione art. 73 (val_Art73), emesso come SI se attivo

L’elemento 2.1.1.10 Arrotondamento non viene usato a livello di testata: l’arrotondamento è gestito nel riepilogo (elemento 2.2.2.4). Anche per la causale esiste la retrocompatibilità con il marcatore *CA* in Documenti Fiscali → Riferimento aggiuntivo 2 (RifAggiuntivo2).

2.1.2 – 2.1.6 Documenti collegati

I blocchi DatiOrdineAcquisto (2.1.2), DatiContratto (2.1.3), DatiConvenzione (2.1.4), DatiRicezione (2.1.5) e DatiFattureCollegate (2.1.6) hanno la stessa struttura e la stessa origine: i dati stanno sulle righe del documento, e Konga raggruppa le righe che condividono lo stesso documento di riferimento.

I campi stanno tutti nell’archivio Righe dei documenti fiscali e hanno nomi tecnici costruiti allo stesso modo: un prefisso fisso più il suffisso del blocco, cioè OrdAcquisto per l’ordine d’acquisto, Contratto, Convenzione, Ricezione e FatturaCol per la fattura collegata.

ID	Elemento XML	Occ.	Origine in Konga (archivio Righe dei documenti fiscali)
2.1.x.1	RiferimentoNumeroLinea	0.N	Numero progressivo della riga (NumeroRiga) delle righe raggruppate
2.1.x.2	IdDocumento	1.1	Numero documento (NumDoc + suffisso: NumDocOrdAcquisto, NumDocContratto, …)
2.1.x.3	Data	0.1	Data (Data + suffisso: DataOrdAcquisto, DataContratto, …)
2.1.x.4	NumItem	0.1	Numero identificativo interno (NumItem + suffisso)
2.1.x.5	CodiceCommessaConvenzione	0.1	Codice commessa/convenzione (CodiceCC + suffisso)
2.1.x.6	CodiceCUP	0.1	Codice CUP (CodiceCUP + suffisso)
2.1.x.7	CodiceCIG	0.1	Codice CIG (CodiceCIG + suffisso)

RiferimentoNumeroLinea viene emesso solo se i documenti di riferimento distinti sono più di uno, oppure se alcune righe hanno il riferimento e altre no: quando tutte le righe puntano allo stesso documento è superfluo e Konga lo omette.

Quando le righe non hanno riferimenti

Blocco	Condizione	Origine alternativa
DatiOrdineAcquisto	Stato degli Archivi → Usa dati degli ordini di acquisto dalla testata (val_AutoDatiOrdAcquisto) è Sì	Risalita all’ordine di origine tramite la riga d’ordine collegata (ref_RigaOrdineCliente): Ordini da clienti → Riferimento ordine, Data protocollo cliente (o Data ordine), Codice commessa/convenzione, Codice CUP, Codice CIG
DatiOrdineAcquisto	Altrimenti	Testata del documento: Riferimento ordine (RiferimentoOrdine), Data protocollo (DataProtocollo), Identificativo (Identificativo) come NumItem, Codice commessa/convenzione, Codice CIG, Codice CUP, oppure Rif. tracciabilità (RifTracciabilita)
DatiContratto	Documenti Fiscali → Contratto (ref_Contratto) valorizzato	Contratti → Descrizione del contratto (tra_Descrizione) come IdDocumento
DatiFattureCollegate	Riferimento aggiuntivo 1 contiene il marcatore *FC*	I venti caratteri successivi al marcatore diventano IdDocumento

CIG e CUP senza campi dedicati. Sui documenti che non li hanno valorizzati, Konga interpreta Documenti Fiscali → Rif. tracciabilità (RifTracciabilita) cercando i marcatori CUP: e CIG:. Se non ne trova nessuno, l’intero contenuto del campo viene preso come CIG.

2.1.7 DatiSAL

ID	Elemento XML	Occ.	Origine in Konga
2.1.7.1	RiferimentoFase	1.1	Documenti Fiscali → Riferimento fase SAL (RiferimentoFaseSAL), spezzato sulle virgole: un blocco per ogni fase

2.1.8 DatiDDT

ID	Elemento XML	Occ.	Origine in Konga
2.1.8.1	NumeroDDT	1.1	Righe dei documenti fiscali → Numero DDT (NumeroDDT)
2.1.8.2	DataDDT	1.1	Righe dei documenti fiscali → Data DDT (DataDDT)
2.1.8.3	RiferimentoNumeroLinea	0.N	Righe dei documenti fiscali → Numero progressivo della riga (NumeroRiga)

Se Stato degli Archivi → Usa dati DDT dalla testata (val_AutoDatiDDT) è Sì, numero e data sono risaliti dal documento di trasporto di origine attraverso la riga collegata (ref_RigaDdT). Anche qui esiste la retrocompatibilità con il marcatore *DT* in Riferimento aggiuntivo 1.

2.1.9 DatiTrasporto

Il blocco è emesso solo per le fatture accompagnatorie, cioè quando Tipologie Documenti Fiscali → Tipo documento (val_TipoDocumento) è «fattura accompagnatoria».

ID	Elemento XML	Occ.	Origine in Konga
2.1.9.1.1.1	IdPaese	1.1	Vettori → Codice ISO nazione (val_CodiceISO), tramite Documenti Fiscali → Vettore (ref_Vettore1)
2.1.9.1.1.2	IdCodice	1.1	Vettori → Partita IVA (PartitaIVA)
2.1.9.1.2	CodiceFiscale	0.1	Vettori → Codice Fiscale (CodiceFiscale)
2.1.9.1.3.1	Denominazione	0.1	Vettori → Descrizione (Descrizione)
2.1.9.1.4	NumeroLicenzaGuida	0.1	Vettori → Numero licenza di guida (NumeroLicenzaGuida)
2.1.9.2	MezzoTrasporto	0.1	Documenti Fiscali → Modalità di trasporto (val_ModalitaTrasporto)
2.1.9.3	CausaleTrasporto	0.1	Documenti Fiscali → Causale di trasporto (CausaleTrasporto)
2.1.9.4	NumeroColli	0.1	Documenti Fiscali → Numero colli (NumeroColli), minimo 1
2.1.9.5	Descrizione	0.1	Documenti Fiscali → Aspetto esteriore dei beni (AspettoBeni)
2.1.9.6	UnitaMisuraPeso	0.1	Costante Kg
2.1.9.7	PesoLordo	0.1	Documenti Fiscali → Peso in kg (Peso)
2.1.9.10	DataInizioTrasporto	0.1	Documenti Fiscali → Data inizio trasporto (DataInizioTrasp)
2.1.9.11	TipoResa	0.1	Condizioni di consegna → Codice Incoterm (val_CodiceIncoterm), tramite Documenti Fiscali → Condizione di consegna (ref_CondizioneConsegna)
2.1.9.12.1	Indirizzo	1.1	Documenti Fiscali → Indirizzo destinazione (Indirizzo_Dest)
2.1.9.12.2	NumeroCivico	0.1	Estratto dalla coda dell’indirizzo di destinazione
2.1.9.12.3	CAP	1.1	Documenti Fiscali → CAP destinazione (CAP_Dest), forzato a 00000 se la nazione non è IT
2.1.9.12.4	Comune	1.1	Documenti Fiscali → Località destinazione (Localita_Dest)
2.1.9.12.5	Provincia	0.1	Documenti Fiscali → Provincia destinazione (Provincia_Dest), solo per nazione IT
2.1.9.12.6	Nazione	1.1	Documenti Fiscali → Nazione destinazione (val_NazioneDest)

2.1.10 FatturaPrincipale

ID	Elemento XML	Occ.	Origine in Konga
2.1.10.1	NumeroFatturaPrincipale	1.1	Documenti Fiscali → Numero fattura principale (NumeroFatturaPrincipale)
2.1.10.2	DataFatturaPrincipale	1.1	Documenti Fiscali → Data fattura principale (DataFatturaPrincipale)

Il blocco è emesso solo se entrambi i campi sono valorizzati.

3. DatiBeniServizi

2.2.1 DettaglioLinee

Konga emette una riga XML per ogni riga del documento che abbia un’aliquota IVA valorizzata.

ID	Elemento XML	Occ.	Origine in Konga
2.2.1.1	NumeroLinea	1.1	Righe dei documenti fiscali → Numero progressivo della riga (NumeroRiga)
2.2.1.2	TipoCessionePrestazione	0.1	Righe dei documenti fiscali → Omaggio (val_Omaggio): AB se la riga è in omaggio (convenzione AssoSoftware)
2.2.1.3.1	CodiceTipo	1.1	Stato degli Archivi → Etichetta codice articolo (EtichettaCodiceArtDE), per impostazione predefinita Cedente
2.2.1.3.2	CodiceValore	1.1	Righe dei documenti fiscali → Articolo (code_Articolo), se Includi codice articolo (val_CodiceArtDE) è Sì
2.2.1.3.1	CodiceTipo (2°)	1.1	Stato degli Archivi → Etichetta codice alternativo (EtichettaCodiceAltArtDE), predefinito Alternativo
2.2.1.3.2	CodiceValore (2°)	1.1	Articoli → Codice alternativo (CodiceAlternativo), se Includi codice alternativo (val_CodiceAltArtDE) è Sì
2.2.1.3.1	CodiceTipo (3°)	1.1	Stato degli Archivi → Etichetta barcode (EtichettaBarcodeArtDE), predefinito Barcode
2.2.1.3.2	CodiceValore (3°)	1.1	Articoli → BarCode (BarCode), se Includi barcode (val_BarcodeArtDE) è Sì
2.2.1.4	Descrizione	1.1	Righe dei documenti fiscali → Descrizione dell’articolo (DescArticolo), troncata a 1000 caratteri. Se vuota viene segnalato errore
2.2.1.5	Quantita	0.1	Righe dei documenti fiscali → Quantità (Quantita), emessa solo se diversa da zero
2.2.1.6	UnitaMisura	0.1	Righe dei documenti fiscali → Unità di misura (code_RigheUnitaMisura)
2.2.1.9	PrezzoUnitario	1.1	Righe dei documenti fiscali → Valore unitario (ValoreUnitario) o Valore unitario in valuta di conto (ValoreUnitarioVC): lordo se c’è uno sconto di riga o globale, netto altrimenti
2.2.1.10.1	Tipo	1.1	Righe dei documenti fiscali → Percentuale di sconto di riga (Sconto): SC o MG
2.2.1.10.2	Percentuale	0.1	Righe dei documenti fiscali → Percentuale di sconto di riga (Sconto)
2.2.1.10.3	Importo	0.1	Calcolato. Un secondo blocco ScontoMaggiorazione viene aggiunto per la quota di sconto globale ripartita sulla riga
2.2.1.11	PrezzoTotale	1.1	Valore unitario netto (ValoreUnitarioNetto) moltiplicato per la quantità
2.2.1.12	AliquotaIVA	1.1	Aliquote IVA → Percentuale IVA (PercentualeIVA), tramite Righe dei documenti fiscali → Aliquota IVA (code_AliquotaIVA)
2.2.1.13	Ritenuta	0.1	Righe dei documenti fiscali → Ritenuta (val_Ritenuta), emesso come SI se attivo
2.2.1.14	Natura	0.1	Aliquote IVA → Natura (val_Natura). Obbligatorio quando l’aliquota è zero: se manca viene segnalato errore
2.2.1.15	RiferimentoAmministrazione	0.1	Righe dei documenti fiscali → Riferimento interno (RiferimentoInterno); se vuoto, Documenti Fiscali → Riferimento (Riferimento)
2.2.1.16.x	AltriDatiGestionali	0.N	Vedi il capitolo dedicato

Le righe che Konga aggiunge da sé

Oltre alle righe del documento, la generazione del file XML può aggiungere in coda alcune righe sintetiche, che nell’archivio delle righe non esistono.

Riga	Quando compare	Descrizione e importo
Eco-contributo	Gestione eco contributo (val_TipoGestEcoContributo) diversa da «nessuna»	Descrizione da DescrEcoContributo1 e DescrEcoContributo2; importo dalle righe del documento, ValUnitEco1VC e ValUnitEco2VC
Storno omaggi	Storno omaggi con rivalsa IVA (val_GestioneOmaggiFE) è Sì	«Storno valori omaggi con rivalsa IVA»; importo calcolato, con l’aliquota di Codici Fissi → ref_AliquotaIVAStornoOmaggi
Spese accessorie	Le spese sono diverse da zero	«Spese Accessorie»; somma di SpeseImballo, SpeseTrasporto, SpeseIncasso e SpeseVarie
Spese bolli	I bolli sono diversi da zero	«Spese Bolli»; importo da SpeseBolli
Storno acconto	È presente un acconto	«Storno Acconto»; importo dell’acconto

Le prime due condizioni si leggono in Stato degli Archivi, le altre sulla testata del documento.

Le righe di eco-contributo, storno omaggi e storno acconto portano un blocco AltriDatiGestionali di tipo AswRifRiga o AswTRiga con il riferimento alla riga di origine, secondo la convenzione AssoSoftware.

4. Le convenzioni su AltriDatiGestionali

Il tracciato non prevede tutto: AltriDatiGestionali (2.2.1.16) è il contenitore in cui Konga veicola le informazioni che non hanno un elemento dedicato. La struttura è sempre la stessa — TipoDato, RiferimentoTesto, RiferimentoNumero, RiferimentoData — e questi sono i tipi usati.

Nella tabella le colonne Testo, Numero e Data sono, rispettivamente, RiferimentoTesto, RiferimentoNumero e RiferimentoData.

TipoDato	Quando	Testo	Numero	Data
INTENTO	Gestione delle dichiarazioni d’intento attiva	Riferimento della dichiarazione	—	Data della dichiarazione
VALUTA UN	Documento non in valuta di conto	Sigla della valuta	Valore unitario netto in valuta	—
VALUTA TOT	Documento non in valuta di conto	Sigla della valuta	Totale della riga in valuta	—
AswLottSca / AswMatric	Includi lotti e matricole (val_AutoLottiDE) è Sì	Lotto o matricola (ref_Lotto)	Quantità, se maggiore di 1	Data scadenza del lotto
CASSA PREV	Contributo Enasarco diverso da zero	TC07 - ENASARCO	Importo Enasarco	—
DP	Indirizzi → Delivery Point (DeliveryPoint) valorizzato	Delivery point	—	—
AswRifRiga / AswTRiga	Righe sintetiche generate da Konga	Riferimento alla riga di origine, nel formato #n#	—	—
libero	Righe inserite a mano	Valore testuale (Testo)	Valore numerico (Numero)	Valore data (Data)

L’ultima riga è la più utile da conoscere: l’archivio Altri dati aggiuntivi per documenti elettronici, collegato alla singola riga del documento, permette di inserire a mano blocchi AltriDatiGestionali arbitrari, con il tipo di dato che serve.

5. Riepilogo, pagamenti e allegati

2.2.2 DatiRiepilogo

Konga emette un blocco per ogni riga del castelletto IVA.

ID	Elemento XML	Occ.	Origine in Konga
2.2.2.1	AliquotaIVA	1.1	Percentuale IVA della riga di castelletto
2.2.2.2	Natura	0.1	Aliquote IVA → Natura (val_Natura), solo se l’aliquota è zero
2.2.2.3	SpeseAccessorie	0.1	Somma di spese ed eco-contributi, sulla sola aliquota in cui sono confluiti
2.2.2.4	Arrotondamento	0.1	Differenza fra l’imponibile del castelletto e la somma dei PrezzoTotale delle righe
2.2.2.5	ImponibileImporto	1.1	Netto imponibile della riga di castelletto, in valuta di conto
2.2.2.6	Imposta	1.1	Importo IVA della riga di castelletto, in valuta di conto
2.2.2.7	EsigibilitaIVA	0.1	Documenti Fiscali → Tipo di esigibilità IVA (val_TipoEsigibilitaIVA): I immediata, D differita, S scissione dei pagamenti
2.2.2.8	RiferimentoNormativo	0.1	Aliquote IVA → Normativa di riferimento (RiferimentoNormativo). Obbligatorio quando l’aliquota è zero: se manca viene segnalato errore

2.4 DatiPagamento

ID	Elemento XML	Occ.	Origine in Konga
2.4.1	CondizioniPagamento	1.1	Condizioni di pagamento → Numero di rate (NumeroRate): TP01 se più di una rata, TP02 altrimenti
2.4.2.1	Beneficiario	0.1	Aziende → Ragione sociale (RagioneSociale)
2.4.2.2	ModalitaPagamento	1.1	Condizioni di pagamento → Tipo di pagamento (val_TipologiaPagamento), tradotto nel codice MPxx. Valore predefinito MP05 (bonifico)
2.4.2.5	DataScadenzaPagamento	0.1	Scadenze → Data scadenza (Data): un blocco DettaglioPagamento per ogni scadenza
2.4.2.6	ImportoPagamento	1.1	Scadenze → Importo scadenza (Importo). Se il documento non ha scadenze viene emesso un blocco unico con il totale documento
2.4.2.12	IstitutoFinanziario	0.1	Banche dell’azienda → Descrizione della banca (Descrizione), tramite Documenti Fiscali → Banca dell’azienda (ref_BancaAzienda)
2.4.2.13	IBAN	0.1	Banche dell’azienda → IBAN (IBAN)
2.4.2.14	ABI	0.1	Banche → ABI (ABI), tramite Banche dell’azienda → Banca (ref_Banca)
2.4.2.15	CAB	0.1	Banche → CAB (CAB)
2.4.2.16	BIC	0.1	Banche → SWIFT (SWIFT)

2.5 Allegati

Gli allegati non sono automatici: al momento della generazione Konga propone i file associati al documento e lascia scegliere quali includere.

ID	Elemento XML	Occ.	Origine in Konga
2.5.1	NomeAttachment	1.1	Nome del file allegato
2.5.2	AlgoritmoCompressione	0.1	ZIP, se la compressione è attiva
2.5.3	FormatoAttachment	0.1	Estensione del file, in maiuscolo
2.5.4	DescrizioneAttachment	0.1	Dati binari → Descrizione del file allegato (Descrizione)
2.5.5	Attachment	1.1	Contenuto del file, codificato in base64

Prima dell’invio

Sul file generato Konga esegue tre passaggi, in quest’ordine: il trigger di post-elaborazione, che permette a uno script utente di intervenire sull’albero XML prima di chiuderlo; la pulizia dei caratteri non ammessi dal tracciato; e infine la validazione contro lo schema, eseguita solo se non sono già stati registrati errori nelle fasi precedenti.

Vale la pena ricordare l’ultimo punto: se durante la generazione Konga ha già segnalato un errore — una partita IVA mancante, una natura IVA non impostata su un’aliquota a zero, una descrizione di riga vuota — la validazione non viene nemmeno tentata. Il registro delle elaborazioni è quindi il primo posto da guardare quando un documento non esce come previsto.