Esempi
Esempi, passo per passo
Ogni esempio è un programma Go completo, che funziona così com'è. Crea una vera fattura elettronica, la verifica con le regole del paese, poi la rilegge. I test del repository eseguono ogni programma e controllano che stampi ciò che mostra questa pagina.
Le aziende, le persone e gli identificativi di questi esempi sono fittizi. Gli identificativi hanno cifre di controllo valide, perché le regole nazionali li accettino.
Esempio 1
Un caseificio reggiano fattura il Parmigiano a una trattoria milanese
Il Caseificio Sociale Il Crinale, sulle colline di Vezzano sul Crostolo, consegna ogni settimana alla Trattoria dei Navigli, a Milano, Parmigiano Reggiano di diverse stagionature, ricotta e burro di affioramento. Ogni consegna viaggia con il suo documento di trasporto; a fine mese il caseificio emette una sola fattura differita che li riepiloga tutti.
La fattura va al Sistema di Interscambio in formato FatturaPA. ZeRechnung la scrive a partire dal modello EN 16931, ricava il formato FPR12 dal codice destinatario del cliente e la controlla rispetto allo schema XSD dell'Agenzia delle Entrate.
-
Descrivere il cedente e il cessionario
Il caseificio è identificato dalla partita IVA (BT-31) e dal codice fiscale, con lo schema 0210 (BT-30); l'iscrizione al REA segue la convenzione della CIUS-IT, «REA:ufficio#numero». Il numero civico va nella seconda riga dell'indirizzo e la provincia nella suddivisione. La trattoria riceve le fatture con il suo codice destinatario, un indirizzo elettronico con lo schema 0205.
Gocaseificio := invoice.Party{ Name: "Caseificio Sociale Il Crinale Soc. Agr. Coop.", IDs: []invoice.Identifier{{ID: "REA:RE#245871"}}, LegalRegistration: invoice.Identifier{ID: "02846170351", Scheme: invoice.SchemeCodiceFiscale}, VATID: "IT02846170351", Address: invoice.Address{Line1: "Via del Crinale", Line2: "14", PostCode: "42030", City: "Vezzano sul Crostolo", CountrySubdivision: "RE", CountryCode: "IT"}, } trattoria := invoice.Party{ Name: "Trattoria dei Navigli S.r.l.", LegalRegistration: invoice.Identifier{ID: "05172830159", Scheme: invoice.SchemeCodiceFiscale}, VATID: "IT05172830159", Address: invoice.Address{Line1: "Ripa di Porta Ticinese", Line2: "55", PostCode: "20143", City: "Milano", CountrySubdivision: "MI", CountryCode: "IT"}, ElectronicAddress: invoice.Identifier{ID: "KRRH6B9", Scheme: invoice.SchemeCodiceDestinatario}, } -
Indicare la fattura differita e i DDT
La fattura differita, emessa entro il 15 del mese dopo le consegne, ha il tipo documento TD24, che il blocco nazionale Italy aggiunge al codice 380 di EN 16931. Riporta i documenti di trasporto del mese (DatiDDT): il primo è anche il riferimento all'avviso di spedizione, BT-16.
God := invoice.MustDecimal inv := &invoice.Invoice{ Number: "312/2026", TypeCode: invoice.TypeCommercialInvoice, IssueDate: invoice.NewDate(2026, time.November, 30), Currency: "EUR", Seller: caseificio, Buyer: trattoria, Italy: &invoice.Italy{ DocumentType: "TD24", // fattura differita TransportDocuments: []invoice.TransportDocument{ {Number: "412", Date: invoice.NewDate(2026, time.November, 6)}, {Number: "437", Date: invoice.NewDate(2026, time.November, 13)}, {Number: "465", Date: invoice.NewDate(2026, time.November, 20)}, {Number: "489", Date: invoice.NewDate(2026, time.November, 27)}, }, }, PaymentMeans: []invoice.PaymentMeans{{ TypeCode: invoice.PaymentSEPACreditTransfer, PayeeIBAN: "IT60X0542811101000000123456", }}, PaymentTerms: []invoice.PaymentTerms{{ Description: "Bonifico bancario a 30 giorni fine mese.", DueDate: invoice.NewDate(2026, time.December, 31), }}, } -
Elencare i prodotti
Formaggi, latticini e burro hanno l'aliquota IVA del 4%. Il trasporto refrigerato è accessorio alla cessione: segue l'aliquota dei beni che accompagna (art. 12 DPR 633/1972). Le unità sono codici UN/ECE: KGM per il chilogrammo, C62 per l'unità.
Goinv.Lines = []invoice.Line{{ ID: "1", Item: invoice.Item{Name: "Parmigiano Reggiano DOP 24 mesi, quarti di forma"}, Quantity: d("38.40"), UnitCode: "KGM", NetPrice: d("16.90"), VATCategoryCode: invoice.VATStandard, VATRate: d("4"), }, { ID: "2", Item: invoice.Item{Name: "Parmigiano Reggiano DOP 36 mesi, spicchi sottovuoto"}, Quantity: d("12"), UnitCode: "KGM", NetPrice: d("21.50"), VATCategoryCode: invoice.VATStandard, VATRate: d("4"), }, { ID: "3", Item: invoice.Item{Name: "Ricotta vaccina fresca"}, Quantity: d("16"), UnitCode: "KGM", NetPrice: d("6.80"), VATCategoryCode: invoice.VATStandard, VATRate: d("4"), }, { ID: "4", Item: invoice.Item{Name: "Burro di affioramento"}, Quantity: d("8"), UnitCode: "KGM", NetPrice: d("9.40"), VATCategoryCode: invoice.VATStandard, VATRate: d("4"), }, { ID: "5", Item: invoice.Item{Name: "Trasporto refrigerato, quattro consegne"}, Quantity: d("4"), UnitCode: "C62", NetPrice: d("18.00"), VATCategoryCode: invoice.VATStandard, VATRate: d("4"), }} -
Scrivere la FatturaPA
Calculate calcola gli importi delle righe, i totali e il riepilogo IVA con decimali esatti. Marshal scrive il documento nell'ordine dello schema: il codice destinatario della trattoria dà il formato FPR12, e il cedente è anche il trasmittente.
Goinv.Calculate() xml, err := fatturapa.Marshal(inv, &fatturapa.MarshalOptions{Indent: true}) if err != nil { log.Fatal(err) } -
Controllare lo schema
validate.XML riconosce una FatturaPA e la controlla rispetto allo schema XSD 1.2.4, che segnala le date, gli importi e i codici scritti male, e ai controlli dello SdI sul contenuto. Lo SdI scarta una fattura con una data successiva alla sua ricezione (codice 00403): ReceivedAt dice quando la riceve, qui il giorno stesso dell'emissione.
Goreport := validate.XML(xml, &validate.Options{ReceivedAt: inv.IssueDate.Time(nil)}) if !report.Valid() { log.Fatal(report) } -
Rileggere la fattura
fatturapa.Parse riporta il documento nel modello: i dati che EN 16931 prevede tornano nei campi comuni, il resto nel blocco nazionale.
Goback, err := fatturapa.Parse(xml) if err != nil { log.Fatal(err) } it := back.Italy fmt.Println("Fattura", back.Number, "·", it.DocumentType, "·", len(it.TransportDocuments), "DDT") for _, vat := range back.VATBreakdown { fmt.Printf("IVA %s%% su %s €: %s €\n", vat.Rate, vat.TaxableAmount, vat.TaxAmount) } fmt.Println("Totale documento:", back.Totals.GrandTotal, "€") fmt.Println("Errori:", len(report.Errors()))
Che cosa stampa il programma
Fattura 312/2026 · TD24 · 4 DDT
IVA 4.00% su 1162.96 €: 46.52 €
Totale documento: 1209.48 €
Errori: 0Il programma completo
package main
import (
"fmt"
"log"
"time"
"github.com/ritoon/zerechnung/fatturapa"
"github.com/ritoon/zerechnung/invoice"
"github.com/ritoon/zerechnung/validate"
)
func main() {
// Descrivere il cedente e il cessionario
caseificio := invoice.Party{
Name: "Caseificio Sociale Il Crinale Soc. Agr. Coop.",
IDs: []invoice.Identifier{{ID: "REA:RE#245871"}},
LegalRegistration: invoice.Identifier{ID: "02846170351", Scheme: invoice.SchemeCodiceFiscale},
VATID: "IT02846170351",
Address: invoice.Address{Line1: "Via del Crinale", Line2: "14", PostCode: "42030",
City: "Vezzano sul Crostolo", CountrySubdivision: "RE", CountryCode: "IT"},
}
trattoria := invoice.Party{
Name: "Trattoria dei Navigli S.r.l.",
LegalRegistration: invoice.Identifier{ID: "05172830159", Scheme: invoice.SchemeCodiceFiscale},
VATID: "IT05172830159",
Address: invoice.Address{Line1: "Ripa di Porta Ticinese", Line2: "55", PostCode: "20143",
City: "Milano", CountrySubdivision: "MI", CountryCode: "IT"},
ElectronicAddress: invoice.Identifier{ID: "KRRH6B9", Scheme: invoice.SchemeCodiceDestinatario},
}
// Indicare la fattura differita e i DDT
d := invoice.MustDecimal
inv := &invoice.Invoice{
Number: "312/2026",
TypeCode: invoice.TypeCommercialInvoice,
IssueDate: invoice.NewDate(2026, time.November, 30),
Currency: "EUR",
Seller: caseificio,
Buyer: trattoria,
Italy: &invoice.Italy{
DocumentType: "TD24", // fattura differita
TransportDocuments: []invoice.TransportDocument{
{Number: "412", Date: invoice.NewDate(2026, time.November, 6)},
{Number: "437", Date: invoice.NewDate(2026, time.November, 13)},
{Number: "465", Date: invoice.NewDate(2026, time.November, 20)},
{Number: "489", Date: invoice.NewDate(2026, time.November, 27)},
},
},
PaymentMeans: []invoice.PaymentMeans{{
TypeCode: invoice.PaymentSEPACreditTransfer, PayeeIBAN: "IT60X0542811101000000123456",
}},
PaymentTerms: []invoice.PaymentTerms{{
Description: "Bonifico bancario a 30 giorni fine mese.",
DueDate: invoice.NewDate(2026, time.December, 31),
}},
}
// Elencare i prodotti
inv.Lines = []invoice.Line{{
ID: "1", Item: invoice.Item{Name: "Parmigiano Reggiano DOP 24 mesi, quarti di forma"},
Quantity: d("38.40"), UnitCode: "KGM", NetPrice: d("16.90"),
VATCategoryCode: invoice.VATStandard, VATRate: d("4"),
}, {
ID: "2", Item: invoice.Item{Name: "Parmigiano Reggiano DOP 36 mesi, spicchi sottovuoto"},
Quantity: d("12"), UnitCode: "KGM", NetPrice: d("21.50"),
VATCategoryCode: invoice.VATStandard, VATRate: d("4"),
}, {
ID: "3", Item: invoice.Item{Name: "Ricotta vaccina fresca"},
Quantity: d("16"), UnitCode: "KGM", NetPrice: d("6.80"),
VATCategoryCode: invoice.VATStandard, VATRate: d("4"),
}, {
ID: "4", Item: invoice.Item{Name: "Burro di affioramento"},
Quantity: d("8"), UnitCode: "KGM", NetPrice: d("9.40"),
VATCategoryCode: invoice.VATStandard, VATRate: d("4"),
}, {
ID: "5", Item: invoice.Item{Name: "Trasporto refrigerato, quattro consegne"},
Quantity: d("4"), UnitCode: "C62", NetPrice: d("18.00"),
VATCategoryCode: invoice.VATStandard, VATRate: d("4"),
}}
// Scrivere la FatturaPA
inv.Calculate()
xml, err := fatturapa.Marshal(inv, &fatturapa.MarshalOptions{Indent: true})
if err != nil {
log.Fatal(err)
}
// Controllare lo schema
report := validate.XML(xml, &validate.Options{ReceivedAt: inv.IssueDate.Time(nil)})
if !report.Valid() {
log.Fatal(report)
}
// Rileggere la fattura
back, err := fatturapa.Parse(xml)
if err != nil {
log.Fatal(err)
}
it := back.Italy
fmt.Println("Fattura", back.Number, "·", it.DocumentType, "·", len(it.TransportDocuments), "DDT")
for _, vat := range back.VATBreakdown {
fmt.Printf("IVA %s%% su %s €: %s €\n", vat.Rate, vat.TaxableAmount, vat.TaxAmount)
}
fmt.Println("Totale documento:", back.Totals.GrandTotal, "€")
fmt.Println("Errori:", len(report.Errors()))
}Eseguitelo da un clone del repository:
git clone https://github.com/ritoon/zerechnung
cd zerechnung/site/examples/it-1-caseificio
go run .Esempio 2
Una bottega di Deruta fattura a un Comune le targhe in maiolica
Le Fornaci del Tevere, bottega di ceramica artistica di Deruta, hanno dipinto a mano le nuove targhe toponomastiche di Torre dei Colli, un borgo delle colline umbre: nomi delle vie, numeri civici e un pannello con lo stemma comunale, tutti in maiolica, posati sulle facciate del centro storico dai loro artigiani. Il cliente è il Comune, che riceve le fatture dal Sistema di Interscambio dal 2015.
Il Comune applica la scissione dei pagamenti (art. 17-ter DPR 633/1972): paga alla bottega il solo imponibile e versa l'IVA direttamente all'Erario. ZeRechnung scrive la fattura in FatturaPA, ne controlla lo schema, poi applica alla sua versione europea le regole della CIUS-IT.
-
Descrivere la bottega e il Comune
Il Comune, che acquista per la sua attività istituzionale, è identificato dal solo codice fiscale (schema 0210). Il suo indirizzo elettronico è il codice univoco ufficio dell'Indice delle Pubbliche Amministrazioni (IPA, schema 0201): per questo ZeRechnung scrive la fattura nel formato FPA12.
Gobottega := invoice.Party{ Name: "Fornaci del Tevere S.r.l.", LegalRegistration: invoice.Identifier{ID: "03918460548", Scheme: invoice.SchemeCodiceFiscale}, VATID: "IT03918460548", Address: invoice.Address{Line1: "Via Tiberina Nord", Line2: "112", PostCode: "06053", City: "Deruta", CountrySubdivision: "PG", CountryCode: "IT"}, } comune := invoice.Party{ Name: "Comune di Torre dei Colli", LegalRegistration: invoice.Identifier{ID: "80002460543", Scheme: invoice.SchemeCodiceFiscale}, Address: invoice.Address{Line1: "Piazza del Municipio", Line2: "1", PostCode: "06050", City: "Torre dei Colli", CountrySubdivision: "PG", CountryCode: "IT"}, ElectronicAddress: invoice.Identifier{ID: "UF4TQZ", Scheme: invoice.SchemeIPA}, } -
Riportare contratto, CIG e CUP
Per la tracciabilità dei flussi finanziari (legge 136/2010), la fattura alla PA riporta il CIG della procedura (BT-17) e il CUP del progetto (BT-11): in FatturaPA vanno con il contratto (BT-12), mentre la determina che ha affidato il lavoro è il riferimento dell'ordine. Il profilo CIUS-IT darà alla versione europea della fattura il suo identificativo (BT-24). La CIUS-IT chiede le condizioni di pagamento in chiaro (BT-20): con la scissione dei pagamenti, la frase prevista dalla regola BR-IT-DC-510.
God := invoice.MustDecimal inv := &invoice.Invoice{ Profile: invoice.ProfileCIUSIT, Number: "FT-2026/0187", TypeCode: invoice.TypeCommercialInvoice, IssueDate: invoice.NewDate(2026, time.November, 24), Currency: "EUR", Seller: bottega, Buyer: comune, ProjectReference: "D29J26000110004", // CUP ProjectName: "Riqualificazione del centro storico", AdditionalDocuments: []invoice.AdditionalDocument{{ID: "B4F7A21C93", TypeCode: "50"}}, // CIG ContractReference: "REP-1187/2026", PurchaseOrderReference: "DET-214/2026", DeliveryDate: invoice.NewDate(2026, time.November, 19), PaymentMeans: []invoice.PaymentMeans{{ TypeCode: invoice.PaymentSEPACreditTransfer, PayeeIBAN: "IT60X0542811101000000123456", }}, PaymentTerms: []invoice.PaymentTerms{{ Description: "The total is without the VAT amount due to Split payment (ex art.17-ter del DPR 633/1972)", DueDate: invoice.NewDate(2026, time.December, 24), }}, } -
Elencare le maioliche e la posa
Ogni riga ha la categoria IVA B, la scissione dei pagamenti, con l'aliquota ordinaria del 22%. La CIUS-IT non ammette altre categorie nella stessa fattura. H87 è il codice UN/ECE del pezzo, HUR quello dell'ora.
Goinv.Lines = []invoice.Line{{ ID: "1", Item: invoice.Item{Name: "Targa toponomastica in maiolica, 60 x 30 cm"}, Quantity: d("28"), UnitCode: "H87", NetPrice: d("165.00"), VATCategoryCode: invoice.VATSplitPayment, VATRate: d("22"), }, { ID: "2", Item: invoice.Item{Name: "Numero civico in maiolica, 15 x 15 cm"}, Quantity: d("140"), UnitCode: "H87", NetPrice: d("22.00"), VATCategoryCode: invoice.VATSplitPayment, VATRate: d("22"), }, { ID: "3", Item: invoice.Item{Name: "Stemma comunale in maiolica, pannello 80 x 80 cm"}, Quantity: d("1"), UnitCode: "H87", NetPrice: d("1350.00"), VATCategoryCode: invoice.VATSplitPayment, VATRate: d("22"), }, { ID: "4", Item: invoice.Item{Name: "Posa in opera sulle facciate"}, Quantity: d("24"), UnitCode: "HUR", NetPrice: d("35.00"), VATCategoryCode: invoice.VATSplitPayment, VATRate: d("22"), }} -
Calcolare il totale e l'importo del bonifico
Calculate calcola l'IVA come per l'aliquota ordinaria, e il totale documento la comprende, come vuole EN 16931 (BR-CO-15): la scissione cambia chi versa l'imposta, non il totale della fattura. Il Comune paga alla bottega l'imponibile, che è l'importo del bonifico (ImportoPagamento), nel blocco nazionale del pagamento.
Goinv.Calculate() inv.PaymentMeans[0].Italy = &invoice.ItalyPayment{Amount: inv.Totals.TaxBasisTotal} -
Scrivere la FatturaPA
Il formato FPA12 viene dal codice IPA del Comune. La categoria B diventa l'esigibilità IVA S nel riepilogo; la frase delle condizioni di pagamento non serve in FatturaPA, e Marshal la toglie. Con Strict, Marshal si ferma se un dato non trova posto in FatturaPA. Lo schema XSD 1.2.4 e i controlli dello SdI verificano poi il documento prima che parta; ReceivedAt fissa la ricezione al giorno dell'emissione, perché lo SdI scarta una fattura datata dopo (codice 00403).
Gofpa, err := fatturapa.Marshal(inv, &fatturapa.MarshalOptions{Indent: true, Strict: true}) if err != nil { log.Fatal(err) } if r := validate.XML(fpa, &validate.Options{ReceivedAt: inv.IssueDate.Time(nil)}); !r.Valid() { log.Fatal(r) } -
Controllare le regole della CIUS-IT
Le regole della CIUS-IT valgono per le fatture europee destinate alla PA: si applicano alla stessa fattura scritta in UBL. L'importo del bonifico non ha un termine EN 16931 e resta solo nella FatturaPA. Il controllo comprende anche la cifra di controllo della partita IVA e del codice fiscale.
Goxml, err := ubl.Marshal(inv, nil) if err != nil { log.Fatal(err) } report := validate.XML(xml, &validate.Options{Rules: validate.Default | validate.Italy}) if !report.Valid() { log.Fatal(report) } -
Rileggere la FatturaPA
fatturapa.Parse ritrova la categoria B dall'esigibilità S e rimette la frase della scissione nelle condizioni di pagamento.
Goback, err := fatturapa.Parse(fpa) if err != nil { log.Fatal(err) } vat := back.VATBreakdown[0] fmt.Printf("Categoria IVA %s, aliquota %s%%\n", vat.CategoryCode, vat.Rate) t, paid := back.Totals, back.PaymentMeans[0].Italy.Amount fmt.Println("Imponibile:", t.TaxBasisTotal, "€ · totale documento:", t.GrandTotal, "€") fmt.Println("Bonifico alla bottega:", paid, "€ · IVA all'Erario:", t.TaxTotal, "€") fmt.Println("Segnalazioni CIUS-IT:", len(report.Findings))
Che cosa stampa il programma
Categoria IVA B, aliquota 22.00%
Imponibile: 9890.00 € · totale documento: 12065.80 €
Bonifico alla bottega: 9890.00 € · IVA all'Erario: 2175.80 €
Segnalazioni CIUS-IT: 0Il programma completo
package main
import (
"fmt"
"log"
"time"
"github.com/ritoon/zerechnung/fatturapa"
"github.com/ritoon/zerechnung/invoice"
"github.com/ritoon/zerechnung/ubl"
"github.com/ritoon/zerechnung/validate"
)
func main() {
// Descrivere la bottega e il Comune
bottega := invoice.Party{
Name: "Fornaci del Tevere S.r.l.",
LegalRegistration: invoice.Identifier{ID: "03918460548", Scheme: invoice.SchemeCodiceFiscale},
VATID: "IT03918460548",
Address: invoice.Address{Line1: "Via Tiberina Nord", Line2: "112", PostCode: "06053",
City: "Deruta", CountrySubdivision: "PG", CountryCode: "IT"},
}
comune := invoice.Party{
Name: "Comune di Torre dei Colli",
LegalRegistration: invoice.Identifier{ID: "80002460543", Scheme: invoice.SchemeCodiceFiscale},
Address: invoice.Address{Line1: "Piazza del Municipio", Line2: "1", PostCode: "06050",
City: "Torre dei Colli", CountrySubdivision: "PG", CountryCode: "IT"},
ElectronicAddress: invoice.Identifier{ID: "UF4TQZ", Scheme: invoice.SchemeIPA},
}
// Riportare contratto, CIG e CUP
d := invoice.MustDecimal
inv := &invoice.Invoice{
Profile: invoice.ProfileCIUSIT,
Number: "FT-2026/0187",
TypeCode: invoice.TypeCommercialInvoice,
IssueDate: invoice.NewDate(2026, time.November, 24),
Currency: "EUR",
Seller: bottega,
Buyer: comune,
ProjectReference: "D29J26000110004", // CUP
ProjectName: "Riqualificazione del centro storico",
AdditionalDocuments: []invoice.AdditionalDocument{{ID: "B4F7A21C93", TypeCode: "50"}}, // CIG
ContractReference: "REP-1187/2026",
PurchaseOrderReference: "DET-214/2026",
DeliveryDate: invoice.NewDate(2026, time.November, 19),
PaymentMeans: []invoice.PaymentMeans{{
TypeCode: invoice.PaymentSEPACreditTransfer, PayeeIBAN: "IT60X0542811101000000123456",
}},
PaymentTerms: []invoice.PaymentTerms{{
Description: "The total is without the VAT amount due to Split payment (ex art.17-ter del DPR 633/1972)",
DueDate: invoice.NewDate(2026, time.December, 24),
}},
}
// Elencare le maioliche e la posa
inv.Lines = []invoice.Line{{
ID: "1", Item: invoice.Item{Name: "Targa toponomastica in maiolica, 60 x 30 cm"},
Quantity: d("28"), UnitCode: "H87", NetPrice: d("165.00"),
VATCategoryCode: invoice.VATSplitPayment, VATRate: d("22"),
}, {
ID: "2", Item: invoice.Item{Name: "Numero civico in maiolica, 15 x 15 cm"},
Quantity: d("140"), UnitCode: "H87", NetPrice: d("22.00"),
VATCategoryCode: invoice.VATSplitPayment, VATRate: d("22"),
}, {
ID: "3", Item: invoice.Item{Name: "Stemma comunale in maiolica, pannello 80 x 80 cm"},
Quantity: d("1"), UnitCode: "H87", NetPrice: d("1350.00"),
VATCategoryCode: invoice.VATSplitPayment, VATRate: d("22"),
}, {
ID: "4", Item: invoice.Item{Name: "Posa in opera sulle facciate"},
Quantity: d("24"), UnitCode: "HUR", NetPrice: d("35.00"),
VATCategoryCode: invoice.VATSplitPayment, VATRate: d("22"),
}}
// Calcolare il totale e l'importo del bonifico
inv.Calculate()
inv.PaymentMeans[0].Italy = &invoice.ItalyPayment{Amount: inv.Totals.TaxBasisTotal}
// Scrivere la FatturaPA
fpa, err := fatturapa.Marshal(inv, &fatturapa.MarshalOptions{Indent: true, Strict: true})
if err != nil {
log.Fatal(err)
}
if r := validate.XML(fpa, &validate.Options{ReceivedAt: inv.IssueDate.Time(nil)}); !r.Valid() {
log.Fatal(r)
}
// Controllare le regole della CIUS-IT
xml, err := ubl.Marshal(inv, nil)
if err != nil {
log.Fatal(err)
}
report := validate.XML(xml, &validate.Options{Rules: validate.Default | validate.Italy})
if !report.Valid() {
log.Fatal(report)
}
// Rileggere la FatturaPA
back, err := fatturapa.Parse(fpa)
if err != nil {
log.Fatal(err)
}
vat := back.VATBreakdown[0]
fmt.Printf("Categoria IVA %s, aliquota %s%%\n", vat.CategoryCode, vat.Rate)
t, paid := back.Totals, back.PaymentMeans[0].Italy.Amount
fmt.Println("Imponibile:", t.TaxBasisTotal, "€ · totale documento:", t.GrandTotal, "€")
fmt.Println("Bonifico alla bottega:", paid, "€ · IVA all'Erario:", t.TaxTotal, "€")
fmt.Println("Segnalazioni CIUS-IT:", len(report.Findings))
}Eseguitelo da un clone del repository:
git clone https://github.com/ritoon/zerechnung
cd zerechnung/site/examples/it-2-maioliche
go run .Esempio 3
Un pastificio di Gragnano spedisce la pasta a Lione
Il Pastificio Fratelli Amitrano, a Gragnano, trafila al bronzo ed essicca lentamente la sua pasta di Gragnano IGP. Un bancale di spaghetti, paccheri, fusilli lunghi bucati e candele parte per il Comptoir Italien de la Croix-Rousse, una gastronomia italiana di Lione.
La fattura parte due volte. Dal luglio 2022 anche le fatture verso i clienti esteri passano dal Sistema di Interscambio, in FatturaPA; il cliente francese la riceve invece come Factur-X, un PDF che porta con sé i dati strutturati. ZeRechnung scrive i due formati dallo stesso modello e li controlla entrambi.
-
Leggere il PDF della fattura
Il gestionale del pastificio stampa già la fattura in PDF. Idealmente un PDF/A-3, ma va bene qualsiasi PDF: ZeRechnung non ne modifica i byte, aggiunge l'allegato XML con un aggiornamento incrementale.
Gopdf, err := os.ReadFile("fattura.pdf") if err != nil { log.Fatal(err) } -
Descrivere il pastificio e il cliente francese
Il cliente è identificato dalla sua partita IVA francese (BT-48) e dal SIREN, con lo schema 0002. Per una cessione intracomunitaria EN 16931 chiede anche il paese di consegna (BT-80): la Francia, dove arriva la merce.
Gopastificio := invoice.Party{ Name: "Pastificio Fratelli Amitrano S.r.l.", LegalRegistration: invoice.Identifier{ID: "07429510634", Scheme: invoice.SchemeCodiceFiscale}, VATID: "IT07429510634", Address: invoice.Address{Line1: "Via Roma", Line2: "48", PostCode: "80054", City: "Gragnano", CountrySubdivision: "NA", CountryCode: "IT"}, } comptoir := invoice.Party{ Name: "Comptoir Italien de la Croix-Rousse SARL", LegalRegistration: invoice.Identifier{ID: "817456320", Scheme: invoice.SchemeSIREN}, VATID: "FR34817456320", Address: invoice.Address{Line1: "12 boulevard de la Croix-Rousse", PostCode: "69004", City: "Lyon", CountryCode: "FR"}, } -
Indicare la cessione intracomunitaria
Una cessione di beni a un'impresa di un altro Stato membro è non imponibile: categoria IVA K, aliquota 0%, con il motivo e il codice VATEX dell'esenzione (BT-120, BT-121) nel riepilogo. In FatturaPA la categoria K diventa la natura N3.2, e il motivo il riferimento normativo.
God := invoice.MustDecimal inv := &invoice.Invoice{ Profile: invoice.ProfileEN16931, Number: "EX-2026/0093", TypeCode: invoice.TypeCommercialInvoice, IssueDate: invoice.NewDate(2026, time.November, 23), Currency: "EUR", Seller: pastificio, Buyer: comptoir, ShipTo: &invoice.Party{Name: comptoir.Name, Address: comptoir.Address}, DeliveryDate: invoice.NewDate(2026, time.November, 20), VATBreakdown: []invoice.VATBreakdown{{ CategoryCode: invoice.VATIntraCommunity, Rate: d("0"), ExemptionReasonCode: invoice.VATEXIntraCommunity, ExemptionReason: "Cessione intracomunitaria non imponibile, art. 41 D.L. 331/1993", }}, PaymentMeans: []invoice.PaymentMeans{{ TypeCode: invoice.PaymentSEPACreditTransfer, PayeeIBAN: "IT60X0542811101000000123456", }}, PaymentTerms: []invoice.PaymentTerms{{ Description: "Bonifico SEPA a 30 giorni data fattura.", DueDate: invoice.NewDate(2026, time.December, 23), }}, } -
Elencare le paste
La pasta viaggia in cartoni (XCT, il codice UN/ECE del cartone). Ogni riga porta la stessa categoria K: Calculate ne raccoglie gli importi in un solo riepilogo, conservando il motivo dell'esenzione.
Goinv.Lines = []invoice.Line{{ ID: "1", Item: invoice.Item{Name: "Spaghetti di Gragnano IGP, 24 x 500 g"}, Quantity: d("60"), UnitCode: "XCT", NetPrice: d("26.40"), VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"), }, { ID: "2", Item: invoice.Item{Name: "Paccheri di Gragnano IGP, 24 x 500 g"}, Quantity: d("40"), UnitCode: "XCT", NetPrice: d("28.80"), VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"), }, { ID: "3", Item: invoice.Item{Name: "Fusilli lunghi bucati di Gragnano IGP, 12 x 500 g"}, Quantity: d("25"), UnitCode: "XCT", NetPrice: d("16.20"), VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"), }, { ID: "4", Item: invoice.Item{Name: "Candele spezzate di Gragnano IGP, 24 x 500 g"}, Quantity: d("20"), UnitCode: "XCT", NetPrice: d("27.60"), VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"), }} -
Scrivere la FatturaPA per lo SdI
Il cliente non ha codice destinatario: per un cliente estero Marshal scrive XXXXXXX, e lo SdI non recapita la fattura, ma ne acquisisce i dati. Lo schema XSD e i controlli dello SdI verificano il documento; ReceivedAt fissa la ricezione al giorno dell'emissione, perché lo SdI scarta una fattura datata dopo (codice 00403).
Goinv.Calculate() fpa, err := fatturapa.Marshal(inv, &fatturapa.MarshalOptions{Indent: true}) if err != nil { log.Fatal(err) } if r := validate.XML(fpa, &validate.Options{ReceivedAt: inv.IssueDate.Time(nil)}); !r.Valid() { log.Fatal(r) } -
Creare il Factur-X per il cliente
Create scrive la stessa fattura in CII, al profilo EN 16931, la controlla con lo schema, le regole EN 16931 e lo schematron Factur-X (comprese le regole BR-IC delle cessioni intracomunitarie) e la allega al PDF. Una fattura non valida viene rifiutata: Create restituisce le segnalazioni e non scrive nulla.
Goout, err := zerechnung.Create(pdf, inv, &zerechnung.CreateOptions{ Validate: &validate.Options{}, }) if err != nil { log.Fatal(err) } if err := os.WriteFile("EX-2026-0093.pdf", out, 0o644); err != nil { log.Fatal(err) } -
Rileggere e controllare i due documenti
La FatturaPA riletta e il Factur-X riletto danno lo stesso totale. Check controlla anche il contenitore PDF e i metadati XMP.
Gosdi, err := fatturapa.Parse(fpa) if err != nil { log.Fatal(err) } back, att, err := zerechnung.Read(out) if err != nil { log.Fatal(err) } fmt.Println("FatturaPA · codice destinatario", sdi.Italy.RecipientCode) fmt.Println("Factur-X ·", att.Filename, "·", att.Metadata.ConformanceLevel) vat := back.VATBreakdown[0] fmt.Printf("IVA %s %s%% su %s €: %s €\n", vat.CategoryCode, vat.Rate, vat.TaxableAmount, vat.TaxAmount) fmt.Println("Totale FatturaPA:", sdi.Totals.GrandTotal, "€ · Factur-X:", back.Totals.GrandTotal, "€") report, _, err := zerechnung.Check(out, nil) if err != nil { log.Fatal(err) } fmt.Println("Errori:", len(report.Errors()))
Che cosa stampa il programma
FatturaPA · codice destinatario XXXXXXX
Factur-X · factur-x.xml · EN 16931
IVA K 0% su 3693.00 €: 0.00 €
Totale FatturaPA: 3693.00 € · Factur-X: 3693.00 €
Errori: 0Il programma completo
package main
import (
"fmt"
"log"
"os"
"time"
"github.com/ritoon/zerechnung"
"github.com/ritoon/zerechnung/fatturapa"
"github.com/ritoon/zerechnung/invoice"
"github.com/ritoon/zerechnung/validate"
)
func main() {
// Leggere il PDF della fattura
pdf, err := os.ReadFile("fattura.pdf")
if err != nil {
log.Fatal(err)
}
// Descrivere il pastificio e il cliente francese
pastificio := invoice.Party{
Name: "Pastificio Fratelli Amitrano S.r.l.",
LegalRegistration: invoice.Identifier{ID: "07429510634", Scheme: invoice.SchemeCodiceFiscale},
VATID: "IT07429510634",
Address: invoice.Address{Line1: "Via Roma", Line2: "48", PostCode: "80054",
City: "Gragnano", CountrySubdivision: "NA", CountryCode: "IT"},
}
comptoir := invoice.Party{
Name: "Comptoir Italien de la Croix-Rousse SARL",
LegalRegistration: invoice.Identifier{ID: "817456320", Scheme: invoice.SchemeSIREN},
VATID: "FR34817456320",
Address: invoice.Address{Line1: "12 boulevard de la Croix-Rousse", PostCode: "69004",
City: "Lyon", CountryCode: "FR"},
}
// Indicare la cessione intracomunitaria
d := invoice.MustDecimal
inv := &invoice.Invoice{
Profile: invoice.ProfileEN16931,
Number: "EX-2026/0093",
TypeCode: invoice.TypeCommercialInvoice,
IssueDate: invoice.NewDate(2026, time.November, 23),
Currency: "EUR",
Seller: pastificio,
Buyer: comptoir,
ShipTo: &invoice.Party{Name: comptoir.Name, Address: comptoir.Address},
DeliveryDate: invoice.NewDate(2026, time.November, 20),
VATBreakdown: []invoice.VATBreakdown{{
CategoryCode: invoice.VATIntraCommunity,
Rate: d("0"),
ExemptionReasonCode: invoice.VATEXIntraCommunity,
ExemptionReason: "Cessione intracomunitaria non imponibile, art. 41 D.L. 331/1993",
}},
PaymentMeans: []invoice.PaymentMeans{{
TypeCode: invoice.PaymentSEPACreditTransfer, PayeeIBAN: "IT60X0542811101000000123456",
}},
PaymentTerms: []invoice.PaymentTerms{{
Description: "Bonifico SEPA a 30 giorni data fattura.",
DueDate: invoice.NewDate(2026, time.December, 23),
}},
}
// Elencare le paste
inv.Lines = []invoice.Line{{
ID: "1", Item: invoice.Item{Name: "Spaghetti di Gragnano IGP, 24 x 500 g"},
Quantity: d("60"), UnitCode: "XCT", NetPrice: d("26.40"),
VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"),
}, {
ID: "2", Item: invoice.Item{Name: "Paccheri di Gragnano IGP, 24 x 500 g"},
Quantity: d("40"), UnitCode: "XCT", NetPrice: d("28.80"),
VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"),
}, {
ID: "3", Item: invoice.Item{Name: "Fusilli lunghi bucati di Gragnano IGP, 12 x 500 g"},
Quantity: d("25"), UnitCode: "XCT", NetPrice: d("16.20"),
VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"),
}, {
ID: "4", Item: invoice.Item{Name: "Candele spezzate di Gragnano IGP, 24 x 500 g"},
Quantity: d("20"), UnitCode: "XCT", NetPrice: d("27.60"),
VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"),
}}
// Scrivere la FatturaPA per lo SdI
inv.Calculate()
fpa, err := fatturapa.Marshal(inv, &fatturapa.MarshalOptions{Indent: true})
if err != nil {
log.Fatal(err)
}
if r := validate.XML(fpa, &validate.Options{ReceivedAt: inv.IssueDate.Time(nil)}); !r.Valid() {
log.Fatal(r)
}
// Creare il Factur-X per il cliente
out, err := zerechnung.Create(pdf, inv, &zerechnung.CreateOptions{
Validate: &validate.Options{},
})
if err != nil {
log.Fatal(err)
}
if err := os.WriteFile("EX-2026-0093.pdf", out, 0o644); err != nil {
log.Fatal(err)
}
// Rileggere e controllare i due documenti
sdi, err := fatturapa.Parse(fpa)
if err != nil {
log.Fatal(err)
}
back, att, err := zerechnung.Read(out)
if err != nil {
log.Fatal(err)
}
fmt.Println("FatturaPA · codice destinatario", sdi.Italy.RecipientCode)
fmt.Println("Factur-X ·", att.Filename, "·", att.Metadata.ConformanceLevel)
vat := back.VATBreakdown[0]
fmt.Printf("IVA %s %s%% su %s €: %s €\n", vat.CategoryCode, vat.Rate, vat.TaxableAmount, vat.TaxAmount)
fmt.Println("Totale FatturaPA:", sdi.Totals.GrandTotal, "€ · Factur-X:", back.Totals.GrandTotal, "€")
report, _, err := zerechnung.Check(out, nil)
if err != nil {
log.Fatal(err)
}
fmt.Println("Errori:", len(report.Errors()))
}Eseguitelo da un clone del repository:
git clone https://github.com/ritoon/zerechnung
cd zerechnung/site/examples/it-3-pastificio
go run .Altri esempi, per ogni funzione del pacchetto: Esempi completi nel README · Riferimento dell'API