Top Up Credits โ†’
InvoiceSpec / Rules Registry / peppol-bis-3 / BR-CL-20
fatal ASSERTION ยท BR-CL-20 Peppol BIS Billing 3.0 (UBL-2.1) Jurisdiction: EU

BR-CL-20: Coded charge reasons MUST belong to the UNCL 7161 code list

Official Peppol BIS Billing 3.0 Spec โ†—
01. Technical Specification & XPath Evaluation Context

Schematron rule BR-CL-20 (FATAL) enforces the EN 16931 / OpenPeppol assertion "Coded charge reasons MUST belong to the UNCL 7161 code list". During validation at context node `cac:AllowanceCharge[cbc:ChargeIndicator = true()]/cbc:AllowanceChargeReasonCode`, the XSLT/Schematron engine evaluates the XPath boolean expression `((not(contains(normalize-space(.), ' ')) and contains(' AA AAA AAC AAD AAE AAF AAH AAI AAS AAT AAV AAY AAZ ABA ABB ABC ABD ABF ABK ABL ABN ABR ABS ABT ABU ACF ACG ACH ACI ACJ ACK ACL ACM ACS ADC ADE ADJ ADK ADL ADM ADN ADO ADP ADQ ADR ADT ADW ADY ADZ AEA AEB AEC AED AEF AEH AEI AEJ AEK AEL AEM AEN AEO AEP AES AET AEU AEV AEW AEX AEY AEZ AJ AU CA CAB CAD CAE CAF CAI CAJ CAK CAL CAM CAN CAO CAP CAQ CAR CAS CAT CAU CAV CAW CAX CAY CAZ CD CG CS CT DAB DAD DAC DAF DAG DAH DAI DAJ DAK DAL DAM DAN DAO DAP DAQ DL EG EP ER FAA FAB FAC FC FH FI GAA HAA HD HH IAA IAB ID IF IR IS KO L1 LA LAA LAB LF MAE MI ML NAA OA PA PAA PC PL PRV RAB RAC RAD RAF RE RF RH RV SA SAA SAD SAE SAI SG SH SM SU TAB TAC TT TV V1 V2 WH XAA YY ZZZ ', concat(' ', normalize-space(.), ' '))))`. If this expression evaluates to false, the receiving Peppol Access Point or tax authority gateway rejects the UBL-2.1 document immediately.

Evaluated XPath Location:
cac:AllowanceCharge[cbc:ChargeIndicator = true()]/cbc:AllowanceChargeReasonCode
Deterministic Remediation Steps

1. Inspect the UBL 2.1 node at XPath `cac:AllowanceCharge[cbc:ChargeIndicator = true()]/cbc:AllowanceChargeReasonCode`. 2. Ensure the XML payload satisfies the Schematron assertion `((not(contains(normalize-space(.), ' ')) and contains(' AA AAA AAC AAD AAE AAF AAH AAI AAS AAT AAV AAY AAZ ABA ABB ABC ABD ABF ABK ABL ABN ABR ABS ABT ABU ACF ACG ACH ACI ACJ ACK ACL ACM ACS ADC ADE ADJ ADK ADL ADM ADN ADO ADP ADQ ADR ADT ADW ADY ADZ AEA AEB AEC AED AEF AEH AEI AEJ AEK AEL AEM AEN AEO AEP AES AET AEU AEV AEW AEX AEY AEZ AJ AU CA CAB CAD CAE CAF CAI CAJ CAK CAL CAM CAN CAO CAP CAQ CAR CAS CAT CAU CAV CAW CAX CAY CAZ CD CG CS CT DAB DAD DAC DAF DAG DAH DAI DAJ DAK DAL DAM DAN DAO DAP DAQ DL EG EP ER FAA FAB FAC FC FH FI GAA HAA HD HH IAA IAB ID IF IR IS KO L1 LA LAA LAB LF MAE MI ML NAA OA PA PAA PC PL PRV RAB RAC RAD RAF RE RF RH RV SA SAA SAD SAE SAI SG SH SM SU TAB TAC TT TV V1 V2 WH XAA YY ZZZ ', concat(' ', normalize-space(.), ' '))))` (Coded charge reasons MUST belong to the UNCL 7161 code list). 3. Validate that all required child tags, @currencyID / @schemeID attributes, and decimal totals match EN 16931-1 before dispatching to the Peppol network.

02. Side-by-Side UBL-2.1 Payload Diff (Rejected vs. Compliant)
--- a/invoice-rejected.xml (BR-CL-20) FAIL
1 <Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
2 xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
3 xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
4 <cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>
5 - <cbc:ID>INV-BR-CL-20-FAIL</cbc:ID>
6 - <!-- ERROR [BR-CL-20]: Coded charge reasons MUST belong to the UNCL 7161 code list -->
7 <!-- Evaluated at XPath: cac:AllowanceCharge[cbc:ChargeIndicator = true()]/cbc:AllowanceChargeReasonCode -->
8 <cac:AllowanceCharge>
9 <cbc:AllowanceChargeReasonCode></cbc:AllowanceChargeReasonCode>
10 </cac:AllowanceCharge>
11 </Invoice>
+++ b/invoice-compliant.xml (EN 16931 VALID)
PASS
1 <Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
2 xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
3 xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
4 <cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>
5 + <cbc:ID>INV-BR-CL-20-VALID</cbc:ID>
6 + <!-- COMPLIANT [BR-CL-20]: Satisfies cac:AllowanceCharge[cbc:ChargeIndicator = true()]/cbc:AllowanceChargeReasonCode -->
7 <cac:AllowanceCharge>
8 + <cbc:AllowanceChargeReasonCode>EN16931-VERIFIED-VALUE</cbc:AllowanceChargeReasonCode>
9 </cac:AllowanceCharge>
10 </Invoice>
03. Interactive Peppol BIS Billing 3.0 Validation & Auto-Fix Workbench
1 CREDITS
invoice.xmlUBL-2.1
DETECTED SOURCECustom ERP / Billing Engine
BT-131 LINE SUM0.00 EUR
BT-106 HEADER0.00 EUR
SCHEMATRON: PASS (0 FATAL)ยท 1ms
Peppol BIS Billing 3.0
BR-DE-15Buyer reference / Leitweg-ID (BT-10) is missing
Spec & Diff
xpath: /ubl:Invoice/cbc:BuyerReference

No <cbc:BuyerReference> (BT-10) found. Mandatory in XRechnung 3.0 (BR-DE-15) and required in Peppol BIS 3.0 (PEPPOL-EN16931-R003) when OrderReference is absent.

fix: Insert <cbc:BuyerReference>991-12849-74</cbc:BuyerReference> in the document header.

Automate Custom ERP / Billing Engine โ†’ Peppol BIS Billing 3.0 AP Delivery

Deploy certified Peppol Access Point & ZUGFeRD ERP connector

04. Adjacent Peppol BIS Billing 3.0 Assertions Browse All Rules โ†’