# BR-CO-22 L’onere a livello di documento richiede un motivo o un codice motivo

Ogni onere a livello di documento (BG-21) deve contenere un motivo dell’onere (BT-104) o un codice del motivo (BT-105), 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 onere a livello di documento sia motivato, con un testo o un codice, affinché l’acquirente veda a cosa si riferisce l’importo aggiuntivo. L’errore nasce spesso quando spese di spedizione, imballaggio o gestione vengono esportate solo come importo.

## Soluzione

Per ogni onere a livello di documento, aggiungi un motivo (BT-104) e/o un codice motivo (BT-105) della lista UNCL 7161: 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-22)
- [Converti fattura](/it/pdf-to-xrechnung?source=resource&rule=BR-CO-22)

## Esempi validi

- Onere a livello di documento con BT-105 = FC e BT-104 = "Costo di trasporto"

## Esempi non validi

- Importo di onere 15,00 senza BT-104 né BT-105

## Esempi di codice

### XML valido
```
<cac:AllowanceCharge>
  <cbc:ChargeIndicator>true</cbc:ChargeIndicator>
  <cbc:AllowanceChargeReasonCode>FC</cbc:AllowanceChargeReasonCode>
  <cbc:AllowanceChargeReason>Freight charge</cbc:AllowanceChargeReason>
  <cbc:Amount currencyID="EUR">15.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>true</cbc:ChargeIndicator>
  <cbc:Amount currencyID="EUR">15.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-21 Oneri a livello di documento](/resources/xrechnung/bt-99-document-level-charge-amount)
- [BT-104 Motivo dell’onere a livello di documento](/resources/xrechnung/bt-104-document-level-charge-reason)
- [BT-105 Codice del motivo dell’onere a livello di documento](/resources/xrechnung/bt-105-document-level-charge-reason-code)

## Regole correlate

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