# BR-DE-22 I nomi file degli allegati incorporati devono essere univoci

In base alla regola tedesca XRechnung BR-DE-22, la fattura non deve contenere allegati incorporati con nomi file identici (BT-125 / attributo filename). Quando sono presenti più documenti di supporto (BG-24) con allegati binari (cac:Attachment/cbc:EmbeddedDocumentBinaryObject o ram:AttachmentBinaryObject), ciascun nome file deve essere univoco. Nomi duplicati causano sovrascritture nei sistemi documentali.

## Descrizione del problema

> **ERRORE**: Regola nazionale tedesca XRechnung (KoSIT, BR-DE) · XRechnung 3.0

> **Dove viene controllata BR-DE-22**
>
> 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-DE-22: regola XRechnung (Germania), fase «Regole nazionali (CIUS)».

## Contesto e significato

Il validatore tedesco XRechnung controlla rigorosamente i nomi dei file allegati incorporati e attiva l’errore BR-DE-22 in presenza di duplicati.

## Soluzione

Nel gestionale ERP o sistema documentale assicurati che tutti i file allegati abbiano nomi univoci prima dell’esportazione XML XRechnung. In UBL 2.1 compila attributi filename univoci in <cbc:EmbeddedDocumentBinaryObject filename="rapporto_ore_gennaio.pdf" mimeCode="application/pdf"> dentro <cac:AdditionalDocumentReference>. In CII compila attributi filename univoci sotto <ram:AdditionalReferencedDocument>.

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

## Esempi validi

- Fattura con due allegati: "rapporto_gennaio.pdf" e "verbale_collaudo_gennaio.pdf"
- Fattura con allegato singolo: "allegato_contratto_1.pdf"

## Esempi non validi

- La fattura include due allegati entrambi denominati "anlage.pdf"
- cac:AdditionalDocumentReference contiene più oggetti binari con attributi filename identici

## Esempi di codice

### XML valido
```
<cac:AdditionalDocumentReference>
  <cbc:ID>DOC-1</cbc:ID>
  <cac:Attachment>
    <cbc:EmbeddedDocumentBinaryObject filename="stundennachweis.pdf" mimeCode="application/pdf">UEsDBBQ...</cbc:EmbeddedDocumentBinaryObject>
  </cac:Attachment>
</cac:AdditionalDocumentReference>
<cac:AdditionalDocumentReference>
  <cbc:ID>DOC-2</cbc:ID>
  <cac:Attachment>
    <cbc:EmbeddedDocumentBinaryObject filename="leistungsnachweis.pdf" mimeCode="application/pdf">UEsDBBQ...</cbc:EmbeddedDocumentBinaryObject>
  </cac:Attachment>
</cac:AdditionalDocumentReference>
```

### XML non valido
```
<cac:AdditionalDocumentReference>
  <cbc:ID>DOC-1</cbc:ID>
  <cac:Attachment>
    <cbc:EmbeddedDocumentBinaryObject filename="anhang.pdf" mimeCode="application/pdf">UEsDBBQ...</cbc:EmbeddedDocumentBinaryObject>
  </cac:Attachment>
</cac:AdditionalDocumentReference>
<cac:AdditionalDocumentReference>
  <cbc:ID>DOC-2</cbc:ID>
  <cac:Attachment>
    <cbc:EmbeddedDocumentBinaryObject filename="anhang.pdf" mimeCode="application/pdf">UEsDBBQ...</cbc:EmbeddedDocumentBinaryObject>
  </cac:Attachment>
</cac:AdditionalDocumentReference>
```

## Campi interessati

- [BT-125 Documento allegato](/resources/xrechnung/bt-125-attached-document)
- [BG-24 Documenti di supporto aggiuntivi](/resources/xrechnung/bt-122-supporting-document-reference)
- [BT-122 Riferimento del documento di supporto](/resources/xrechnung/bt-122-supporting-document-reference)

## Regole correlate

- [BR-52](/resources/kosit-validator-errors/br-52-supporting-document-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://xeinkauf.de/xrechnung/)
- [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.