BR-58:Document charge must have reason
Fix: Add AllowanceChargeReasonCode from UNCL7161 code list. Provide the required value in the free validator.
Document level charge must have reason code or text.
Engine Classification
Business data required · Explicit input workflow · No assumptions made
Required input: Charge Reason Code, Charge Reason Description
What is BR-58?
BR-58 is a fatal validation rule defined in the en16931 specification. It validates the AllowanceCharge element under Invoice in the UBL invoice XML.
When this rule fires, the invoice is rejected by Peppol access points and never reaches the buyer.
Target path: XPath: /Invoice/cac:AllowanceCharge[cbc:ChargeIndicator=true]
Why This Error Matters
Charge reasons required for proper accounting and VAT treatment.
BR-58 is a hard failure — the invoice must be corrected and re-sent before it can reach the recipient.
Validator Behavior
- ·Causes invoice rejection
- ·Fails EN 16931 business rule validation
- ·Error returned: BR-58
- ·Specification: en16931
How to Fix It
Find document charge
ChargeIndicator=true at document level
Add reason code
Common codes: FC (freight), FI (financing)
XML Example
Generic example based on the rule's target XPath. Your actual XML structure may differ.
<!-- Required block is missing --> <!-- <cac:AllowanceCharge> ... </cac:AllowanceCharge> -->
<!-- Add the required block --> <cac:AllowanceCharge> <!-- child elements --> </cac:AllowanceCharge>
Technical Reference
XPath: /Invoice/cac:AllowanceCharge[cbc:ChargeIndicator=true]Common Causes
- ·Shipping charge without code
- ·Service fee missing reason
Seeing this in production? The API handles BR-58 automatically. See the fix response →
Frequently Asked Questions
Document level charge must have reason code or text.
Add AllowanceChargeReasonCode from UNCL7161 code list. Invoice Navigator detects this error and prompts for the required business data before applying a safe fix.
Yes, BR-58 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.
BR-58 requires specific business data to resolve. Invoice Navigator detects the error and guides you through providing the needed information, then applies the fix with full audit documentation.
Related Errors
Related Content
Last updated: 3 March 2026
Validate your invoice
Drop your XML here to check for BR-58
Fix BR-58 with guided input
Upload your invoice and we'll ask for the missing data, then apply a safe, auditable fix.