BR-36: Betrag des Zuschlags auf Dokumentebene (BT-99) fehlt

Jeder Zuschlag auf Dokumentebene (BG-21, cac:AllowanceCharge mit ChargeIndicator true in UBL, ram:SpecifiedTradeAllowanceCharge mit Indikator true in CII) muss seinen Betrag (BT-99) angeben. Unten: die Meldung, Ursache und Lösung, und eine von unserem Validator geprüfte Beispielrechnung.

Die Meldung des Validators

BR-36 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-36]-Each Document level charge (BG-21) shall have a Document level charge amount (BT-99).

Was die Regel prüft

Jeder Zuschlag auf Dokumentebene (BG-21, cac:AllowanceCharge mit ChargeIndicator true in UBL, ram:SpecifiedTradeAllowanceCharge mit Indikator true in CII) muss seinen Betrag (BT-99) angeben.

Warum Rechnungen daran scheitern

Ein Zuschlag wird nur als Prozentsatz geschrieben.

So beheben Sie den Fehler

Den Betrag des Zuschlags berechnen und in BT-99 schreiben.

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-36 und 2 weitere Regeln, wie es eine echte Datei mit diesem Fehler täte.

RegelSchwereStelleMeldung
BR-36Fehler/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge[3]/ram:ChargeIndicatorEach Document level charge (BG-21) shall have a Document level charge amount (BT-99).
BR-CO-12Fehler/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeSettlementHeaderMonetarySummationSum of charges on document level (BT-108) = Σ Document level charge amount (BT-99).
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 (+)
  …
            <udt:Indicator>true</udt:Indicator>
          </ram:ChargeIndicator>
+         <ram:ActualAmount>24.90</ram:ActualAmount>
          <ram:ReasonCode>FC</ram:ReasonCode>
          <ram:Reason>Versand</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 = true()] | /cn:CreditNote/cac:AllowanceCharge[cbc:ChargeIndicator = true()]
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='true']
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-36-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:ActualAmount>57.00</ram:ActualAmount>
        <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: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