Zum Inhalt springen

Ironfang Finance - Regelreferenz

BR-64: Das Attribut schemeID an der Standardkennung des Artikels ergänzen

Eine Standardkennung des Artikels in cac:StandardItemIdentification/cbc:ID muss in schemeID angeben, zu welchem Schema sie gehört: 0160 für eine GTIN.

EN 16931Fehler: Das Dokument ist ungültigPositionen und PreiseCodelisten

Auf dieser Seite

Die kurze Antwort

BR-64 schlägt fehl, wenn cac:Item/cac:StandardItemIdentification/cbc:ID in einer Position kein Attribut schemeID hat. Ergänzen Sie schemeID mit dem ICD-Code nach ISO 6523 des Nummernsystems, zu dem die Kennung gehört. Für eine GS1-GTIN, wie im aufgezeichneten Beispiel, ist das 0160.

Ist die Nummer Ihre eigene Artikelnummer und stammt nicht aus einem registrierten Schema, gehört sie in cac:SellersItemIdentification/cbc:ID, das kein Schema kennt. Im Versuch bestand dieselbe Nummer, dorthin verschoben und ohne Attribut, alle Prüfschritte.

Was die Regel prüft

Die Regel läuft auf jeder cbc:ID innerhalb von cac:StandardItemIdentification in einer Rechnungs- oder Gutschriftsposition und prüft eine Sache: ob ein Attribut schemeID vorhanden ist.

Der Wert des Attributs bleibt BR-CL-21 überlassen. Im Versuch bestand schemeID="" diese Regel und wurde von jener gemeldet.

Die Kennung wird nicht gegen ihr Schema geprüft. Mit schemeID="0160" bestanden im Versuch sowohl eine 13-stellige Nummer mit falscher GS1-Prüfziffer als auch der Text ABC alle Prüfschritte; für eine korrekte GTIN sind also Sie verantwortlich.

Andere Attribute ersetzen schemeID nicht. Als der Code stattdessen in schemeAgencyID geschrieben wurde, wurde diese Regel zusammen mit der Warnung UBL-DT-27 gemeldet.

Eine leere cbc:ID, die schemeID trägt, besteht diese Regel; im Versuch wurde sie allein von PEPPOL-EN16931-R008 gemeldet.

BegriffBedeutungUBL-Element
BT-157Kennung eines Artikels nach registriertem Schemacac:InvoiceLine/cac:Item/cac:StandardItemIdentification/cbc:ID (cac:CreditNoteLine/cac:Item/cac:StandardItemIdentification/cbc:ID in a credit note)
BT-157Kennung eines Artikels nach registriertem Schema: Attribut für die Kennung des Schemascac:InvoiceLine/cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeID

Wie es in einer Integration dazu kommt

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

  • Der Produktstamm speichert die Barcode-Nummer, ohne zu erfassen, zu welchem Schema sie gehört, und das Mapping schreibt nur die Nummer.
  • Die Artikelnummer des Verkäufers wird auf cac:StandardItemIdentification statt auf cac:SellersItemIdentification abgebildet, sodass es kein Schema anzugeben gibt.
  • Der Serialisierer verwirft Attribute, deren Quellspalte null ist, und die Schemaspalte ist bei einigen Produkten leer.
  • Das Schema wird in schemeAgencyID statt in schemeID geschrieben.

So korrigieren Sie das Dokument

  1. Klären Sie, was die Nummer in cbc:ID ist. Eine GTIN, wozu auch EAN-13- und UPC-Barcode-Nummern gehören, erhält 0160. Eine Kennung aus einem anderen registrierten Nummernsystem für Artikel erhält den Code dieses Schemas aus der ICD-Liste.
  2. Schreiben Sie den Code in das Attribut schemeID von cac:StandardItemIdentification/cbc:ID, genau in dieser Schreibweise, als vierstelligen Code und nicht als Namen des Schemas.
  3. Ist die Kennung eine interne Nummer des Verkäufers oder des Käufers, verschieben Sie sie nach cac:SellersItemIdentification oder cac:BuyersItemIdentification und lassen Sie cac:StandardItemIdentification für diese Position weg. Senden Sie diese Kennungen ohne Schema: Im Versuch ergab eine schemeID an der Artikelkennung des Verkäufers die Warnung UBL-CR-668.
  4. Führen Sie das Schema in den Produktdaten neben der Kennung, damit jede Standardkennung mit einem Schema exportiert wird.

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: Die GTIN hat kein Schema-Attribut

<cac:Item>
  <cbc:Name>Example service</cbc:Name>
  <cac:StandardItemIdentification>
    <cbc:ID>5012345678900</cbc:ID>
  </cac:StandardItemIdentification>
  <!-- classification, tax category and item attribute omitted from this fragment -->
</cac:Item>

Ausschnitt der korrigierten Rechnung: schemeID 0160 kennzeichnet die Kennung als GTIN

<cac:Item>
  <cbc:Name>Example service</cbc:Name>
  <cac:StandardItemIdentification>
    <cbc:ID schemeID="0160">5012345678900</cbc:ID>
  </cac:StandardItemIdentification>
  <!-- classification, tax category and item attribute omitted from this fragment -->
</cac:Item>

Der einzige Unterschied ist schemeID="0160" an der Standardkennung des Artikels, das in der fehlerhaften Rechnung fehlt. Das fehlerhafte Dokument meldet nur BR-64. BR-CL-21 wird nicht mitgemeldet, weil diese Regel den Wert des Attributs prüft und es kein Attribut zu prüfen gibt.

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 cac:InvoiceLine in einer Invoice und cac:CreditNoteLine in einer CreditNote, deren Artikelstruktur identisch ist. Im Versuch meldete eine Gutschrift, bei deren GTIN das Attribut entfernt war, nur diese Regel.
  • Die Standardkennung ist optional. Eine Position ohne cac:StandardItemIdentification besteht, es gibt also keinen Grund, ohne echte Kennung eine hinzuzufügen.
  • Artikelkennungen des Verkäufers und des Käufers liegen außerhalb dieser Regel, ebenso Kennungen von Parteien, die eigene Schema-Regeln haben, etwa BR-62.

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