BR-CL-19: Code des Nachlassgrunds nicht nach UNTDID 5189

Der Code des Grundes eines Nachlasses (BT-98 bzw. BT-140: cbc:AllowanceChargeReasonCode mit ChargeIndicator false, ram:ReasonCode eines Nachlasses) muss aus UNTDID 5189 stammen. Unten: die Meldung, Ursache und Lösung, und eine von unserem Validator geprüfte Beispielrechnung.

Die Meldung des Validators

BR-CL-19 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-CL-19]-Coded allowance reasons MUST belong to the UNCL 5189 code list

Was die Regel prüft

Der Code des Grundes eines Nachlasses (BT-98 bzw. BT-140: cbc:AllowanceChargeReasonCode mit ChargeIndicator false, ram:ReasonCode eines Nachlasses) muss aus UNTDID 5189 stammen.

Warum Rechnungen daran scheitern

Für einen Rabatt wird ein Zuschlagscode aus UNTDID 7161 (FC) oder ein freies Stichwort verwendet.

So beheben Sie den Fehler

Einen Code nach UNTDID 5189 verwenden (95 Rabatt, 100 Sonderrabatt …) oder nur den Text angeben.

Eine fehlerhafte Rechnung und ihre Korrektur, geprüft

Ausgangspunkt ist unser Muster « allowance-and-charge », 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-CL-19.

RegelSchwereStelleMeldung
BR-CL-19Fehler/ubl:Invoice/cac:AllowanceCharge[1]/cbc:AllowanceChargeReasonCodeCoded allowance reasons MUST belong to the UNCL 5189 code list
UBL: fehlerhaft (-) → korrigiert (+)
  …
    <cac:AllowanceCharge>
      <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
-     <cbc:AllowanceChargeReasonCode>FC</cbc:AllowanceChargeReasonCode>
+     <cbc:AllowanceChargeReasonCode>95</cbc:AllowanceChargeReasonCode>
      <cbc:AllowanceChargeReason>Treuerabatt 3 %</cbc:AllowanceChargeReason>
      <cbc:MultiplierFactorNumeric>3.00</cbc:MultiplierFactorNumeric>
  …

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:AllowanceCharge[cbc:ChargeIndicator = false()]/cbc:AllowanceChargeReasonCode
test:    ((not(contains(normalize-space(.), ' ')) and contains(' 41 42 60 62 63 64 65 66 67 68 70 71 88 95 100 102 103 104 105 ', concat(' ', normalize-space(.), ' '))))
CII · CEN EN 16931 validation artefacts (CII) 1.3.16 · assert · Fehler
context: ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator = false()]/ram:ReasonCode
test:    ((not(contains(normalize-space(.), ' ')) and contains(' 41 42 60 62 63 64 65 66 67 68 70 71 88 95 100 102 103 104 105 ', concat(' ', normalize-space(.), ' '))))

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-CL-19-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-040</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:AllowanceCharge>
    <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
    <cbc:AllowanceChargeReasonCode>FC</cbc:AllowanceChargeReasonCode>
    <cbc:AllowanceChargeReason>Treuerabatt 3 %</cbc:AllowanceChargeReason>
    <cbc:MultiplierFactorNumeric>3.00</cbc:MultiplierFactorNumeric>
    <cbc:Amount currencyID="EUR">57.00</cbc:Amount>
    <cbc:BaseAmount currencyID="EUR">1900.00</cbc:BaseAmount>
    <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:AllowanceCharge>
  <cac:AllowanceCharge>
    <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
    <cbc:AllowanceChargeReason>Mengenrabatt Bücher</cbc:AllowanceChargeReason>
    <cbc:Amount currencyID="EUR">10.00</cbc:Amount>
    <cac:TaxCategory>
      <cbc:ID>S</cbc:ID>
      <cbc:Percent>7.00</cbc:Percent>
      <cac:TaxScheme>
        <cbc:ID>VAT</cbc:ID>
      </cac:TaxScheme>
    </cac:TaxCategory>
  </cac:AllowanceCharge>
  <cac:AllowanceCharge>
    <cbc:ChargeIndicator>true</cbc:ChargeIndicator>
    <cbc:AllowanceChargeReasonCode>FC</cbc:AllowanceChargeReasonCode>
    <cbc:AllowanceChargeReason>Versand</cbc:AllowanceChargeReason>
    <cbc:Amount currencyID="EUR">24.90</cbc:Amount>
    <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:AllowanceCharge>
  <cac:TaxTotal>
    <cbc:TaxAmount currencyID="EUR">368.19</cbc:TaxAmount>
    <cac:TaxSubtotal>
      <cbc:TaxableAmount currencyID="EUR">1867.90</cbc:TaxableAmount>
      <cbc:TaxAmount currencyID="EUR">354.90</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:TaxSubtotal>
      <cbc:TaxableAmount currencyID="EUR">189.90</cbc:TaxableAmount>
      <cbc:TaxAmount currencyID="EUR">13.29</cbc:TaxAmount>
      <cac:TaxCategory>
        <cbc:ID>S</cbc:ID>
        <cbc:Percent>7.00</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:TaxCategory>
    </cac:TaxSubtotal>
  </cac:TaxTotal>
  <cac:LegalMonetaryTotal>
    <cbc:LineExtensionAmount currencyID="EUR">2099.90</cbc:LineExtensionAmount>
    <cbc:TaxExclusiveAmount currencyID="EUR">2057.80</cbc:TaxExclusiveAmount>
    <cbc:TaxInclusiveAmount currencyID="EUR">2425.99</cbc:TaxInclusiveAmount>
    <cbc:AllowanceTotalAmount currencyID="EUR">67.00</cbc:AllowanceTotalAmount>
    <cbc:ChargeTotalAmount currencyID="EUR">24.90</cbc:ChargeTotalAmount>
    <cbc:PayableAmount currencyID="EUR">2425.99</cbc:PayableAmount>
  </cac:LegalMonetaryTotal>
  <cac:InvoiceLine>
    <cbc:ID>1</cbc:ID>
    <cbc:InvoicedQuantity unitCode="HUR">20.00</cbc:InvoicedQuantity>
    <cbc:LineExtensionAmount currencyID="EUR">1900.00</cbc:LineExtensionAmount>
    <cac:Item>
      <cbc:Name>Relaunch Website</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">10.00</cbc:InvoicedQuantity>
    <cbc:LineExtensionAmount currencyID="EUR">199.90</cbc:LineExtensionAmount>
    <cac:Item>
      <cbc:Name>Fachbuch Barrierefreiheit</cbc:Name>
      <cac:ClassifiedTaxCategory>
        <cbc:ID>S</cbc:ID>
        <cbc:Percent>7.00</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:ClassifiedTaxCategory>
    </cac:Item>
    <cac:Price>
      <cbc:PriceAmount currencyID="EUR">19.99</cbc:PriceAmount>
    </cac:Price>
  </cac:InvoiceLine>
</ubl:Invoice>

Sources