Zum Inhalt springen

Ironfang Finance - Regelreferenz

BR-CL-14: Einen Alpha-2-Ländercode nach ISO 3166-1 in Anschriften verwenden

Jeder cac:Country/cbc:IdentificationCode muss ein zweistelliger Code nach ISO 3166-1 in Großbuchstaben sein. Der Code für das Vereinigte Königreich ist GB, nicht UK.

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

Auf dieser Seite

Die kurze Antwort

BR-CL-14 schlägt fehl, wenn ein cac:Country/cbc:IdentificationCode etwas anderes als einen Code aus der Liste ISO 3166-1 alpha-2 enthält. Im aufgezeichneten Beispiel ist das Land des Verkäufers UK; der Code für das Vereinigte Königreich ist GB.

Erfasst ist jedes Land einer Anschrift im Dokument, gleich zu welcher Partei die Anschrift gehört. Die Fundstelle des Befunds nennt das genaue Element, das zu korrigieren ist.

Was die Regel prüft

Sie läuft auf jedem cbc:IdentificationCode innerhalb eines cac:Country: in den Postanschriften von Verkäufer, Käufer und Steuervertreter sowie in der Lieferanschrift. Im Versuch wurde UK in den Anschriften von Käufer und Steuervertreter und in der Lieferanschrift jeweils an diesen Elementen gemeldet.

Umgebende Leerzeichen werden entfernt, und der Rest muss genau einem gelisteten Code entsprechen, in Großbuchstaben. Im Versuch schlugen gb, GBR und United Kingdom alle fehl.

Die Liste folgt ISO 3166-1 alpha-2 und akzeptiert zusätzlich 1A und XI; XI, das für Nordirland verwendet wird, bestand im Versuch als Land des Käufers. EL, das Präfix, das Griechenland für Umsatzsteuer-Identifikationsnummern verwendet, steht nicht auf der Liste und schlug als Land des Käufers fehl.

Auch ein leerer Code schlägt fehl. Im Versuch meldete ein leerer Code des Käufers diese Regel zusammen mit BR-11 und PEPPOL-EN16931-R008.

Das Ursprungsland eines Artikels ist nicht erfasst: Im Versuch wurde UK in cac:Item/cac:OriginCountry stattdessen von BR-CL-15 gemeldet.

BegriffBedeutungUBL-Element
BT-40Ländercode des Verkäuferscac:AccountingSupplierParty/cac:Party/cac:PostalAddress/cac:Country/cbc:IdentificationCode
BT-55Ländercode des Käuferscac:AccountingCustomerParty/cac:Party/cac:PostalAddress/cac:Country/cbc:IdentificationCode
BT-69Ländercode des Steuervertreterscac:TaxRepresentativeParty/cac:PostalAddress/cac:Country/cbc:IdentificationCode
BT-80Ländercode der Lieferanschriftcac:Delivery/cac:DeliveryLocation/cac:Address/cac:Country/cbc:IdentificationCode

Wie es in einer Integration dazu kommt

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

  • Das Land ist als UK gespeichert, die geläufige Abkürzung, die nicht der ISO-Code für das Vereinigte Königreich ist.
  • Die Ländercodes stammen aus einem System, das ISO-Codes nach Alpha-3 wie GBR oder numerische Codes verwendet.
  • Die Anschrift enthält einen Ländernamen, und das Mapping schreibt den Namen in cbc:IdentificationCode.
  • Codes werden von Hand in Kleinbuchstaben eingegeben und so gesendet, wie sie eingegeben wurden.
  • Das Umsatzsteuerpräfix der Partei, etwa EL für Griechenland, wird als Land ihrer Anschrift wiederverwendet.

So korrigieren Sie das Dokument

  1. Finden Sie das Element über die Fundstelle des Befunds; sie nennt die Partei und die Anschrift.
  2. Wandeln Sie den gespeicherten Wert in seinen Code nach ISO 3166-1 alpha-2 in Großbuchstaben um: GB für das Vereinigte Königreich, GR für Griechenland, DE für Deutschland.
  3. Nehmen Sie die Umwandlung dort vor, wo Anschriften gespeichert werden, oder in einem gemeinsamen Mapping, damit jede Partei und die Lieferanschrift gleich behandelt werden.
  4. Halten Sie das Präfix der Umsatzsteuer-Identifikationsnummer getrennt vom Land der Anschrift. Bei Griechenland unterscheiden sich beide: Die Umsatzsteuer-Identifikationsnummer beginnt mit EL, und der Ländercode ist GR.

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 Verkäufers gibt als Land UK an

<cac:AccountingSupplierParty>
  <cac:Party>
    <!-- endpoint omitted from this fragment -->
    <cac:PostalAddress>
      <cbc:StreetName>1 Example Street</cbc:StreetName>
      <cbc:CityName>London</cbc:CityName>
      <cbc:PostalZone>SW1A 1AA</cbc:PostalZone>
      <cac:Country>
        <cbc:IdentificationCode>UK</cbc:IdentificationCode>
      </cac:Country>
    </cac:PostalAddress>
    <!-- tax scheme and legal entity omitted from this fragment -->
  </cac:Party>
</cac:AccountingSupplierParty>

Ausschnitt der korrigierten Rechnung: Das Land des Verkäufers ist GB

<cac:AccountingSupplierParty>
  <cac:Party>
    <!-- endpoint omitted from this fragment -->
    <cac:PostalAddress>
      <cbc:StreetName>1 Example Street</cbc:StreetName>
      <cbc:CityName>London</cbc:CityName>
      <cbc:PostalZone>SW1A 1AA</cbc:PostalZone>
      <cac:Country>
        <cbc:IdentificationCode>GB</cbc:IdentificationCode>
      </cac:Country>
    </cac:PostalAddress>
    <!-- tax scheme and legal entity omitted from this fragment -->
  </cac:Party>
</cac:AccountingSupplierParty>

Nur der Ländercode des Verkäufers unterscheidet sich: UK in der fehlerhaften Rechnung, GB in der korrigierten. Das fehlerhafte Dokument meldet allein BR-CL-14. Die Regel zum Land des Verkäufers, BR-09, ist erfüllt, weil sie nur einen Wert verlangt, und UK ist einer.

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

  • Eine Gutschrift wird gleich behandelt: Im Versuch meldete UK als Land ihres Verkäufers allein diese Regel.
  • Gemeldet im Prüfschritt EN 16931; der Peppol-Prüfschritt wurde im aufgezeichneten Beispiel bestanden.
  • Ländercodes werden mit nichts anderem verglichen. Die Regel prüft nicht, ob ein Verkäufer, dessen Umsatzsteuer-Identifikationsnummer mit GB beginnt, eine Anschrift in GB hat.

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-24.1: Quelle geprüft am 2026-09-24, Erklärung zuletzt aktualisiert am 2026-09-24.

Die offizielle Definition von BR-CL-14 (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.