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.
Was die Leitweg-ID ist
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.
Format
Typisches Muster: {Grobadresse}-{Feinadresse}-{Prüfziffer}, z. B. 04011000-1234512345-06.
- Grobadressierung: 2–12 Ziffern
- Feinadressierung (optional): 1–30 alphanumerisch
- Prüfziffer: genau 2 Ziffern
Format OK — so erwartet normbill invoice.buyer_reference (tier-1).
Hinweis: Die offizielle KoSIT-Schematron prüft bei BR-DE-15 nur die Anwesenheit — nicht die Syntax. Die Formatprüfung ist normbill tier-1 (NB-LEITWEG-FORMAT).
Im normbill-Request
{
"format": "xrechnung-3.0",
"invoice": {
"buyer_reference": "04011000-1234512345-06",
...
}
}Fehlt das Feld, liefert Generate einen 422 mit path: "invoice.buyer_reference" und einer konkreten Fix-Zeile — nicht nur den rohen Schematron-Text.
KoSIT vs. tier-1
- BR-DE-15 (KoSIT): Feld muss vorhanden sein
- NB-LEITWEG-FORMAT (normbill): Format wie oben — damit Sie Syntaxfehler schon vor dem Sidecar sehen
Weiter
Validator · Playground · Docs · OSS vs. API