Zum Inhalt springen

Ironfang Finance - Regelreferenz

BR-53: Die Umsatzsteuersumme in der Umsatzsteuer-Buchungswährung ergänzen

Wenn cbc:TaxCurrencyCode angegeben ist, braucht das Dokument eine zweite Steuersumme, deren cbc:TaxAmount in dieser Währung angegeben ist.

EN 16931Fehler: Das Dokument ist ungültigUmsatzsteuerSummen

Auf dieser Seite

Die kurze Antwort

BR-53 schlägt fehl, wenn das Dokument in cbc:TaxCurrencyCode eine Umsatzsteuer-Buchungswährung angibt und kein cac:TaxTotal/cbc:TaxAmount diese Währung in seiner currencyID hat. Ergänzen Sie direkt unter der Wurzel ein zweites cac:TaxTotal, das nur ein cbc:TaxAmount enthält, mit currencyID gleich der Buchungswährung und der in sie umgerechneten Umsatzsteuersumme.

Bucht der Verkäufer die Umsatzsteuer in der Rechnungswährung, läuft die Korrektur andersherum: Entfernen Sie cbc:TaxCurrencyCode. Das Element ist optional und gehört nur in ein Dokument, dessen Umsatzsteuer in einer anderen Währung als der Ausstellungswährung gebucht werden muss.

Was die Regel prüft

Die Regel läuft einmal an der Dokumentwurzel. Für den dortigen cbc:TaxCurrencyCode sucht sie ein cbc:TaxAmount, das direktes Kindelement eines cac:TaxTotal ist und dessen currencyID derselbe Code ist. Steuerbeträge innerhalb eines cac:TaxSubtotal zählen nicht, und die Reihenfolge der Steuersummen spielt keine Rolle.

Ein Dokument ohne cbc:TaxCurrencyCode gibt der Regel nichts zu suchen, daher besteht es.

Abgeglichen wird nur die Währung. Der Betrag wird nicht untersucht: Keine Regel rechnet die Umsatzsteuersumme der Rechnung um oder prüft einen Wechselkurs, und im Versuch bestand eine Summe in der Buchungswährung von 0.00 neben 5.00 Umsatzsteuer in der Rechnungswährung jeden Prüfschritt.

Der Code und die currencyID werden exakt so abgeglichen, wie sie geschrieben sind. Im Versuch meldete ein cbc:TaxCurrencyCode mit Leerzeichen um EUR, neben einer korrekten Summe in EUR, diese Regel und sonst nichts. Ein kleingeschriebenes eur brachte zusätzlich BR-CL-05, die Regel zur Codeliste der Währungen, und PEPPOL-EN16931-R055.

BegriffBedeutungUBL-Element
BT-6Code für die Umsatzsteuer-Buchungswährungcbc:TaxCurrencyCode
BT-111Gesamtbetrag der Umsatzsteuer in der Buchungswährungcac:TaxTotal/cbc:TaxAmount (in the tax total without cac:TaxSubtotal, currencyID equal to BT-6)
BT-110Gesamtbetrag der Umsatzsteuercac:TaxTotal/cbc:TaxAmount (in the tax total that holds the VAT breakdown)

Wie es in einer Integration dazu kommt

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

  • Der Code der Buchungswährung wird bei jedem Dokument aus einer Unternehmenseinstellung gefüllt, während die umgerechnete Umsatzsteuersumme nur geschrieben wird, wenn tatsächlich umgerechnet wurde.
  • Der Serialisierer schreibt ein einziges cac:TaxTotal und hat keinen Platz für ein zweites, sodass der umgerechnete Wert verloren geht.
  • Der umgerechnete Betrag wird mit der Rechnungswährung oder einer anderen Währung in seiner currencyID geschrieben. Im Versuch mit der Rechnungswährung kam BR-CO-15 hinzu, weil diese Regel genau eine Umsatzsteuersumme in der Rechnungswährung erwartet.
  • Der Code wird kleingeschrieben oder mit Auffüllzeichen geschrieben, sodass er nicht mehr zur currencyID des Betrags passt.

So korrigieren Sie das Dokument

  1. Entscheiden Sie, ob das Dokument überhaupt eine Umsatzsteuer-Buchungswährung braucht. Bucht der Verkäufer die Umsatzsteuer in der Rechnungswährung, entfernen Sie cbc:TaxCurrencyCode und hören Sie hier auf.
  2. Andernfalls nehmen Sie die Umsatzsteuersumme der Rechnung, das cbc:TaxAmount des cac:TaxTotal mit der Aufschlüsselung, und rechnen Sie sie zu dem Kurs in die Buchungswährung um, den Ihre Umsatzsteuerbuchhaltung vorschreibt. Der Kurs ergibt sich aus Ihren Buchhaltungsregeln; der Validator prüft ihn nicht.
  3. Ergänzen Sie direkt unter der Wurzel ein zweites cac:TaxTotal, das nur cbc:TaxAmount enthält, mit currencyID gleich dem Wert von cbc:TaxCurrencyCode und dem umgerechneten Betrag, auf zwei Nachkommastellen gerundet. Eine dritte Nachkommastelle bringt UBL-DT-01. Geben Sie dieser Summe kein cac:TaxSubtotal: Die Aufschlüsselung bleibt in der Rechnungswährung.
  4. Schreiben Sie den Code und die currencyID als denselben großgeschriebenen Code nach ISO 4217 ohne Leerzeichen, und halten Sie den umgerechneten Betrag auf derselben Seite von null wie die Umsatzsteuersumme der Rechnung, was PEPPOL-EN16931-R055 prüft.

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: EUR ist als Buchungswährung angegeben, aber die einzige Steuersumme ist in GBP

<cbc:DocumentCurrencyCode>GBP</cbc:DocumentCurrencyCode>
<cbc:TaxCurrencyCode>EUR</cbc:TaxCurrencyCode>
<!-- buyer reference and parties omitted from this fragment -->
<cac:TaxTotal>
  <cbc:TaxAmount currencyID="GBP">5.00</cbc:TaxAmount>
  <!-- VAT breakdown omitted from this fragment -->
</cac:TaxTotal>
<cac:LegalMonetaryTotal>
  <!-- monetary totals omitted from this fragment -->
</cac:LegalMonetaryTotal>

Ausschnitt der korrigierten Rechnung: Eine zweite Steuersumme gibt die Umsatzsteuer in EUR an

<cbc:DocumentCurrencyCode>GBP</cbc:DocumentCurrencyCode>
<cbc:TaxCurrencyCode>EUR</cbc:TaxCurrencyCode>
<!-- buyer reference and parties omitted from this fragment -->
<cac:TaxTotal>
  <cbc:TaxAmount currencyID="GBP">5.00</cbc:TaxAmount>
  <!-- VAT breakdown omitted from this fragment -->
</cac:TaxTotal>
<cac:TaxTotal>
  <cbc:TaxAmount currencyID="EUR">5.80</cbc:TaxAmount>
</cac:TaxTotal>
<cac:LegalMonetaryTotal>
  <!-- monetary totals omitted from this fragment -->
</cac:LegalMonetaryTotal>

Die korrigierte Rechnung hat ein zweites cac:TaxTotal, das nur ein cbc:TaxAmount von 5.80 in EUR enthält; die fehlerhafte gibt EUR als Buchungswährung an und hat keinen Betrag darin. Zwei Peppol-Regeln melden dieselbe Lücke. PEPPOL-EN16931-R054 schlägt an, weil eine angegebene Buchungswährung genau eine Steuersumme ohne Aufschlüsselung braucht und es keine gibt. PEPPOL-EN16931-R055 schlägt an, weil diese Regel die Vorzeichen der beiden Umsatzsteuersummen vergleicht und die in EUR nicht findet. Das Wiederherstellen der Summe in EUR behebt alle drei Befunde. Der Wert 5.80 dient nur der Veranschaulichung: Nichts prüft ihn gegen die 5.00 in GBP.

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, die EUR angibt, aber keine Steuersumme in EUR hat, meldete im Versuch dieselben drei Regeln.
  • Wird vom Prüfschritt EN 16931 gemeldet. Der Peppol-Prüfschritt fügt für dieselbe Lücke PEPPOL-EN16931-R054 und PEPPOL-EN16931-R055 hinzu, und PEPPOL-EN16931-R005, wenn die angegebene Buchungswährung die Rechnungswährung ist.
  • Der Betrag in der Buchungswährung ist von der Peppol-Anforderung ausgenommen, dass jede currencyID der Rechnungswährung entspricht, weil er in einer Steuersumme ohne Aufschlüsselung steht. Eine Aufschlüsselung in der Buchungswährung wird nicht akzeptiert; dieser Fall ist unter PEPPOL-EN16931-R054 beschrieben.
  • Ein cbc:TaxCurrencyCode, der kein gültiger Code nach ISO 4217 ist, wird von BR-CL-05 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-24.1: Quelle geprüft am 2026-09-24, Erklärung zuletzt aktualisiert am 2026-09-24.

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