Rules / DE-R-022 · Markdown

Peppol BIS Billing 3.0 · rule

DE-R-022

Layer peppol·Checked against Peppol BIS Billing 3.0 2026.5

What does DE-R-022 mean? If both supplier and customer are located in Germany, attached documents provided with an invoice in "ADDITIONAL SUPPORTING DOCUMENTS" (BG-24) shall have a unique filename (non case-sensitive) within the element ″Attached document″ (BT-125).

Why did my invoice fail DE-R-022?

On domestic German invoices, every attached document in the ADDITIONAL SUPPORTING DOCUMENTS group (BG-24) must have a filename that is unique on the invoice, compared case-insensitively, within the Attached document element (BT-125). Duplicate filenames would make it impossible to reliably store or reference the individual attachments. In UBL the filename is the filename attribute of cac:AdditionalDocumentReference/cac:Attachment/cbc:EmbeddedDocumentBinaryObject.

Official rule text

If both supplier and customer are located in Germany, attached documents provided with an invoice in "ADDITIONAL SUPPORTING DOCUMENTS" (BG-24) shall have a unique filename (non case-sensitive) within the element ″Attached document″ (BT-125).

Common causes

• Two attachments both exported with a default name like document.pdf
• Filenames differing only in case (Anlage.PDF vs anlage.pdf), which still count as duplicates
• The same attachment accidentally embedded twice

How do I fix it?

<cac:AdditionalDocumentReference>
  <cbc:ID>Anlage-1</cbc:ID>
  <cac:Attachment>
    <cbc:EmbeddedDocumentBinaryObject mimeCode="application/pdf" filename="leistungsnachweis-2026-06.pdf">UjBsR09E...</cbc:EmbeddedDocumentBinaryObject>
  </cac:Attachment>
</cac:AdditionalDocumentReference>

Related rules

DE-R-001 · DE-R-002 · DE-R-003 · DE-R-004 · DE-R-005 · DE-R-006 · DE-R-007 · DE-R-008