Zum Inhalt springen

Ironfang Finance - Regelreferenz

BR-DEC-06: Den Grundbetrag des Zuschlags auf Dokumentenebene mit höchstens zwei Nachkommastellen schreiben

Das cbc:BaseAmount eines Zuschlags auf Dokumentenebene hat mehr als zwei Nachkommastellen. Schreiben Sie den Betrag, auf den der Prozentsatz des Zuschlags angewendet wird, mit zwei.

EN 16931Fehler: Das Dokument ist ungültigNachlässe und Zuschläge

Auf dieser Seite

Die kurze Antwort

BR-DEC-06 schlägt fehl, wenn ein Zuschlag auf das Dokument, also ein cac:AllowanceCharge auf Wurzelebene mit cbc:ChargeIndicator gleich true, ein cbc:BaseAmount mit mehr als zwei Zeichen nach dem Dezimalpunkt trägt. Schreiben Sie den Grundbetrag mit höchstens zwei Nachkommastellen: 35.00 statt 35.000.

Der Zuschlagsbetrag daneben kann einwandfrei formatiert sein, und das Dokument scheitert trotzdem: In der aufgezeichneten Rechnung ist nur der Grundbetrag des Zuschlags von 10 Prozent aufgefüllt. UBL-DT-01 meldet dieses cbc:BaseAmount ebenfalls.

Was die Regel prüft

Für jeden Zuschlag auf Dokumentenebene liest die Regel cbc:BaseAmount als Text und erlaubt bis zu zwei Zeichen nach dem Dezimalpunkt. Eine Pauschalgebühr hat keinen Grundbetrag; es wird also nichts gezählt, und der Zuschlag besteht.

Diese Regel vergleicht den Grundbetrag nie mit etwas anderem. Im Versuch meldete ein Grundbetrag von 35.004 nur diese Regel und UBL-DT-01, denn 10 Prozent davon sind 3.5004, und PEPPOL-EN16931-R040 akzeptiert den Zuschlag von 3.50 innerhalb seines Spielraums von 0.02.

Welche Regel ein cbc:BaseAmount auf Dokumentenebene zählt, hängt vom Kennzeichen im selben cac:AllowanceCharge ab: true führt hierher, false zu BR-DEC-02. Grundbeträge von Nachlässen und Zuschlägen auf einer Position haben eigene Regeln.

BegriffBedeutungUBL-Element
BT-100Grundbetrag des Zuschlags auf Dokumentenebenecac:AllowanceCharge[cbc:ChargeIndicator = true]/cbc:BaseAmount

Wie es in einer Integration dazu kommt

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

  • Der Grundbetrag ist eine Zwischensumme von Positionen in der Genauigkeit der Einzelpreise, wird für die Berechnung des Aufschlags verwendet und so geschrieben, wie er gehalten wird.
  • Der Zuschlagsbetrag wird für die Summen gerundet, der Grundbetrag aber aus der Berechnung vor jeder Rundung übernommen.
  • Das Mapping schreibt jedes Geldfeld mit fest drei Nachkommastellen.

So korrigieren Sie das Dokument

  1. Runden Sie den Grundbetrag auf zwei Nachkommastellen, bevor Sie den Prozentsatz des Zuschlags darauf anwenden.
  2. Schreiben Sie ihn in cbc:BaseAmount im Zuschlag, mit höchstens zwei Nachkommastellen und ohne Leerzeichen.
  3. Prüfen Sie, dass cbc:Amount nach der Rundung weiterhin innerhalb von 0.02 von Grundbetrag mal Prozentsatz durch 100 liegt, wie PEPPOL-EN16931-R040 es verlangt.
  4. Lassen Sie bei einem pauschalen Zuschlag Grundbetrag und Prozentsatz zusammen weg; Peppol akzeptiert keines von beiden ohne das andere.

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: Beim Zuschlag von 10 Prozent ist der Grundbetrag als 35.000 geschrieben

<cac:AllowanceCharge>
  <cbc:ChargeIndicator>true</cbc:ChargeIndicator>
  <cbc:AllowanceChargeReasonCode>CG</cbc:AllowanceChargeReasonCode>
  <cbc:AllowanceChargeReason>Example document charge</cbc:AllowanceChargeReason>
  <cbc:MultiplierFactorNumeric>10</cbc:MultiplierFactorNumeric>
  <cbc:Amount currencyID="GBP">3.50</cbc:Amount>
  <cbc:BaseAmount currencyID="GBP">35.000</cbc:BaseAmount>
  <!-- tax category omitted from this fragment -->
</cac:AllowanceCharge>

Ausschnitt der korrigierten Rechnung: derselbe Grundbetrag als 35.00 geschrieben

<cac:AllowanceCharge>
  <cbc:ChargeIndicator>true</cbc:ChargeIndicator>
  <cbc:AllowanceChargeReasonCode>CG</cbc:AllowanceChargeReasonCode>
  <cbc:AllowanceChargeReason>Example document charge</cbc:AllowanceChargeReason>
  <cbc:MultiplierFactorNumeric>10</cbc:MultiplierFactorNumeric>
  <cbc:Amount currencyID="GBP">3.50</cbc:Amount>
  <cbc:BaseAmount currencyID="GBP">35.00</cbc:BaseAmount>
  <!-- tax category omitted from this fragment -->
</cac:AllowanceCharge>

Nur der Grundbetrag des Zuschlags auf Dokumentenebene ändert sich: 35.000 in der fehlerhaften Rechnung, 35.00 in der korrigierten, also derselbe Wert. Der Zuschlag von 3.50 ist 10 Prozent von beiden, daher ist nichts anderes betroffen. Das fehlerhafte Dokument meldet BR-DEC-06 am Zuschlag, dem zweiten cac:AllowanceCharge, und UBL-DT-01 an dessen cbc:BaseAmount. UBL-DT-01 begrenzt alle Betragselemente auf zwei Nachkommastellen und verschont nur Artikelpreise und die Beträge eines Nachlasses auf den Preis; der Grundbetrag eines Zuschlags ist keines davon, daher schlägt diese Regel nie ohne jene fehl.

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. Im Versuch meldete eine Gutschrift, deren Zuschlag auf Dokumentenebene einen Grundbetrag von 35.000 hat, dieselben zwei Befunde.
  • Die Zählung beachtet die Währung nicht, denn currencyID wird nicht gelesen.
  • Ein Grundbetrag an einem Zuschlag muss mit einem Prozentsatz kommen und umgekehrt; in einem Dokument, das Peppol besteht, trifft diese Regel daher nur auf prozentuale Zuschläge. PEPPOL-EN16931-R041 und PEPPOL-EN16931-R042 erzwingen diese Paarung.

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-DEC-06 (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.