XRechnung 3.0
Deutschland · B2G aktiv, B2B 2027–2028XRechnung ist die deutsche CIUS auf Basis von EN 16931 — eine UBL- oder CII-Rechnung mit strengen deutschen Vorgaben für den öffentlichen Sektor, insbesondere einer verpflichtenden Routing-Kennung (Leitweg-ID). Sie ist bereits für Rechnungen an deutsche Behörden vorgeschrieben, B2B-Ausstellung wird ab 2027 stufenweise verpflichtend.
Worum es geht
XRechnung 3.0.2 legt die genauen Felder, Codelisten und Geschäftsregeln fest, die eine deutsche Rechnung erfüllen muss, in UBL- oder CII-Syntax. Sie wird von KoSIT gepflegt, und CrateAPI validiert gegen KoSITs eigene Validierungsartefakte — dieselben, die auch das System Ihres Empfängers nutzt.
Wo es Pflicht ist
Deutschland: öffentliche Rechnungsstellung (B2G) läuft bereits. B2B-Ausstellung wird ab 2027 für Unternehmen mit über 800.000 € Umsatz verpflichtend, ab 2028 für alle — Details in unserem Pflicht-Tracker.
Was wir nicht tun. Die Leitweg-ID — der Routing-Code, den ein deutscher öffentlicher Auftraggeber benötigt — bildet direkt auf das Feld buyer_reference (BT-10) des kanonischen Modells ab. Das ist ein Standardfeld aus EN 16931, das XRechnung lediglich verpflichtend macht, kein XRechnung-spezifisches Extra.
Ausprobieren
curl -X POST "$BASE/v1/generate/ubl?profile=xrechnung" \ -H "X-API-Key: $KEY" -H "Content-Type: application/json" \ -d @invoice.json -o invoice.xml
Relevante Endpoints
| Endpoint | Hinweise |
|---|---|
POST /v1/generate/ubl?profile=xrechnung | UBL-Syntax, XRechnung-3.0.2-Regeln. |
POST /v1/generate/cii?profile=xrechnung | CII-Syntax — gleiche Regeln, andere XML-Form. |
POST /v1/validate/{ubl,cii}?profile=xrechnungkostenlos | KoSITs eigene Validierungsartefakte, dieselben, gegen die auch Ihr Empfänger prüft. |
POST /v1/render/{html,pdf}?lang=de | Für Rechnungen, die Sie erhalten und nicht als reines XML lesen können. |
Beispiele & Dokumentation
Laden Sie ein validiertes XRechnung-Beispiel aus unserer Beispielbibliothek herunter, oder lesen Sie die vollständige API-Referenz.
FAQ
UBL oder CII für XRechnung?
Beides — XRechnung ist auf beiden Syntaxen definiert, CrateAPI erzeugt und validiert beide. Nutzen Sie, was Ihr Handelspartner oder Portal erwartet.
Ist das dasselbe wie ZUGFeRD?
Nein, aber verwandt: ZUGFeRD 2.x ist Deutschlands hybrides PDF+XML-Format und teilt seinen XML-Kern (CII) mit Factur-X. Für die hybride PDF-Variante statt reinem XML siehe unsere Factur-X-Seite.
Brauche ich ein spezielles Feld für die Leitweg-ID?
Nein — es ist das Standardfeld buyer_reference (BT-10) des kanonischen Modells, das XRechnung verpflichtend macht und andere Profile optional lassen.