Zum Inhalt springen

Ironfang Finance - Regelreferenz

PEPPOL-EN16931-R005: Eine Umsatzsteuer-Buchungswährung entfernen, die die Rechnungswährung wiederholt

cbc:TaxCurrencyCode ist nur für Umsatzsteuer gedacht, die in einer anderen Währung als der Rechnungswährung verbucht wird. Lassen Sie es weg, wenn beide gleich wären.

Peppol BIS BillingFehler: Das Dokument ist ungültigUmsatzsteuerKernfelder

Auf dieser Seite

Die kurze Antwort

PEPPOL-EN16931-R005 schlägt fehl, wenn cbc:TaxCurrencyCode dieselbe Währung wie cbc:DocumentCurrencyCode nennt, und der Befund verweist auf cbc:TaxCurrencyCode. Wird die Umsatzsteuer in der Rechnungswährung verbucht, löschen Sie dieses Element; die Umsatzsteuersumme in der Rechnungswährung deckt das bereits ab.

Senden Sie cbc:TaxCurrencyCode nur, wenn der Verkäufer die Umsatzsteuer in einer anderen Währung verbuchen muss, und fügen Sie dann die Umsatzsteuersumme in dieser Währung als eigene Steuersumme hinzu.

Was die Regel prüft

Die Regel läuft für cbc:TaxCurrencyCode direkt unter der Wurzel, sofern vorhanden, und vergleicht dessen Text mit dem Text von cbc:DocumentCurrencyCode. Führende und nachgestellte Leerzeichen werden zuerst entfernt, daher schlägt ein aufgefülltes GBP gegenüber GBP trotzdem fehl; im Versuch wurde dieser aufgefüllte Code hier gemeldet.

Groß- und Kleinschreibung wird nicht angeglichen. Im Versuch meldete gbp auf einer GBP-Rechnung diese Regel nicht. Stattdessen meldete es BR-CL-05, weil gbp kein gültiger Währungscode ist, zusammen mit BR-53, PEPPOL-EN16931-R054 und PEPPOL-EN16931-R055, die alle keine Summe in der Buchungswährung fanden.

Fehlt cbc:TaxCurrencyCode, hat die Regel nichts zu prüfen. Sie beurteilt nie, ob die Buchungswährung für den Verkäufer die richtige ist, nur, dass sie sich von der Rechnungswährung unterscheidet.

BegriffBedeutungUBL-Element
BT-6Code für die Umsatzsteuer-Buchungswährungcbc:TaxCurrencyCode
BT-5Code für die Rechnungswährungcbc:DocumentCurrencyCode

Wie es in einer Integration dazu kommt

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

  • Der Export füllt cbc:TaxCurrencyCode bei jedem Dokument aus der Basiswährung des Unternehmens, auch bei Dokumenten, die in genau dieser Währung ausgestellt werden.
  • Die Zuordnung kopiert die Rechnungswährung in cbc:TaxCurrencyCode, weil beide Felder im Quellmodell als Währung bezeichnet sind.
  • Eine Vorlage für Rechnungen in Fremdwährung, die das Element braucht, wird für Inlandsrechnungen wiederverwendet.

So korrigieren Sie das Dokument

  1. Vergleichen Sie die Rechnungswährung mit der Währung, in der der Verkäufer die Umsatzsteuer verbucht.
  2. Sind sie gleich, entfernen Sie cbc:TaxCurrencyCode und jede zusätzliche cac:TaxTotal, die nur hinzugefügt wurde, um die Umsatzsteuer in dieser Währung zu tragen. Ohne den Code ist eine Steuersumme ohne Aufschlüsselung selbst ein Fehler nach PEPPOL-EN16931-R054.
  3. Unterscheiden sie sich, war der Code falsch und nicht überflüssig: Schreiben Sie die tatsächliche Buchungswährung und fügen Sie eine cac:TaxTotal hinzu, die nur cbc:TaxAmount in dieser Währung enthält, wie es BR-53 verlangt.
  4. Lassen Sie den Export anhand der beiden Währungseinstellungen entscheiden, ob das Element geschrieben wird, statt es auf jedes Dokument zu schreiben.

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: Eine GBP-Rechnung gibt GBP als Umsatzsteuer-Buchungswährung an

<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
<cbc:DocumentCurrencyCode>GBP</cbc:DocumentCurrencyCode>
<cbc:TaxCurrencyCode>GBP</cbc:TaxCurrencyCode>
<cbc:BuyerReference>BUYER-REF-001</cbc:BuyerReference>

Ausschnitt der korrigierten Rechnung: Die Umsatzsteuer-Buchungswährung ist weggelassen

<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
<cbc:DocumentCurrencyCode>GBP</cbc:DocumentCurrencyCode>
<cbc:BuyerReference>BUYER-REF-001</cbc:BuyerReference>

Die fehlerhafte Rechnung hat <cbc:TaxCurrencyCode>GBP</cbc:TaxCurrencyCode> nach ihrer Dokumentwährung GBP; die korrigierte hat kein solches Element und ist sonst identisch. Das fehlerhafte Dokument meldet außerdem PEPPOL-EN16931-R054, weil eine angegebene Buchungswährung genau eine Steuersumme ohne Aufschlüsselung verlangt und diese Rechnung keine hat. Das Entfernen des Codes behebt beide. Der Prüfschritt EN 16931 besteht: BR-53 findet die vorhandene GBP-Steuersumme, deren Währung dem angegebenen Code entspricht.

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 UBL Invoice und CreditNote. Eine Gutschrift mit cbc:TaxCurrencyCode GBP auf einem GBP-Dokument meldete im Versuch diese Regel und PEPPOL-EN16931-R054.
  • Wird nur im Peppol-Prüfschritt gemeldet; der Prüfschritt EN 16931 lässt das aufgezeichnete Beispiel bestehen.
  • Eine zweite Steuersumme in der Rechnungswährung hinzuzufügen ist kein Ausweg. Im Versuch behob das PEPPOL-EN16931-R054, ließ aber diese Regel bestehen und fügte BR-CO-15 hinzu, das genau eine Umsatzsteuersumme in der Rechnungswährung erwartet.
  • Ob cbc:DocumentCurrencyCode selbst ein gültiger Code ist, prüft BR-CL-04.

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 PEPPOL-EN16931-R005 (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.