Zum Inhalt springen

Ironfang Finance - Regelreferenz

UBL-CR-665: Das Attribut schemeID aus der Kennung eines nicht auf das Rechnungsobjekt bezogenen Dokumentverweises entfernen

Warnung: Das Attribut schemeID an der Kennung eines nicht auf das Rechnungsobjekt bezogenen Dokumentverweises liegt außerhalb von EN 16931; entfernen Sie es.

EN 16931Warnung: Das Dokument bleibt gültigProzess und Referenzen

Auf dieser Seite

Die kurze Antwort

UBL-CR-665 ist eine Warnung, die ausgelöst wird, wenn an der Kennung eines nicht auf das Rechnungsobjekt bezogenen Dokumentverweises (cac:AdditionalDocumentReference/cbc:ID) ein Attribut schemeID angegeben ist. EN 16931 verwendet das Attribut dort nicht; entfernen Sie es und behalten Sie das Element mit seinem Wert. An einer rechnungsbegründenden Unterlage steht die Kennung für sich (BT-122); ein Schema gehört nur an den Verweis auf das Rechnungsobjekt (BT-18-1).

Die Warnung allein macht das Dokument nicht ungültig, doch andere Regeln prüfen weiterhin, was vorhanden ist.

Was die Regel prüft

Die Regel betrachtet jeden cac:AdditionalDocumentReference, dessen cbc:DocumentTypeCode nicht 130 ist oder der keinen hat, und prüft, ob seine cbc:ID ein Attribut schemeID trägt. Der Verweis auf das Rechnungsobjekt mit Code 130 darf eines tragen (BT-18-1).

Sie wird einmal für das ganze Dokument ausgewertet und daher nur einmal gemeldet, gleich wie oft das Dokument das Attribut enthält; der Befund verweist auf das Wurzelelement, nicht auf das Element selbst: Suchen Sie im XML nach cac:AdditionalDocumentReference/cbc:ID/@schemeID.

BegriffBedeutungUBL-Element
-Attribut schemeID (BT-18-1 nur am Verweis auf das Rechnungsobjekt)cac:AdditionalDocumentReference/cbc:ID/@schemeID
BT-122Kennung eines nicht auf das Rechnungsobjekt bezogenen Dokumentverweisescac:AdditionalDocumentReference/cbc:ID

Wie es in einer Integration dazu kommt

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

  • Schema- und Listenattribute (schemeID, listID und ähnliche) werden standardmäßig an jede Kennung oder jeden Code geschrieben, auch dort, wo EN 16931 sie nicht vorsieht.
  • 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 schemeID an der cbc:ID eines Dokumentverweises, dessen cbc:DocumentTypeCode nicht 130 ist, nicht mehr aus; behalten Sie es am Verweis auf das Rechnungsobjekt.
  2. An einer rechnungsbegründenden Unterlage steht die Kennung für sich (BT-122); ein Schema gehört nur an den Verweis auf das Rechnungsobjekt (BT-18-1).
  3. Prüfen Sie erneut: Die Warnung verschwindet.

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 Gutschrift mit der Warnung: das Attribut schemeID an der Kennung eines nicht auf das Rechnungsobjekt bezogenen Dokumentverweises

<cac:AdditionalDocumentReference>
  <cbc:ID schemeID="ABT">PROJECT-001</cbc:ID>
  <cbc:DocumentTypeCode>50</cbc:DocumentTypeCode>
</cac:AdditionalDocumentReference>

Ausschnitt der korrigierten Gutschrift: dieselben Zeilen ohne das Attribut

<cac:AdditionalDocumentReference>
  <cbc:ID>PROJECT-001</cbc:ID>
  <cbc:DocumentTypeCode>50</cbc:DocumentTypeCode>
</cac:AdditionalDocumentReference>

Die Gutschrift mit der Warnung enthält <cbc:ID schemeID="ABT">PROJECT-001</cbc:ID>, und die korrigierte Gutschrift ist dasselbe Dokument ohne das Attribut. Die Gutschrift mit der Warnung meldet nur diese Warnung, ist in jedem Prüfschritt gültig und würde so angenommen.

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 UBL Invoice und CreditNote; das aufgezeichnete Beispiel ist eine Gutschrift.
  • 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 Attribut ist gültiges UBL 2.1 und liegt lediglich außerhalb des Modells von EN 16931.
  • Ein Dokumentverweis mit schemeID scheitert außerdem in beiden Dokumenttypen an UBL-SR-43 (fatal): Diese Regel lässt ein Schema nur beim Rechnungsobjekt zu und in einer Gutschrift bei der Projektreferenz (Code 50). Nur dort wird diese Warnung daher allein gemeldet, wie im aufgezeichneten Beispiel, der Projektreferenz einer Gutschrift.

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-665 (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.