UBL-DT-07: Jedem eingebetteten Anhang ein Attribut filename geben

Die kurze Antwort

UBL-DT-07 schlägt für jeden eingebetteten Anhang, ein cbc:EmbeddedDocumentBinaryObject, fehl, der kein Attribut filename hat. Ergänzen Sie neben seinem mimeCode den Namen, unter dem die Datei gespeichert werden soll, etwa filename="timesheet.pdf".

Das Schema lässt dies durch, weil UBL den Dateinamen optional macht, den MIME-Code dagegen verpflichtend. Die EN-16931-Syntaxbindung schließt diese Lücke, damit der Empfänger einen Namen hat, unter dem er die Datei speichern und öffnen kann.

Was die Regel prüft

Die Regel betrachtet jedes Element, dessen Name auf BinaryObject endet, daher wird jeder Anhang für sich geprüft. Im Versuch mit zwei rechnungsbegründenden Unterlagen ohne Dateinamen meldete sie zweimal, einmal an jedem cbc:EmbeddedDocumentBinaryObject.

Das Attribut muss nur vorhanden sein. Im Versuch bestanden filename="", ein Name aus drei Leerzeichen und ein Name ohne Endung, timesheet, alle Prüfschritte; der Dateiname wird also weder auf Inhalt noch auf Form geprüft.

Ein über eine Adresse angegebener Anhang zählt nicht. Im Versuch bestand eine rechnungsbegründende Unterlage, deren cac:Attachment nur cac:ExternalReference/cbc:URI enthielt, weil sie kein Binärobjekt enthält.

Wo der Anhang steht, spielt keine Rolle. Im Versuch meldete ein PDF, das ohne Dateinamen an eine Dokumentreferenz einer Rechnungsposition angehängt war, diese Regel auch dort, zusammen mit der Warnung UBL-CR-544, da Dateien nicht an eine Position gehören, und PEPPOL-EN16931-R101, da diese Referenz keinen Typcode 130 hatte.

Wie es in einer Integration dazu kommt

Mögliche Ursachen, abgeleitet aus der Form der Regel und nicht aus gemessener Nutzung:

• Der Anhang wird aus dem Dateiinhalt und seinem Inhaltstyp gebaut, und der ursprüngliche Dateiname wird nicht mitgeführt.
• Spontan erzeugte Anhänge, etwa ein gerenderter Stundenzettel, hatten nie einen Dateinamen, den man weitergeben könnte.
• Das Mapping schreibt filename nur, wenn ein Feld in der Dokumentablage gefüllt ist, und ältere Datensätze lassen es leer.

So korrigieren Sie das Dokument

1. Suchen Sie jeden in den Befunden genannten Anhang; für jeden Anhang ohne Namen gibt es einen Befund.
2. Ergänzen Sie ein Attribut filename mit dem Namen der Datei und einer Endung, die zum mimeCode passt, zum Beispiel .pdf für application/pdf.
3. Gibt es keinen ursprünglichen Namen, leiten Sie einen aus der Referenz der Unterlage ab, etwa TIMESHEET-001.pdf, statt einen leeren Wert zu schreiben, der die Regel erfüllt, aber niemandem hilft.
4. Machen Sie den Dateinamen in Ihrem Export zu einem Pflichtbestandteil jedes Anhangs, neben dem MIME-Code.

Korrigierte Rechnung prüfen

Vorher und nachher

Dies sind Ausschnitte, keine vollständigen Dokumente. Die vollständigen synthetischen Dokumente, aus denen sie stammen, sind unten verlinkt.

Ausschnitt der fehlerhaften Rechnung: Das PDF des Stundenzettels ist ohne Dateinamen angehängt

<cac:AdditionalDocumentReference>
  <cbc:ID>TIMESHEET-001</cbc:ID>
  <cbc:DocumentDescription>Timesheet</cbc:DocumentDescription>
  <cac:Attachment>
    <cbc:EmbeddedDocumentBinaryObject mimeCode="application/pdf">JVBERi0xLjQK</cbc:EmbeddedDocumentBinaryObject>
  </cac:Attachment>
</cac:AdditionalDocumentReference>

Ausschnitt der korrigierten Rechnung: derselbe Anhang mit dem Namen timesheet.pdf

<cac:AdditionalDocumentReference>
  <cbc:ID>TIMESHEET-001</cbc:ID>
  <cbc:DocumentDescription>Timesheet</cbc:DocumentDescription>
  <cac:Attachment>
    <cbc:EmbeddedDocumentBinaryObject mimeCode="application/pdf" filename="timesheet.pdf">JVBERi0xLjQK</cbc:EmbeddedDocumentBinaryObject>
  </cac:Attachment>
</cac:AdditionalDocumentReference>

Der einzige Unterschied ist das Attribut filename: In der fehlerhaften Rechnung fehlt es, in der korrigierten lautet es timesheet.pdf; Referenz, Beschreibung, MIME-Code und Inhalt sind gleich. Das fehlerhafte Dokument meldet nur UBL-DT-07, am cbc:EmbeddedDocumentBinaryObject, im Prüfschritt EN 16931; der XSD- und der Peppol-Prüfschritt haben es akzeptiert.

Wo die Regel gilt

• Gilt für Invoice und CreditNote. Im Versuch meldete eine Gutschrift mit einem Anhang ohne filename diese Regel auf dieselbe Weise.
• Um den MIME-Code kümmern sich andere: um seinen Wert BR-CL-24 und PEPPOL-EN16931-CL001, um sein Vorhandensein das UBL-Schema selbst. Im Versuch scheiterte ein Anhang ohne mimeCode am XSD-Prüfschritt, sodass keine Geschäftsregel lief.
• Im Versuch meldete ein Anhang ohne Dateinamen, der als application/octet-stream deklariert war, UBL-DT-07, BR-CL-24 und PEPPOL-EN16931-CL001 zusammen; jeder Befund braucht seine eigene Korrektur.

Verwandte Regeln

• BR-52 verlangt die Referenz der rechnungsbegründenden Unterlage, deren Datei dieses Attribut benennt
• BR-CL-24 prüft den MIME-Code, der neben dem Dateinamen steht
• PEPPOL-EN16931-R101 behält Dokumentreferenzen auf Positionsebene den abgerechneten Objekten vor, daher gehört eine Datei in eine Referenz auf Dokumentenebene
• Alle Regeln der Referenz ansehen
• Hintergrund (auf Englisch): Understanding EN 16931 validation errors

Umfang und Quelle

Geschrieben für Peppol BIS Billing 3.0.21 (May 2026), EN 16931 1.3.16, angewendet auf Invoice- und CreditNote-Dokumente in UBL 2.1. Andere Profile, Syntaxen und Releases können diese Kennung anders definieren. Version des Hinweiskatalogs 2026-09-28.1: Quelle geprüft am 2026-09-28, Erklärung zuletzt aktualisiert am 2026-09-28.

Die offizielle Definition von UBL-DT-07 (auf Englisch) enthält den normativen Wortlaut und den Test. Diese Seite ist unsere Erklärung dazu, keine Kopie.

Die Erklärung ändert das Urteil der Engine nicht. Dass Sie diesen Befund beheben, heißt nicht, dass das Dokument jeden Prüfschritt besteht. Die Validierung bescheinigt keine rechtliche oder steuerliche Konformität und überträgt kein Dokument über Peppol.