AttestwireXRechnung-RegelnBR-DE-9

BR-DE-9 XRechnung verlangt die Postleitzahl des Käufers

Ihre Rechnung wurde abgelehnt, weil in der Anschrift Ihres Kunden die Postleitzahl fehlt. Eine XRechnung braucht bei Verkäufer und Käufer Ort und Postleitzahl; die EN 16931 begnügt sich mit dem Ländercode. Ergänzen Sie die Postleitzahl im Kundenstamm, als Text. Im Standard ist das Feld BT-53; BR-DE-9 ist die Regel, die es verlangt.

Die Regelnummer bezeichnet die fehlgeschlagene Prüfung. BT steht für ein Rechnungsfeld, BG für eine Gruppe von Feldern. XRechnung ergänzt die europäische Norm EN 16931 um deutsche Anforderungen (CIUS).

Informationselement
BT-53
Schweregrad
fatal — Ablehnung: das Dokument ist nicht konform
Regelwerk
XRechnung-CIUS (KoSIT) — nationale Verschärfung der EN 16931

Die Lösung

Setzen Sie buyer.address.postalCode, zum Beispiel "10115". Als Zeichenkette, damit führende Nullen erhalten bleiben.

Ein Wert, der die Prüfung besteht

So sieht das Feld aus, wenn es stimmt
"postalCode": "10115"

Was die Regel verlangt

Setzen Sie die Postleitzahl des Käufers (BT-53), als Zeichenkette. Das Gegenstück ist BR-DE-8 für die Stadt.

Bei ausländischen Auftraggebern übernehmen Sie das dort übliche Format unverändert. Die Regel prüft, dass etwas da ist — nicht, ob es einem deutschen Fünfstellenschema folgt.

Der offizielle Regeltext

Die Regel BR-DE-9 stammt aus der XRechnung-CIUS und wird im Schematron der KoSIT geführt, den offiziellen Prüfregeln. Ein wörtliches Zitat des Regeltextes liegt uns für diese Regel nicht vor; was Sie oben lesen, ist unsere Erklärung. Maßgeblich ist die Veröffentlichung der KoSIT.

Warum es die Regel gibt

Wie bei der Stadt: Die Rechnung muss die vollständige Anschrift des Leistungsempfängers tragen, und ohne Postleitzahl ist eine deutsche Anschrift nicht vollständig. Die Prüfung meldet den Mangel, solange Sie ihn noch selbst beheben können.

So sieht der Befund aus

Genau dieses Objekt liefert die Bibliothek in result.errors, wenn die Regel anschlägt. Es wird beim Bauen dieser Seite durch Ausführen von @attestwire/en16931 erzeugt und entspricht dem Text, den Sie in Ihrem eigenen Log sehen. Die Meldung selbst ist englisch, weil die Bibliothek englisch meldet.

TeachingError
{
  "rule": "BR-DE-9",
  "field": "BT-53",
  "severity": "fatal",
  "message": "XRechnung requires the element \"Buyer post code\" (BT-53). Core EN 16931 only requires the country code, but the German CIUS additionally makes city and post code mandatory on both parties so that the address is deliverable, not merely jurisdictional.",
  "fix": "Set buyer.address.postalCode.",
  "example": "\"postalCode\": \"10115\"",
  "xpath": "/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:PostalAddress/cbc:PostalZone",
  "docsUrl": "https://attestwire.com/rules/BR-DE-9"
}

xpath zeigt auf das Element in einem UBL-Dokument — dort meldet auch ein KoSIT-Validator denselben Mangel. Bei einer CII-Rechnung (xrechnung-cii, ZUGFeRD, Factur-X) erhalten Sie dieselbe Zeichenkette und müssen sie selbst auf das CII-Element übertragen.

Häufige Fragen

Was bedeutet BR-DE-9?
Ihre Rechnung wurde abgelehnt, weil in der Anschrift Ihres Kunden die Postleitzahl fehlt. Eine XRechnung braucht bei Verkäufer und Käufer Ort und Postleitzahl; die EN 16931 begnügt sich mit dem Ländercode. Ergänzen Sie die Postleitzahl im Kundenstamm, als Text. Im Standard ist das Feld BT-53; BR-DE-9 ist die Regel, die es verlangt.
Wie behebe ich BR-DE-9?
Setzen Sie buyer.address.postalCode, zum Beispiel "10115". Als Zeichenkette, damit führende Nullen erhalten bleiben.
Ist BR-DE-9 Pflicht für XRechnung?
Ja. Ein Verstoß führt zur Ablehnung. Ort und Postleitzahl werden einzeln geprüft; eine von beiden genügt nicht.

Über eine Fehlermeldung hierhergekommen? Der docsUrl jedes Befunds führt auf die englische Seite; diese hier ist ihre deutsche Fassung. Etwas stimmt nicht — schreiben Sie uns.