ZeRechnung
Langue: Français
Cette traduction n'a pas encore été relue par un locuteur natif. Proposer une correction

Exemples

Exemples, pas à pas

Chaque exemple est un programme Go complet, qui tourne tel quel. Il crée une vraie facture électronique, la vérifie avec les règles du pays, puis la relit. Les tests du dépôt exécutent chaque programme et vérifient qu'il affiche ce que montre cette page.

Exemple 1

Une fromagerie du Jura facture un bouchon lyonnais

Factur-XEN 16931BR-FRTVA 5,5 % et 20 %

La Fromagerie des Monts du Jura, à Poligny, livre chaque semaine le Bouchon des Canuts, à Lyon : meules de Comté, Morbier, Mont d'Or en boîte d'épicéa et quelques bouteilles de vin jaune. Son logiciel de caisse produit déjà la facture en PDF ; ZeRechnung y ajoute le XML et les métadonnées Factur-X, et vérifie les règles françaises de la réforme avant d'écrire quoi que ce soit.

Les fromages sont à 5,5 % de TVA, le vin jaune et la livraison à 20 % : la facture porte deux taux, et ZeRechnung calcule la ventilation.

  1. Lire le PDF de la facture

    Le point de départ est le PDF que votre logiciel produit déjà. Idéalement un PDF/A-3, mais tout PDF convient : ZeRechnung n'en modifie pas les octets, il ajoute la pièce jointe par une mise à jour incrémentale.

    Go
    pdf, err := os.ReadFile("facture.pdf")
    if err != nil {
    	log.Fatal(err)
    }
  2. Décrire le vendeur et l'acheteur

    Depuis la réforme, chaque partie est identifiée par son SIREN (BT-30) et son SIRET, et reçoit ses factures à une adresse électronique de l'annuaire (schéma 0225). Le numéro de TVA est obligatoire pour les deux.

    Go
    fromagerie := invoice.Party{
    	Name:              "Fromagerie des Monts du Jura SARL",
    	IDs:               []invoice.Identifier{{ID: "84215763800011", Scheme: invoice.SchemeSIRET}},
    	LegalRegistration: invoice.Identifier{ID: "842157638", Scheme: invoice.SchemeSIREN},
    	VATID:             "FR62842157638",
    	Address: invoice.Address{
    		Line1: "12 rue du Comté", PostCode: "39800", City: "Poligny", CountryCode: "FR",
    	},
    	ElectronicAddress: invoice.Identifier{ID: "842157638", Scheme: invoice.SchemeFRDirectory},
    }
    bouchon := invoice.Party{
    	Name:              "Le Bouchon des Canuts SAS",
    	IDs:               []invoice.Identifier{{ID: "53917842600018", Scheme: invoice.SchemeSIRET}},
    	LegalRegistration: invoice.Identifier{ID: "539178426", Scheme: invoice.SchemeSIREN},
    	VATID:             "FR53539178426",
    	Address: invoice.Address{
    		Line1: "8 rue Mercière", PostCode: "69002", City: "Lyon", CountryCode: "FR",
    	},
    	ElectronicAddress: invoice.Identifier{ID: "539178426_ACHATS", Scheme: invoice.SchemeFRDirectory},
    }
  3. Ajouter les mentions obligatoires

    Le cadre de facturation B1 dit qu'il s'agit d'une livraison de biens. Les notes PMT, PMD et AAB portent l'indemnité forfaitaire de recouvrement, les pénalités de retard et les conditions d'escompte, que le Code de commerce exige sur toute facture entre professionnels.

    Go
    d := invoice.MustDecimal
    inv := &invoice.Invoice{
    	Profile:                invoice.ProfileEN16931,
    	BusinessProcess:        "B1",
    	Number:                 "FJ-2026-0318",
    	TypeCode:               invoice.TypeCommercialInvoice,
    	IssueDate:              invoice.NewDate(2026, time.November, 20),
    	Currency:               "EUR",
    	BuyerReference:         "CUISINE",
    	PurchaseOrderReference: "BC-1147",
    	Seller:                 fromagerie,
    	Buyer:                  bouchon,
    	DeliveryDate:           invoice.NewDate(2026, time.November, 18),
    	Notes: []invoice.Note{
    		{SubjectCode: "PMT", Content: "Indemnité forfaitaire pour frais de recouvrement : 40 euros."},
    		{SubjectCode: "PMD", Content: "Pénalités de retard : trois fois le taux d'intérêt légal."},
    		{SubjectCode: "AAB", Content: "Pas d'escompte pour paiement anticipé."},
    	},
    	PaymentMeans: []invoice.PaymentMeans{{
    		TypeCode:  invoice.PaymentSEPACreditTransfer,
    		PayeeIBAN: "FR7630006000011234567890189",
    	}},
    	PaymentTerms: []invoice.PaymentTerms{{
    		Description: "Paiement à 30 jours fin de livraison, par virement.",
    		DueDate:     invoice.NewDate(2026, time.December, 18),
    	}},
    }
  4. Lister les produits

    Chaque ligne a sa quantité, son unité (code UN/ECE : KGM pour le kilogramme, H87 pour la pièce, C62 pour une unité), son prix net et son taux de TVA. Les fromages relèvent du taux réduit de 5,5 %.

    Go
    inv.Lines = []invoice.Line{{
    	ID: "1", Item: invoice.Item{Name: "Comté AOP 18 mois, à la coupe"},
    	Quantity: d("12.5"), UnitCode: "KGM", NetPrice: d("24.80"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("5.5"),
    }, {
    	ID: "2", Item: invoice.Item{Name: "Morbier AOP"},
    	Quantity: d("6"), UnitCode: "KGM", NetPrice: d("17.40"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("5.5"),
    }, {
    	ID: "3", Item: invoice.Item{Name: "Mont d'Or AOP, boîte d'épicéa de 500 g"},
    	Quantity: d("10"), UnitCode: "H87", NetPrice: d("11.90"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("5.5"),
    }, {
    	ID: "4", Item: invoice.Item{Name: "Vin jaune du Jura AOC, clavelin 62 cl"},
    	Quantity: d("6"), UnitCode: "H87", NetPrice: d("32.00"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("20"),
    }, {
    	ID: "5", Item: invoice.Item{Name: "Livraison en camion frigorifique"},
    	Quantity: d("1"), UnitCode: "C62", NetPrice: d("35.00"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("20"),
    }}
  5. Créer la facture Factur-X

    Calculate calcule les montants des lignes, les totaux et la ventilation de TVA par taux, en décimales exactes. Avec Auto, la validation ajoute les règles BR-FR, puisque le vendeur est en France. Une facture invalide est refusée : Create renvoie alors les constats, rien n'est écrit.

    Go
    out, err := zerechnung.Create(pdf, inv, &zerechnung.CreateOptions{
    	Calculate: true,
    	Validate:  &validate.Options{Auto: true},
    })
    if err != nil {
    	log.Fatal(err)
    }
    if err := os.WriteFile("FJ-2026-0318.pdf", out, 0o644); err != nil {
    	log.Fatal(err)
    }
  6. Relire et vérifier le résultat

    Le PDF produit se relit comme n'importe quelle facture reçue. Check contrôle le conteneur PDF, les métadonnées XMP et le XML, avec les mêmes règles.

    Go
    back, att, err := zerechnung.Read(out)
    if err != nil {
    	log.Fatal(err)
    }
    fmt.Println(att.Filename, "·", att.Metadata.ConformanceLevel)
    for _, vat := range back.VATBreakdown {
    	fmt.Printf("TVA %s %% sur %s € : %s €\n", vat.Rate, vat.TaxableAmount, vat.TaxAmount)
    }
    fmt.Println("Total HT :", back.Totals.TaxBasisTotal, "€ · TTC :", back.Totals.GrandTotal, "€")
    
    report, _, err := zerechnung.Check(out, &validate.Options{Auto: true})
    if err != nil {
    	log.Fatal(err)
    }
    fmt.Println("Erreurs :", len(report.Errors()))

Ce qu'affiche le programme

go run .
factur-x.xml · EN 16931
TVA 5.5 % sur 533.40 € : 29.34 €
TVA 20 % sur 227.00 € : 45.40 €
Total HT : 760.40 € · TTC : 835.14 €
Erreurs : 0
Le programme complet
main.go
package main

import (
	"fmt"
	"log"
	"os"
	"time"

	"github.com/ritoon/zerechnung"
	"github.com/ritoon/zerechnung/invoice"
	"github.com/ritoon/zerechnung/validate"
)

func main() {
	// Lire le PDF de la facture
	pdf, err := os.ReadFile("facture.pdf")
	if err != nil {
		log.Fatal(err)
	}

	// Décrire le vendeur et l'acheteur
	fromagerie := invoice.Party{
		Name:              "Fromagerie des Monts du Jura SARL",
		IDs:               []invoice.Identifier{{ID: "84215763800011", Scheme: invoice.SchemeSIRET}},
		LegalRegistration: invoice.Identifier{ID: "842157638", Scheme: invoice.SchemeSIREN},
		VATID:             "FR62842157638",
		Address: invoice.Address{
			Line1: "12 rue du Comté", PostCode: "39800", City: "Poligny", CountryCode: "FR",
		},
		ElectronicAddress: invoice.Identifier{ID: "842157638", Scheme: invoice.SchemeFRDirectory},
	}
	bouchon := invoice.Party{
		Name:              "Le Bouchon des Canuts SAS",
		IDs:               []invoice.Identifier{{ID: "53917842600018", Scheme: invoice.SchemeSIRET}},
		LegalRegistration: invoice.Identifier{ID: "539178426", Scheme: invoice.SchemeSIREN},
		VATID:             "FR53539178426",
		Address: invoice.Address{
			Line1: "8 rue Mercière", PostCode: "69002", City: "Lyon", CountryCode: "FR",
		},
		ElectronicAddress: invoice.Identifier{ID: "539178426_ACHATS", Scheme: invoice.SchemeFRDirectory},
	}

	// Ajouter les mentions obligatoires
	d := invoice.MustDecimal
	inv := &invoice.Invoice{
		Profile:                invoice.ProfileEN16931,
		BusinessProcess:        "B1",
		Number:                 "FJ-2026-0318",
		TypeCode:               invoice.TypeCommercialInvoice,
		IssueDate:              invoice.NewDate(2026, time.November, 20),
		Currency:               "EUR",
		BuyerReference:         "CUISINE",
		PurchaseOrderReference: "BC-1147",
		Seller:                 fromagerie,
		Buyer:                  bouchon,
		DeliveryDate:           invoice.NewDate(2026, time.November, 18),
		Notes: []invoice.Note{
			{SubjectCode: "PMT", Content: "Indemnité forfaitaire pour frais de recouvrement : 40 euros."},
			{SubjectCode: "PMD", Content: "Pénalités de retard : trois fois le taux d'intérêt légal."},
			{SubjectCode: "AAB", Content: "Pas d'escompte pour paiement anticipé."},
		},
		PaymentMeans: []invoice.PaymentMeans{{
			TypeCode:  invoice.PaymentSEPACreditTransfer,
			PayeeIBAN: "FR7630006000011234567890189",
		}},
		PaymentTerms: []invoice.PaymentTerms{{
			Description: "Paiement à 30 jours fin de livraison, par virement.",
			DueDate:     invoice.NewDate(2026, time.December, 18),
		}},
	}

	// Lister les produits
	inv.Lines = []invoice.Line{{
		ID: "1", Item: invoice.Item{Name: "Comté AOP 18 mois, à la coupe"},
		Quantity: d("12.5"), UnitCode: "KGM", NetPrice: d("24.80"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("5.5"),
	}, {
		ID: "2", Item: invoice.Item{Name: "Morbier AOP"},
		Quantity: d("6"), UnitCode: "KGM", NetPrice: d("17.40"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("5.5"),
	}, {
		ID: "3", Item: invoice.Item{Name: "Mont d'Or AOP, boîte d'épicéa de 500 g"},
		Quantity: d("10"), UnitCode: "H87", NetPrice: d("11.90"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("5.5"),
	}, {
		ID: "4", Item: invoice.Item{Name: "Vin jaune du Jura AOC, clavelin 62 cl"},
		Quantity: d("6"), UnitCode: "H87", NetPrice: d("32.00"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("20"),
	}, {
		ID: "5", Item: invoice.Item{Name: "Livraison en camion frigorifique"},
		Quantity: d("1"), UnitCode: "C62", NetPrice: d("35.00"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("20"),
	}}

	// Créer la facture Factur-X
	out, err := zerechnung.Create(pdf, inv, &zerechnung.CreateOptions{
		Calculate: true,
		Validate:  &validate.Options{Auto: true},
	})
	if err != nil {
		log.Fatal(err)
	}
	if err := os.WriteFile("FJ-2026-0318.pdf", out, 0o644); err != nil {
		log.Fatal(err)
	}

	// Relire et vérifier le résultat
	back, att, err := zerechnung.Read(out)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(att.Filename, "·", att.Metadata.ConformanceLevel)
	for _, vat := range back.VATBreakdown {
		fmt.Printf("TVA %s %% sur %s € : %s €\n", vat.Rate, vat.TaxableAmount, vat.TaxAmount)
	}
	fmt.Println("Total HT :", back.Totals.TaxBasisTotal, "€ · TTC :", back.Totals.GrandTotal, "€")

	report, _, err := zerechnung.Check(out, &validate.Options{Auto: true})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println("Erreurs :", len(report.Errors()))
}

Pour l'exécuter, depuis un clone du dépôt :

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

Cet exemple sur GitHub

Exemple 2

Un pâtissier dijonnais facture une commune par Chorus Pro

Factur-XChorus ProB2Gcode servicenuméro d'engagement

Pour le vin d'honneur du 11 Novembre, la commune de Vergy-les-Vignes a commandé à la Pâtisserie Lambert, à Dijon, des gougères, des petits fours, du pain d'épices au miel et du crémant de Bourgogne. Depuis 2020, toute facture adressée à une collectivité passe par Chorus Pro : la commune y est identifiée par son SIRET, et elle exige un code service et un numéro d'engagement.

L'exemple montre ce que ZeRechnung vérifie avant le dépôt : une première facture, sans numéro d'engagement, est refusée ; la seconde est créée. Le dépôt lui-même se fait sur le portail Chorus Pro, par son API ou par une plateforme agréée.

  1. Lire le PDF et décrire le pâtissier

    Comme en B2B, le vendeur donne son SIREN, son SIRET, son numéro de TVA et son adresse électronique de l'annuaire (schéma 0225).

    Go
    pdf, err := os.ReadFile("facture.pdf")
    if err != nil {
    	log.Fatal(err)
    }
    patisserie := invoice.Party{
    	Name:              "Pâtisserie Lambert SARL",
    	IDs:               []invoice.Identifier{{ID: "79315284400015", Scheme: invoice.SchemeSIRET}},
    	LegalRegistration: invoice.Identifier{ID: "793152844", Scheme: invoice.SchemeSIREN},
    	VATID:             "FR44793152844",
    	Address: invoice.Address{
    		Line1: "21 rue de la Liberté", PostCode: "21000", City: "Dijon", CountryCode: "FR",
    	},
    	ElectronicAddress: invoice.Identifier{ID: "793152844", Scheme: invoice.SchemeFRDirectory},
    }
  2. Identifier la commune par son SIRET

    Chorus Pro identifie la structure publique par son SIRET (BT-46, schéma 0009), dont ZeRechnung contrôle la clé de Luhn. Une commune n'a pas toujours de numéro de TVA : il n'est pas exigé de l'acheteur.

    Go
    commune := invoice.Party{
    	Name:              "Commune de Vergy-les-Vignes",
    	IDs:               []invoice.Identifier{{ID: "21219990500010", Scheme: invoice.SchemeSIRET}},
    	LegalRegistration: invoice.Identifier{ID: "212199905", Scheme: invoice.SchemeSIREN},
    	Address: invoice.Address{
    		Line1:       "Place de la Mairie",
    		PostCode:    "21220",
    		City:        "Vergy-les-Vignes",
    		CountryCode: "FR",
    	},
    	ElectronicAddress: invoice.Identifier{ID: "212199905", Scheme: invoice.SchemeFRDirectory},
    }
  3. Ajouter le code service et les mentions

    Le code service du destinataire va dans la référence acheteur (BT-10). Les notes PMT, PMD et AAB restent obligatoires ; pour un acheteur public, le retard de paiement donne lieu à des intérêts moratoires.

    Go
    d := invoice.MustDecimal
    inv := &invoice.Invoice{
    	Profile:         invoice.ProfileEN16931,
    	BusinessProcess: "B1",
    	Number:          "PL-2026-1111",
    	TypeCode:        invoice.TypeCommercialInvoice,
    	IssueDate:       invoice.NewDate(2026, time.November, 13),
    	Currency:        "EUR",
    	BuyerReference:  "FETES-CEREMONIES",
    	Seller:          patisserie,
    	Buyer:           commune,
    	DeliveryDate:    invoice.NewDate(2026, time.November, 11),
    	Notes: []invoice.Note{
    		{SubjectCode: "PMT", Content: "Indemnité forfaitaire pour frais de recouvrement : 40 euros."},
    		{SubjectCode: "PMD", Content: "Intérêts moratoires au taux de la BCE majoré de huit points."},
    		{SubjectCode: "AAB", Content: "Pas d'escompte pour paiement anticipé."},
    	},
    	PaymentMeans: []invoice.PaymentMeans{{
    		TypeCode:  invoice.PaymentSEPACreditTransfer,
    		PayeeIBAN: "FR7610107001011234567890129",
    	}},
    	PaymentTerms: []invoice.PaymentTerms{{
    		Description: "Paiement à 30 jours, délai global de paiement de la commande publique.",
    		DueDate:     invoice.NewDate(2026, time.December, 13),
    	}},
    }
  4. Lister la commande

    Les gougères, les petits fours et le pain d'épices sont des denrées alimentaires vendues à emporter : 5,5 %. Le crémant est à 20 %.

    Go
    inv.Lines = []invoice.Line{{
    	ID: "1", Item: invoice.Item{Name: "Gougères bourguignonnes"},
    	Quantity: d("300"), UnitCode: "H87", NetPrice: d("0.45"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("5.5"),
    }, {
    	ID: "2", Item: invoice.Item{Name: "Petits fours sucrés assortis"},
    	Quantity: d("400"), UnitCode: "H87", NetPrice: d("0.70"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("5.5"),
    }, {
    	ID: "3", Item: invoice.Item{Name: "Pain d'épices de Dijon au miel, 1 kg"},
    	Quantity: d("6"), UnitCode: "H87", NetPrice: d("14.50"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("5.5"),
    }, {
    	ID: "4", Item: invoice.Item{Name: "Crémant de Bourgogne brut, 75 cl"},
    	Quantity: d("24"), UnitCode: "H87", NetPrice: d("11.50"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("20"),
    }}
  5. Valider avec les règles de Chorus Pro

    Les règles ChorusPro s'ajoutent aux règles françaises. PublicBuyer reprend le paramétrage de la commune dans l'annuaire de Chorus Pro : elle exige un code service et un numéro d'engagement. Le numéro d'engagement a été oublié : Create refuse la facture et renvoie les constats dans une *ValidationError.

    Go
    opts := &zerechnung.CreateOptions{
    	Calculate: true,
    	Validate: &validate.Options{
    		Rules:       validate.Default | validate.France | validate.ChorusPro,
    		PublicBuyer: validate.PublicBuyer{ServiceCodeRequired: true, EngagementRequired: true},
    	},
    }
    _, err = zerechnung.Create(pdf, inv, opts)
    var invalid *zerechnung.ValidationError
    if !errors.As(err, &invalid) {
    	log.Fatal("la facture aurait dû être refusée")
    }
    for _, f := range invalid.Report.Errors() {
    	fmt.Println("Refusée :", f.Rule)
    }
  6. Ajouter le numéro d'engagement et créer la facture

    Le numéro d'engagement, donné par la commune sur son bon de commande, va dans la référence de commande (BT-13). La facture passe alors toutes les règles, et le PDF est prêt à être déposé.

    Go
    inv.PurchaseOrderReference = "EJ-2026-004187"
    out, err := zerechnung.Create(pdf, inv, opts)
    if err != nil {
    	log.Fatal(err)
    }
    if err := os.WriteFile("PL-2026-1111.pdf", out, 0o644); err != nil {
    	log.Fatal(err)
    }
    back, att, err := zerechnung.Read(out)
    if err != nil {
    	log.Fatal(err)
    }
    fmt.Println(att.Filename, "·", att.Metadata.ConformanceLevel)
    fmt.Println("Service :", back.BuyerReference, "· engagement :", back.PurchaseOrderReference)
    for _, vat := range back.VATBreakdown {
    	fmt.Printf("TVA %s %% sur %s € : %s €\n", vat.Rate, vat.TaxableAmount, vat.TaxAmount)
    }
    fmt.Println("Total TTC :", back.Totals.GrandTotal, "€")

Ce qu'affiche le programme

go run .
Refusée : CPRO-05
factur-x.xml · EN 16931
Service : FETES-CEREMONIES · engagement : EJ-2026-004187
TVA 5.5 % sur 502.00 € : 27.61 €
TVA 20 % sur 276.00 € : 55.20 €
Total TTC : 860.81 €
Le programme complet
main.go
package main

import (
	"errors"
	"fmt"
	"log"
	"os"
	"time"

	"github.com/ritoon/zerechnung"
	"github.com/ritoon/zerechnung/invoice"
	"github.com/ritoon/zerechnung/validate"
)

func main() {
	// Lire le PDF et décrire le pâtissier
	pdf, err := os.ReadFile("facture.pdf")
	if err != nil {
		log.Fatal(err)
	}
	patisserie := invoice.Party{
		Name:              "Pâtisserie Lambert SARL",
		IDs:               []invoice.Identifier{{ID: "79315284400015", Scheme: invoice.SchemeSIRET}},
		LegalRegistration: invoice.Identifier{ID: "793152844", Scheme: invoice.SchemeSIREN},
		VATID:             "FR44793152844",
		Address: invoice.Address{
			Line1: "21 rue de la Liberté", PostCode: "21000", City: "Dijon", CountryCode: "FR",
		},
		ElectronicAddress: invoice.Identifier{ID: "793152844", Scheme: invoice.SchemeFRDirectory},
	}

	// Identifier la commune par son SIRET
	commune := invoice.Party{
		Name:              "Commune de Vergy-les-Vignes",
		IDs:               []invoice.Identifier{{ID: "21219990500010", Scheme: invoice.SchemeSIRET}},
		LegalRegistration: invoice.Identifier{ID: "212199905", Scheme: invoice.SchemeSIREN},
		Address: invoice.Address{
			Line1:       "Place de la Mairie",
			PostCode:    "21220",
			City:        "Vergy-les-Vignes",
			CountryCode: "FR",
		},
		ElectronicAddress: invoice.Identifier{ID: "212199905", Scheme: invoice.SchemeFRDirectory},
	}

	// Ajouter le code service et les mentions
	d := invoice.MustDecimal
	inv := &invoice.Invoice{
		Profile:         invoice.ProfileEN16931,
		BusinessProcess: "B1",
		Number:          "PL-2026-1111",
		TypeCode:        invoice.TypeCommercialInvoice,
		IssueDate:       invoice.NewDate(2026, time.November, 13),
		Currency:        "EUR",
		BuyerReference:  "FETES-CEREMONIES",
		Seller:          patisserie,
		Buyer:           commune,
		DeliveryDate:    invoice.NewDate(2026, time.November, 11),
		Notes: []invoice.Note{
			{SubjectCode: "PMT", Content: "Indemnité forfaitaire pour frais de recouvrement : 40 euros."},
			{SubjectCode: "PMD", Content: "Intérêts moratoires au taux de la BCE majoré de huit points."},
			{SubjectCode: "AAB", Content: "Pas d'escompte pour paiement anticipé."},
		},
		PaymentMeans: []invoice.PaymentMeans{{
			TypeCode:  invoice.PaymentSEPACreditTransfer,
			PayeeIBAN: "FR7610107001011234567890129",
		}},
		PaymentTerms: []invoice.PaymentTerms{{
			Description: "Paiement à 30 jours, délai global de paiement de la commande publique.",
			DueDate:     invoice.NewDate(2026, time.December, 13),
		}},
	}

	// Lister la commande
	inv.Lines = []invoice.Line{{
		ID: "1", Item: invoice.Item{Name: "Gougères bourguignonnes"},
		Quantity: d("300"), UnitCode: "H87", NetPrice: d("0.45"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("5.5"),
	}, {
		ID: "2", Item: invoice.Item{Name: "Petits fours sucrés assortis"},
		Quantity: d("400"), UnitCode: "H87", NetPrice: d("0.70"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("5.5"),
	}, {
		ID: "3", Item: invoice.Item{Name: "Pain d'épices de Dijon au miel, 1 kg"},
		Quantity: d("6"), UnitCode: "H87", NetPrice: d("14.50"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("5.5"),
	}, {
		ID: "4", Item: invoice.Item{Name: "Crémant de Bourgogne brut, 75 cl"},
		Quantity: d("24"), UnitCode: "H87", NetPrice: d("11.50"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("20"),
	}}

	// Valider avec les règles de Chorus Pro
	opts := &zerechnung.CreateOptions{
		Calculate: true,
		Validate: &validate.Options{
			Rules:       validate.Default | validate.France | validate.ChorusPro,
			PublicBuyer: validate.PublicBuyer{ServiceCodeRequired: true, EngagementRequired: true},
		},
	}
	_, err = zerechnung.Create(pdf, inv, opts)
	var invalid *zerechnung.ValidationError
	if !errors.As(err, &invalid) {
		log.Fatal("la facture aurait dû être refusée")
	}
	for _, f := range invalid.Report.Errors() {
		fmt.Println("Refusée :", f.Rule)
	}

	// Ajouter le numéro d'engagement et créer la facture
	inv.PurchaseOrderReference = "EJ-2026-004187"
	out, err := zerechnung.Create(pdf, inv, opts)
	if err != nil {
		log.Fatal(err)
	}
	if err := os.WriteFile("PL-2026-1111.pdf", out, 0o644); err != nil {
		log.Fatal(err)
	}
	back, att, err := zerechnung.Read(out)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(att.Filename, "·", att.Metadata.ConformanceLevel)
	fmt.Println("Service :", back.BuyerReference, "· engagement :", back.PurchaseOrderReference)
	for _, vat := range back.VATBreakdown {
		fmt.Printf("TVA %s %% sur %s € : %s €\n", vat.Rate, vat.TaxableAmount, vat.TaxAmount)
	}
	fmt.Println("Total TTC :", back.Totals.GrandTotal, "€")
}

Pour l'exécuter, depuis un clone du dépôt :

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

Cet exemple sur GitHub

Exemple 3

Une savonnerie marseillaise émet un avoir

Factur-XUBLavoir 381facture d'origineTVA 20 %

La Savonnerie du Vieux-Port, à Marseille, a livré fin octobre à L'Herbier de Montmartre, une boutique parisienne, des cubes de savon de Marseille moulés au chaudron et du savon noir à l'huile d'olive. Un carton est arrivé écrasé : la savonnerie accorde un avoir pour les pièces abîmées.

Un avoir n'annule pas la facture, il s'y ajoute. Il porte le type 381 et cite la facture d'origine avec sa date, ce que les règles françaises exigent. L'exemple l'écrit en Factur-X, puis en UBL pour un client qui préfère cette syntaxe : la réforme admet les deux.

  1. Retrouver la facture d'origine

    L'avoir référence la facture qu'il corrige (BG-3) : son numéro (BT-25) et sa date (BT-26). Sans cette référence datée, la règle BR-FR-CO-05 refuse l'avoir.

    Go
    pdf, err := os.ReadFile("facture.pdf")
    if err != nil {
    	log.Fatal(err)
    }
    origine := invoice.DocumentReference{ID: "SV-2026-0712", IssueDate: invoice.NewDate(2026, time.October, 28)}
  2. Décrire la savonnerie et la boutique

    Les parties sont les mêmes que sur la facture : SIREN, SIRET, numéro de TVA et adresse électronique de l'annuaire.

    Go
    savonnerie := invoice.Party{
    	Name:              "Savonnerie du Vieux-Port SAS",
    	IDs:               []invoice.Identifier{{ID: "38450127600016", Scheme: invoice.SchemeSIRET}},
    	LegalRegistration: invoice.Identifier{ID: "384501276", Scheme: invoice.SchemeSIREN},
    	VATID:             "FR16384501276",
    	Address: invoice.Address{
    		Line1: "14 rue Caisserie", PostCode: "13002", City: "Marseille", CountryCode: "FR",
    	},
    	ElectronicAddress: invoice.Identifier{ID: "384501276", Scheme: invoice.SchemeFRDirectory},
    }
    herbier := invoice.Party{
    	Name:              "L'Herbier de Montmartre SARL",
    	IDs:               []invoice.Identifier{{ID: "50672913600016", Scheme: invoice.SchemeSIRET}},
    	LegalRegistration: invoice.Identifier{ID: "506729136", Scheme: invoice.SchemeSIREN},
    	VATID:             "FR25506729136",
    	Address: invoice.Address{
    		Line1: "37 rue des Abbesses", PostCode: "75018", City: "Paris", CountryCode: "FR",
    	},
    	ElectronicAddress: invoice.Identifier{ID: "506729136", Scheme: invoice.SchemeFRDirectory},
    }
  3. Rédiger l'avoir

    Le type 381 fait de ce document un avoir : les quantités et les prix restent positifs, c'est le type qui dit qu'il s'agit d'un crédit. Le montant sera déduit de la prochaine facture, ce que disent les conditions de paiement.

    Go
    d := invoice.MustDecimal
    inv := &invoice.Invoice{
    	Profile:           invoice.ProfileEN16931,
    	BusinessProcess:   "B1",
    	Number:            "SV-AV-2026-0031",
    	TypeCode:          invoice.TypeCreditNote,
    	IssueDate:         invoice.NewDate(2026, time.November, 19),
    	Currency:          "EUR",
    	BuyerReference:    "BOUTIQUE",
    	PrecedingInvoices: []invoice.DocumentReference{origine},
    	Seller:            savonnerie,
    	Buyer:             herbier,
    	Notes: []invoice.Note{
    		{SubjectCode: "AAI", Content: "Avoir pour marchandises endommagées pendant le transport."},
    		{SubjectCode: "PMT", Content: "Indemnité forfaitaire pour frais de recouvrement : 40 euros."},
    		{SubjectCode: "PMD", Content: "Pénalités de retard : trois fois le taux d'intérêt légal."},
    		{SubjectCode: "AAB", Content: "Pas d'escompte pour paiement anticipé."},
    	},
    	PaymentTerms: []invoice.PaymentTerms{{Description: "Montant déduit de la prochaine facture."}},
    }
  4. Lister les pièces abîmées

    Seules les pièces abîmées sont créditées, au prix de la facture d'origine. Le savon est à 20 % de TVA.

    Go
    inv.Lines = []invoice.Line{{
    	ID: "1", Item: invoice.Item{Name: "Cube de savon de Marseille, 72 % d'huile d'olive, 600 g"},
    	Quantity: d("24"), UnitCode: "H87", NetPrice: d("4.20"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("20"),
    }, {
    	ID: "2", Item: invoice.Item{Name: "Savon noir à l'huile d'olive, pot de 1 kg"},
    	Quantity: d("6"), UnitCode: "H87", NetPrice: d("7.90"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("20"),
    }}
  5. Créer l'avoir Factur-X

    Create traite un avoir comme une facture : calcul, validation avec les règles françaises (Auto), puis pièce jointe dans le PDF.

    Go
    out, err := zerechnung.Create(pdf, inv, &zerechnung.CreateOptions{
    	Calculate: true,
    	Validate:  &validate.Options{Auto: true},
    })
    if err != nil {
    	log.Fatal(err)
    }
    if err := os.WriteFile("SV-AV-2026-0031.pdf", out, 0o644); err != nil {
    	log.Fatal(err)
    }
    back, _, err := zerechnung.Read(out)
    if err != nil {
    	log.Fatal(err)
    }
    ref := back.PrecedingInvoices[0]
    fmt.Println("Avoir", back.TypeCode, "·", back.Number, "sur", ref.ID, "du", ref.IssueDate)
    t := back.Totals
    fmt.Println("Total HT :", t.TaxBasisTotal, "€ · TVA :", t.TaxTotal, "€ · TTC :", t.GrandTotal, "€")
  6. Écrire le même avoir en UBL

    ubl.Marshal écrit un avoir UBL avec l'élément racine CreditNote, comme le veut UBL 2.1. Le XML se valide avec les mêmes règles, ici choisies explicitement : schéma, EN 16931 et règles françaises.

    Go
    xml, err := ubl.Marshal(inv, &ubl.MarshalOptions{Indent: true})
    if err != nil {
    	log.Fatal(err)
    }
    report := validate.XML(xml, &validate.Options{Rules: validate.Default | validate.France})
    if !report.Valid() {
    	for _, f := range report.Errors() {
    		fmt.Println(f)
    	}
    	os.Exit(1)
    }
    if err := os.WriteFile("SV-AV-2026-0031.xml", xml, 0o644); err != nil {
    	log.Fatal(err)
    }
    root := bytes.Contains(xml, []byte("<CreditNote "))
    fmt.Println("UBL CreditNote :", root, "· erreurs :", len(report.Errors()))

Ce qu'affiche le programme

go run .
Avoir 381 · SV-AV-2026-0031 sur SV-2026-0712 du 2026-10-28
Total HT : 148.20 € · TVA : 29.64 € · TTC : 177.84 €
UBL CreditNote : true · erreurs : 0
Le programme complet
main.go
package main

import (
	"bytes"
	"fmt"
	"log"
	"os"
	"time"

	"github.com/ritoon/zerechnung"
	"github.com/ritoon/zerechnung/invoice"
	"github.com/ritoon/zerechnung/ubl"
	"github.com/ritoon/zerechnung/validate"
)

func main() {
	// Retrouver la facture d'origine
	pdf, err := os.ReadFile("facture.pdf")
	if err != nil {
		log.Fatal(err)
	}
	origine := invoice.DocumentReference{ID: "SV-2026-0712", IssueDate: invoice.NewDate(2026, time.October, 28)}

	// Décrire la savonnerie et la boutique
	savonnerie := invoice.Party{
		Name:              "Savonnerie du Vieux-Port SAS",
		IDs:               []invoice.Identifier{{ID: "38450127600016", Scheme: invoice.SchemeSIRET}},
		LegalRegistration: invoice.Identifier{ID: "384501276", Scheme: invoice.SchemeSIREN},
		VATID:             "FR16384501276",
		Address: invoice.Address{
			Line1: "14 rue Caisserie", PostCode: "13002", City: "Marseille", CountryCode: "FR",
		},
		ElectronicAddress: invoice.Identifier{ID: "384501276", Scheme: invoice.SchemeFRDirectory},
	}
	herbier := invoice.Party{
		Name:              "L'Herbier de Montmartre SARL",
		IDs:               []invoice.Identifier{{ID: "50672913600016", Scheme: invoice.SchemeSIRET}},
		LegalRegistration: invoice.Identifier{ID: "506729136", Scheme: invoice.SchemeSIREN},
		VATID:             "FR25506729136",
		Address: invoice.Address{
			Line1: "37 rue des Abbesses", PostCode: "75018", City: "Paris", CountryCode: "FR",
		},
		ElectronicAddress: invoice.Identifier{ID: "506729136", Scheme: invoice.SchemeFRDirectory},
	}

	// Rédiger l'avoir
	d := invoice.MustDecimal
	inv := &invoice.Invoice{
		Profile:           invoice.ProfileEN16931,
		BusinessProcess:   "B1",
		Number:            "SV-AV-2026-0031",
		TypeCode:          invoice.TypeCreditNote,
		IssueDate:         invoice.NewDate(2026, time.November, 19),
		Currency:          "EUR",
		BuyerReference:    "BOUTIQUE",
		PrecedingInvoices: []invoice.DocumentReference{origine},
		Seller:            savonnerie,
		Buyer:             herbier,
		Notes: []invoice.Note{
			{SubjectCode: "AAI", Content: "Avoir pour marchandises endommagées pendant le transport."},
			{SubjectCode: "PMT", Content: "Indemnité forfaitaire pour frais de recouvrement : 40 euros."},
			{SubjectCode: "PMD", Content: "Pénalités de retard : trois fois le taux d'intérêt légal."},
			{SubjectCode: "AAB", Content: "Pas d'escompte pour paiement anticipé."},
		},
		PaymentTerms: []invoice.PaymentTerms{{Description: "Montant déduit de la prochaine facture."}},
	}

	// Lister les pièces abîmées
	inv.Lines = []invoice.Line{{
		ID: "1", Item: invoice.Item{Name: "Cube de savon de Marseille, 72 % d'huile d'olive, 600 g"},
		Quantity: d("24"), UnitCode: "H87", NetPrice: d("4.20"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("20"),
	}, {
		ID: "2", Item: invoice.Item{Name: "Savon noir à l'huile d'olive, pot de 1 kg"},
		Quantity: d("6"), UnitCode: "H87", NetPrice: d("7.90"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("20"),
	}}

	// Créer l'avoir Factur-X
	out, err := zerechnung.Create(pdf, inv, &zerechnung.CreateOptions{
		Calculate: true,
		Validate:  &validate.Options{Auto: true},
	})
	if err != nil {
		log.Fatal(err)
	}
	if err := os.WriteFile("SV-AV-2026-0031.pdf", out, 0o644); err != nil {
		log.Fatal(err)
	}
	back, _, err := zerechnung.Read(out)
	if err != nil {
		log.Fatal(err)
	}
	ref := back.PrecedingInvoices[0]
	fmt.Println("Avoir", back.TypeCode, "·", back.Number, "sur", ref.ID, "du", ref.IssueDate)
	t := back.Totals
	fmt.Println("Total HT :", t.TaxBasisTotal, "€ · TVA :", t.TaxTotal, "€ · TTC :", t.GrandTotal, "€")

	// Écrire le même avoir en UBL
	xml, err := ubl.Marshal(inv, &ubl.MarshalOptions{Indent: true})
	if err != nil {
		log.Fatal(err)
	}
	report := validate.XML(xml, &validate.Options{Rules: validate.Default | validate.France})
	if !report.Valid() {
		for _, f := range report.Errors() {
			fmt.Println(f)
		}
		os.Exit(1)
	}
	if err := os.WriteFile("SV-AV-2026-0031.xml", xml, 0o644); err != nil {
		log.Fatal(err)
	}
	root := bytes.Contains(xml, []byte("<CreditNote "))
	fmt.Println("UBL CreditNote :", root, "· erreurs :", len(report.Errors()))
}

Pour l'exécuter, depuis un clone du dépôt :

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

Cet exemple sur GitHub

D'autres exemples, pour chaque fonction du package : Exemples complets dans le README · Référence de l'API