Zum Inhalt springen

Ironfang Finance - Regelreferenz

BR-20: Der Anschrift des Steuervertreters einen Ländercode hinzufügen

Die cac:PostalAddress des Steuervertreters braucht cac:Country/cbc:IdentificationCode mit einem Wert wie GB. Straße, Ort und Postleitzahl genügen nicht.

EN 16931Fehler: Das Dokument ist ungültigBeteiligte und Adressen

Auf dieser Seite

Die kurze Antwort

BR-20 schlägt fehl, wenn die Postanschrift der cac:TaxRepresentativeParty keinen oder einen leeren Ländercode hat. Schließen Sie diese Anschrift mit cac:Country/cbc:IdentificationCode ab, das den Code nach ISO 3166-1 alpha-2 für das Land enthält, in dem die Anschrift des Vertreters liegt.

Straße, Ort und Postleitzahl sind für die Regeln optional, das Land nicht. Das aufgezeichnete Beispiel hat alle drei und schlägt trotzdem fehl, weil der Ländercode das einzige Element ist, das diese Regel liest.

Was die Regel prüft

Die Regel läuft in jeder cac:PostalAddress des Vertreters und meldet an ihr. Der Text von cac:Country/cbc:IdentificationCode wird von Leerraum am Rand befreit, und ein leeres Ergebnis schlägt fehl.

Ein leeres Code-Element zählt als fehlend. Im Versuch meldete ein leeres cbc:IdentificationCode in der Anschrift des Vertreters BR-20, BR-CL-14 und PEPPOL-EN16931-R008 zusammen.

Der Name des Landes ersetzt den Code nicht. Im Versuch meldete cac:Country/cbc:Name mit United Kingdom BR-20 und die Warnung UBL-CR-323, die dieses Element als außerhalb des Modells kennzeichnet.

Hier wird nur das Vorhandensein geprüft. Im Versuch bestand UK diese Regel und scheiterte an BR-CL-14, während DE, ein echter Code, der vom Land des Verkäufers abweicht, alle Prüfschritte bestand.

BegriffBedeutungUBL-Element
BT-69Ländercode des Steuervertreterscac:TaxRepresentativeParty/cac:PostalAddress/cac:Country/cbc:IdentificationCode
BG-12Postanschrift des Steuervertreters des Verkäuferscac:TaxRepresentativeParty/cac:PostalAddress

Wie es in einer Integration dazu kommt

Mögliche Ursachen, abgeleitet aus der Form der Regel und nicht aus gemessener Nutzung:

  • Die Anschrift des Vertreters stammt aus einer Registrierungstabelle, die das Land als Namen oder gar nicht speichert.
  • Ein gemeinsamer Anschriften-Baustein füllt das Land nur für Verkäufer und Käufer aus, für die ein Standardland eingestellt ist.
  • Die Zuordnung des Ländercodes läuft über den Datensatz des Verkäufers, und die Anschrift des Vertreters wird ohne Code geschrieben.

So korrigieren Sie das Dokument

  1. Ermitteln Sie das Land der Anschrift des Vertreters aus seinem Bestellungs- oder Registrierungsdatensatz.
  2. Schreiben Sie dessen zweistelligen Code in Großbuchstaben als cac:Country/cbc:IdentificationCode, das letzte Kindelement von cac:TaxRepresentativeParty/cac:PostalAddress.
  3. Kopieren Sie nicht standardmäßig das Land des Verkäufers. Ein Vertreter kann in einem anderen Land ansässig sein als der Verkäufer, und der Code muss die Anschrift des Vertreters beschreiben.
  4. Entfernen Sie ein etwaiges cac:Country/cbc:Name; es zieht eine Warnung nach sich und erfüllt diese Regel nicht.

Korrigierte Rechnung prüfen

Vorher und nachher

Dies sind Ausschnitte, keine vollständigen Dokumente. Die vollständigen synthetischen Dokumente, aus denen sie stammen, sind unten verlinkt.

Ausschnitt der fehlerhaften Rechnung: Die Anschrift des Vertreters hat Straße, Ort und Postleitzahl, aber kein Land

<cac:TaxRepresentativeParty>
  <!-- name omitted from this fragment -->
  <cac:PostalAddress>
    <cbc:StreetName>4 Example Street</cbc:StreetName>
    <cbc:CityName>London</cbc:CityName>
    <cbc:PostalZone>SW1A 4AA</cbc:PostalZone>
  </cac:PostalAddress>
  <!-- tax scheme omitted from this fragment -->
</cac:TaxRepresentativeParty>

Ausschnitt der korrigierten Rechnung: Der Ländercode GB schließt die Anschrift des Vertreters ab

<cac:TaxRepresentativeParty>
  <!-- name omitted from this fragment -->
  <cac:PostalAddress>
    <cbc:StreetName>4 Example Street</cbc:StreetName>
    <cbc:CityName>London</cbc:CityName>
    <cbc:PostalZone>SW1A 4AA</cbc:PostalZone>
    <cac:Country>
      <cbc:IdentificationCode>GB</cbc:IdentificationCode>
    </cac:Country>
  </cac:PostalAddress>
  <!-- tax scheme omitted from this fragment -->
</cac:TaxRepresentativeParty>

Der einzige Unterschied ist cac:Country mit dem Code GB am Ende der Anschrift des Vertreters in der korrigierten Rechnung. Das fehlerhafte Dokument meldet nur BR-20: Die Anschriften von Verkäufer und Käufer behalten ihre Ländercodes, und BR-19 ist erfüllt, weil der Vertreter weiterhin eine Anschrift hat.

Was der Validator gemeldet hat

Aufgezeichnet mit phive 12.1.0 / phive-rules-peppol 4.5.6 / Saxon-HE 12.10, der Engine hinter dem kostenlosen Validator, mit synthetischen Daten. Ein aufgezeichnetes Ergebnis ist ein Regressionsnachweis für diese Dokumente, keine Zertifizierung.

Wo die Regel gilt

  • Gilt für Invoice und CreditNote. Im Versuch meldete eine Gutschrift mit derselben Anschrift des Vertreters ohne Land BR-20 an cac:TaxRepresentativeParty/cac:PostalAddress.
  • Gemeldet im Prüfschritt EN 16931. Der Prüfschritt Peppol bestand die aufgezeichnete fehlerhafte Rechnung.
  • Die Regel braucht eine Anschrift, in der sie laufen kann. Hat der Vertreter überhaupt keine Anschrift, wird stattdessen BR-19 gemeldet.

Umfang und Quelle

Geschrieben für Peppol BIS Billing 3.0.21 (May 2026), EN 16931 1.3.16, angewendet auf Invoice- und CreditNote-Dokumente in UBL 2.1. Andere Profile, Syntaxen und Releases können diese Kennung anders definieren. Version des Hinweiskatalogs 2026-09-28.1: Quelle geprüft am 2026-09-28, Erklärung zuletzt aktualisiert am 2026-09-28.

Die offizielle Definition von BR-20 (auf Englisch) enthält den normativen Wortlaut und den Test. Diese Seite ist unsere Erklärung dazu, keine Kopie.

Die Erklärung ändert das Urteil der Engine nicht. Dass Sie diesen Befund beheben, heißt nicht, dass das Dokument jeden Prüfschritt besteht. Die Validierung bescheinigt keine rechtliche oder steuerliche Konformität und überträgt kein Dokument über Peppol.