# BR-DE-22 Gömülü ek belge dosya adları tüm eklerde benzersiz olmalıdır

Alman XRechnung kuralı BR-DE-22 uyarınca, bir fatura belgesi aynı dosya adına sahip gömülü ekler içermemelidir (BT-125 / filename özniteliği). İkili ekler (cac:Attachment/cbc:EmbeddedDocumentBinaryObject veya ram:AttachmentBinaryObject) içeren birden fazla ek belge (BG-24) eklendiğinde, her dosya adı benzersiz olmalıdır. Yinelenen dosya adları, belge yönetim sistemlerinin zaman çizelgesi veya sözleşme gibi kanıtları üzerine yazmasına veya kaybetmesine neden olur.

## Sorun açıklaması

Alman XRechnung kuralı BR-DE-22 uyarınca, bir fatura belgesi aynı dosya adına sahip gömülü ekler içermemelidir (BT-125 / filename özniteliği). İkili ekler (cac:Attachment/cbc:EmbeddedDocumentBinaryObject veya ram:AttachmentBinaryObject) içeren birden fazla ek belge (BG-24) eklendiğinde, her dosya adı benzersiz olmalıdır. Yinelenen dosya adları, belge yönetim sistemlerinin zaman çizelgesi veya sözleşme gibi kanıtları üzerine yazmasına veya kaybetmesine neden olur.

> **HATA**: XRechnung 3.0

## Bağlam ve önem

Alman XRechnung doğrulayıcısı tüm gömülü ek dosya adlarını yinelenen değerlere karşı katı şekilde denetler ve iki veya daha fazla ek aynı adı paylaştığında BR-DE-22 hatası üretir.

## Çözüm

ERP veya doküman yönetim sisteminizde, XRechnung XML çıktısı almadan önce tüm ekli dosyaların benzersiz dosya adlarına sahip olduğundan emin olun. UBL 2.1 sözdiziminde <cac:AdditionalDocumentReference> içinde <cbc:EmbeddedDocumentBinaryObject filename="calisma_raporu_01.pdf" mimeCode="application/pdf"> şeklinde benzersiz filename öznitelikleri tanımlayın. CII sözdiziminde <ram:AdditionalReferencedDocument> altında benzersiz filename öznitelikleri kullanın. Aynı ada sahip ekleri göndermeden önce yeniden adlandırın.

- validate
- convert

## Geçerli örnekler

- İki eki olan fatura: "stundennachweis_januar.pdf" ve "leistungsabnahme_januar.pdf"
- Tek eki olan fatura: "vertrag_anlage_1.pdf"

## Geçersiz örnekler

- Fatura her ikisi de "anlage.pdf" olarak adlandırılmış iki ek içeriyor
- cac:AdditionalDocumentReference özdeş filename özniteliklerine sahip birden fazla ikili nesne içeriyor

## Kod örnekleri

### Geçerli XML
```
<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>
```

### Geçersiz XML
```
<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>
    <!-- Duplicate filename triggers BR-DE-22 -->
    <cbc:EmbeddedDocumentBinaryObject filename="anhang.pdf" mimeCode="application/pdf">UEsDBBQ...</cbc:EmbeddedDocumentBinaryObject>
  </cac:Attachment>
</cac:AdditionalDocumentReference>
```

## Etkilenen alanlar

- [BT-125 Ekli belge](/resources/xrechnung/bt-125-attached-document)
- [BG-24 Ek destekleyici belgeler](/resources/xrechnung)
- [BT-122 Destekleyici belge referansı](/resources/xrechnung/bt-122-supporting-document-reference)

## İlgili kurallar

- [BR-DE-23](#)
- [BR-52](/resources/kosit-validator-errors/br-52-supporting-document-reference-required)

## Doğrulama araçları

- [Resmi KoSIT doğrulayıcı](https://erechnungsvalidator.service-bw.de/): XRechnung dosyalarınızı tüm BR-DE kurallarına göre doğrulayın.
- [PDF’yi XRechnung’e dönüştür](/pdf-to-xrechnung): Dönüştürürken doğrulama hatalarını otomatik olarak düzeltir.

## İlgili kaynaklar

- [Resmi spesifikasyon](https://xeinkauf.de/xrechnung/)
- [Test paketi](https://github.com/itplr-kosit/xrechnung-testsuite)
- [Tam hata listesi](/resources/kosit-validator-errors): Tüm Alman XRechnung doğrulama kurallarına genel bakış.