Vai al contenuto principale

Riferimento

Esporta Markdown

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)

Pipeline interattiva

Fai clic su una fase per vedere cosa controlla, oppure digita l’ID di una regola per trovare la fase che la segnala.

Prova:

BR-23 regola di base EN 16931

Segnalata nella fase 2: Regole EN 16931.

Livello errore: il report raccomanda di rifiutare la fattura.

Fase 2 · Cosa controlla

  • I termini di business essenziali sono presenti (da BR-01 a BR-65).
  • I totali tornano e i campi collegati sono coerenti (BR-CO); codici e decimali sono validi (BR-CL, BR-DEC).
  • Ogni categoria IVA è coerente: S, Z, E, AE, K, G, O, L, M (BR-S, BR-Z, BR-AE, BR-IC …).

Codici di esempio

Correzione tipica

Ricalcola totali e IVA dalle righe e correggi la categoria IVA nei dati di origine.

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-23: regola di base EN 16931, fase «Regole EN 16931». Set di regole: validatore KoSIT 1.6.3 con la configurazione XRechnung del 31 ago 2026 (artefatti EN 16931 1.3.16), Peppol BIS Billing 3.0.21.

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

Azioni rapide

Valida XMLConverti fattura

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
BT-129 Quantità fatturata
BG-25 Riga di fattura

Strumenti di validazione

Validatore KoSIT ufficiale

Esegui il validatore ufficiale KoSIT con la configurazione XRechnung per controllare le regole EN 16931 e XRechnung.

Converti PDF in XRechnung

Individua gli errori di validazione durante la conversione e verifica ogni correzione.