What does BR-DE-22 mean?
Not all filename attributes of the embeddedDocumentBinaryObject elements are unique. This is a national KoSIT rule (XRechnung) that goes beyond EN 16931 and is mandatory for German e-invoices.
Common causes of BR-DE-22
- The element required by the German KoSIT rule is missing from the XML.
- The value appears only in the PDF, not in the structured data set.
- The entry was left empty.
How to fix BR-DE-22
- Find the faulty spot in the XML. Open the XML of the invoice and go to the spot in question along this XPath:
//ram:AdditionalReferencedDocument/ram:AttachmentBinaryObject/@filename - Apply the fix. Every embedded attachment (embeddedDocumentBinaryObject) needs a unique 'filename' — give each attachment a different file name.
- Validate again. Save the file and validate it again to check that BR-DE-22 is no longer reported.
Every embedded attachment (embeddedDocumentBinaryObject) needs a unique 'filename' — give each attachment a different file name.
//ram:AdditionalReferencedDocument/ram:AttachmentBinaryObject/@filenameFrequent questions about BR-DE-22
How do I fix BR-DE-22?
Related error codes
Check BR-DE-22 automatically
Instead of digging through the XML by hand you can validate your ZUGFeRD or XRechnung file online – upload the PDF or the XML and you get every error with rule ID, affected field, fix and XPath, as a readable report or as JSON through the API.