Zum Inhalt springen

Ironfang Finance - Regelreferenz

PEPPOL-EN16931-CL001: Einen eingebetteten Anhang mit einem der sechs MIME-Codes von Peppol angeben

Peppol akzeptiert sechs MIME-Codes an einem eingebetteten Anhang, dieselben sechs wie BR-CL-24. Eine Variante wie application/x-pdf scheitert an beiden Regeln.

Peppol BIS BillingFehler: Das Dokument ist ungültigCodelistenProzess und Referenzen

Auf dieser Seite

Die kurze Antwort

PEPPOL-EN16931-CL001 schlägt fehl, wenn der mimeCode eines cbc:EmbeddedDocumentBinaryObject nicht exakt einer der sechs Codes ist, die Peppol für Anhänge zulässt: PDF, PNG, JPEG, CSV, Excel xlsx und OpenDocument-Tabelle. Das aufgezeichnete PDF war als application/x-pdf angegeben, ein nicht registrierter Name, den manche Software noch für PDF verwendet; zu senden ist application/pdf.

Dies ist die Peppol-Kopie von BR-CL-24. Beide Regeln führen dieselben sechs Werte und vergleichen sie auf dieselbe Weise, sodass ein Wert, der an der einen scheitert, auch an der anderen scheitert, und eine einzige Korrektur beide behebt.

Was die Regel prüft

Jedes eingebettete Binärobjekt mit einem Attribut mimeCode wird geprüft, und der Befund zeigt auf dieses Element.

Der Vergleich ist exakt: keine Bereinigung um Leerzeichen und keine Angleichung der Groß- und Kleinschreibung. Im Versuch schlugen application/PDF, application/pdf mit führendem Leerzeichen und ein leeres Attribut jeweils fehl, und jeder Wert wurde auch von BR-CL-24 gemeldet.

Typen anderer Formate schlagen fehl, auch wenn sie registrierte MIME-Typen sind. Im Versuch wurden application/vnd.ms-excel für eine ältere Excel-Arbeitsmappe und text/plain beide abgelehnt.

Kein Wert trennt diese Regel von BR-CL-24: Die beiden Listen stimmen Eintrag für Eintrag überein, und keine der Regeln bereinigt das Attribut, daher kamen die beiden Befunde in jedem Versuch gemeinsam.

BegriffBedeutungUBL-Element
BT-125-1MIME-Code des angehängten Dokumentscac:AdditionalDocumentReference/cac:Attachment/cbc:EmbeddedDocumentBinaryObject/@mimeCode
BT-125Angehängtes Dokumentcac:AdditionalDocumentReference/cac:Attachment/cbc:EmbeddedDocumentBinaryObject

Wie es in einer Integration dazu kommt

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

  • Eine MIME-Bibliothek oder eine Tabelle des Betriebssystems liefert einen veralteten Alias wie application/x-pdf.
  • Der Typ des älteren binären Excel-Formats, application/vnd.ms-excel, wird für jede Tabelle gesendet.
  • Das Attribut wird aus den Metadaten der Datei übernommen, ohne Groß- und Kleinschreibung oder Leerraum zu normalisieren.
  • Ein Text- oder XML-Export wird unverändert angehängt, obwohl keiner der beiden Typen auf der Liste steht.

So korrigieren Sie das Dokument

  1. Bestimmen Sie das Format aus dem Dateiinhalt oder einer verlässlichen Prüfung der Endung, nicht aus dem, was eine Bibliothek vorschlägt.
  2. Ordnen Sie das Format über eine feste Tabelle den sechs zulässigen Werten zu, sodass ein PDF immer als application/pdf gesendet wird.
  3. Wandeln Sie jedes andere Format, etwa ein Word-Dokument oder eine Arbeitsmappe .xls, vor dem Einbetten in PDF, xlsx oder ods um, und passen Sie den Dateinamen an.
  4. Korrigieren Sie den Wert einmal, in der Zuordnung; die Prüfungen von EN 16931 und Peppol lesen dasselbe Attribut.

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: der Stundenzettel als PDF ist als application/x-pdf angegeben

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

Ausschnitt der korrigierten Rechnung: dieselbe Datei, angegeben als application/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>

Nur das Attribut mimeCode unterscheidet sich: application/x-pdf in der fehlerhaften Rechnung, application/pdf in der korrigierten, beim selben Inhalt von timesheet.pdf. Das fehlerhafte Dokument meldet außerdem BR-CL-24 am selben Element, die Prüfung gegen dieselben sechs Werte im Prüfschritt EN 16931.

Was der Validator gemeldet hat

Aufgezeichnet mit phive 12.1.0 / phive-rules-peppol 4.5.6 / Saxon-HE 12.10, der Engine hinter dem kostenlosen Validator, mit synthetischen Daten. Ein aufgezeichnetes Ergebnis ist ein Regressionsnachweis für diese Dokumente, keine Zertifizierung.

Wo die Regel gilt

  • Gilt für Invoice und CreditNote; im Versuch meldete ein als application/x-pdf angegebener Anhang in einer Gutschrift diese Regel und BR-CL-24.
  • Eine Regel aus Peppol BIS Billing 3.0, gemeldet im Peppol-Prüfschritt mit der Codeliste des festgelegten Release vom Mai 2026.
  • Ein Anhang ganz ohne mimeCode erreicht diese Regel nie: Im Versuch scheiterte er am XSD-Prüfschritt, der das Attribut verlangt.
  • Ein Dokument, das per URL in cac:ExternalReference referenziert wird, ist nicht eingebettet, hat keinen MIME-Code und liegt außerhalb der Regel.

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 PEPPOL-EN16931-CL001 (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.