UBL-CR-537: DocumentType aus der Objektkennung der Rechnungsposition entfernen

Die kurze Antwort

UBL-CR-537 ist eine Warnung, die ausgelöst wird, wenn cbc:DocumentType in der Objektkennung der Rechnungsposition (cac:InvoiceLine/cac:DocumentReference) steht. EN 16931 hat dafür kein Informationselement; entfernen Sie daher das Element.

Die Warnung allein macht das Dokument nicht ungültig, doch andere Regeln prüfen weiterhin, was vorhanden ist. Das Entfernen des Elements hält das XML innerhalb des Modells von EN 16931, auf dessen Grundlage ein Empfänger die Rechnung übernimmt.

Was die Regel prüft

Die Regel prüft genau eines: ob cac:InvoiceLine/cac:DocumentReference/cbc:DocumentType vorhanden ist. Seinen Wert liest sie nicht.

Sie wird einmal für das ganze Dokument ausgewertet und daher nur einmal gemeldet, gleich wie viele Positionen das Element enthalten; der Befund verweist auf das Wurzelelement, nicht auf das Element selbst: Suchen Sie im XML nach cac:InvoiceLine/cac:DocumentReference/cbc:DocumentType.

Wie es in einer Integration dazu kommt

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

• Das Quellsystem führt den Wert, und das Mapping schreibt ihn, weil UBL 2.1 einen Platz dafür hat.
• Eine allgemeine UBL-2.1-Bibliothek schreibt jedes Element und Attribut, für das sie einen Wert hat, ob EN 16931 es verwendet oder nicht.
• Ein Mapping für ein anderes UBL-basiertes Dokument, etwa eine Bestellung, eine Versandanzeige oder ein nationales Profil, wird für Peppol BIS Billing wiederverwendet.

So korrigieren Sie das Dokument

1. Geben Sie cac:InvoiceLine/cac:DocumentReference/cbc:DocumentType nicht mehr aus.
2. Wenn Sie die Information brauchen, bewahren Sie sie in Ihren eigenen Unterlagen auf: EN 16931 hat dafür kein Informationselement, daher hat ein Empfänger keinen vereinbarten Ort, an dem er sie lesen könnte.
3. Prüfen Sie erneut: Die Warnung verschwindet. War das Element das einzige in seinem übergeordneten Element, entfernen Sie auch dieses: Peppol weist leere Elemente zurück (PEPPOL-EN16931-R008).

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 Rechnung mit der Warnung: DocumentType in der Objektkennung der Rechnungsposition

<cac:DocumentReference>
  <cbc:ID schemeID="ABZ">LINE-OBJECT-001</cbc:ID>
  <cbc:DocumentTypeCode>130</cbc:DocumentTypeCode>
  <cbc:DocumentType>Example</cbc:DocumentType>
</cac:DocumentReference>

Ausschnitt der korrigierten Rechnung: dieselben Zeilen ohne das Element

<cac:DocumentReference>
  <cbc:ID schemeID="ABZ">LINE-OBJECT-001</cbc:ID>
  <cbc:DocumentTypeCode>130</cbc:DocumentTypeCode>
</cac:DocumentReference>

Die Rechnung mit der Warnung enthält <cbc:DocumentType>Example</cbc:DocumentType> in der Objektkennung der Rechnungsposition, und die korrigierte Rechnung ist dasselbe Dokument ohne das Element. Die Rechnung mit der Warnung meldet nur diese Warnung, ist in jedem Prüfschritt gültig und würde so angenommen.

Wo die Regel gilt

• Gilt gleichermaßen für UBL Invoice und CreditNote, für Rechnungs- wie für Gutschriftpositionen; das aufgezeichnete Beispiel ist eine Rechnung.
• Die Warnung stammt aus den Regeln des Prüfschritts EN 16931 für die UBL-Syntax. Im aufgezeichneten Beispiel besteht das Dokument den XSD-Prüfschritt: Das Element ist gültiges UBL 2.1 und liegt lediglich außerhalb des Modells von EN 16931.

Verwandte Regeln

• UBL-CR-535: IssueTime in der Objektkennung der Rechnungsposition
• UBL-CR-538: XPath in der Objektkennung der Rechnungsposition
• UBL-CR-539: LanguageID in der Objektkennung der Rechnungsposition
• 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-29.1: Quelle geprüft am 2026-09-29, Erklärung zuletzt aktualisiert am 2026-09-29.

Die offizielle Definition von UBL-CR-537 (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.