Créer
Transformez le PDF que produit votre application en facture Factur-X ou ZUGFeRD. Les totaux et la ventilation de la TVA sont calculés en décimales exactes, et une facture invalide est refusée avant que rien ne soit écrit.
Package Go open source · licence MIT
Continuez à générer vos factures PDF comme aujourd'hui. ZeRechnung ajoute la facture XML et les métadonnées qu'exige la norme, et le PDF devient une facture électronique Factur-X ou ZUGFeRD conforme. Il lit et valide aussi les factures que vous recevez.
go get github.com/ritoon/zerechnung
Version 0 : l'API peut encore changer avant la v1.
Un seul package pour toute la vie d'une facture électronique, à l'émission comme à la réception.
Transformez le PDF que produit votre application en facture Factur-X ou ZUGFeRD. Les totaux et la ventilation de la TVA sont calculés en décimales exactes, et une facture invalide est refusée avant que rien ne soit écrit.
Lisez les PDF hybrides et le XML seul, en CII ou en UBL, de toutes les versions de ZUGFeRD depuis la 1.0. Les données que le modèle ne prévoit pas sont conservées, puis réécrites à leur place.
Vérifiez les schémas, les règles EN 16931, celles des profils et les règles nationales de la France, de l'Allemagne, des Pays-Bas et de l'Italie, ainsi que Peppol. Chaque erreur donne l'identifiant officiel de la règle et le XPath de l'élément.
Passez du CII à l'UBL, à FatturaPA ou à Facturae, et réécrivez un PDF en PDF/A-3 quand cela ne demande pas de moteur PDF. Sinon, vous obtenez les raisons, page par page.
Pas de CGO, pas de Java, pas de binaire externe, aucun appel réseau. Un go get suffit à l'installer.
Chaque pull request compare les résultats avec KoSIT, Mustang et veraPDF, facture par facture. Tout nouvel écart fait échouer la CI.
Lire et valider entièrement une facture courante prend environ 25 µs, cinq fois moins qu'avec le package Go le plus rapide après lui.
Le XML est ajouté par une mise à jour incrémentale. Les octets d'origine ne bougent pas : une signature existante reste valide.
Des programmes complets, pas à pas, avec des factures du pays de chaque langue.
Les temps d'exécution, mesurés face aux autres librairies Go et face à TypeScript, Python et Rust.
Les règles de facturation électronique de chaque pays européen, et les points de contrôle que ZeRechnung couvre.
Un seul modèle de facture, invoice.Invoice, pour toutes les syntaxes : passer de l'une à l'autre tient en une lecture et une écriture.
| Format | Pays | Lecture | Écriture | Validation |
|---|---|---|---|---|
| Factur-X 1.0x / ZUGFeRD 2.xCII · profils MINIMUM à EXTENDED, et EXTENDED-CTC-FR | FRDE | oui | oui | oui |
| XRechnung 3.0CII · UBL | DE | oui | oui | oui |
| Peppol BIS Billing 3.0CII · UBL | EU | oui | oui | oui |
| NLCIUSCII · UBL | NL | oui | oui | oui |
| CIUS-ITCII · UBL | IT | oui | oui | oui |
| UBL 2.1Invoice · CreditNote · EN 16931 | EU | oui | oui | oui |
| FatturaPA 1.2FPA12 · FPR12 | IT | oui | oui | via CII (CIUS-IT) |
| Facturae 3.2.x3.2 · 3.2.1 · 3.2.2 | ES | oui | oui | schéma XSD ; EN 16931 via UBL ou CII |
| ZUGFeRD 1.0CII | DE | oui | en Factur-X | contrôles minimaux |
Chaque pull request fait tourner les validateurs de référence sur les corpus de test officiels et compare leurs résultats à ceux de ZeRechnung, facture par facture.
128 / 128
KoSIT
factures XRechnung avec exactement les mêmes erreurs que le validateur KoSIT.
241 / 282
Mustang
factures avec les mêmes erreurs que Mustang. Chaque écart vient des références elles-mêmes et est expliqué.
283 / 290
NPa
fichiers NLCIUS avec les mêmes règles que les validateurs néerlandais de la NPa. Les autres écarts sont justifiés.
609 / 614
veraPDF
fichiers PDF/A invalides du corpus veraPDF détectés par une règle de la bonne clause.
Installez le package. Il demande Go 1.24 ou plus récent.
go get github.com/ritoon/zerechnungTransformez votre PDF en facture Factur-X.
pdf, err := zerechnung.Create(host, inv, &zerechnung.CreateOptions{
Calculate: true, // totals and VAT breakdown
Validate: &validate.Options{}, // refuse an invalid invoice
})Validez une facture reçue, avec les règles nationales du pays du vendeur.
report, _, err := zerechnung.Check(pdf, &validate.Options{Auto: true})
if err != nil {
log.Fatal(err)
}
for _, f := range report.Errors() {
fmt.Println(f)
}Ou passez par la ligne de commande. validate sort avec le code 1 en cas d'erreur : il s'insère tel quel dans une CI.
go install github.com/ritoon/zerechnung/cmd/zerechnung@latest
zerechnung validate -auto invoice.pdfZeRechnung est un logiciel libre sous licence MIT. Signalements de bogues, écarts avec un validateur de référence, règles manquantes : les contributions sont les bienvenues.
Les traductions sont ouvertes à tous. Une erreur dans votre langue ? Modifier cette traduction