ZeRechnung
Sprache: Deutsch
Diese Übersetzung wurde noch nicht von Muttersprachlern geprüft. Korrektur vorschlagen

Open-Source-Paket für Go · MIT-Lizenz

E-Rechnungen in Go, aus den PDFs, die Sie ohnehin erzeugen

Erzeugen Sie Ihre Rechnungs-PDFs weiter wie bisher. ZeRechnung fügt die XML-Rechnung und die Metadaten hinzu, die der Standard verlangt, und aus dem PDF wird eine konforme E-Rechnung nach Factur-X oder ZUGFeRD. Außerdem liest und validiert es die Rechnungen, die Sie erhalten.

go get github.com/ritoon/zerechnung

Version 0: Die API kann sich bis zur v1 noch ändern.

Der Go-Gopher mit Brille und Papierschiffchen auf dem Kopf liest an einem Schreibtisch mit Schreibmaschine in einem Rechnungsbuch, zwischen Stapeln von Rechnungen.

Was es kann

Ein Paket für den ganzen Lebenslauf einer E-Rechnung, beim Versand wie beim Empfang.

Erstellen

Machen Sie aus dem PDF, das Ihre Anwendung erzeugt, eine Rechnung nach Factur-X oder ZUGFeRD. Summen und Steueraufschlüsselung werden mit exakten Dezimalzahlen berechnet, und eine ungültige Rechnung wird abgelehnt, bevor etwas geschrieben wird.

Lesen

Lesen Sie hybride PDFs und reines XML, in CII oder UBL, aus allen ZUGFeRD-Versionen seit 1.0. Daten, für die das Modell kein Feld hat, bleiben erhalten und werden an ihrer Stelle zurückgeschrieben.

Validieren

Prüfen Sie die Schemas, die Regeln der EN 16931, die Profilregeln und die nationalen Regeln Frankreichs, Deutschlands, der Niederlande und Italiens sowie Peppol. Jeder Befund nennt die offizielle Regel-ID und den XPath des Elements.

Konvertieren

Wandeln Sie zwischen CII, UBL, FatturaPA und Facturae um, und schreiben Sie ein PDF als PDF/A-3 neu, wenn dafür keine PDF-Engine nötig ist. Andernfalls erhalten Sie die Gründe, Seite für Seite.

Warum ZeRechnung

  • Reines Go, nur die Standardbibliothek

    Kein CGO, kein Java, keine externen Programme, keine Netzwerkzugriffe. Ein go get ist die ganze Einrichtung.

  • An den Referenzvalidatoren gemessen

    Jeder Pull Request vergleicht die Ergebnisse mit KoSIT, Mustang und veraPDF, Rechnung für Rechnung. Jede neue Abweichung lässt den Build scheitern.

  • Schnell

    Eine typische Rechnung zu lesen und vollständig zu validieren dauert etwa 25 µs, ein Fünftel der Zeit des nächstschnelleren Go-Pakets.

  • Ihr PDF bleibt, wie es ist

    Das XML wird per inkrementellem Update hinzugefügt. Die ursprünglichen Bytes bleiben unverändert, eine vorhandene Signatur bleibt also gültig.

Formate und Länder

Ein einziges Rechnungsmodell, invoice.Invoice, für alle Syntaxen: Die Umwandlung von einer in die andere ist ein Parse und ein Marshal.

FormatLänderLesenSchreibenValidieren
Factur-X 1.0x / ZUGFeRD 2.xCII · Profile MINIMUM bis EXTENDED sowie EXTENDED-CTC-FRFRDEjajaja
XRechnung 3.0CII · UBLDEjajaja
Peppol BIS Billing 3.0CII · UBLEUjajaja
NLCIUSCII · UBLNLjajaja
CIUS-ITCII · UBLITjajaja
UBL 2.1Invoice · CreditNote · EN 16931EUjajaja
FatturaPA 1.2FPA12 · FPR12ITjajaüber CII (CIUS-IT)
Facturae 3.2.x3.2 · 3.2.1 · 3.2.2ESjajaXSD-Schema; EN 16931 über UBL oder CII
ZUGFeRD 1.0CIIDEjaals Factur-XGrundprüfungen

Wie genau ist es?

Jeder Pull Request lässt die Referenzvalidatoren über die offiziellen Testkorpora laufen und vergleicht ihre Ergebnisse mit denen von ZeRechnung, Rechnung für Rechnung.

128 / 128

KoSIT

XRechnung-Rechnungen mit genau denselben Fehlern wie beim KoSIT-Validator.

241 / 282

Mustang

Rechnungen mit denselben Fehlern wie bei Mustang. Jede Abweichung geht auf die Referenzen selbst zurück und ist erklärt.

283 / 290

NPa

NLCIUS-Dateien mit denselben Regeln wie bei den niederländischen NPa-Validatoren. Die übrigen Abweichungen sind begründet.

609 / 614

veraPDF

ungültige PDF/A-Dateien des veraPDF-Korpus, erkannt durch eine Regel der richtigen Klausel.

Methode und Grenzen im Wiki

Loslegen

  1. Installieren Sie das Paket. Es braucht Go 1.24 oder neuer.

    Shell
    go get github.com/ritoon/zerechnung
  2. Machen Sie aus Ihrem PDF eine Factur-X-Rechnung.

    Go
    pdf, err := zerechnung.Create(host, inv, &zerechnung.CreateOptions{
    	Calculate: true,                // totals and VAT breakdown
    	Validate:  &validate.Options{}, // refuse an invalid invoice
    })
  3. Validieren Sie eine erhaltene Rechnung, mit den nationalen Regeln des Landes des Verkäufers.

    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. Oder nutzen Sie die Kommandozeile. validate endet bei Fehlern mit dem Exit-Code 1 und passt so unverändert in eine CI-Pipeline.

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

Open Source und offen für Beiträge

ZeRechnung ist freie Software unter der MIT-Lizenz. Fehlerberichte, Abweichungen von einem Referenzvalidator und fehlende Regeln sind willkommen.

Issue eröffnen

Die Übersetzungen sind für alle offen. Ein Fehler in Ihrer Sprache? Diese Übersetzung bearbeiten