# BR-52 Il documento di supporto aggiuntivo deve avere un riferimento

Ogni documento di supporto aggiuntivo (BG-24) deve contenere un riferimento del documento di supporto (BT-122).

## Descrizione del problema

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

## Contesto e significato

È una regola di base della norma EN 16931. Il riferimento (BT-122) consente all’acquirente di collegare alla fattura un allegato o un link esterno, come foglio ore, documento di trasporto o estratto. BR-52 verifica che il riferimento non sia vuoto; in UBL un cbc:ID assente è già rifiutato dallo schema. L’errore compare quando un file viene allegato o collegato via URL ma viene esportata solo una descrizione o il nome del file.

## Soluzione

Compila cbc:ID in ogni cac:AdditionalDocumentReference (CII: ram:AdditionalReferencedDocument/ram:IssuerAssignedID) che contiene o riferisce un documento di supporto, ad esempio con il numero del foglio ore o del documento di trasporto.

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

## Esempi validi

- BT-122 = "TIMESHEET-2026-02" per un foglio ore allegato

## Esempi non validi

- cac:AdditionalDocumentReference con cbc:ID vuoto e una descrizione, oppure ram:AdditionalReferencedDocument CII senza ram:IssuerAssignedID; in UBL l’assenza di cbc:ID è già un errore di schema XML

## Esempi di codice

### XML valido
```
<cac:AdditionalDocumentReference>
  <cbc:ID>TIMESHEET-2026-02</cbc:ID>
  <cbc:DocumentDescription>Timesheet February 2026</cbc:DocumentDescription>
</cac:AdditionalDocumentReference>
```

### XML non valido
```
<cac:AdditionalDocumentReference>
  <cbc:ID></cbc:ID>
  <cbc:DocumentDescription>Timesheet February 2026</cbc:DocumentDescription>
</cac:AdditionalDocumentReference>
```

## Campi interessati

- [BT-122 Riferimento documento di supporto](/resources/xrechnung/bt-122-supporting-document-reference)

## Regole correlate

- [BR-55](/resources/kosit-validator-errors/br-55-preceding-invoice-reference-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.