BR-DEC-18: Mehr als 2 Nachkommastellen in BT-115 (Zahlbetrag)

Das Feld « Zahlbetrag » (BT-115; cac:LegalMonetaryTotal/cbc:PayableAmount in UBL, ram:DuePayableAmount in CII) darf höchstens zwei Nachkommastellen haben. Unten: die Meldung, Ursache und Lösung, und eine von unserem Validator geprüfte Beispielrechnung.

Die Meldung des Validators

BR-DEC-18 ist eine Regel der Geschäftsregeln der EN 16931 (CEN-Validierungsartefakte 1.3.16) für UBL und CII. Sie ist ein Fehler (fatal): ein Validator weist die Rechnung zurück.

UBL und CII
[BR-DEC-18]-The allowed maximum number of decimals for the Amount due for payment (BT-115) is 2.

Was die Regel prüft

Das Feld « Zahlbetrag » (BT-115; cac:LegalMonetaryTotal/cbc:PayableAmount in UBL, ram:DuePayableAmount in CII) darf höchstens zwei Nachkommastellen haben. Beträge nach EN 16931 lauten auf Cent; nur Preise (BT-146, BT-148) und Mengen dürfen mehr Stellen tragen.

Warum Rechnungen daran scheitern

Der Zahlbetrag wird aus ungerundeten Summen abgeleitet.

So beheben Sie den Fehler

BT-115 vor dem Schreiben kaufmännisch auf zwei Stellen runden und alle davon abhängigen Summen aus dem gerundeten Wert berechnen.

Eine fehlerhafte Rechnung und ihre Korrektur, geprüft

Ausgangspunkt ist unsere Musterrechnung (zwei Positionen zu 19 %, Berlin nach Stuttgart), von unserer eigenen Erzeugung als EN 16931 in UBL geschrieben. Die Änderung unten (mit - die fehlerhafte Fassung, mit + die korrigierte) lässt die Regel scheitern. Beide Fassungen liefen am 2026-11-17 durch unseren Validator (XML-Schema und die offiziellen Regeldateien, wie POST /einvoice/validate sie anwendet): die korrigierte ist gültig, die fehlerhafte meldet BR-DEC-18 und 2 weitere Regeln, wie es eine echte Datei mit diesem Fehler täte.

RegelSchwereStelleMeldung
BR-CO-16Fehler/ubl:Invoice/cac:LegalMonetaryTotalAmount due for payment (BT-115) = Invoice total amount with VAT (BT-112) -Paid amount (BT-113) +Rounding amount (BT-114).
BR-DEC-18Fehler/ubl:Invoice/cac:LegalMonetaryTotalThe allowed maximum number of decimals for the Amount due for payment (BT-115) is 2.
UBL-DT-01Fehler/ubl:Invoice/cac:LegalMonetaryTotal/cbc:PayableAmountAmounts shall be decimal up to two fraction digits
UBL: fehlerhaft (-) → korrigiert (+)
  …
      <cbc:TaxExclusiveAmount currencyID="EUR">2408.40</cbc:TaxExclusiveAmount>
      <cbc:TaxInclusiveAmount currencyID="EUR">2866.00</cbc:TaxInclusiveAmount>
-     <cbc:PayableAmount currencyID="EUR">2866.004</cbc:PayableAmount>
+     <cbc:PayableAmount currencyID="EUR">2866.00</cbc:PayableAmount>
    </cac:LegalMonetaryTotal>
    <cac:InvoiceLine>
  …

Die Regel im Wortlaut

Wo die Regel ansetzt (context) und was gelten muss (test), unverändert aus CEN EN 16931 validation artefacts 1.3.16. Ein assert schlägt fehl, wenn sein Test falsch ist.

Wortlaut und Prüfung: © CEN/TC 434, EN-16931-Validierungsartefakte, EUPL 1.2. Zitiert ohne Änderung; die Erklärungen auf dieser Seite sind von Veriport.

UBL · CEN EN 16931 validation artefacts (UBL) 1.3.16 · assert · Fehler
context: cac:LegalMonetaryTotal
test:    string-length(substring-after(cbc:PayableAmount,'.'))<=2
CII · CEN EN 16931 validation artefacts (CII) 1.3.16 · assert · Fehler
context: //ram:SpecifiedTradeSettlementHeaderMonetarySummation
test:    string-length(substring-after(ram:DuePayableAmount,'.'))<=2

Eigene Rechnung prüfen

Laden Sie Ihre XRechnung, ZUGFeRD- oder Peppol-Datei im kostenlosen XRechnung-Prüfer hoch: er wendet dieselben Regeldateien an und verlinkt bei jedem Befund die Seite der Regel. Für Ihre Software: POST /einvoice/validate (Referenz) liefert dieselbe Prüfung als JSON, jeder Befund mit dem Feld explanation, das auf diese Seiten zeigt (5 Aufrufe je Prüfung, ohne Schlüssel im Tageskontingent).

Die ganze fehlerhafte Rechnung (UBL)
BR-DEC-18-failing.xml
<?xml version="1.0" encoding="UTF-8"?>
<ubl:Invoice xmlns:ubl="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2" xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2" xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
  <cbc:CustomizationID>urn:cen.eu:en16931:2017</cbc:CustomizationID>
  <cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>
  <cbc:ID>2026-017</cbc:ID>
  <cbc:IssueDate>2026-10-20</cbc:IssueDate>
  <cbc:DueDate>2026-11-03</cbc:DueDate>
  <cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
  <cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
  <cbc:BuyerReference>EK-2026-0345</cbc:BuyerReference>
  <cac:AccountingSupplierParty>
    <cac:Party>
      <cbc:EndpointID schemeID="EM">rechnung@hartmann-webdesign.example</cbc:EndpointID>
      <cac:PostalAddress>
        <cbc:StreetName>Lindenstraße 14</cbc:StreetName>
        <cbc:CityName>Berlin</cbc:CityName>
        <cbc:PostalZone>10969</cbc:PostalZone>
        <cac:Country>
          <cbc:IdentificationCode>DE</cbc:IdentificationCode>
        </cac:Country>
      </cac:PostalAddress>
      <cac:PartyTaxScheme>
        <cbc:CompanyID>DE136695976</cbc:CompanyID>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:PartyTaxScheme>
      <cac:PartyLegalEntity>
        <cbc:RegistrationName>Lena Hartmann — Webdesign</cbc:RegistrationName>
      </cac:PartyLegalEntity>
      <cac:Contact>
        <cbc:Name>Lena Hartmann</cbc:Name>
        <cbc:Telephone>+49 30 1234567</cbc:Telephone>
        <cbc:ElectronicMail>rechnung@hartmann-webdesign.example</cbc:ElectronicMail>
      </cac:Contact>
    </cac:Party>
  </cac:AccountingSupplierParty>
  <cac:AccountingCustomerParty>
    <cac:Party>
      <cbc:EndpointID schemeID="EM">buchhaltung@mustermann.example</cbc:EndpointID>
      <cac:PostalAddress>
        <cbc:StreetName>Industrieweg 7</cbc:StreetName>
        <cbc:CityName>Stuttgart</cbc:CityName>
        <cbc:PostalZone>70565</cbc:PostalZone>
        <cac:Country>
          <cbc:IdentificationCode>DE</cbc:IdentificationCode>
        </cac:Country>
      </cac:PostalAddress>
      <cac:PartyLegalEntity>
        <cbc:RegistrationName>Mustermann Maschinenbau GmbH</cbc:RegistrationName>
      </cac:PartyLegalEntity>
      <cac:Contact>
        <cbc:ElectronicMail>buchhaltung@mustermann.example</cbc:ElectronicMail>
      </cac:Contact>
    </cac:Party>
  </cac:AccountingCustomerParty>
  <cac:Delivery>
    <cbc:ActualDeliveryDate>2026-10-15</cbc:ActualDeliveryDate>
  </cac:Delivery>
  <cac:PaymentMeans>
    <cbc:PaymentMeansCode>58</cbc:PaymentMeansCode>
    <cac:PayeeFinancialAccount>
      <cbc:ID>DE02120300000000202051</cbc:ID>
    </cac:PayeeFinancialAccount>
  </cac:PaymentMeans>
  <cac:TaxTotal>
    <cbc:TaxAmount currencyID="EUR">457.60</cbc:TaxAmount>
    <cac:TaxSubtotal>
      <cbc:TaxableAmount currencyID="EUR">2408.40</cbc:TaxableAmount>
      <cbc:TaxAmount currencyID="EUR">457.60</cbc:TaxAmount>
      <cac:TaxCategory>
        <cbc:ID>S</cbc:ID>
        <cbc:Percent>19.00</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:TaxCategory>
    </cac:TaxSubtotal>
  </cac:TaxTotal>
  <cac:LegalMonetaryTotal>
    <cbc:LineExtensionAmount currencyID="EUR">2408.40</cbc:LineExtensionAmount>
    <cbc:TaxExclusiveAmount currencyID="EUR">2408.40</cbc:TaxExclusiveAmount>
    <cbc:TaxInclusiveAmount currencyID="EUR">2866.00</cbc:TaxInclusiveAmount>
    <cbc:PayableAmount currencyID="EUR">2866.004</cbc:PayableAmount>
  </cac:LegalMonetaryTotal>
  <cac:InvoiceLine>
    <cbc:ID>1</cbc:ID>
    <cbc:InvoicedQuantity unitCode="HUR">24.00</cbc:InvoicedQuantity>
    <cbc:LineExtensionAmount currencyID="EUR">2280.00</cbc:LineExtensionAmount>
    <cac:Item>
      <cbc:Name>Relaunch Website, Konzeption und Umsetzung</cbc:Name>
      <cac:ClassifiedTaxCategory>
        <cbc:ID>S</cbc:ID>
        <cbc:Percent>19.00</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:ClassifiedTaxCategory>
    </cac:Item>
    <cac:Price>
      <cbc:PriceAmount currencyID="EUR">95.00</cbc:PriceAmount>
    </cac:Price>
  </cac:InvoiceLine>
  <cac:InvoiceLine>
    <cbc:ID>2</cbc:ID>
    <cbc:InvoicedQuantity unitCode="C62">1.00</cbc:InvoicedQuantity>
    <cbc:LineExtensionAmount currencyID="EUR">128.40</cbc:LineExtensionAmount>
    <cac:Item>
      <cbc:Name>Lizenz Bildmaterial</cbc:Name>
      <cac:ClassifiedTaxCategory>
        <cbc:ID>S</cbc:ID>
        <cbc:Percent>19.00</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:ClassifiedTaxCategory>
    </cac:Item>
    <cac:Price>
      <cbc:PriceAmount currencyID="EUR">128.40</cbc:PriceAmount>
    </cac:Price>
  </cac:InvoiceLine>
</ubl:Invoice>

Sources