BR-CL-20: Charge reason code not from UNCL 7161
Official message
[BR-CL-20] Coded charge reasons MUST belong to the UNCL 7161 code list
[BR-CL-20] Coded charge reasons MUST belong to the UNCL 7161 code list
- Severity
- Error The invoice is invalid and may be rejected by the recipient.
- Applies to
- EN 16931 (CII), EN 16931 (UBL)
What does this mean?
Coded charge reasons must belong to the UNCL 7161 code list, e.g. FC (freight service). This applies to document level charges (document level charge reason code, BT-105) and line level charges (invoice line charge reason code, BT-145). The value given is not in that list.
Only charges (ChargeIndicator true) are checked. Allowances use a different list (UNCL 5189, BR-CL-19).
Typical causes
An allowance code from UNCL 5189 (e.g. 95) was used for a charge.
Free text ("shipping", "postage") instead of the code.
The ChargeIndicator is wrong: an allowance was marked as charge.
How to fix the error
State the reason code with a code from UNCL 7161, or omit it and give the reason as text (BT-104 or BT-144).
Check whether ChargeIndicator matches the case (true for charge, false for allowance).
CII: ram:SpecifiedTradeAllowanceCharge/ram:ReasonCode, UBL: cac:AllowanceCharge/cbc:AllowanceChargeReasonCode.
Generate and validate the invoice again.
In E-Rechnungsfreund
In the invoice form, "Experte" view, section "Zu-/Abschläge auf Dokumentenebene (BG-20/BG-21)" (document level allowances and charges), choose "Zuschlag (BG-21)" (charge) as "Typ" and select an entry from the list in the field "Code", or leave "– –" and fill in "Begründung" (reason). For lines the same applies on the tab "Zu-/Abschläge (BG-27/28)" of the line.
Example
Wrong
<ram:SpecifiedTradeAllowanceCharge>
<ram:ChargeIndicator>
<udt:Indicator>true</udt:Indicator>
</ram:ChargeIndicator>
<ram:ActualAmount>5.90</ram:ActualAmount>
<ram:ReasonCode>95</ram:ReasonCode>
...
</ram:SpecifiedTradeAllowanceCharge>Correct
<ram:SpecifiedTradeAllowanceCharge>
<ram:ChargeIndicator>
<udt:Indicator>true</udt:Indicator>
</ram:ChargeIndicator>
<ram:ActualAmount>5.90</ram:ActualAmount>
<ram:ReasonCode>FC</ram:ReasonCode>
<ram:Reason>Freight</ram:Reason>
...
</ram:SpecifiedTradeAllowanceCharge>For developers: test expression per syntax
EN 16931 (CII) (CII)
Context: ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator = true()]/ram:ReasonCode
((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(.), ' '))))EN 16931 (UBL) (UBL)
Context: cac:AllowanceCharge[cbc:ChargeIndicator = true()]/cbc:AllowanceChargeReasonCode
((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(.), ' '))))Related validation rules
- BR-CL-01: Invoice type code (BT-3) not from UNTDID 1001
- BR-CL-03: Currency attribute currencyID not according to ISO 4217
- BR-CL-04: Invoice currency code (BT-5) not according to ISO 4217
- BR-CL-05: VAT accounting currency code (BT-6) not according to ISO 4217
- BR-CL-06: Value added tax point date code (BT-8) not permitted
- BR-CL-07: Object identifier scheme (BT-18-1, BT-128-1) not from UNTDID 1153
Last updated:
Explanation of the validation rule, not legal or tax advice.