# BR-CL-03 Valuta-attribuut moet ISO 4217 alfa-3 gebruiken

Het currencyID-attribuut op bedragelementen moet een drieletterige code uit ISO 4217 alfa-3 zijn.

## Probleembeschrijving

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

## Context en betekenis

In UBL draagt elk bedragelement (bijv. cbc:LineExtensionAmount, cbc:TaxAmount of cbc:PayableAmount) een currencyID-attribuut; in CII alleen ram:TaxTotalAmount. De regel faalt wanneer een export het symbool "€", de naam "Euro", de numerieke ISO-code 978 of een kleingeschreven "eur" schrijft, want de controle is hoofdlettergevoelig. Voorbeeld: currencyID="EUR" is geldig, currencyID="€" niet.

## Oplossing

Zet in elk currencyID-attribuut een geldige ISO 4217 alfa-3-code in hoofdletters, zoals EUR, USD of CHF. Neem het attribuut over uit de factuurvalutacode (BT-5), niet uit weergavetekst.

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

## Geldige voorbeelden

- currencyID="EUR" op een regelbedrag
- currencyID="USD" op een btw-bedrag

## Ongeldige voorbeelden

- currencyID="€" — symbool in plaats van code
- currencyID="978" — numerieke ISO-code in plaats van lettercode
- currencyID="eur" — kleine letters

## Codevoorbeelden

### Geldig XML
```
<cbc:LineExtensionAmount currencyID="EUR">100.00</cbc:LineExtensionAmount>
```

### Ongeldig XML
```
<cbc:LineExtensionAmount currencyID="€">100.00</cbc:LineExtensionAmount>
```

## Betrokken velden

- [currencyID-attribuut op bedragelementen](/resources/xrechnung)

## Gerelateerde regels

- [BR-CL-04](/resources/kosit-validator-errors/br-cl-04-iso-4217-invoice-currency)
- [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.