# BR-23 Il codice unità di misura per la quantità fatturata deve essere specificato

Ai sensi della regola EN 16931 BR-23, ogni quantità fatturata in BT-129 deve essere corredata del codice unità di misura in BT-130 (@unitCode). Il codice deve appartenere all’elenco UN/ECE Raccomandazione 20 / 21 (es. "H87" per pezzo, "KGM" per chilogrammo, "HUR" per ora).

## Descrizione del problema

> **ERRORE**: Regola di business della norma EN 16931 (CEN)

## Contesto e significato

È una regola di base della norma EN 16931. Una quantità senza attributo unitCode viola BR-23; un attributo con codice vuoto o sconosciuto viola invece la regola di lista codici BR-CL-23. BR-23 compare di solito quando l’esportazione non ha una mappatura delle unità e scrive solo la quantità, mentre un’unità ERP come "pz" copiata in unitCode attiva BR-CL-23.

## Soluzione

Nel gestionale ERP verifica che a ogni quantità sia associato un codice unità UN/ECE valido. In UBL 2.1 compila l’attributo unitCode: <cbc:InvoicedQuantity unitCode="H87">10.00</cbc:InvoicedQuantity>. In CII compila l’attributo unitCode: <ram:BilledQuantity unitCode="H87">10.00</ram:BilledQuantity>.

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

## Esempi validi

- Riga di fattura con BT-129 = 10 e BT-130 = "H87" (10 pezzi)
- Riga di fattura con BT-129 = 40.5 e BT-130 = "HUR" (40,5 ore)

## Esempi non validi

- cac:InvoiceLine contiene quantità numerica ma omette l’attributo unitCode (<cbc:InvoicedQuantity>10</cbc:InvoicedQuantity>)
- Una riga di nota di credito con <cbc:CreditedQuantity>2</cbc:CreditedQuantity> senza attributo unitCode; un unitCode vuoto o sconosciuto fallisce invece sulla regola di lista codici BR-CL-23

## Esempi di codice

### XML valido
```
<cac:InvoiceLine>
  <cbc:ID>1</cbc:ID>
  <cbc:InvoicedQuantity unitCode="H87">10</cbc:InvoicedQuantity>
</cac:InvoiceLine>
```

### XML non valido
```
<cac:InvoiceLine>
  <cbc:ID>1</cbc:ID>
  <cbc:InvoicedQuantity>10</cbc:InvoicedQuantity>
</cac:InvoiceLine>
```

## Campi interessati

- [BT-130 Codice unità di misura della quantità fatturata](/resources/xrechnung/bt-130-invoice-line-quantity-unit-of-measure-code)
- [BT-129 Quantità fatturata](/resources/xrechnung/bt-129-invoice-line-quantity)
- [BG-25 Riga di fattura](/resources/xrechnung/bt-126-invoice-line-identifier)

## Regole correlate

- [BR-22](/resources/kosit-validator-errors/br-22-invoice-line-quantity-must-be-present)
- [BR-CL-23](/resources/kosit-validator-errors/br-cl-23-unece-rec20-unit-code)

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