Repository navigation
Releases
Releases · ritoon/zerechnung
v0.1.0
Première version publiée de ZeRechnung, package Go pour les factures électroniques hybrides Factur-X, ZUGFeRD et XRechnung, et pour les factures XML UBL 2.1.
Version 0.x : l'API publique peut encore changer d'une version mineure à l'autre.
go get github.com/ritoon/zerechnung@v0.1.0Ce que contient cette version
- Pur Go, bibliothèque standard uniquement : pas de CGO, de JVM, de binaire externe ni d'appel réseau. Go 1.24 ou plus récent.
- Lecture et écriture CII de tous les profils : MINIMUM, BASIC WL, BASIC, EN 16931, EXTENDED (jeu de données complet, sans perte silencieuse), XRECHNUNG et EXTENDED-CTC-FR, à jour de Factur-X 1.09.2 / ZUGFeRD 2.5.2. Lecture des variantes ZUGFeRD 2.0 et 2.1 et du XML ZUGFeRD 1.0, réécrit en Factur-X.
- UBL 2.1 (Invoice et CreditNote) : lecture et écriture dans le même modèle que le CII, syntaxe détectée d'après l'élément racine.
- Conteneur PDF : extraction, injection par mise à jour incrémentale (octets et signatures de l'hôte conservés), XMP fusionné, PDF/A-3 et PDF/A-4, pièces jointes complémentaires,
/AFRelationshipselon le profil et le pays, contrôle des prérequis PDF/A vérifiables sans rendu. - Validation sans Java : XSD du profil (Factur-X 1.09.2, CII D16B pour XRechnung, UBL 2.1), règles EN 16931 des artefacts CEN 1.3.17, schematrons Factur-X 1.09.2, règles françaises BR-FR (France_RFE 1.4.0.04) et syntaxe EXTENDED-CTC-FR, règles allemandes BR-DE (XRechnung 3.0.2) avec Leitweg-ID et GEBA, Peppol BIS Billing 3.0 en CII et en UBL, contrôles Chorus Pro.
- Parité prouvée en CI avec KoSIT 1.6.3 (128 factures sur 128 aux mêmes erreurs) et Mustang 2.26.0 (241 sur 282, les 41 écarts justifiés un à un).
- Outil en ligne de commande
zerechnung:extract,info,validate,embed,jsonetrules.
Performances
Sur un Apple M4 Pro, ZeRechnung extrait le XML d'un PDF en ~28 µs, lit une facture de 13 Ko en ~15 µs, la valide en ~23 µs et injecte le XML dans un PDF en ~80 µs : de 2,6 à 21 fois plus vite que les autres librairies Go mesurées. Détail sur les pages Benchmarks et Benchmarks : autres langages du wiki.
Limites connues
- Pas de conversion d'un PDF quelconque en PDF/A-3, ni de validation PDF/A complète (espaces de couleur, transparence, contenu des pages) : voir #8.
- Veille réglementaire (EN 16931-1:2026, XRechnung 4.0, CIUS britannique) suivie dans #20.
La couverture critère par critère est sur la page Grille de la norme du wiki.