# BR-CO-21 Lo sconto a livello di documento richiede un motivo o un codice motivo

Ogni sconto a livello di documento (BG-20) deve contenere un motivo dello sconto (BT-97) o un codice del motivo (BT-98), o entrambi.

## Descrizione del problema

> **ERRORE**: Regola di calcolo e coerenza EN 16931 (BR-CO)

## Contesto e significato

Questa regola EN 16931 richiede che ogni sconto a livello di documento sia motivato, con un testo o un codice, affinché l’acquirente possa capire e contabilizzare la detrazione. L’errore nasce spesso quando l’ERP esporta solo l’importo o la percentuale dello sconto senza descrizione, ad esempio uno sconto globale inserito come semplice importo.

## Soluzione

Per ogni sconto a livello di documento, aggiungi un motivo (BT-97) e/o un codice motivo (BT-98) della lista UNCL 5189: cbc:AllowanceChargeReason / cbc:AllowanceChargeReasonCode in UBL, ram:Reason / ram:ReasonCode in ram:SpecifiedTradeAllowanceCharge in CII.

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

## Esempi validi

- Sconto a livello di documento con BT-98 = 95 e BT-97 = "Sconto quantità"

## Esempi non validi

- Importo di sconto 10,00 senza BT-97 né BT-98

## Esempi di codice

### XML valido
```
<cac:AllowanceCharge>
  <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
  <cbc:AllowanceChargeReasonCode>95</cbc:AllowanceChargeReasonCode>
  <cbc:AllowanceChargeReason>Volume discount</cbc:AllowanceChargeReason>
  <cbc:Amount currencyID="EUR">10.00</cbc:Amount>
  <cac:TaxCategory>
    <cbc:ID>S</cbc:ID>
    <cbc:Percent>19</cbc:Percent>
    <cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
  </cac:TaxCategory>
</cac:AllowanceCharge>
```

### XML non valido
```
<cac:AllowanceCharge>
  <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
  <cbc:Amount currencyID="EUR">10.00</cbc:Amount>
  <cac:TaxCategory>
    <cbc:ID>S</cbc:ID>
    <cbc:Percent>19</cbc:Percent>
    <cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
  </cac:TaxCategory>
</cac:AllowanceCharge>
```

## Campi interessati

- [BG-20 Sconti a livello di documento](/resources/xrechnung/bt-92-document-level-allowance-amount)
- [BT-97 Motivo dello sconto a livello di documento](/resources/xrechnung/bt-97-document-level-allowance-reason)
- [BT-98 Codice del motivo dello sconto a livello di documento](/resources/xrechnung/bt-98-document-level-allowance-reason-code)

## Regole correlate

- [BR-CO-05](/resources/kosit-validator-errors/br-co-05-allowance-reason-code-match)
- [BR-CO-22](/resources/kosit-validator-errors/br-co-22-document-charge-reason-required)
- [BR-CO-23](/resources/kosit-validator-errors/br-co-23-line-allowance-reason-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.