XRechnung REST-API: Reines EN 16931 CII-XML per API generieren

Für Rechnungen an Bundes- und Landesbehörden (B2G) ist in Deutschland das reine XML-Format XRechnung (Standard EN 16931) vorgeschrieben. Unsere REST-API generiert standardkonforme CII-XML-Dateien per POST /v1/invoice/xrechnung in Millisekunden.

Eigene Rechnung hier hineinziehen

oder Datei vom Computer auswählen (.pdf oder .xml bis 10 MB)

🔒 100 % flüchtige RAM-Prüfung auf deutschen Servern (Frankfurt) – keine Speicherung.

Code-Vergleich: Falsches vs. Korrektes CII-XML

✗ Häufiger Fehler / Falsches XML Nicht konform

<!-- FEHLER: Veraltete oder fehlende SpecificationIdentifier / CustomizationID -->
<rsm:CrossIndustryInvoice>
  <rsm:ExchangedDocumentContext>
    <!-- ram:GuidelineSpecifiedDocumentContextParameter fehlt oder enthält alte Version -->
    <ram:GuidelineSpecifiedDocumentContextParameter>
      <ram:ID>urn:cen.eu:en16931:2017</ram:ID>
    </ram:GuidelineSpecifiedDocumentContextParameter>
  </rsm:ExchangedDocumentContext>
</rsm:CrossIndustryInvoice>

✓ Valide nach EN 16931 / KoSIT Normkonform

<!-- KORREKT: Gültige XRechnung 3.0 Kennung nach aktuellem KoSIT Standard -->
<rsm:CrossIndustryInvoice>
  <rsm:ExchangedDocumentContext>
    <ram:GuidelineSpecifiedDocumentContextParameter>
      <ram:ID>urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0</ram:ID>
    </ram:GuidelineSpecifiedDocumentContextParameter>
  </rsm:ExchangedDocumentContext>
</rsm:CrossIndustryInvoice>

Technische Ursache & Lösung

Die Erstellung einer XRechnung stellt Entwickler oft vor große Herausforderungen: Reine XML-Dateien nach dem UN/CEFACT CII- oder OASIS UBL-Standard erfordern hunderte geschachtelte Tags, exakte Namensräume und strenge KoSIT-Schematron-Regeln.

Über unsere E-Rechnung Cloud REST-API entfällt der manuelle XML-Bau vollständig: Du sendest ein einfaches JSON-Objekt an `POST /v1/invoice/xrechnung`. Das Backend berechnet alle Steuerbasisbeträge, prüft die Leitweg-ID (BT-10) und liefert sofort eine 100 % valide XRechnung 3.0 XML-Datei zurück.

Die API lässt sich aus jeder Programmiersprache (Python, PHP, C#, Node.js, Go) oder No-Code-Plattform (n8n, Make.com) ansprechen.

⚡ Die schlüsselfertige Abkürzung für Entwickler & No-Code

Keine Lust auf XML-Schematron-Fehler und Rundungsdifferenzen?

Unsere E-Rechnung Cloud API übernimmt alle mathematischen Berechnungen, Steuerregeln, XSD-Schemata und die PDF/A-3 Konvertierung vollautomatisch im Hintergrund.

📦 n8n Workflow (.json) ⚡ Make.com Blueprint 🛒 WooCommerce Plugin (.zip) API-Key ab 10 € Prepaid holen →

Häufig gestellte Fragen (FAQ)

Welche XRechnung-Version wird über die API erzeugt?

Standardmäßig wird die aktuelle XRechnung 3.0 nach KoSIT-Standard und europäischer Norm EN 16931 im CII-Format (CrossIndustryInvoice) erzeugt.

Wie binde ich den Endpunkt in mein Backend ein?

Sende einen POST-Request an /v1/invoice/xrechnung mit dem Header X-API-Key und deiner Rechnungs-JSON. Als Response erhältst du direkt den rohen XML-String mit Content-Type application/xml.

Wird die erzeugte XRechnung vor der Ausgabe validiert?

Ja. Jede generierte XRechnung durchläuft vor der Auslieferung unsere interne Schematron- und XSD-Validierung, sodass keine fehlerhaften Rechnungen ausgeliefert werden.

Passende Themen & Normen

Alle 12 Themen ansehen →

KOSIT SCHEMATRON