erroren16931
BR-57:Document allowance must have reason
Document level allowance must have reason code or text.
We can help you fix this
NEEDS INPUTRequires 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 QuestionsWhy 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: