erroren16931

BR-CO-05:Allowance reason code and reason text mismatch

Document level allowance reason code (BT-98) and reason (BT-97) must indicate the same type of allowance. The coded reason and textual reason should describe the same discount type.

We can fix this automatically

AUTO-FIX

Auto-fix: Align the reason code with the reason text. Map common text patterns to standard UNTDID 5189 codes, or update text to match the code.

No manual changes needed
Upload and Fix Now

Why This Error Matters

Invoice may be rejected or require manual review. Inconsistent allowance information confuses accounting reconciliation and audit trails.

How to Fix It

1

Identify the mismatch

Check if AllowanceChargeReasonCode (BT-98) and AllowanceChargeReason (BT-97) describe the same type of discount

2

Choose the correct value

Decide which is correct - the code or the text description

3

Update to match

Either update the text to match the UNTDID 5189 code meaning, or change the code to match the text (e.g., code 95=Discount, 42=Other bonus, 100=Special rebate)

Technical Details

XPath: /Invoice/cac:AllowanceCharge[cbc:ChargeIndicator=false]/cbc:AllowanceChargeReasonCode and cbc:AllowanceChargeReason

Common Causes

  • Allowance reason code and text describe different discounts
  • ReasonCode says "42" (volume) but text says "early payment"
  • Mismatch between coded and textual allowance reason
  • Code updated but description not changed
  • Automated code assignment inconsistent with manual text

Frequently Asked Questions

BR-CO-05 occurs when the allowance reason code (BT-98) and reason text (BT-97) describe different types of discounts. For example, code 95 (Discount) with text "Freight rebate" is a mismatch.
Align the reason code with the reason text. Either update the text to match the UNTDID 5189 code meaning, or change the code to match your text. Invoice Navigator can help identify mismatches.
Yes, BR-CO-05 is a business rule violation that can cause invoice rejection. Inconsistent allowance information confuses accounting reconciliation.
Partially. Invoice Navigator can suggest corrections by mapping common text patterns to UNTDID 5189 codes, but review is recommended since the correct value depends on business context.

See Also

EN 16931 Validator

Check your invoice now

Related Errors

BR-CO-04

Invoice currency must be valid ISO 4217

BR-CO-06

Charge reason and code must match

Last updated: 17 January 2026

Share this guide: