ZeRechnung
Lingua: Italiano
Questa traduzione non è ancora stata rivista da un madrelingua. Proponi una correzione

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.

Esempio 1

Un caseificio reggiano fattura il Parmigiano a una trattoria milanese

FatturaPAFPR12fattura differitaIVA 4%

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.

  1. 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.

    Go
    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},
    }
  2. 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.

    Go
    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),
    	}},
    }
  3. 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à.

    Go
    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"),
    }}
  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.

    Go
    inv.Calculate()
    xml, err := fatturapa.Marshal(inv, &fatturapa.MarshalOptions{Indent: true})
    if err != nil {
    	log.Fatal(err)
    }
  5. 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.

    Go
    report := validate.XML(xml, &validate.Options{ReceivedAt: inv.IssueDate.Time(nil)})
    if !report.Valid() {
    	log.Fatal(report)
    }
  6. 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.

    Go
    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()))

Che cosa stampa il programma

go run .
Fattura 312/2026 · TD24 · 4 DDT
IVA 4.00% su 1162.96 €: 46.52 €
Totale documento: 1209.48 €
Errori: 0
Il programma completo
main.go
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:

Shell
git clone https://github.com/ritoon/zerechnung
cd zerechnung/site/examples/it-1-caseificio
go run .

Questo esempio su GitHub

Esempio 2

Una bottega di Deruta fattura a un Comune le targhe in maiolica

FatturaPAFPA12CIUS-ITscissione dei pagamentiIVA 22%

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.

  1. 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.

    Go
    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},
    }
  2. 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.

    Go
    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),
    	}},
    }
  3. 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.

    Go
    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"),
    }}
  4. 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.

    Go
    inv.Calculate()
    inv.PaymentMeans[0].Italy = &invoice.ItalyPayment{Amount: inv.Totals.TaxBasisTotal}
  5. 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).

    Go
    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)
    }
  6. 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.

    Go
    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)
    }
  7. Rileggere la FatturaPA

    fatturapa.Parse ritrova la categoria B dall'esigibilità S e rimette la frase della scissione nelle condizioni di pagamento.

    Go
    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))

Che cosa stampa il programma

go run .
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: 0
Il programma completo
main.go
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:

Shell
git clone https://github.com/ritoon/zerechnung
cd zerechnung/site/examples/it-2-maioliche
go run .

Questo esempio su GitHub

Esempio 3

Un pastificio di Gragnano spedisce la pasta a Lione

FatturaPAFactur-XEN 16931cessione intracomunitariaIVA 0%

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.

  1. 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.

    Go
    pdf, err := os.ReadFile("fattura.pdf")
    if err != nil {
    	log.Fatal(err)
    }
  2. 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.

    Go
    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"},
    }
  3. 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.

    Go
    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),
    	}},
    }
  4. 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.

    Go
    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"),
    }}
  5. 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).

    Go
    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)
    }
  6. 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.

    Go
    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)
    }
  7. 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.

    Go
    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()))

Che cosa stampa il programma

go run .
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: 0
Il programma completo
main.go
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:

Shell
git clone https://github.com/ritoon/zerechnung
cd zerechnung/site/examples/it-3-pastificio
go run .

Questo esempio su GitHub

Altri esempi, per ogni funzione del pacchetto: Esempi completi nel README · Riferimento dell'API