BR-CL-04:Invalid currency code
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.
This is a soft validation failure. The invoice may pass initial transmission, but non-compliant values in this field can cause problems during tax audits, buyer-side processing, or downstream VAT reconciliation.
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. The invoice may pass initial validation, but the non-compliant field can cause issues at the receiving end — tax authorities may flag it during audits, buyer ERP systems may fail to process it, or VAT reconciliation may produce mismatches. Fixing warnings before they accumulate prevents larger compliance gaps.
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.
See Also
Related Errors
Last updated: 27 February 2026
Handle BR-CL-04 Automatically in Your Pipeline
The compliance engine auto-remediates this error with controlled safety policies and evidence pack generation.