BR-31: Betrag des Nachlasses auf Dokumentebene (BT-92) fehlt

Jeder Nachlass auf Dokumentebene (BG-20, cac:AllowanceCharge mit ChargeIndicator false in UBL, ram:SpecifiedTradeAllowanceCharge in der Kopfabrechnung in CII) muss seinen Betrag (BT-92) angeben. Unten: die Meldung, Ursache und Lösung, und eine von unserem Validator geprüfte Beispielrechnung.

Die Meldung des Validators

BR-31 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-31]-Each Document level allowance (BG-20) shall have a Document level allowance amount (BT-92).

Was die Regel prüft

Jeder Nachlass auf Dokumentebene (BG-20, cac:AllowanceCharge mit ChargeIndicator false in UBL, ram:SpecifiedTradeAllowanceCharge in der Kopfabrechnung in CII) muss seinen Betrag (BT-92) angeben.

Warum Rechnungen daran scheitern

Der Nachlass wird nur als Prozentsatz (BT-94) ohne berechneten Betrag geschrieben.

So beheben Sie den Fehler

Den Betrag berechnen (Basis × Prozentsatz / 100, auf zwei Stellen gerundet) und in BT-92 schreiben; Basis und Prozentsatz können zusätzlich stehen.

Eine fehlerhafte Rechnung und ihre Korrektur, geprüft

Ausgangspunkt ist unser Muster « allowance-and-charge », von unserer eigenen Erzeugung als EN 16931 in CII 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-31 und 2 weitere Regeln, wie es eine echte Datei mit diesem Fehler täte.

RegelSchwereStelleMeldung
BR-31Fehler/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge[1]/ram:ChargeIndicatorEach Document level allowance (BG-20) shall have a Document level allowance amount (BT-92).
BR-CO-11Fehler/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeSettlementHeaderMonetarySummationSum of allowances on document level (BT-107) = Σ Document level allowance amount (BT-92).
BR-S-08Fehler/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:ApplicableTradeTax[1]/ram:CategoryCodeFor each different value of VAT category rate (BT-119) where the VAT category code (BT-118) is "Standard rated", the VAT category taxable amount (BT-116) in a VAT breakdown (BG-23) shall equal the sum of Invoice line net amounts (BT-131) plus the sum of document level charge amounts (BT-99) minus the sum of document level allowance amounts (BT-92) where the VAT category code (BT-151, BT-102, BT-95) is "Standard rated" and the VAT rate (BT-152, BT-103, BT-96) equals the VAT category rate (BT-119).
CII: fehlerhaft (-) → korrigiert (+)
  …
          <ram:CalculationPercent>3.00</ram:CalculationPercent>
          <ram:BasisAmount>1900.00</ram:BasisAmount>
+         <ram:ActualAmount>57.00</ram:ActualAmount>
          <ram:ReasonCode>95</ram:ReasonCode>
          <ram:Reason>Treuerabatt 3 %</ram:Reason>
  …

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: /ubl:Invoice/cac:AllowanceCharge[cbc:ChargeIndicator = false()] | /cn:CreditNote/cac:AllowanceCharge[cbc:ChargeIndicator = false()]
test:    exists(cbc:Amount)
CII · CEN EN 16931 validation artefacts (CII) 1.3.16 · assert · Fehler
context: //ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:ChargeIndicator[udt:Indicator='false']
test:    (../ram:ActualAmount)

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 (CII)
BR-31-failing.xml
<?xml version="1.0" encoding="UTF-8"?>
<rsm:CrossIndustryInvoice xmlns:rsm="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100" xmlns:ram="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100" xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100" xmlns:qdt="urn:un:unece:uncefact:data:standard:QualifiedDataType:100">
  <rsm:ExchangedDocumentContext>
    <ram:BusinessProcessSpecifiedDocumentContextParameter>
      <ram:ID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</ram:ID>
    </ram:BusinessProcessSpecifiedDocumentContextParameter>
    <ram:GuidelineSpecifiedDocumentContextParameter>
      <ram:ID>urn:cen.eu:en16931:2017</ram:ID>
    </ram:GuidelineSpecifiedDocumentContextParameter>
  </rsm:ExchangedDocumentContext>
  <rsm:ExchangedDocument>
    <ram:ID>2026-040</ram:ID>
    <ram:TypeCode>380</ram:TypeCode>
    <ram:IssueDateTime>
      <udt:DateTimeString format="102">20261020</udt:DateTimeString>
    </ram:IssueDateTime>
  </rsm:ExchangedDocument>
  <rsm:SupplyChainTradeTransaction>
    <ram:IncludedSupplyChainTradeLineItem>
      <ram:AssociatedDocumentLineDocument>
        <ram:LineID>1</ram:LineID>
      </ram:AssociatedDocumentLineDocument>
      <ram:SpecifiedTradeProduct>
        <ram:Name>Relaunch Website</ram:Name>
      </ram:SpecifiedTradeProduct>
      <ram:SpecifiedLineTradeAgreement>
        <ram:NetPriceProductTradePrice>
          <ram:ChargeAmount>95.00</ram:ChargeAmount>
        </ram:NetPriceProductTradePrice>
      </ram:SpecifiedLineTradeAgreement>
      <ram:SpecifiedLineTradeDelivery>
        <ram:BilledQuantity unitCode="HUR">20.00</ram:BilledQuantity>
      </ram:SpecifiedLineTradeDelivery>
      <ram:SpecifiedLineTradeSettlement>
        <ram:ApplicableTradeTax>
          <ram:TypeCode>VAT</ram:TypeCode>
          <ram:CategoryCode>S</ram:CategoryCode>
          <ram:RateApplicablePercent>19.00</ram:RateApplicablePercent>
        </ram:ApplicableTradeTax>
        <ram:SpecifiedTradeSettlementLineMonetarySummation>
          <ram:LineTotalAmount>1900.00</ram:LineTotalAmount>
        </ram:SpecifiedTradeSettlementLineMonetarySummation>
      </ram:SpecifiedLineTradeSettlement>
    </ram:IncludedSupplyChainTradeLineItem>
    <ram:IncludedSupplyChainTradeLineItem>
      <ram:AssociatedDocumentLineDocument>
        <ram:LineID>2</ram:LineID>
      </ram:AssociatedDocumentLineDocument>
      <ram:SpecifiedTradeProduct>
        <ram:Name>Fachbuch Barrierefreiheit</ram:Name>
      </ram:SpecifiedTradeProduct>
      <ram:SpecifiedLineTradeAgreement>
        <ram:NetPriceProductTradePrice>
          <ram:ChargeAmount>19.99</ram:ChargeAmount>
        </ram:NetPriceProductTradePrice>
      </ram:SpecifiedLineTradeAgreement>
      <ram:SpecifiedLineTradeDelivery>
        <ram:BilledQuantity unitCode="C62">10.00</ram:BilledQuantity>
      </ram:SpecifiedLineTradeDelivery>
      <ram:SpecifiedLineTradeSettlement>
        <ram:ApplicableTradeTax>
          <ram:TypeCode>VAT</ram:TypeCode>
          <ram:CategoryCode>S</ram:CategoryCode>
          <ram:RateApplicablePercent>7.00</ram:RateApplicablePercent>
        </ram:ApplicableTradeTax>
        <ram:SpecifiedTradeSettlementLineMonetarySummation>
          <ram:LineTotalAmount>199.90</ram:LineTotalAmount>
        </ram:SpecifiedTradeSettlementLineMonetarySummation>
      </ram:SpecifiedLineTradeSettlement>
    </ram:IncludedSupplyChainTradeLineItem>
    <ram:ApplicableHeaderTradeAgreement>
      <ram:BuyerReference>EK-2026-0345</ram:BuyerReference>
      <ram:SellerTradeParty>
        <ram:Name>Lena Hartmann — Webdesign</ram:Name>
        <ram:DefinedTradeContact>
          <ram:PersonName>Lena Hartmann</ram:PersonName>
          <ram:TelephoneUniversalCommunication>
            <ram:CompleteNumber>+49 30 1234567</ram:CompleteNumber>
          </ram:TelephoneUniversalCommunication>
          <ram:EmailURIUniversalCommunication>
            <ram:URIID>rechnung@hartmann-webdesign.example</ram:URIID>
          </ram:EmailURIUniversalCommunication>
        </ram:DefinedTradeContact>
        <ram:PostalTradeAddress>
          <ram:PostcodeCode>10969</ram:PostcodeCode>
          <ram:LineOne>Lindenstraße 14</ram:LineOne>
          <ram:CityName>Berlin</ram:CityName>
          <ram:CountryID>DE</ram:CountryID>
        </ram:PostalTradeAddress>
        <ram:URIUniversalCommunication>
          <ram:URIID schemeID="EM">rechnung@hartmann-webdesign.example</ram:URIID>
        </ram:URIUniversalCommunication>
        <ram:SpecifiedTaxRegistration>
          <ram:ID schemeID="VA">DE136695976</ram:ID>
        </ram:SpecifiedTaxRegistration>
      </ram:SellerTradeParty>
      <ram:BuyerTradeParty>
        <ram:Name>Mustermann Maschinenbau GmbH</ram:Name>
        <ram:DefinedTradeContact>
          <ram:EmailURIUniversalCommunication>
            <ram:URIID>buchhaltung@mustermann.example</ram:URIID>
          </ram:EmailURIUniversalCommunication>
        </ram:DefinedTradeContact>
        <ram:PostalTradeAddress>
          <ram:PostcodeCode>70565</ram:PostcodeCode>
          <ram:LineOne>Industrieweg 7</ram:LineOne>
          <ram:CityName>Stuttgart</ram:CityName>
          <ram:CountryID>DE</ram:CountryID>
        </ram:PostalTradeAddress>
        <ram:URIUniversalCommunication>
          <ram:URIID schemeID="EM">buchhaltung@mustermann.example</ram:URIID>
        </ram:URIUniversalCommunication>
      </ram:BuyerTradeParty>
    </ram:ApplicableHeaderTradeAgreement>
    <ram:ApplicableHeaderTradeDelivery>
      <ram:ActualDeliverySupplyChainEvent>
        <ram:OccurrenceDateTime>
          <udt:DateTimeString format="102">20261015</udt:DateTimeString>
        </ram:OccurrenceDateTime>
      </ram:ActualDeliverySupplyChainEvent>
    </ram:ApplicableHeaderTradeDelivery>
    <ram:ApplicableHeaderTradeSettlement>
      <ram:InvoiceCurrencyCode>EUR</ram:InvoiceCurrencyCode>
      <ram:SpecifiedTradeSettlementPaymentMeans>
        <ram:TypeCode>58</ram:TypeCode>
        <ram:PayeePartyCreditorFinancialAccount>
          <ram:IBANID>DE02120300000000202051</ram:IBANID>
        </ram:PayeePartyCreditorFinancialAccount>
      </ram:SpecifiedTradeSettlementPaymentMeans>
      <ram:ApplicableTradeTax>
        <ram:CalculatedAmount>354.90</ram:CalculatedAmount>
        <ram:TypeCode>VAT</ram:TypeCode>
        <ram:BasisAmount>1867.90</ram:BasisAmount>
        <ram:CategoryCode>S</ram:CategoryCode>
        <ram:RateApplicablePercent>19.00</ram:RateApplicablePercent>
      </ram:ApplicableTradeTax>
      <ram:ApplicableTradeTax>
        <ram:CalculatedAmount>13.29</ram:CalculatedAmount>
        <ram:TypeCode>VAT</ram:TypeCode>
        <ram:BasisAmount>189.90</ram:BasisAmount>
        <ram:CategoryCode>S</ram:CategoryCode>
        <ram:RateApplicablePercent>7.00</ram:RateApplicablePercent>
      </ram:ApplicableTradeTax>
      <ram:SpecifiedTradeAllowanceCharge>
        <ram:ChargeIndicator>
          <udt:Indicator>false</udt:Indicator>
        </ram:ChargeIndicator>
        <ram:CalculationPercent>3.00</ram:CalculationPercent>
        <ram:BasisAmount>1900.00</ram:BasisAmount>
        <ram:ReasonCode>95</ram:ReasonCode>
        <ram:Reason>Treuerabatt 3 %</ram:Reason>
        <ram:CategoryTradeTax>
          <ram:TypeCode>VAT</ram:TypeCode>
          <ram:CategoryCode>S</ram:CategoryCode>
          <ram:RateApplicablePercent>19.00</ram:RateApplicablePercent>
        </ram:CategoryTradeTax>
      </ram:SpecifiedTradeAllowanceCharge>
      <ram:SpecifiedTradeAllowanceCharge>
        <ram:ChargeIndicator>
          <udt:Indicator>false</udt:Indicator>
        </ram:ChargeIndicator>
        <ram:ActualAmount>10.00</ram:ActualAmount>
        <ram:Reason>Mengenrabatt Bücher</ram:Reason>
        <ram:CategoryTradeTax>
          <ram:TypeCode>VAT</ram:TypeCode>
          <ram:CategoryCode>S</ram:CategoryCode>
          <ram:RateApplicablePercent>7.00</ram:RateApplicablePercent>
        </ram:CategoryTradeTax>
      </ram:SpecifiedTradeAllowanceCharge>
      <ram:SpecifiedTradeAllowanceCharge>
        <ram:ChargeIndicator>
          <udt:Indicator>true</udt:Indicator>
        </ram:ChargeIndicator>
        <ram:ActualAmount>24.90</ram:ActualAmount>
        <ram:ReasonCode>FC</ram:ReasonCode>
        <ram:Reason>Versand</ram:Reason>
        <ram:CategoryTradeTax>
          <ram:TypeCode>VAT</ram:TypeCode>
          <ram:CategoryCode>S</ram:CategoryCode>
          <ram:RateApplicablePercent>19.00</ram:RateApplicablePercent>
        </ram:CategoryTradeTax>
      </ram:SpecifiedTradeAllowanceCharge>
      <ram:SpecifiedTradePaymentTerms>
        <ram:DueDateDateTime>
          <udt:DateTimeString format="102">20261103</udt:DateTimeString>
        </ram:DueDateDateTime>
      </ram:SpecifiedTradePaymentTerms>
      <ram:SpecifiedTradeSettlementHeaderMonetarySummation>
        <ram:LineTotalAmount>2099.90</ram:LineTotalAmount>
        <ram:ChargeTotalAmount>24.90</ram:ChargeTotalAmount>
        <ram:AllowanceTotalAmount>67.00</ram:AllowanceTotalAmount>
        <ram:TaxBasisTotalAmount>2057.80</ram:TaxBasisTotalAmount>
        <ram:TaxTotalAmount currencyID="EUR">368.19</ram:TaxTotalAmount>
        <ram:GrandTotalAmount>2425.99</ram:GrandTotalAmount>
        <ram:DuePayableAmount>2425.99</ram:DuePayableAmount>
      </ram:SpecifiedTradeSettlementHeaderMonetarySummation>
    </ram:ApplicableHeaderTradeSettlement>
  </rsm:SupplyChainTradeTransaction>
</rsm:CrossIndustryInvoice>

Sources