# BR-CL-03 L’attributo valuta deve usare ISO 4217 alfa-3

L’attributo currencyID sugli elementi di importo 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)

> **Dove viene controllata BR-CL-03**
>
> Un validatore controlla una fattura elettronica per fasi. Prima il file deve essere XML ben formato e conforme allo schema UBL o CII (XSD). Poi si applicano le regole di business della EN 16931: regole di base BR, calcoli BR-CO, liste di codici BR-CL, decimali BR-DEC e regole per categoria IVA come BR-S. Seguono le regole nazionali o di rete selezionate da BT-24: BR-DE per XRechnung, PEPPOL-EN16931 per Peppol BIS Billing. Il report elenca ogni regola violata: un errore significa rifiuto, i soli avvisi significano comunque accettazione. BR-CL-03: regola di lista codici EN 16931, fase «Regole EN 16931».

## Contesto e significato

In UBL ogni elemento di importo (ad es. cbc:LineExtensionAmount, cbc:TaxAmount o cbc:PayableAmount) ha un attributo currencyID; in CII solo ram:TaxTotalAmount. La regola fallisce quando l’esportazione scrive il simbolo "€", il nome "Euro", il codice ISO numerico 978 o "eur" in minuscolo, perché il controllo distingue maiuscole e minuscole. Esempio: currencyID="EUR" è valido, currencyID="€" no.

## Soluzione

Inserisci in ogni attributo currencyID un codice ISO 4217 alfa-3 valido in maiuscolo, come EUR, USD o CHF. Genera l’attributo dal codice valuta della fattura (BT-5), non da un testo visualizzato.

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

## Esempi validi

- currencyID="EUR" su un importo di riga
- currencyID="USD" su un importo IVA

## Esempi non validi

- currencyID="€" — simbolo anziché codice
- currencyID="978" — codice ISO numerico anziché alfabetico
- currencyID="eur" — minuscolo

## Esempi di codice

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

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

## Campi interessati

- [Attributo currencyID sugli elementi di importo](/resources/xrechnung)

## Regole correlate

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

## 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.