Developers · XRechnung 4.0 · Readiness-Check
Was ändert sich mit XRechnung 4.0 in den Rechnungen, die Ihr System heute sendet?
Der Check liest eine XRechnung 3.0.x (UBL oder CII) und sagt für jeden Wert, was mit ihm in der XRechnung 4.0.0 Vorversion vom 15.09.2026 passiert — und was Sie ergänzen müssen. Ein 4.0-Prüfergebnis gibt es noch nicht: KoSIT hat keine 4.0-Validierungsartefakte veröffentlicht.
Eine Rechnung, im Browser
Beim ersten Prüfen erhalten Sie einen kostenlosen API-Schlüssel ohne Konto (100 Dokumente pro Monat). Die Rechnung wird weder geändert noch gespeichert.
59 Felder neu, 24 geändert, 12 entfallen
Aus den beiden offiziellen KoSIT-Spezifikationen (3.0.2 und 4.0.0 Vorversion) mechanisch abgeglichen: 95 Begriffe und 248 Regeln, jede mit festgelegtem Schicksal. Die fünf, die Entwicklern zuerst begegnen:
| Änderung | 3.0.2 | 4.0.0 Vorversion |
|---|---|---|
| Skonto wird ein eigenes Feld statt Text in den Zahlungsbedingungen (BR-DE-18 #SKONTO#) | BT-20 0..1 unter INVOICE | BG-35 0..* unter BG-33; BT-20 0..1 unter BG-33 |
| Drittzahlungen kommen aus der Extension in den Kern | BG-DEX-09 0..* unter INVOICE (nur Extension) | BG-34 0..* unter BG-22 |
| Bezüge und Lieferangaben je Position | — | 11 neue Bezugsfelder unter BG-25, Lieferung je Position BG-37/BG-38 (11 Felder) |
| Käuferreferenz (Leitweg-ID) darf mehrfach vorkommen | BT-10 1 unter INVOICE (Text) | BT-10 1..* unter INVOICE (Identifier) |
| Zahlungsanweisungen werden optional | BG-16 1 unter INVOICE | BG-16 0..1 unter INVOICE |
Was wann gilt
- XRechnung 3.0.x bleibt mindestens bis 31.07.2027 in Kraft (KoSIT).
- EN 16931-1:2017 und :2026 gelten parallel bis März 2029.
- Das technische 4.0-Paket (Schematron, Validator-Konfiguration, Testsuite) erwartet KoSIT im Frühjahr 2027. Erst dann ist eine 4.0-Prüfung möglich; der Check sagt bis dahin, was sich ändert, nicht ob eine Rechnung gültig ist.
Drei Zustände, neun Klassen
no-action — nur unveränderte oder identische Werte. automatic — dazu Werte, die nach fester Regel umziehen; der Absender muss nichts Neues liefern. needs-attention — mindestens ein Wert der folgenden Klassen ab needs-input:
| unchanged | bleibt, wie es ist |
| identical | gleicher Wert, nur Kardinalität oder Typ im Modell geändert |
| transform | wandert nach einer festen Regel an seinen 4.0-Platz (Regel steht im Ergebnis) |
| needs-input | braucht eine Angabe, die nur der Absender hat |
| not-representable | in 4.0 nicht darstellbar |
| blocked | Extension-Feld, für das 4.0 noch keine Extension veröffentlicht hat |
| outside-model | kein BT in EN 16931 — entscheidet die noch nicht veröffentlichte 4.0-Syntax |
| residual | XML-Element außerhalb der EN-16931-Bindung (4.0-Bindung unbekannt) |
| unclassified | nicht klassifiziert — wird gemeldet (auf den 86 offiziellen Testdokumenten: 0) |
Jede Antwort enthält basis: XRechnung 4.0.0 Vorversion 2026-09-15 (semantic model only), officialValidation: "not yet possible — KoSIT has not published 4.0 validation artefacts".
Aus Ihrem Code: einzeln oder im Stapel
curl -s -X POST https://www.invoicenavigator.eu/api/v3/readiness \
-H "Authorization: Bearer sk_live_…" -H "Content-Type: application/json" \
-d "$(jq -n --arg b "$(base64 < rechnung.xml | tr -d '\n')" '{xmlBase64: $b}')" \
| jq '.data | {summary, counts, changes: [.changes[] | {bt, class, detail}]}'# bis zu 20 Dokumente pro Aufruf — jedes zählt als ein Aufruf
jq -n --rawfile a a.xml --rawfile b b.xml \
'{documents: [{name: "a.xml", xml: $a}, {name: "b.xml", xml: $b}]}' \
| curl -s -X POST https://www.invoicenavigator.eu/api/v3/readiness \
-H "Authorization: Bearer sk_live_…" -H "Content-Type: application/json" -d @- \
| jq '.data.aggregate'Ein Stapel, der das Monatskontingent überschreiten würde, wird als Ganzes mit 402 QUOTA_EXCEEDED abgelehnt — nie halb verarbeitet. Andere Formate als XRechnung 3.0.x erhalten 422 UNSUPPORTED_FORMAT. Vollständige Beschreibung in der API-v3-Referenz.
What changes in your invoices with XRechnung 4.0
The check reads an XRechnung 3.0.x invoice (UBL or CII) and classifies every value against the XRechnung 4.0.0 Vorversion of 15 Sep 2026: 59 terms added, 24 changed, 12 removed, 248 rules — from both official KoSIT specifications. It tells you what changes and what you will have to supply; it does not say whether an invoice is valid under 4.0, because KoSIT has not published 4.0 validation artefacts yet (expected spring 2027). XRechnung 3.0.x stays in force at least until 31 Jul 2027.
POST /api/v3/readiness with { xml }, { xmlBase64 } or { documents: [...] } (up to 20; each document is one call). Free key: 100 documents a month · €49/month for 5,000. API v3 reference.