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

> **Dove viene controllata BR-52**
>
> 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-52: regola di base EN 16931, fase «Regole EN 16931».

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