Repository navigation
Pourquoi ce projet
État des lieux au 16 novembre 2026. Les chiffres viennent de la recherche décrite dans Grille de la norme et des mesures de Benchmarks.
zerechnung est un package Go qui prend un PDF déjà produit par votre application, y ajoute ce que la norme Factur-X exige (XML CII, métadonnées XMP, pièce jointe associée), et qui sait relire et valider n'importe quelle facture Factur-X, ZUGFeRD ou XRechnung, quel que soit son profil.
Le package ne dessine pas de facture : le rendu visuel reste le travail de votre moteur PDF.
La réforme de la facturation électronique entre en vigueur par étapes :
| Date | Obligation |
|---|---|
| 1er septembre 2026 | Toutes les entreprises doivent pouvoir recevoir des factures électroniques. Les grandes entreprises et les ETI doivent les émettre. |
| 1er octobre 2026 | Les règles BR-FR des schematrons FNFE (v1.4.0.04) passent en mode bloquant. |
| 1er septembre 2027 | Les PME, TPE et micro-entreprises doivent émettre. Les données de ligne (BT-153, BT-129, BT-146 à 148) et l'adresse de livraison deviennent obligatoires. |
Trois formats sont admis : UBL, CII et Factur-X. Le socle commun est formé des profils EN 16931 et EXTENDED-CTC-FR. En Factur-X, le profil BASIC WL est admis aujourd'hui ; le profil MINIMUM est exclu. Un PDF simple n'est plus une facture.
La réforme ajoute des mentions qui n'existent pas dans la norme européenne : SIREN du vendeur et de l'acheteur, cadre de facturation (BT-23, 20 codes), notes obligatoires PMT, PMD et AAB, adresses électroniques en schéma 0225, etc. Les schematrons FNFE en tirent 59 règles BR-FR pour la syntaxe CII.
- Réception obligatoire depuis le 1er janvier 2025.
- Émission obligatoire en 2027 au-delà de 800 000 € de chiffre d'affaires, pour toutes les entreprises en 2028.
- Formats acceptés : XRechnung 3.0.2, et ZUGFeRD à partir de 2.0.1 sauf MINIMUM et BASIC WL. Dans une facture hybride, c'est le XML qui fait foi.
Factur-X 1.09.2 et ZUGFeRD 2.5.2 sont la même norme. Un même package peut donc servir les deux pays.
La feuille de route publiée le 28 octobre 2026 rend la facture électronique obligatoire en B2B et B2G au 1er avril 2029, via le réseau Peppol. La syntaxe n'est pas encore désignée et Factur-X n'y a aucun statut. Le secteur public (NHS) utilise aujourd'hui Peppol BIS Billing 3.0, en UBL. Pour le Royaume-Uni, l'objectif est donc d'être prêt à lire et écrire de l'UBL Peppol, pas de pousser Factur-X.
Nous avons examiné une soixantaine de dépôts Go trouvés sur GitHub, pkg.go.dev, GitLab et Codeberg, puis évalué les plus sérieux contre une grille de 73 critères tirée des textes officiels. Le détail, librairie par librairie, est sur la page Grille de la norme.
Ce qui ressort :
- Aucune librairie ne couvre les trois besoins à la fois : un modèle de facture typé, l'injection dans un PDF existant et une validation complète. Les meilleures en modèle et en validation XML (speedata/einvoice, papierleicht) n'injectent rien dans un PDF ; les meilleures en PDF (litho, pdf0) n'ont pas de modèle de facture.
- La réforme française est presque absente. Aucune librairie ne produit ni ne valide un Factur-X EXTENDED-CTC-FR ; seule invopop/gobl.fr.ctc connaît cet identifiant, en CII et UBL purs. La meilleure couverture des règles BR-FR est de 28 identifiants sur 59 (invopop/gobl.fr.ctc), puis 26 (angelodlfrtr/go-invoice-generator). Les librairies spécialisées en validation n'en implémentent aucun.
-
L'extraction échoue souvent sur des PDF réels. Sur les 104 PDF du corpus officiel ZUGFeRD, toutes les librairies qui s'appuient sur pdfcpu en ratent 29 : pdfcpu refuse l'entrée
/AFRelationshipdans un PDF déclaré en version 1.3. gopdfattach rejette en plus les 7 exemples officiels français de la FNFE à cause d'une dateModDatemal formée. - L'injection casse certains PDF. andeedotnet/go-xinvoice-pdf et kanjo réécrivent le PDF d'entrée et perdent les objets rangés dans des flux d'objets compressés, une structure courante dans les PDF modernes : le fichier passe de 144 Ko à 25 Ko et ne se relit plus.
- Les validateurs ne sont pas d'accord entre eux. Sur 26 factures officielles valides, ils en rejettent entre 0 et 26. La référence, papierleicht, qui exécute les artefacts officiels, en rejette 6 (des exemples plus anciens que les règles actuelles). pdf0/formalis rejette exactement les mêmes ; speedata et DCNWS n'ont aucun faux positif mais laissent passer une partie des 6. Les autres appliquent des règles allemandes sans condition, arrondissent mal les montants ou perdent des données au parsing.
- Les performances varient d'un facteur 100. Valider une facture de 13 Ko prend 132 µs avec pdf0/formalis et 15 ms avec papierleicht, pour les mêmes verdicts. Extraire le XML d'un PDF de 1,1 Mo prend 152 µs avec litho et 2,5 ms avec les librairies fondées sur pdfcpu. Injecter le XML prend de 0,35 ms à 36 ms. Voir Benchmarks.
-
Injecter un XML de facture dans un PDF existant :
- nom de fichier selon le profil (
factur-x.xml, ouxrechnung.xmlpour XRECHNUNG) ; -
/AFRelationshipselon le profil et le pays (Data pour MINIMUM et BASIC WL, Alternative en Allemagne) ; - FileSpec complet (
/Subtype /text#2Fxml,/ParamsavecModDate,/Fet/UF), entrée dans/Names /EmbeddedFileset dans/AF; - XMP
fx:avec son schéma d'extension PDF/A, fusionné avec le XMP existant ; - mise à jour incrémentale, pour ne pas casser les signatures existantes.
- nom de fichier selon le profil (
-
Lire et extraire le XML et les métadonnées de tout PDF hybride : Factur-X 1.0 à 1.09.2, ZUGFeRD 1.0, 2.0 et 2.x, XRechnung en PDF, avec ou sans
/AF, avec ou sans flux d'objets compressés. - Modéliser la facture avec des types Go qui couvrent les BT et BG de l'EN 16931 et les extensions EXTENDED et CTC-FR, avec un calcul des totaux et de la ventilation de TVA qui respecte les règles d'arrondi.
-
Valider :
- XSD par profil (Factur-X 1.09.2, CII D22B et D16B) ;
- règles EN 16931 (artefacts CEN 1.3.17) et règles Factur-X par profil ;
- règles françaises BR-FR, toutes (FNFE v1.4.0.04) ;
- règles allemandes BR-DE (XRechnung 3.0.2), avec un résultat identique au validateur KoSIT ;
- contrôles du conteneur : cohérence entre le profil du XML, le XMP et le nom de fichier.
- Convertir en PDF/A-3 un PDF hôte qui ne l'est pas, pour tout ce qui se convertit sans moteur PDF (output intent, XMP, éléments interdits, filtres, ressources, annotations), et refuser le reste avec ses raisons (#62, PR #68).
- Préparer le Royaume-Uni : lecture et écriture UBL 2.1 au format Peppol BIS Billing 3.0.
Ce que la branche main valide aujourd'hui, jeu de règles par jeu de règles, est sur la page Ce que valide ZeRechnung.
- Rapide. Faire mieux que la meilleure librairie actuelle sur chaque opération : par exemple 40 µs au plus pour extraire le XML d'un PDF de 149 Ko (75 µs aujourd'hui), 100 µs au plus pour parser et valider entièrement une facture EN 16931 de 13 Ko, règles françaises comprises (132 µs aujourd'hui sans ces règles), 150 µs au plus pour l'injection (545 µs aujourd'hui). Mesuré le 16 novembre 2026, ZeRechnung atteint tous ces objectifs : 28 µs pour l'extraction, 32,5 µs pour parser et valider avec les règles françaises, 80 µs pour l'injection. Les objectifs et les résultats détaillés sont sur la page Benchmarks.
- Pur Go, sans dépendance lourde : pas de CGO, pas de JVM, pas de binaire externe, pas d'appel réseau. Les schematrons officiels sont en XSLT 2.0 ; nous les compilerons en code Go à la construction plutôt que d'embarquer un moteur XSLT.
- Licence MIT, avec la provenance et la licence de chaque artefact officiel embarqué.
- Testé sur le corpus officiel (ZUGFeRD corpus, exemples FNFE, suites de tests KoSIT et CEN), y compris les cas qui doivent échouer.
- Versionné avec les normes. Les listes de codes changent deux fois par an (15 mai et 15 novembre), Factur-X environ deux fois par an. Chaque version du package indique les versions d'artefacts qu'elle applique.
- Générer le rendu PDF d'une facture.
- La conversion complète d'un PDF quelconque en PDF/A-3. Le package vérifie les exigences de PDF/A-2 et PDF/A-3 lisibles sans rendu et convertit ce qui ne demande pas de moteur PDF ; incorporer une police manquante, convertir des couleurs ou traiter un document signé reste le travail d'un outil spécialisé, et
ConvertPDFArefuse ces fichiers. - La transmission via une plateforme agréée, l'annuaire, les statuts de cycle de vie CDAR et l'e-reporting.
Nous l'avons envisagé. Aucune base ne convient sans réécriture profonde :
- speedata/einvoice a le meilleur modèle XML (BSD-3) mais ne gère pas le PDF, s'appuie sur un DOM et du XPath, et n'a aucune règle française.
- papierleicht/go-e-rechnung-validator est le seul validateur dont la parité avec KoSIT et Mustang est prouvée en intégration continue, mais il exécute les schematrons XSLT via un moteur de 180 000 lignes, sérialise tous les appels derrière un verrou global, et ne gère ni MINIMUM ni BASIC WL.
- gotenberg/litho est le plus complet sur le PDF/A, mais il est sous AGPL avec CLA et n'a pas de modèle de facture.
- mgilbir/pdf0 a le meilleur validateur PDF/A et l'écriture incrémentale, mais pas de modèle de facture et environ 190 000 lignes de dépendances.
-
DCNWS/invoicekit.go est la boîte à outils la plus complète, mais elle exige Go 1.27, calcule les montants en
float64et écrase l'arbre/Namesdu PDF.
Le besoin français (59 règles BR-FR, EXTENDED-CTC-FR) et l'objectif de performance imposent de toute façon un nouveau cœur. Ce projet reprend les bonnes idées de ces librairies et vise à les dépasser sur la conformité et le temps de réponse.
ZeRechnung
Guides
- Creating invoices
- Reading invoices
- Validating invoices
- Coverage and accuracy
- Testing
- License and provenance
By country
- Facturer en France
- E-Rechnungen in Deutschland
- E-facturen in Nederland
- Fatturazione elettronica in Italia
- Facturación electrónica en España
- Guides par pays
En français