Loading…
JSON senden, validiertes XRechnung- oder ZUGFeRD / Factur-X-Dokument zurückbekommen — geprüft gegen den offiziellen KoSIT-Validator. Schlägt eine Regel fehl, zeigen wir auf das exakte Feld in Ihrem Request und sagen, wie Sie es beheben — kein Schematron-Code. API-Key sofort, ohne Sales-Gespräch, kostenlos starten.
{
"format": "xrechnung-3.0",
"invoice": {
"number": "INV-2026-0001",
"buyer_reference": "04011000-1234512345-06",
"seller": { "name": "Acme GmbH",
"vat_id": "DE123456789" },
"lines": [{ "name": "Consulting", "qty": 8,
"unit_price": 120, "vat": 19 }]
}
}Der Empfang strukturierter E-Rechnungen ist für jedes deutsche Unternehmen bereits Pflicht — seit Januar 2025. Unser /parse-Endpunkt übernimmt das heute. Das Ausstellen folgt: Januar 2027 (über 800.000 € Umsatz), Januar 2028 für alle; Frankreich startet im September 2026. In einem Nachmittag angebunden statt in einem Quartal.
Andere Validatoren liefern einen Schematron-Regelcode und wünschen viel Glück. Wir liefern die Regel, den Pfad in Ihrem JSON, was falsch ist — und wie Sie es beheben.
[error] BR-DE-15 | XRechnung_3.0 | severity=fatal cvc-complex-type.2.4.b: The content of element 'cac:PartyIdentification' is not complete. One of '{urn:oasis:names:specification:ubl:schema:xsd: CommonBasicComponents-2}ID' is expected. (line 47, col 28)
{
"valid": false,
"format": "xrechnung-3.0",
"profile": "XRechnung 3.0.2 (UBL 2.1)",
"tier": "schematron",
"counts": {
"errors": 1,
"warnings": 0
},
"issues": [
{
"severity": "error",
"rule": "BR-DE-15",
"path": "invoice.buyer_reference",
"message": "Leitweg-ID is missing. Public-sector buyers in Germany require one (BT-10).",
"fix": "Ask the buyer for their Leitweg-ID. Format: 04011000-1234512345-06",
"docs_url": "https://normbill.com/docs/rules/br-de-15",
"location": "/ubl:Invoice/cbc:BuyerReference"
}
]
}Rechnungsdaten als JSON senden. Zurück kommt validiertes XRechnung-XML oder ein hybrides ZUGFeRD / Factur-X-PDF — plus vollständiger Validierungsreport. Einfaches REST aus jeder Sprache, kein SDK nötig.
curl https://api.normbill.com/v1/invoices/generate \ -H "Authorization: Bearer sk_live_..." \ -H "Content-Type: application/json" \ -d '{ "format": "xrechnung-3.0", "invoice": { "number": "INV-2026-0001", "issue_date": "2026-06-15", "due_date": "2026-07-15", "buyer_reference": "04011000-1234512345-06", "seller": { "name": "Muster Lieferant GmbH", "vat_id": "DE123456789", "address": { "country": "DE", "city": "Berlin", "postal_code": "10115" }, "contact": { "name": "Erika Muster", "phone": "+49 30 1234567", "email": "billing@lieferant.example" } }, "buyer": { "name": "Beispiel Kunde AG", "address": { "country": "DE", "city": "Hamburg", "postal_code": "20095" }, "contact": { "email": "ap@kunde.example" } }, "payment": { "iban": "DE89370400440532013000" }, "lines": [{ "name": "Beratungsleistung", "qty": 10, "unit_price": 100, "vat": 19 }] } }'
Registrieren, Test-Key kopieren, erste Anfrage senden. Auch Live-Keys gibt es self-service — ohne Vertrieb, ohne Vertragsprüfung.
sk_test_4fk…Einfaches JSON — Verkäufer, Käufer, Positionen. UBL/CII-Serialisierung, Codelisten und Steuerarithmetik übernehmen wir.
POST /v1/invoices/generateXRechnung-XML — vor der Rückgabe gegen die offiziellen KoSIT-Regeln geprüft — oder ein hybrides ZUGFeRD / Factur-X-PDF mit strukturellen EN-16931-Prüfungen.
"validation": { "valid": true }Die deutsche CIUS inklusive Leitweg-ID für B2G. Vor der Rückgabe gegen das offizielle KoSIT-Schematron validiert.
PDF/A-3 mit eingebettetem CII-XML — Mensch und Maschine lesen dasselbe Dokument. EN-16931-Profil, in den Bezahlplänen.
Beliebige XRechnung- oder UBL/CII-Dokumente an /v1/invoices/validate senden — EN-16931-Strukturprüfungen für jedes Format, der offizielle KoSIT-Validator (XSD + Schematron) für XRechnung, als maschinenlesbarer Report.
Die Empfangsseite der Pflicht: beliebige E-Rechnungen — UBL/XRechnung oder CII (ZUGFeRD) — an /v1/invoices/parse senden und typisiertes JSON zurückbekommen.
BIS-konformes UBL für das Peppol-Netzwerk aus demselben JSON. Zustellung über einen Access Point steht auf der Roadmap.
Test- & Live-Keys, OpenAPI-Spezifikation, RFC-9457-Fehler, öffentliche Doku. EU-Hosting — Rechnungsinhalte werden nie gespeichert.
Öffentlich, mit lauffähigen Beispielen — jede Regel und jeder Fehlercode dokumentiert, Validierungsregeln auf Deutsch und Englisch. Die gesamte Oberfläche: drei Endpunkte plus OpenAPI-Spezifikation — bewusst klein.
Sie zahlen nur für erzeugte Dokumente. Validierung, Wiederholungen und fehlgeschlagene Aufrufe sind kostenlos.
Alle Preise zzgl. USt. Kunden in DE: +19 % MwSt. beim Checkout. EU-B2B mit gültiger USt-IdNr.: Reverse Charge.
25 Dokumente im Monat, vollständige KoSIT-Validierung, Test- & Live-Keys. Ohne Kreditkarte.
Kostenlos starten →≈ 0,098 € pro Dokument
≈ 0,075 € pro Dokument
≈ 0,04 € pro Dokument
50.000+ Dokumente im Monat? Ab 990 €/Monat zzgl. USt. im Jahresvertrag: dedizierter Support, EU-Datenresidenz-Garantie, Zahlung auf Rechnung (SEPA, 30 Tage netto).
Sprechen Sie uns an →horstoeko/zugferd und Mustangproject sind solide, echt kostenlose Bibliotheken. Wenn Sie nur das XML erzeugen müssen, nehmen Sie sie. Was sie Ihnen zurückgeben, ist alles, was danach kommt.
Wenn Sie keine externen Abhängigkeiten wollen und ein Team haben, das die Compliance-Updates selbst trägt, ist die Open-Source-Bibliothek die richtige Wahl — nehmen Sie sie. normbill ist für Teams, die lieber ausliefern und nie wieder an ein Schematron-Release denken wollen.
Die Ausgabe entspricht EN 16931, der europäischen Norm hinter der deutschen Pflicht. XRechnung-Dokumente folgen der aktuellen KoSIT-Spezifikation und werden vor der Rückgabe gegen das offizielle KoSIT-Schematron validiert; ZUGFeRD-Ausgabe ist valides Factur-X mit strukturellen EN-16931-Prüfungen. Die inhaltliche Richtigkeit (korrekte Umsatzsteuer, Pflichtreferenzen Ihres Käufers) hängt von Ihren Daten ab — genau dazu liefert der Validierungsreport die Hinweise.
XRechnung ist reines XML — Pflicht bei deutschen Behörden (B2G) und im B2B verbreitet. ZUGFeRD / Factur-X ist ein normales PDF mit demselben strukturierten XML eingebettet — Mensch und Maschine lesen dasselbe Dokument. Beide erfüllen die Pflicht; viele Teams senden ZUGFeRD an Unternehmen und XRechnung an Behörden. Die API erzeugt beides aus demselben JSON.
Nein. Rechnungen werden im Speicher verarbeitet und zurückgegeben; nichts wird persistiert, Request-Bodies sind von den Logs ausgeschlossen. EU-Hosting, DSGVO-first — es gibt keine Aufbewahrungseinstellung, weil nichts aufbewahrt wird.
Ja — XRechnung- oder UBL-Dokumente an /v1/invoices/validate senden für die autoritative KoSIT-Validierung; CII-Dokumente (ZUGFeRD / Factur-X) werden heute auf der strukturellen EN-16931-Ebene geprüft. So oder so kommt ein maschinenlesbarer Report zurück: jede verletzte Regel mit ID, Schweregrad, verständlicher Meldung und Korrekturvorschlag. Die Validierung ist im Rahmen einer großzügigen Fair-Use-Grenze kostenlos — dem Fünffachen Ihres monatlichen Dokumentkontingents — und zählt nie auf Ihre abrechenbaren Dokumente.
Genau der Kernanwendungsfall. Ein API-Key, plus ein freies metadata-Objekt auf jeder Rechnung für Ihre eigene Mandanten-Zuordnung. Die API antwortet synchron — Ihre Nutzer sehen normbill nie, sie bekommen einfach konforme Rechnungen aus Ihrem Produkt. Bei Plattform-Volumen bietet der Platform-Tarif Zahlung auf Rechnung, dedizierten Support und eine EU-Datenresidenz-Garantie.
Die API erzeugt heute Peppol BIS Billing 3.0 UBL — Ihre Dokumente sind netzwerkfertig. Die Übertragung über das Peppol-Netzwerk (zertifizierter Access Point) steht auf der Roadmap — Erzeugung und Validierung kommen zuerst, weil jedes Team sie am ersten Tag braucht.
Sie erhalten einen 422 mit Fehlern auf Feldebene: die verletzte Regel, der Pfad in Ihrem JSON, eine verständliche Meldung und ein Korrekturvorschlag. Die API gibt niemals stillschweigend ein ungültiges Dokument zurück.
Nur erfolgreich erzeugte Dokumente zählen auf Ihr Kontingent — fehlgeschlagene Versuche kosten nichts, und die Validierung hat eine eigene großzügige Freigrenze. Ab 80 % Auslastung trägt jede Antwort einen X-Quota-Warning-Header, damit Sie nichts überrascht. Darüber hinaus liefern Anfragen einen klaren 429 mit Upgrade-Link — die gemessene Mehrverbrauchs-Abrechnung für Bezahlpläne wird gerade ausgerollt. sk_test_-Keys werden nie berechnet.
Per E-Mail an support@normbill.com — für Support, Fragen zur Doku oder alles, was dieses FAQ nicht beantwortet. Der Einstieg steht in der öffentlichen Dokumentation.
Kostenloser Key, 25 Rechnungen im Monat, volle Validierung. Upgrade erst, wenn echtes Volumen läuft — ohne Sales-Gespräch, ohne Vertrag, ohne Kreditkarte.
$ curl https://api.normbill.com/v1/invoices/generate