Leitfaden
OSS-Bibliothek vs. API für XRechnung
Ein ehrlicher Vergleich für Produktteams, die E-Rechnungen in Deutschland einbetten.
Aktualisiert am
Open-Source-Bibliotheken wie horstoeko/zugferd und Mustangproject sind stark, wenn Sie die XML-Erzeugung selbst besitzen wollen. Das ist der echte Wettbewerber zu einer API wie normbill — nicht „noch ein Rechnungs-SaaS“.
Was kann die Bibliothek gut — und was bleibt bei Ihnen?
| Aufgabe | OSS-Bibliothek (horstoeko, Mustangproject) | normbill-API |
|---|---|---|
| XML-Erzeugung | Serializer, Abhängigkeiten und Sonderfälle gehören Ihnen | Ein POST-Request — XRechnung (UBL/CII), ZUGFeRD / Factur-X |
| Autoritative KoSIT-Validierung | Sie betreiben und interpretieren das offizielle Schematron selbst | Läuft bei jedem XRechnung-Generate; die rechtliche Referenz hat das letzte Wort |
| Fehlerzuordnung | Rohe BR-*/PEPPOL-*-Meldungen gegen XML-XPaths | 422-Report mit Pfad in Ihrem JSON und verständlicher Lösung |
| Formatwechsel (XRechnung 4.0 erwartet Ende 2026) | Ihre Roadmap: jedes XRechnung-/ZUGFeRD-/Peppol-Release | Serverseitig gepflegt, UBL und CII synchron |
| Kostenmodell | Keine Gebühr pro Dokument; Compliance-Engineering im Haus | Pläne pro Dokument; fehlgeschlagene Generates zählen nie |
Wofür ist normbill da?
Sie senden Rechnungs-JSON per POST. Sie bekommen konforme XRechnung (UBL oder CII) oder ZUGFeRD / Factur-X — validiert, bevor es bei Ihnen ankommt. Schlägt eine Regel fehl, nennt der 422-Report den Pfad in Ihrem Request — z. B. invoice.buyer_reference — mit verständlicher Lösung. Validierung ist im Fair-Use kostenlos; fehlgeschlagene Aufrufe zählen nie.
Probieren Sie den kostenlosen Validator oder den Playground ohne Konto.
Wann ist die Bibliothek richtig?
Sie haben (oder wollen) Compliance-Engineering im eigenen Haus, KoSIT läuft bereits in der CI, und Ihre Rechnungsformen sind stabil. Dann kann eine Bibliothek die bessere Wahl sein.
Wann ist eine API günstiger?
Sie sind ein SaaS und stellen für Mandanten aus, wollen Schematron nicht im kritischen Pfad, oder brauchen denselben Report für Generate und Validate. Das ist der normbill-Fall — kostenloser Key, 50 Dokumente/Monat.