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.
Les entreprises, les personnes et les identifiants de ces exemples sont fictifs. Les identifiants ont des clés de contrôle valides, pour que les règles nationales les acceptent.
Exemple 1
Une fromagerie du Jura facture un bouchon lyonnais
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.
-
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.
Gopdf, err := os.ReadFile("facture.pdf") if err != nil { log.Fatal(err) } -
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.
Gofromagerie := 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
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.
God := 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
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 %.
Goinv.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
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.
Goout, 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
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.
Goback, 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
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 : 0Le programme complet
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 :
git clone https://github.com/ritoon/zerechnung
cd zerechnung/site/examples/fr-1-fromagerie
go run .Exemple 2
Un pâtissier dijonnais facture une commune par Chorus Pro
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.
-
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).
Gopdf, 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
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.
Gocommune := 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
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.
God := 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
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 %.
Goinv.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
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.
Goopts := &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
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é.
Goinv.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
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
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 :
git clone https://github.com/ritoon/zerechnung
cd zerechnung/site/examples/fr-2-patisserie
go run .Exemple 3
Une savonnerie marseillaise émet un avoir
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.
-
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.
Gopdf, 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
Les parties sont les mêmes que sur la facture : SIREN, SIRET, numéro de TVA et adresse électronique de l'annuaire.
Gosavonnerie := 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
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.
God := 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
Seules les pièces abîmées sont créditées, au prix de la facture d'origine. Le savon est à 20 % de TVA.
Goinv.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
Create traite un avoir comme une facture : calcul, validation avec les règles françaises (Auto), puis pièce jointe dans le PDF.
Goout, 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
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.
Goxml, 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
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 : 0Le programme complet
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 :
git clone https://github.com/ritoon/zerechnung
cd zerechnung/site/examples/fr-3-savonnerie
go run .D'autres exemples, pour chaque fonction du package : Exemples complets dans le README · Référence de l'API