Skip to main content

Reference

Markdown export

BR-CL-04 Invoice currency code must use ISO 4217 alpha-3

The invoice currency code (BT-5) must be a three-letter code from ISO 4217 alpha-3.

Problem Description

ERROR

EN 16931 code-list rule (BR-CL)

Context and Significance

BT-5 sets the currency of all amounts on the invoice. The rule fails when the currency is copied from PDF text ("Euro", "€"), when an ERP exports an internal code such as "EURO", or when the code is lowercase ("eur"). A wrong BT-5 usually also breaks the currencyID attributes (BR-CL-03). Example: an invoice in Swiss francs uses BT-5 = CHF, not "SFr.".

Solution

Set BT-5 to a valid ISO 4217 alpha-3 code in capital letters, such as EUR (UBL: cbc:DocumentCurrencyCode; CII: ram:InvoiceCurrencyCode). Map the currency field of the ERP to the ISO code; do not use symbols, names or internal abbreviations.

Quick actions

Validate XMLConvert invoice

Valid Examples

  • BT-5 = EUR
  • BT-5 = CHF

Invalid Examples

  • BT-5 = EURO — internal code, not ISO 4217
  • BT-5 = Euro — currency name, not a code
  • BT-5 = eur — lowercase

Code Examples

Valid XML
<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
Invalid XML
<cbc:DocumentCurrencyCode>EURO</cbc:DocumentCurrencyCode>

Affected Fields

BT-5 Invoice currency code

Validation Tools

Official KoSIT Validator

Run the official KoSIT validator with the XRechnung configuration to check EN 16931 and XRechnung rules.

Convert PDF to XRechnung

Find validation errors during conversion and review each correction.