# BR-CL-04 Il codice valuta della fattura deve usare ISO 4217 alfa-3

Il codice valuta della fattura (BT-5) deve essere un codice di tre lettere da ISO 4217 alfa-3.

## Descrizione del problema

> **ERRORE**: Regola sulle liste di codici EN 16931 (BR-CL)

## Contesto e significato

BT-5 stabilisce la valuta di tutti gli importi della fattura. La regola fallisce quando la valuta è copiata dal testo del PDF ("Euro", "€"), quando l’ERP esporta un codice interno come "EURO" o quando il codice è in minuscolo ("eur"). Un BT-5 errato di solito invalida anche gli attributi currencyID (BR-CL-03). Esempio: una fattura in franchi svizzeri usa BT-5 = CHF, non "Fr.".

## Soluzione

Imposta BT-5 su un codice ISO 4217 alfa-3 valido in maiuscolo, come EUR (UBL: cbc:DocumentCurrencyCode; CII: ram:InvoiceCurrencyCode). Associa il campo valuta dell’ERP al codice ISO; non usare simboli, nomi o abbreviazioni interne.

- [Valida XML](/it/xrechnung-validator?source=resource&rule=BR-CL-04)
- [Converti fattura](/it/pdf-to-xrechnung?source=resource&rule=BR-CL-04)

## Esempi validi

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

## Esempi non validi

- BT-5 = EURO — codice interno, non ISO 4217
- BT-5 = Euro — nome valuta, non codice
- BT-5 = eur — minuscolo

## Esempi di codice

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

### XML non valido
```
<cbc:DocumentCurrencyCode>EURO</cbc:DocumentCurrencyCode>
```

## Campi interessati

- [BT-5 Codice valuta della fattura](/resources/xrechnung/bt-5-invoice-currency-code)

## Regole correlate

- [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)

## Strumenti di validazione

- [Validatore KoSIT ufficiale](https://github.com/itplr-kosit/validator): Esegui il validatore ufficiale KoSIT con la configurazione XRechnung per controllare le regole EN 16931 e XRechnung.
- [Converti PDF in XRechnung](/pdf-to-xrechnung): Individua gli errori di validazione durante la conversione e verifica ogni correzione.

## Risorse correlate

- [Specifiche ufficiali](https://docs.peppol.eu/poacc/billing/3.0/rules/ubl-tc434/)
- [Test suite](https://github.com/itplr-kosit/xrechnung-testsuite)
- [Tutti gli errori di validazione](/resources/kosit-validator-errors): Panoramica delle regole di validazione EN 16931, XRechnung e Peppol spiegate qui.
