Fix BR-CL-3: Currency of the amounts (@currencyID) not ISO 4217

BR-CL-3 in your own invoice? Upload the file and find every error in seconds.

What does BR-CL-3 mean?

Every monetary amount with a currency attribute must carry the currency as an ISO 4217 code (three letters). Names or symbols are not unambiguous and therefore not allowed.

Common causes of BR-CL-3

The attribute holds a currency name ('Euro') or symbol instead of the ISO code.
Lower case or a typo such as 'eur', or the four-letter 'EURO'.
An amount field carries a currency other than the invoice currency (BT-5).

How to fix BR-CL-3

Find the faulty spot in the XML. Open the XML of the invoice and go to field BT-5 along this XPath://ram:SpecifiedTradeSettlementHeaderMonetarySummation/ram:TaxTotalAmount/@currencyID
Apply the fix. Code the currency in the @currencyID attribute with an ISO 4217 alpha-3 code, e.g. 'EUR', 'USD', 'GBP', 'CHF', 'SEK'. Exactly three capital letters, no currency name, no symbol. The rule checks every amount field with @currencyID, such as TaxTotalAmount, GrandTotalAmount or DuePayableAmount.
Validate again. Save the file and validate it again to check that BR-CL-3 is no longer reported.

Concrete fix

Code the currency in the @currencyID attribute with an ISO 4217 alpha-3 code, e.g. 'EUR', 'USD', 'GBP', 'CHF', 'SEK'. Exactly three capital letters, no currency name, no symbol. The rule checks every amount field with @currencyID, such as TaxTotalAmount, GrandTotalAmount or DuePayableAmount.

XPath//ram:SpecifiedTradeSettlementHeaderMonetarySummation/ram:TaxTotalAmount/@currencyID

Before / after: the XML example

This is the spot in question before and after the fix (Cross Industry Invoice, ZUGFeRD/Factur-X).

Wrong

<ram:TaxTotalAmount currencyID="Euro">190.00</ram:TaxTotalAmount>

Correct

<ram:TaxTotalAmount currencyID="EUR">190.00</ram:TaxTotalAmount>

Frequent questions about BR-CL-3

On which elements must @currencyID appear?

On all amount fields that carry a currency, such as TaxTotalAmount, GrandTotalAmount or DuePayableAmount. Each needs the valid ISO code.

Is 'EURO' an acceptable value?

No. ISO 4217 alpha-3 has exactly three letters. 'EURO' has four and is invalid. The correct value is 'EUR'.

Related error codes

Check BR-CL-3 automatically

Instead of digging through the XML by hand you can validate your ZUGFeRD or XRechnung file online – upload the PDF or the XML and you get every error with rule ID, affected field, fix and XPath, as a readable report or as JSON through the API.

Validate online now Back to the lexicon