Home › Error code lexicon › BR-CO-22
BR-CO-22 Field BG-21 Calculation and consistency rules (BR-CO)

Fix BR-CO-22: Charge reason (BT-104/BT-105) missing

[BR-CO-22]-Each Document level charge (BG-21) shall contain a Document level charge reason (BT-104) or a Document level charge reas

BR-CO-22 in your own invoice? Upload the file and find every error in seconds.
Check invoice Get an API key

What does BR-CO-22 mean?

Every document level charge must carry a reason as text or as a code. That keeps the surcharge traceable.

Common causes of BR-CO-22

How to fix BR-CO-22

  1. Find the faulty spot in the XML. Open the XML of the invoice and go to field BG-21 along this XPath://ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator='true']
  2. Apply the fix. Every document level charge (BG-21) must contain a reason as text (BT-104, 'ram:Reason') or as a code (BT-105, 'ram:ReasonCode'). Add at least one of the two elements in the affected 'ram:SpecifiedTradeAllowanceCharge' with 'ram:ChargeIndicator' = true.
  3. Validate again. Save the file and validate it again to check that BR-CO-22 is no longer reported.
Concrete fix

Every document level charge (BG-21) must contain a reason as text (BT-104, 'ram:Reason') or as a code (BT-105, 'ram:ReasonCode'). Add at least one of the two elements in the affected 'ram:SpecifiedTradeAllowanceCharge' with 'ram:ChargeIndicator' = true.

XPath//ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator='true']

Before / after: the XML example

This is the spot in question before and after the fix (Cross Industry Invoice, ZUGFeRD/Factur-X).

Wrong 
<ram:SpecifiedTradeAllowanceCharge>
  <ram:ChargeIndicator><udt:Indicator>true</udt:Indicator></ram:ChargeIndicator>
  <ram:ActualAmount>25.00</ram:ActualAmount>
</ram:SpecifiedTradeAllowanceCharge>
Correct 
<ram:SpecifiedTradeAllowanceCharge>
  <ram:ChargeIndicator><udt:Indicator>true</udt:Indicator></ram:ChargeIndicator>
  <ram:ActualAmount>25.00</ram:ActualAmount>
  <ram:ReasonCode>FC</ram:ReasonCode>
  <ram:Reason>Frachtkosten</ram:Reason>
</ram:SpecifiedTradeAllowanceCharge>

Frequent questions about BR-CO-22

Which code list applies to the charge reason BT-105?
UNTDID 7161. Common codes are for example FC for freight costs or PC for packing. Alternatively a free-text reason in BT-104 ('ram:Reason') is enough.
Why does the check report BR-CO-22 although a reason text is present?
Usually the text sits in the wrong element or belongs to a different charge. Check that 'ram:Reason' or 'ram:ReasonCode' sits directly in the 'ram:SpecifiedTradeAllowanceCharge' with ChargeIndicator true.

Related error codes

BR-CO-10 Sum of invoice line net amounts does not add up BR-CO-13 Invoice total amount without VAT calculated wrongly BR-CO-3 VAT point date and VAT point date code exclude each other BR-CO-9 Seller VAT identifier without country prefix BR-CO-15 Invoice total amount with VAT (BT-112) does not add up BR-CO-16 Amount due for payment (BT-115) does not add up

Check BR-CO-22 automatically

Instead of digging through the XML by hand you can validate your ZUGFeRD or XRechnung file online – upload the PDF or the XML and you get every error with rule ID, affected field, fix and XPath, as a readable report or as JSON through the API.

Validate online now Back to the lexicon

Find every error automatically instead of searching by hand

Upload your ZUGFeRD, Factur-X or XRechnung file – you get every violation back with rule ID, field, fix and XPath.

Validate online for free
Check invoice