Leitfaden
OSS-Bibliothek vs. API für XRechnung
Ein ehrlicher Vergleich für Produktteams, die E-Rechnungen in Deutschland einbetten.
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 eine Bibliothek liefert
- Volle Kontrolle über Serializer und Abhängigkeiten
- Keine dokumentbezogene Vendor-Gebühr
- Exotische Edge Cases im eigenen Prozess anpassbar
Was auf Ihrer Roadmap bleibt
- KoSIT-Schematron betreiben und interpretieren (rechtliche Referenz)
- Kryptische BR-*/PEPPOL-*-Fehler auf Felder in Ihrem Domänenmodell mappen
- Jeder XRechnung-/ZUGFeRD-/Peppol-Versionswechsel (4.0 erwartet Ende 2026)
- UBL und CII für dieselbe CIUS synchron halten
Wofür normbill da ist
Sie POSTen Rechnungs-JSON. 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 Generates zählen nie.
Probieren Sie den kostenlosen Validator oder das Playground ohne Konto.
Wann die Bibliothek richtig ist
Sie haben (oder wollen) Compliance-Engineering in-house, KoSIT läuft bereits in der CI, und Ihre Rechnungsformen sind stabil. Dann kann eine Bibliothek die bessere Wahl sein.
Wann eine API günstiger ist
Sie sind ein SaaS und stellen für Mandanten aus, wollen Schematron nicht im Hot Path, oder brauchen denselben Report für Generate und Validate. Das ist der normbill-Fall — kostenloser Key, 25 Dokumente/Monat.