# BR-CL-04 De factuurvalutacode moet ISO 4217 alfa-3 gebruiken

De factuurvalutacode (BT-5) moet een drieletterige code uit ISO 4217 alfa-3 zijn.

## Probleembeschrijving

> **FOUT**: Codelijstregel van EN 16931 (BR-CL)

## Context en betekenis

BT-5 bepaalt de valuta van alle bedragen op de factuur. De regel faalt wanneer de valuta uit pdf-tekst wordt overgenomen ("Euro", "€"), wanneer een ERP een interne code zoals "EURO" exporteert, of wanneer de code in kleine letters staat ("eur"). Een verkeerde BT-5 maakt meestal ook de currencyID-attributen ongeldig (BR-CL-03). Voorbeeld: een factuur in Zwitserse frank gebruikt BT-5 = CHF, niet "SFr.".

## Oplossing

Stel BT-5 in op een geldige ISO 4217 alfa-3-code in hoofdletters, zoals EUR (UBL: cbc:DocumentCurrencyCode; CII: ram:InvoiceCurrencyCode). Koppel het valutaveld van het ERP aan de ISO-code; gebruik geen symbolen, namen of interne afkortingen.

- [XML valideren](/nl/xrechnung-validator?source=resource&rule=BR-CL-04)
- [Factuur converteren](/nl/pdf-to-xrechnung?source=resource&rule=BR-CL-04)

## Geldige voorbeelden

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

## Ongeldige voorbeelden

- BT-5 = EURO — interne code, geen ISO 4217
- BT-5 = Euro — valutanaam, geen code
- BT-5 = eur — kleine letters

## Codevoorbeelden

### Geldig XML
```
<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
```

### Ongeldig XML
```
<cbc:DocumentCurrencyCode>EURO</cbc:DocumentCurrencyCode>
```

## Betrokken velden

- [BT-5 Factuurvalutacode](/resources/xrechnung/bt-5-invoice-currency-code)

## Gerelateerde regels

- [BR-CL-03](/resources/kosit-validator-errors/br-cl-03-iso-4217-currency-attribute)
- [BR-CL-05](/resources/kosit-validator-errors/br-cl-05-iso-4217-tax-currency)

## Validatietools

- [Officiële KoSIT-validator](https://github.com/itplr-kosit/validator): Draai de officiële KoSIT-validator met de XRechnung-configuratie om EN 16931- en XRechnung-regels te controleren.
- [PDF naar XRechnung converteren](/pdf-to-xrechnung): Vind validatiefouten tijdens de conversie en controleer elke correctie.

## Gerelateerde bronnen

- [Officiële specificatie](https://docs.peppol.eu/poacc/billing/3.0/rules/ubl-tc434/)
- [Testsuite](https://github.com/itplr-kosit/xrechnung-testsuite)
- [Alle validatiefouten](/resources/kosit-validator-errors): Overzicht van de hier uitgelegde validatieregels uit EN 16931, XRechnung en Peppol.