BR-CL-04:Invalid currency code
Fix: Invoice Navigator automatically fixes this issue by correcting the `cbc:IdentificationCode` element in your Invoice. Upload your invoice to fix this automatically.
Currency code must be a valid ISO 4217 alpha-3 code (e.g., EUR, USD, GBP). Ensure you are using the three-letter currency code, not a currency symbol or name.
Engine Classification
Normalize currency code to uppercase ISO 4217
Confidence: 99% · Applied automatically in pipeline
What is BR-CL-04?
BR-CL-04 is a warning validation rule defined in the EN 16931 specification. It validates the DocumentCurrencyCode element in the UBL invoice XML.
The invoice may pass transmission, but this non-compliance can cause problems during tax audits or buyer-side processing.
Target path: /Invoice/cbc:DocumentCurrencyCode
Why This Error Matters
Invoice rejected. The main invoice currency must be a recognized code.
BR-CL-04 is a soft failure that can cause issues at the receiving end — tax audits, ERP processing, or VAT reconciliation mismatches.
Invalid currency codes prevent proper payment processing. If the currency is lowercase (e.g., "eur" instead of "EUR"), payment systems and banks may reject or misprocess the invoice.
Invoice Navigator can automatically correct this error in your pipeline. The fix is applied with full audit evidence, so your compliance trail remains intact.
Validator Behavior
- ·Generates validation warning
- ·Error returned: BR-CL-04
- ·Specification: EN 16931
How to Fix It
Check currency
DocumentCurrencyCode value
Use ISO code
3 uppercase letters
Before / After
<cbc:DocumentCurrencyCode>EURO</cbc:DocumentCurrencyCode>
<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
Technical Reference
/Invoice/cbc:DocumentCurrencyCodeCommon Causes
- ·Document currency code not from ISO 4217
- ·DocumentCurrencyCode contains invalid value
- ·Currency code lowercase instead of uppercase
- ·Numeric currency code used instead of alpha-3
- ·Obsolete currency code (e.g., DEM instead of EUR)
Seeing this in production? The API handles BR-CL-04 automatically. See the fix response →
Frequently Asked Questions
DocumentCurrencyCode must be valid ISO 4217.
Use 3-letter ISO 4217 code (EUR, USD, GBP, etc.). You can also use Invoice Navigator's automatic Fixer tool to correct this instantly.
Yes, BR-CL-04 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-CL-04 can be automatically corrected using Invoice Navigator's Fixer tool. Upload your invoice and the tool will identify and fix common issues, including invalid currency code.
Related Errors
Related Content
Last updated: 27 February 2026
Validate your invoice
Drop your XML here to check for BR-CL-04
Auto-fix BR-CL-04 in seconds
Upload your invoice and we fix this error automatically. Financial fields are never touched.