BR-CL-05: Einen Code nach ISO 4217 für die Umsatzsteuer-Buchungswährung verwenden

Die kurze Antwort

BR-CL-05 schlägt fehl, wenn cbc:TaxCurrencyCode, die Währung, in der der Verkäufer die Umsatzsteuer verbucht, kein Code der alphabetischen Liste nach ISO 4217 ist, die mit diesem Release festgelegt ist. Schreiben Sie den dreistelligen Code dieser Währung in Großbuchstaben: EUR im korrigierten Beispiel, wo das fehlerhafte HRK enthielt.

HRK war der Code der kroatischen Kuna, die 2023 durch den Euro ersetzt wurde, und steht nicht mehr auf der Liste. Die fehlerhafte Rechnung trug HRK außerdem als Währung ihres Umsatzsteuerbetrags in der Buchungswährung, sodass auch dieser Betrag abgelehnt wurde.

Was die Regel prüft

Die Regel liest cbc:TaxCurrencyCode und nichts anderes, und nur, wenn das Dokument das Element enthält. Es ist optional: Eine Rechnung, deren Umsatzsteuer in der Rechnungswährung verbucht wird, lässt es weg und wird hier nicht geprüft.

Der Code wird um Leerzeichen bereinigt und dann unter Beachtung der Groß- und Kleinschreibung nachgeschlagen. Im Versuch schlugen 978, der numerische ISO-Code des Euro, und das Wort EURO beide fehl. EUR mit umgebenden Leerzeichen bestand diese Regel, wurde aber von BR-53 gemeldet, weil die currencyID EUR am Umsatzsteuerbetrag nicht mehr mit dem Code in seiner geschriebenen Form übereinstimmte.

Die festgelegte Liste hat eine Lücke: STN, der aktuelle Code für den Dobra von São Tomé und Príncipe, fehlt, während das ältere STD noch enthalten ist. Im Versuch schlug STN an beiden Stellen an dieser Regel und an BR-CL-03 fehl; STD bestand den Prüfschritt EN 16931 und wurde am Betrag von PEPPOL-EN16931-CL007 abgelehnt, dessen Liste es genau umgekehrt hält.

Beurteilt wird nur der Code. Dass er sich von cbc:DocumentCurrencyCode unterscheidet, prüft PEPPOL-EN16931-R005, und dass es einen Umsatzsteuerbetrag in dieser Währung gibt, prüft BR-53.

Wie es in einer Integration dazu kommt

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

• Die Umsatzsteuer-Buchungswährung wird einmal in der Konfiguration festgelegt und enthält noch einen inzwischen zurückgezogenen Code, etwa HRK nach der Umstellung Kroatiens auf den Euro.
• Die Währung ist als numerischer ISO-Code gespeichert, 978 für den Euro, und wird unverändert übernommen.
• Ein Währungsname oder eine Abkürzung wie EURO wird dort eingetragen, wo der Code hingehört.
• Ein Formatierer schreibt Codes klein, oder der Wert wurde von Hand in Kleinbuchstaben erfasst.

So korrigieren Sie das Dokument

1. Ermitteln Sie die Währung, in der der Verkäufer seine Umsatzsteuer für diese Leistung verbucht; für einen Verkäufer, der die Umsatzsteuer in Euro meldet, ist das EUR.
2. Schreiben Sie ihren alphabetischen Code nach ISO 4217, drei Großbuchstaben ohne Leerzeichen, in cbc:TaxCurrencyCode.
3. Verwenden Sie denselben Code als currencyID des cbc:TaxAmount im zweiten cac:TaxTotal, dem ohne Aufschlüsselung, der den in diese Währung umgerechneten Umsatzsteuerbetrag angibt.
4. Wird die Umsatzsteuer doch in der Rechnungswährung verbucht, entfernen Sie stattdessen cbc:TaxCurrencyCode und den zweiten Steuerbetrag.
5. Prüfen Sie gespeicherte Währungseinstellungen, wenn ein Land seine Währung wechselt; ein Code, der bei der Konfiguration gültig war, kann später von der Liste fallen.

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: Umsatzsteuer-Buchungswährung und zugehöriger Umsatzsteuerbetrag lauten beide auf HRK

<cbc:DocumentCurrencyCode>GBP</cbc:DocumentCurrencyCode>
<cbc:TaxCurrencyCode>HRK</cbc:TaxCurrencyCode>
<!-- buyer reference, parties and the first tax total omitted from this fragment -->
<cac:TaxTotal>
  <cbc:TaxAmount currencyID="HRK">5.80</cbc:TaxAmount>
</cac:TaxTotal>

Ausschnitt der korrigierten Rechnung: EUR an beiden Stellen

<cbc:DocumentCurrencyCode>GBP</cbc:DocumentCurrencyCode>
<cbc:TaxCurrencyCode>EUR</cbc:TaxCurrencyCode>
<!-- buyer reference, parties and the first tax total omitted from this fragment -->
<cac:TaxTotal>
  <cbc:TaxAmount currencyID="EUR">5.80</cbc:TaxAmount>
</cac:TaxTotal>

Zwei Werte unterscheiden sich, HRK in der fehlerhaften Rechnung und EUR in der korrigierten: cbc:TaxCurrencyCode und die currencyID des Umsatzsteuerbetrags in dieser Währung. BR-CL-05 wird am Währungscode gemeldet. BR-CL-03 und PEPPOL-EN16931-CL007 werden am cbc:TaxAmount des zweiten cac:TaxTotal gemeldet, der denselben ungültigen Code als Währung trägt. Die Korrektur des Codes an beiden Stellen behebt alle drei Befunde.

Wo die Regel gilt

• Gilt für Invoice und CreditNote; im Versuch meldete eine Gutschrift mit HRK an beiden Stellen dieselben drei Regeln.
• Der Peppol-Prüfschritt prüft cbc:TaxCurrencyCode nicht gegen eine Währungsliste. Im Versuch, bei dem nur dieses Element auf HRK geändert war, meldete der Peppol-Prüfschritt PEPPOL-EN16931-R055, das keinen Umsatzsteuerbetrag in der Buchungswährung fand, und der Prüfschritt EN 16931 ergänzte diese Regel um BR-53.
• Die Liste ist derselbe Stand von ISO 4217, den BR-CL-03 und BR-CL-04 auf Beträge und auf die Rechnungswährung anwenden.

Verwandte Regeln

• BR-CL-03 prüft die currencyID jedes Betrags, auch des Umsatzsteuerbetrags in der Buchungswährung
• PEPPOL-EN16931-CL007 wiederholt die Prüfung der Betragswährung im Peppol-Prüfschritt, mit einer leicht abweichenden Liste
• BR-53 verlangt einen Umsatzsteuerbetrag in der Währung, die dieses Element nennt
• BR-CL-06 prüft den Code für das Abrechnungsdatum der Umsatzsteuer, eine weitere optionale Angabe zur Umsatzsteuer mit einer eigenen kurzen Codeliste
• Alle Regeln der Referenz ansehen
• Hintergrund (auf Englisch): Understanding EN 16931 validation errors

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-CL-05 (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.