errorcountryDEUPEPPOL_BIS

DE-R-022:Duplicate attachment filename. All attached documents in German invoices must have unique filenames (case-insensitive) i

Fix: Duplicate attachment filename. All attached documents in German invoices must have unique filenames (case-insensitive) in element BT-125.

Duplicate attachment filename. All attached documents in German invoices must have unique filenames (case-insensitive) in element BT-125.

Severity
Fatal
Rule set
PEPPOL_BIS
Country
DEU
Fix type
CONFIRM
Confidence
80%
Category
structural

Engine Classification

Requires user confirmation before application

What is DE-R-022?

DE-R-022 is a fatal validation rule defined in the PEPPOL_BIS specification (DEU national rules). It validates the CityName element under DeliveryLocation > Address in the UBL invoice XML.

When this rule fires, the invoice is rejected by Peppol access points and never reaches the buyer.

Target path: //cac:Delivery/cac:DeliveryLocation/cac:Address/cbc:CityName

Why This Error Matters

Invoice will be rejected by German XRechnung validators. German e-invoicing has specific format requirements for payment details, contact information, and attachments.

DE-R-022 is a hard failure — the invoice must be corrected and re-sent before it can reach the recipient.

Validator Behavior

  • ·Causes invoice rejection
  • ·Rejected by PEPPOL Access Points
  • ·Rejected by XRechnung endpoints
  • ·Error returned: DE-R-022
  • ·Specification: PEPPOL_BIS

How to Fix It

1.

Find the missing or empty field

Check cbc:CityName at //cac:Delivery/cac:DeliveryLocation/cac:Address/cbc:CityName. This field is required but is either missing or empty.

2.

Set the required value

Duplicate attachment filename. All attached documents in German invoices must have unique filenames (case-insensitive) in element BT-125.

3.

Re-validate your invoice

Upload the corrected invoice to confirm DE-R-022 is resolved.

XML Example

Generic example based on the rule's target XPath. Your actual XML structure may differ.

Before
<!-- Missing or empty element triggers cbc:CityName error -->
<cbc:CityName></cbc:CityName>
After
<!-- Provide the required value -->
<cbc:CityName>VALID_VALUE</cbc:CityName>

Technical Reference

XPath//cac:Delivery/cac:DeliveryLocation/cac:Address/cbc:CityName
SpecPEPPOL_BIS
Operationset_default
StrategyEnsure delivery city name is present when delivery section exists

Common Causes

  • ·Attached document filenames not unique
  • ·BT-125 contains duplicate filename (case insensitive)
  • ·Multiple attachments with same name in BG-24
  • ·cbc:EmbeddedDocumentBinaryObject/@filename duplicated
  • ·File naming collision in additional supporting documents

Seeing this in production? The API handles DE-R-022 automatically. See the fix response →

Frequently Asked Questions

Duplicate attachment filename. All attached documents in German invoices must have unique filenames (case-insensitive) in element BT-125.

Duplicate attachment filename. All attached documents in German invoices must have unique filenames (case-insensitive) in element BT-125. You can also use Invoice Navigator's compliance engine to correct this automatically in your pipeline.

Yes, DE-R-022 is a critical error that will cause invoice rejection. It must be fixed before submission.

Many instances of DE-R-022 can be automatically corrected using Invoice Navigator's compliance engine. The fix is applied in your pipeline with full audit evidence.

Related Content

Last updated: 14 April 2026

Share this guide:

Validate your invoice

Drop your XML here to check for DE-R-022

Fix DE-R-022 with one click

Upload your invoice and we'll suggest a fix for your review before applying it.