ZeRechnung
Langue: Français
Cette traduction n'a pas encore été relue par un locuteur natif. Proposer une correction

Package Go open source · licence MIT

La facture électronique en Go, à partir des PDF que vous produisez déjà

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.

Le gopher de Go, avec des lunettes et un bateau en papier sur la tête, lit un registre de factures à un bureau où trône une machine à écrire, entre des piles de factures.

Ce qu'il fait

Un seul package pour toute la vie d'une facture électronique, à l'émission comme à la réception.

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.

Lire

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.

Valider

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.

Convertir

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.

Pourquoi ZeRechnung

  • Pur Go, bibliothèque standard uniquement

    Pas de CGO, pas de Java, pas de binaire externe, aucun appel réseau. Un go get suffit à l'installer.

  • Comparé aux validateurs de référence

    Chaque pull request compare les résultats avec KoSIT, Mustang et veraPDF, facture par facture. Tout nouvel écart fait échouer la CI.

  • Rapide

    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.

  • Votre PDF reste tel quel

    Le XML est ajouté par une mise à jour incrémentale. Les octets d'origine ne bougent pas : une signature existante reste valide.

Formats et pays

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.

FormatPaysLectureÉcritureValidation
Factur-X 1.0x / ZUGFeRD 2.xCII · profils MINIMUM à EXTENDED, et EXTENDED-CTC-FRFRDEouiouioui
XRechnung 3.0CII · UBLDEouiouioui
Peppol BIS Billing 3.0CII · UBLEUouiouioui
NLCIUSCII · UBLNLouiouioui
CIUS-ITCII · UBLITouiouioui
UBL 2.1Invoice · CreditNote · EN 16931EUouiouioui
FatturaPA 1.2FPA12 · FPR12ITouiouivia CII (CIUS-IT)
Facturae 3.2.x3.2 · 3.2.1 · 3.2.2ESouiouischéma XSD ; EN 16931 via UBL ou CII
ZUGFeRD 1.0CIIDEouien Factur-Xcontrôles minimaux

Quelle fiabilité ?

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.

Méthode et limites, sur le wiki

Démarrer

  1. Installez le package. Il demande Go 1.24 ou plus récent.

    Shell
    go get github.com/ritoon/zerechnung
  2. Transformez votre PDF en facture Factur-X.

    Go
    pdf, err := zerechnung.Create(host, inv, &zerechnung.CreateOptions{
    	Calculate: true,                // totals and VAT breakdown
    	Validate:  &validate.Options{}, // refuse an invalid invoice
    })
  3. Validez une facture reçue, avec les règles nationales du pays du vendeur.

    Go
    report, _, err := zerechnung.Check(pdf, &validate.Options{Auto: true})
    if err != nil {
    	log.Fatal(err)
    }
    for _, f := range report.Errors() {
    	fmt.Println(f)
    }
  4. 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.

    Shell
    go install github.com/ritoon/zerechnung/cmd/zerechnung@latest
    zerechnung validate -auto invoice.pdf

Open source, et ouvert aux contributions

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

Ouvrir une issue

Les traductions sont ouvertes à tous. Une erreur dans votre langue ? Modifier cette traduction