Skip to content

v0.1.0

Latest

Choose a tag to compare

@ritoon ritoon released this 17 Nov 16:28
· 30 commits to main since this release
a580779

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.0

Ce 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, /AFRelationship selon 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, json et rules.

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.