# BR-31 L’importo dello sconto a livello documento è obbligatorio

Ogni sconto a livello documento (BG-20) deve avere un importo dello sconto a livello documento (BT-92).

## Descrizione del problema

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

## Contesto e significato

È una regola di base della norma EN 16931. Uno sconto a livello documento (BG-20) riduce il totale senza IVA (BT-109) e la base imponibile, quindi senza importo il destinatario non può ricalcolare i totali. Lo schema UBL richiede già cbc:Amount in cac:AllowanceCharge, perciò BR-31 compare soprattutto nelle fatture CII il cui sconto contiene solo una percentuale (ram:CalculationPercent) o un motivo, ad esempio quando è noto solo il tasso di sconto.

## Soluzione

Aggiungi cbc:Amount al cac:AllowanceCharge di livello documento con cbc:ChargeIndicator false (CII: ram:ActualAmount in ram:SpecifiedTradeAllowanceCharge). Se è nota solo la percentuale, calcola l’importo come importo base × percentuale ÷ 100.

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

## Esempi validi

- BT-92 = 20,00 su uno sconto a livello documento

## Esempi non validi

- Sconto CII a livello documento con motivo e percentuale ma senza ram:ActualAmount (BT-92); in UBL un cac:AllowanceCharge senza cbc:Amount è già un errore di schema XML

## Esempi di codice

### XML valido
```
<ram:SpecifiedTradeAllowanceCharge>
  <ram:ChargeIndicator>
    <udt:Indicator>false</udt:Indicator>
  </ram:ChargeIndicator>
  <ram:CalculationPercent>2.00</ram:CalculationPercent>
  <ram:BasisAmount>1000.00</ram:BasisAmount>
  <ram:ActualAmount>20.00</ram:ActualAmount>
  <ram:Reason>Loyalty discount</ram:Reason>
</ram:SpecifiedTradeAllowanceCharge>
```

### XML non valido
```
<ram:SpecifiedTradeAllowanceCharge>
  <ram:ChargeIndicator>
    <udt:Indicator>false</udt:Indicator>
  </ram:ChargeIndicator>
  <ram:CalculationPercent>2.00</ram:CalculationPercent>
  <ram:BasisAmount>1000.00</ram:BasisAmount>
  <ram:Reason>Loyalty discount</ram:Reason>
</ram:SpecifiedTradeAllowanceCharge>
```

## Campi interessati

- [BT-92 Importo dello sconto a livello documento](/resources/xrechnung/bt-92-document-level-allowance-amount)

## Regole correlate

- [BR-32](/resources/kosit-validator-errors/br-32-document-allowance-vat-category-required)
- [BR-33](/resources/kosit-validator-errors/br-33-document-allowance-reason-required)
- [BR-36](/resources/kosit-validator-errors/br-36-document-charge-amount-required)

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