BR-DE-22: Dateinamen der Anhänge nicht eindeutig
Alle eingebetteten Anhänge (cbc:EmbeddedDocumentBinaryObject / ram:AttachmentBinaryObject) müssen verschiedene filename-Attribute haben, damit der Empfänger sie speichern kann, ohne einen durch einen anderen zu überschreiben. Unten: die Meldung, Ursache und Lösung, und eine von unserem Validator geprüfte Beispielrechnung.
- Spezifikation: Regeln der XRechnung 3.0, XRechnung 3.0.2 schematron 2.6.0
- Schwere: Fehler
- Gemeldet von
POST /einvoice/validateund unseren kostenlosen Prüfern, mit Verweis auf diese Seite
Die Meldung des Validators
BR-DE-22 ist eine Regel der Regeln der XRechnung 3.0 (xrechnung-schematron 2.6.0 (XRechnung 3.0.2)) für UBL und CII. Sie ist ein Fehler (fatal): ein Validator weist die Rechnung zurück.
[BR-DE-22] Das "filename"-Attribut aller "EmbeddedDocumentBinaryObject"-Elemente muss eindeutig sein[BR-DE-22] Not all filename attributes of the embeddedDocumentBinaryObject elements are uniqueWas die Regel prüft
Alle eingebetteten Anhänge (cbc:EmbeddedDocumentBinaryObject / ram:AttachmentBinaryObject) müssen verschiedene filename-Attribute haben, damit der Empfänger sie speichern kann, ohne einen durch einen anderen zu überschreiben.
Warum Rechnungen daran scheitern
Mehrere Anhänge werden mit demselben Namen erzeugt (« attachment.pdf », « Anlage.pdf »).
So beheben Sie den Fehler
Jedem Anhang einen eigenen Dateinamen geben, etwa mit laufender Nummer oder Belegkennung.
Eine fehlerhafte Rechnung und ihre Korrektur, geprüft
Ausgangspunkt ist unsere Musterrechnung (zwei Positionen zu 19 %, Berlin nach Stuttgart), von unserer eigenen Erzeugung als XRechnung 3.0 in UBL geschrieben. Die Änderung unten (mit - die fehlerhafte Fassung, mit + die korrigierte) lässt die Regel scheitern. Beide Fassungen liefen am 2026-11-17 durch unseren Validator (XML-Schema und die offiziellen Regeldateien, wie POST /einvoice/validate sie anwendet): die korrigierte ist gültig, die fehlerhafte meldet BR-DE-22.
| Regel | Schwere | Stelle | Meldung |
|---|---|---|---|
| BR-DE-22 | Fehler | /ubl:Invoice | Das "filename"-Attribut aller "EmbeddedDocumentBinaryObject"-Elemente muss eindeutig sein |
…
<cbc:DocumentDescription>Stundennachweis</cbc:DocumentDescription>
<cac:Attachment>
- <cbc:EmbeddedDocumentBinaryObject mimeCode="text/csv" filename="stunden-2026-10.csv">RGF0dW07U3R1bmRlbgoyMDI2LTEwLTAxOzgK</cbc:EmbeddedDocumentBinaryObject>
+ <cbc:EmbeddedDocumentBinaryObject mimeCode="text/csv" filename="stunden-2026-09.csv">RGF0dW07U3R1bmRlbgoyMDI2LTEwLTAxOzgK</cbc:EmbeddedDocumentBinaryObject>
</cac:Attachment>
</cac:AdditionalDocumentReference>
…Die Regel im Wortlaut
Wo die Regel ansetzt (context) und was gelten muss (test), unverändert aus XRechnung 3.0.2 schematron 2.6.0. Ein assert schlägt fehl, wenn sein Test falsch ist.
Wortlaut und Prüfung: © KoSIT, Apache-Lizenz 2.0. Zitiert ohne Änderung; die Erklärungen auf dieser Seite sind von Veriport.
context: /ubl:Invoice | /cn:CreditNote
test: count(cac:AdditionalDocumentReference) = count(cac:AdditionalDocumentReference[not(./cac:Attachment/cbc:EmbeddedDocumentBinaryObject/@filename = preceding-sibling::cac:AdditionalDocumentReference/cac:Attachment/cbc:EmbeddedDocumentBinaryObject/@filename)])context: /rsm:CrossIndustryInvoice
test: count(//ram:AdditionalReferencedDocument) = count(//ram:AdditionalReferencedDocument[not(./ram:AttachmentBinaryObject/@filename = preceding-sibling::ram:AdditionalReferencedDocument/ram:AttachmentBinaryObject/@filename)])Eigene Rechnung prüfen
Laden Sie Ihre XRechnung, ZUGFeRD- oder Peppol-Datei im kostenlosen XRechnung-Prüfer hoch: er wendet dieselben Regeldateien an und verlinkt bei jedem Befund die Seite der Regel. Für Ihre Software: POST /einvoice/validate (Referenz) liefert dieselbe Prüfung als JSON, jeder Befund mit dem Feld explanation, das auf diese Seiten zeigt (5 Aufrufe je Prüfung, ohne Schlüssel im Tageskontingent).
Die ganze fehlerhafte Rechnung (UBL)
<?xml version="1.0" encoding="UTF-8"?>
<ubl:Invoice xmlns:ubl="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2" xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2" xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0</cbc:CustomizationID>
<cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>
<cbc:ID>2026-017</cbc:ID>
<cbc:IssueDate>2026-10-20</cbc:IssueDate>
<cbc:DueDate>2026-11-03</cbc:DueDate>
<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
<cbc:BuyerReference>EK-2026-0345</cbc:BuyerReference>
<cac:AdditionalDocumentReference>
<cbc:ID>stunden-2026-10.csv</cbc:ID>
<cbc:DocumentDescription>Stundennachweis</cbc:DocumentDescription>
<cac:Attachment>
<cbc:EmbeddedDocumentBinaryObject mimeCode="text/csv" filename="stunden-2026-10.csv">RGF0dW07U3R1bmRlbgoyMDI2LTEwLTAxOzgK</cbc:EmbeddedDocumentBinaryObject>
</cac:Attachment>
</cac:AdditionalDocumentReference>
<cac:AdditionalDocumentReference>
<cbc:ID>stunden-2026-09</cbc:ID>
<cbc:DocumentDescription>Stundennachweis</cbc:DocumentDescription>
<cac:Attachment>
<cbc:EmbeddedDocumentBinaryObject mimeCode="text/csv" filename="stunden-2026-10.csv">RGF0dW07U3R1bmRlbgoyMDI2LTEwLTAxOzgK</cbc:EmbeddedDocumentBinaryObject>
</cac:Attachment>
</cac:AdditionalDocumentReference>
<cac:AccountingSupplierParty>
<cac:Party>
<cbc:EndpointID schemeID="EM">rechnung@hartmann-webdesign.example</cbc:EndpointID>
<cac:PostalAddress>
<cbc:StreetName>Lindenstraße 14</cbc:StreetName>
<cbc:CityName>Berlin</cbc:CityName>
<cbc:PostalZone>10969</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>DE</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>
<cac:PartyTaxScheme>
<cbc:CompanyID>DE136695976</cbc:CompanyID>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:PartyTaxScheme>
<cac:PartyLegalEntity>
<cbc:RegistrationName>Lena Hartmann — Webdesign</cbc:RegistrationName>
</cac:PartyLegalEntity>
<cac:Contact>
<cbc:Name>Lena Hartmann</cbc:Name>
<cbc:Telephone>+49 30 1234567</cbc:Telephone>
<cbc:ElectronicMail>rechnung@hartmann-webdesign.example</cbc:ElectronicMail>
</cac:Contact>
</cac:Party>
</cac:AccountingSupplierParty>
<cac:AccountingCustomerParty>
<cac:Party>
<cbc:EndpointID schemeID="EM">buchhaltung@mustermann.example</cbc:EndpointID>
<cac:PostalAddress>
<cbc:StreetName>Industrieweg 7</cbc:StreetName>
<cbc:CityName>Stuttgart</cbc:CityName>
<cbc:PostalZone>70565</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>DE</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>
<cac:PartyLegalEntity>
<cbc:RegistrationName>Mustermann Maschinenbau GmbH</cbc:RegistrationName>
</cac:PartyLegalEntity>
<cac:Contact>
<cbc:ElectronicMail>buchhaltung@mustermann.example</cbc:ElectronicMail>
</cac:Contact>
</cac:Party>
</cac:AccountingCustomerParty>
<cac:Delivery>
<cbc:ActualDeliveryDate>2026-10-15</cbc:ActualDeliveryDate>
</cac:Delivery>
<cac:PaymentMeans>
<cbc:PaymentMeansCode>58</cbc:PaymentMeansCode>
<cac:PayeeFinancialAccount>
<cbc:ID>DE02120300000000202051</cbc:ID>
</cac:PayeeFinancialAccount>
</cac:PaymentMeans>
<cac:TaxTotal>
<cbc:TaxAmount currencyID="EUR">457.60</cbc:TaxAmount>
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="EUR">2408.40</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="EUR">457.60</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>19.00</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:LegalMonetaryTotal>
<cbc:LineExtensionAmount currencyID="EUR">2408.40</cbc:LineExtensionAmount>
<cbc:TaxExclusiveAmount currencyID="EUR">2408.40</cbc:TaxExclusiveAmount>
<cbc:TaxInclusiveAmount currencyID="EUR">2866.00</cbc:TaxInclusiveAmount>
<cbc:PayableAmount currencyID="EUR">2866.00</cbc:PayableAmount>
</cac:LegalMonetaryTotal>
<cac:InvoiceLine>
<cbc:ID>1</cbc:ID>
<cbc:InvoicedQuantity unitCode="HUR">24.00</cbc:InvoicedQuantity>
<cbc:LineExtensionAmount currencyID="EUR">2280.00</cbc:LineExtensionAmount>
<cac:Item>
<cbc:Name>Relaunch Website, Konzeption und Umsetzung</cbc:Name>
<cac:ClassifiedTaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>19.00</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:ClassifiedTaxCategory>
</cac:Item>
<cac:Price>
<cbc:PriceAmount currencyID="EUR">95.00</cbc:PriceAmount>
</cac:Price>
</cac:InvoiceLine>
<cac:InvoiceLine>
<cbc:ID>2</cbc:ID>
<cbc:InvoicedQuantity unitCode="C62">1.00</cbc:InvoicedQuantity>
<cbc:LineExtensionAmount currencyID="EUR">128.40</cbc:LineExtensionAmount>
<cac:Item>
<cbc:Name>Lizenz Bildmaterial</cbc:Name>
<cac:ClassifiedTaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>19.00</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:ClassifiedTaxCategory>
</cac:Item>
<cac:Price>
<cbc:PriceAmount currencyID="EUR">128.40</cbc:PriceAmount>
</cac:Price>
</cac:InvoiceLine>
</ubl:Invoice>
Sources
- XRechnung — the German CIUS of EN 16931 (standard, versions and bundles; version 3.0.2 in force) — KoSIT (Koordinierungsstelle für IT-Standards), Bremen, consulted 2026-10-28
- Validator configuration XRechnung v2026-08-31 (XRechnung 3.0.2, CEN schematron 1.3.16, xrechnung-schematron 2.6.0) — KoSIT, consulted 2026-10-28
- XRechnung schematron (xrechnung-schematron) and the XRechnung validator configuration: licence, Apache License 2.0 (LICENSE files; NOTICE of the configuration: « Copyright 2020 Koordinierungsstelle für IT-Standards ») — KoSIT (Koordinierungsstelle für IT-Standards), Bremen, consulted 2026-11-17. Apache 2.0 permits redistribution with the licence and the notices kept. KoSIT’s LICENSE adds that the copyright in the EN 16931 standard lies with CEN. The rule library quotes the BR-DE-*, BR-DEX-* and BR-TMP-* messages unmodified, in KoSIT’s German.