Zum Inhalt springen

Ironfang Finance - Regelreferenz

BR-52: Jedem Verweis auf eine rechnungsbegründende Unterlage eine Kennung geben

Jede cac:AdditionalDocumentReference braucht eine cbc:ID, die die rechnungsbegründende Unterlage benennt. Eine leere oder nur aus Leerraum bestehende Kennung schlägt fehl.

EN 16931Fehler: Das Dokument ist ungültigProzess und Referenzen

Auf dieser Seite

Die kurze Antwort

BR-52 schlägt fehl, wenn eine cac:AdditionalDocumentReference eine cbc:ID ohne Text enthält. Schreiben Sie die Kennung der rechnungsbegründenden Unterlage, etwa die Nummer des Stundenzettels oder Lieferscheins, in diese cbc:ID.

Die leere cbc:ID zu löschen ist kein Ausweg: Das UBL-Schema verlangt das Element, daher scheitert ein Verweis ohne es stattdessen am XSD-Prüfschritt.

Was die Regel prüft

Die Regel läuft einmal für jede cac:AdditionalDocumentReference im Dokument und liest deren cbc:ID. Sie schlägt fehl, wenn diese Kennung leer ist oder nur Leerraum enthält; im Versuch meldete eine Kennung aus drei Leerzeichen diese Regel.

Sonst wird im Verweis nichts benötigt, um zu bestehen. Im Versuch bestand ein Verweis, der nur eine Kennung enthielt, ohne Beschreibung und ohne Anhang, jeden Prüfschritt.

Fehlend und leer verhalten sich hier unterschiedlich. Ganz ohne Element cbc:ID scheitert das Dokument am XSD-Prüfschritt, die Geschäftsregeln werden übersprungen, und BR-52 wird nicht gemeldet.

Die Kennung wird weder auf Format noch auf Eindeutigkeit geprüft. Jeder sichtbare Text erfüllt die Regel.

BegriffBedeutungUBL-Element
BG-24Rechnungsbegründende Unterlagencac:AdditionalDocumentReference
BT-122Kennung der rechnungsbegründenden Unterlagecac:AdditionalDocumentReference/cbc:ID

Wie es in einer Integration dazu kommt

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

  • Anhänge werden ohne Dokumentnummer gespeichert, und der Export bildet die fehlende Nummer auf ein leeres Element ab.
  • Der Verweis wird aus einem Feld gefüllt, das es nur für eine Art von Anhang gibt, etwa Stundenzettel, und das für die anderen leer ist.
  • Eine Vorlage schreibt immer einen Block cac:AdditionalDocumentReference für einen optionalen Anhang und lässt dessen Felder leer, wenn es keinen gibt.
  • Der Quellwert ist eine Folge von Leerzeichen, die der Export als vorhanden behandelt.

So korrigieren Sie das Dokument

  1. Klären Sie, welche rechnungsbegründende Unterlage der Verweis beschreibt: die angehängte Datei oder das externe Dokument, auf das er zeigt.
  2. Schreiben Sie ihre Kennung in cbc:ID: die Nummer, die auf der Unterlage steht, oder, falls sie keine hat, eine stabile Kennung, die Ihre Dokumentenablage dafür führt, damit der Käufer darauf Bezug nehmen kann.
  3. Hat die Rechnung keine rechnungsbegründende Unterlage, entfernen Sie die gesamte cac:AdditionalDocumentReference, statt eine leere Hülle zu senden.
  4. Machen Sie den Verweis überall dort zum Pflichtfeld, wo Anhänge hinzugefügt werden, damit der Export nie auf einen leeren trifft.

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: Ein Stundenzettel ist angehängt, aber sein Verweis ist leer

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

Ausschnitt der korrigierten Rechnung: Der Verweis kennzeichnet den Stundenzettel

<cbc:BuyerReference>BUYER-REF-001</cbc:BuyerReference>
<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 die cbc:ID innerhalb von cac:AdditionalDocumentReference unterscheidet sich: leer in der fehlerhaften Rechnung, TIMESHEET-001 in der korrigierten. Das fehlerhafte Dokument meldet außerdem PEPPOL-EN16931-R008, die Peppol-Regel gegen leere Elemente, an derselben cbc:ID. Das Eintragen der Kennung behebt beide Befunde.

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 gleichermaßen für Invoice und CreditNote; im Versuch meldete eine Gutschrift mit leerem Verweis auf eine rechnungsbegründende Unterlage ebenfalls BR-52 und PEPPOL-EN16931-R008.
  • Wird im Prüfschritt EN 16931 gemeldet, mit dem Befund zum leeren Element daneben im Peppol-Prüfschritt.
  • Jeder Verweis auf eine zusätzliche Unterlage fällt darunter, auch einer, der mit cbc:DocumentTypeCode 130 eine Kennung eines in Rechnung gestellten Objekts trägt; im Versuch meldete eine leere Kennung dort ebenfalls diese Regel.
  • Die angehängte Datei hat eigene Prüfungen: Ihr MIME-Code wird von BR-CL-24 geprüft, und ein fehlendes Attribut filename wird als UBL-DT-07 gemeldet.

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-24.1: Quelle geprüft am 2026-09-24, Erklärung zuletzt aktualisiert am 2026-09-24.

Die offizielle Definition von BR-52 (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.