Leitfaden
Leitweg-ID für Entwickler
BT-10 ist der häufigste Ablehnungsgrund bei XRechnung an die öffentliche Hand. Kurz: was die ID ist, welches Format gilt, und wohin sie im JSON gehört.
Aktualisiert am
Was ist die Leitweg-ID?
Die Leitweg-ID adressiert den öffentlichen Empfänger in Deutschland (Routing über die zentralen Plattformen). In EN 16931 heißt das Feld Buyer reference (BT-10). XRechnung macht es für den öffentlichen Auftrag verpflichtend — Regel BR-DE-15.
Für Lieferanten des Bundes sind E-Rechnungen seit dem 27. November 2020 Pflicht (E-Rechnungsverordnung); die Bundesplattformen ZRE und OZG-RE routen jede Rechnung über die Leitweg-ID. Die ID vergibt Ihr öffentlicher Auftraggeber — sie kommt mit der Bestellung, nicht aus einem Verzeichnisdienst.
Welches Format hat eine Leitweg-ID?
Drei Segmente, durch Bindestriche verbunden: {Grobadresse}-{Feinadresse}-{Prüfziffer}, z. B. 04011000-1234512345-06.
| Segment | Regel | Beispiel |
|---|---|---|
| Grobadressierung | 2–12 Ziffern | 04011000 |
| Feinadressierung (optional) | 1–30 alphanumerische Zeichen | 1234512345 |
| Prüfziffer | genau 2 Ziffern | 06 |
Format OK — so erwartet normbill invoice.buyer_reference (Stufe 1).
Hinweis: Das offizielle KoSIT-Schematron prüft bei BR-DE-15 nur, ob das Feld vorhanden ist — nicht die Syntax. Die Formatprüfung ist Stufe 1 von normbill (NB-LEITWEG-FORMAT).
Wohin gehört die Leitweg-ID im API-Request?
{
"format": "xrechnung-3.0",
"invoice": {
"buyer_reference": "04011000-1234512345-06",
...
}
}Fehlt das Feld, liefert Generate einen 422 mit path: "invoice.buyer_reference" und einem konkreten Korrekturvorschlag — nicht nur dem rohen Schematron-Text.
Welche Regeln prüfen die Leitweg-ID?
| Regel | Ebene | Was geprüft wird |
|---|---|---|
BR-DE-15 | KoSIT-Validator (Stufe 3, maßgeblich) | Die Käuferreferenz muss vorhanden sein |
NB-LEITWEG-FORMAT | normbill-Vorprüfung (Stufe 1) | Format wie oben — Syntaxfehler erscheinen schon vor dem Sidecar |
Wie geht es weiter?
Validator · Playground · Docs · OSS vs. API