CSV to FatturaPA Mapping Reference

This document describes how the standard Transfer CSV fields are mapped to the Italian FatturaPA XML invoice format.

Mapping

FatturaPA Field	CSV Source	Req.	Default	Condition	Description
fatturaElettronicaHeader.datiTrasmissione.pecDestinatario	recipient_pec	No			Computed: businessRegistry.pec. Converted to lowercase
fatturaElettronicaHeader.datiTrasmissione.codiceDestinatario	recipient_code	No			Converted to uppercase. Transform: strReplace
fatturaElettronicaHeader.datiTrasmissione.formatoTrasmissione		No	FPR12
fatturaElettronicaHeader.soggettoEmittente		No	CC	isSelfInvoice()
fatturaElettronicaHeader.cedentePrestatore.datiAnagrafici.idFiscaleIva.idPaese	recipient_country	No		!isSelfInvoice() || !empty(get(row, "recipient_vat_number")) isSelfInvoice() || !empty(businessRegistry.vatNumber)	Computed: businessRegistry.country. Converted to uppercase
fatturaElettronicaHeader.cedentePrestatore.datiAnagrafici.idFiscaleIva.idCodice	recipient_vat_number	No		!isSelfInvoice() || !empty(get(row, "recipient_vat_number")) isSelfInvoice() || !empty(businessRegistry.vatNumber)	Computed: businessRegistry.vatNumber
fatturaElettronicaHeader.cedentePrestatore.datiAnagrafici.codiceFiscale	recipient_fiscal_code	No			Computed: businessRegistry.fiscalCode
fatturaElettronicaHeader.cedentePrestatore.datiAnagrafici.regimeFiscale		No	RF01
fatturaElettronicaHeader.cedentePrestatore.datiAnagrafici.anagrafica.denominazione	recipient_business_name	No			Computed: businessRegistry.businessName
fatturaElettronicaHeader.cedentePrestatore.datiAnagrafici.anagrafica.nome	recipient_name	No		(isSelfInvoice() && empty(get(row, "recipient_business_name"))) || (!isSelfInvoice() && empty(businessRegistry.businessName))	Computed: businessRegistry.name
fatturaElettronicaHeader.cedentePrestatore.datiAnagrafici.anagrafica.cognome	recipient_last_name	No		(isSelfInvoice() && empty(get(row, "recipient_business_name"))) || (!isSelfInvoice() && empty(businessRegistry.businessName))	Computed: businessRegistry.lastName
fatturaElettronicaHeader.cedentePrestatore.sede.indirizzo	recipient_address	No			Computed: businessRegistry.address
fatturaElettronicaHeader.cedentePrestatore.sede.comune	recipient_city	No			Computed: businessRegistry.city
fatturaElettronicaHeader.cedentePrestatore.sede.cAP	recipient_postal_code	No			Computed: businessRegistry.postalCode
fatturaElettronicaHeader.cedentePrestatore.sede.nazione	recipient_country	No			Computed: businessRegistry.country
fatturaElettronicaHeader.cedentePrestatore.sede.provincia	recipient_province	No			Computed: businessRegistry.province
fatturaElettronicaHeader.cessionarioCommittente.datiAnagrafici.idFiscaleIva.idPaese	recipient_country	No		isSelfInvoice() || !empty(get(row, "recipient_vat_number")) !isSelfInvoice() || !empty(businessRegistry.vatNumber)	Computed: businessRegistry.country
fatturaElettronicaHeader.cessionarioCommittente.datiAnagrafici.idFiscaleIva.idCodice	recipient_vat_number	No		isSelfInvoice() || !empty(get(row, "recipient_vat_number")) !isSelfInvoice() || !empty(businessRegistry.vatNumber)	Computed: businessRegistry.vatNumber
fatturaElettronicaHeader.cessionarioCommittente.datiAnagrafici.codiceFiscale	recipient_fiscal_code	No			Computed: businessRegistry.fiscalCode
fatturaElettronicaHeader.cessionarioCommittente.datiAnagrafici.anagrafica.denominazione	recipient_business_name	No			Computed: businessRegistry.businessName
fatturaElettronicaHeader.cessionarioCommittente.datiAnagrafici.anagrafica.nome	recipient_name	No		(!isSelfInvoice() && empty(get(row, "recipient_business_name"))) || (isSelfInvoice() && empty(businessRegistry.businessName))	Computed: businessRegistry.name
fatturaElettronicaHeader.cessionarioCommittente.datiAnagrafici.anagrafica.cognome	recipient_last_name	No		(!isSelfInvoice() && empty(get(row, "recipient_business_name"))) || (isSelfInvoice() && empty(businessRegistry.businessName))	Computed: businessRegistry.lastName
fatturaElettronicaHeader.cessionarioCommittente.sede.indirizzo	recipient_address	No			Computed: businessRegistry.address
fatturaElettronicaHeader.cessionarioCommittente.sede.cAP	recipient_postal_code	No			Computed: businessRegistry.postalCode
fatturaElettronicaHeader.cessionarioCommittente.sede.nazione	recipient_country	No			Computed: businessRegistry.country
fatturaElettronicaHeader.cessionarioCommittente.sede.comune	recipient_city	No			Computed: businessRegistry.city
fatturaElettronicaHeader.cessionarioCommittente.sede.provincia	recipient_province	No			Computed: businessRegistry.province
fatturaElettronicaBody[0].datiGenerali.datiGeneraliDocumento.tipoDocumento	document_type	No
fatturaElettronicaBody[0].datiGenerali.datiGeneraliDocumento.data	invoice_date	No			Formatted as date (d/m/Y)
fatturaElettronicaBody[0].datiGenerali.datiGeneraliDocumento.numero	invoice_number	No	getNumero({invoice_series})		Transform: substitute
fatturaElettronicaBody[0].datiGenerali.datiGeneraliDocumento.causale	invoice_subject	No		!empty(get(row, "invoice_subject"))	Transform: cast
fatturaElettronicaBody[0].datiGenerali.datiGeneraliDocumento.divisa		No	EUR
fatturaElettronicaBody[0].datiBeniServizi.dettaglioLinee		No			Grouped by line_number
fatturaElettronicaBody[0].datiBeniServizi.datiRiepilogo		No	``		Computed: getValue(output, "fatturaElettronicaBody[0].datiBeniServizi.dettaglioLinee"). Transform: calculateInvoiceItDatiRiepilogo
fatturaElettronicaBody[0].datiGenerali.datiGeneraliDocumento.importoTotaleDocumento		No	0.00		Computed: getValue(output, "fatturaElettronicaBody[0].datiBeniServizi.datiRiepilogo"). Transform: calculateInvoiceItTotalAmount
fatturaElettronicaBody[0].datiPagamento[0].condizioniPagamento		No	TP02
fatturaElettronicaBody[0].datiPagamento[0].dettaglioPagamento[0].modalitaPagamento	payment	No
fatturaElettronicaBody[0].datiPagamento[0].dettaglioPagamento[0].importoPagamento		No	0.00		Computed: getValue(output, "fatturaElettronicaBody[0].datiBeniServizi.datiRiepilogo"). Transform: calculateInvoiceItTotalAmount
fatturaElettronicaBody[0].datiPagamento[0].dettaglioPagamento[0].iban	payment_iban	No
fatturaElettronicaBody[0].datiPagamento[0].dettaglioPagamento[0].data_scadenza_pagamento	payment_due_date	No			Formatted as date (d/m/Y)

fatturaElettronicaBody[0].datiBeniServizi.dettaglioLinee

FatturaPA Field	CSV Source	Req.	Default	Condition	Description
numeroLinea	line_number	No
descrizione	line_description	No
aliquotaIVA	line_vat_rate	No			Transform: formatString
natura	line_vat_nature	No		get(row, 'line_vat_rate') == 0
quantita	line_quantity	No			Transform: formatString
prezzoUnitario	line_unit_price	No			Transform: numberFormat
prezzoTotale		No	0		Computed: get(row, 'line_quantity') * get(row, 'line_unit_price'). Transform: numberFormat