What causes the BR-CO-22 error?

BR-CO-22 occurs when a document level charge (surcharge) exists but has no reason code (BT-105) or reason text (BT-104) explaining what the charge is for.

How do I fix BR-CO-22?

Add either AllowanceChargeReasonCode with a valid UNTDID 7161 code (e.g., AAA for Service charge, FC for Freight) or AllowanceChargeReason with descriptive text.

Is BR-CO-22 a critical error?

Yes, BR-CO-22 is a business rule violation that will cause invoice rejection. Buyers need to understand what charges they are being billed for.

Can BR-CO-22 be automatically fixed?

Yes! Invoice Navigator automatically adds the default reason code AAA (Service charge) when no reason is provided. This is a standard charge code from UNTDID 7161.

Error codes · EN 16931

BR-CO-22In your invoicing software

Document charge reason required

This is the rejection, word for word: „[BR-CO-22] Each Document level charge (BG-21) shall contain a Document level charge reason (BT-104) or a Document level charge reason code (BT-105), or both.“

When cac:AllowanceCharge with ChargeIndicator=true exists at document level, either cbc:AllowanceChargeReason (BT-104) or cbc:AllowanceChargeReasonCode (BT-105) must be provided.

What to have readyNothing. The file has to be re-exported from your invoicing software; we check it again afterwards.

What we doInvoice Navigator automatically fixes this issue by correcting the `cac:AllowanceCharge` element in your Invoice (BR-CO-22).

Choose the rejected invoiceor drop it here

XRechnung XML or ZUGFeRD PDF. Checking is free · corrected file €1.90 · the first every 30 days is free · no sign-up.

If you enter it yourself in your invoicing software

Before

<Invoice>
  <cac:AllowanceCharge>INVALID_CODE</cac:AllowanceCharge>
</Invoice>

After

<Invoice>
  <cac:AllowanceCharge>VALID_CODE</cac:AllowanceCharge>
</Invoice>

Element order is part of the rule: if the element sits in the wrong place, the validator rejects with BR-CO-22.

What the finding looks likeExample

FindingStructure invalid · BR-CO-22

Location//cac:AllowanceCharge[cbc:ChargeIndicator='true' and not(cbc:AllowanceChargeReason) and not(cbc:AllowanceChargeReasonCode)]/cbc:AllowanceChargeReasonCode

From youA re-exported file

ThenRe-export

ProofSHA-256 and /verify link after the check

Often appears together with

BR-CO-21Document allowance reason required