erroren16931

BR-57:Document allowance must have reason

Document level allowance must have reason code or text.

We can help you fix this

NEEDS INPUT

Requires user input: Two-letter ISO 3166-1 country code for delivery location. Could potentially derive from country name if present.

Simple form - we handle the XML for you
Upload and Answer Questions

Why This Error Matters

Invoice rejected. Delivery country is needed for logistics, customs, and tax determination.

How to Fix It

1

Locate document allowance

Find AllowanceCharge at document level

2

Add reason code

Common codes: 95 (discount), 100 (special agreement)

Technical Details

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

Common Causes

  • Delivery address missing country code
  • Delivery/DeliveryLocation/Address without country
  • Shipping address entered without country selection
  • Country stored as full name not ISO code
  • Domestic delivery assumed no country needed

Frequently Asked Questions

Document level allowance must have reason code or text.
Add AllowanceChargeReasonCode from UNCL5189 code list. You can also use Invoice Navigator's automatic Fixer tool to correct this instantly.
Yes, BR-57 is a critical error that will cause invoice rejection. It must be fixed before submission to ensure your invoice is accepted by the recipient's system.
Many instances of BR-57 can be automatically corrected using Invoice Navigator's Fixer tool. Upload your invoice and the tool will identify and fix common issues, including document allowance must have reason.

See Also

Related Errors

Last updated: 18 January 2026

Share this guide: