erroren16931
BR-CO-22:Document charge reason required
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.
We can fix this automatically
AUTO-FIXAuto-fix: Add default reason code "ABK" (Miscellaneous) when no reason is provided. This is a catch-all code from UNTDID 7161 that matches the "miscellaneous charge" text.
No manual changes needed
Upload and Fix NowWhy This Error Matters
Invoice rejected. Buyers must know what charges they're paying for.
How to Fix It
1
Add reason code
Add AllowanceChargeReasonCode (BT-105) with a valid UNTDID 7161 code like AAA (Service charge) or FC (Freight)
2
Or add reason text
Alternatively, add AllowanceChargeReason (BT-104) with descriptive text
3
Verify placement
Ensure reason is within the same AllowanceCharge element where ChargeIndicator=true
Technical Details
When cac:AllowanceCharge with ChargeIndicator=true exists at document level, either cbc:AllowanceChargeReason (BT-104) or cbc:AllowanceChargeReasonCode (BT-105) must be provided.Common Causes
- Document charge has no reason text or code
- AllowanceCharge (charge) missing both reason fields
- Surcharge added without explanation
- Template missing charge reason fields
- Generic charge applied without categorization
Frequently Asked Questions
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.
Add either AllowanceChargeReasonCode with a valid UNTDID 7161 code (e.g., AAA for Service charge, FC for Freight) or AllowanceChargeReason with descriptive text.
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.
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.
See Also
Related Errors
Last updated: 17 January 2026
Share this guide: