Zum Inhalt springen

Ironfang Finance - Regelreferenz

BR-63: Das Attribut schemeID an der elektronischen Adresse des Käufers ergänzen

Eine cbc:EndpointID des Käufers muss ein Attribut schemeID tragen. Die Regel prüft, ob das Attribut existiert, nicht, was es enthält.

EN 16931Fehler: Das Dokument ist ungültigBeteiligte und Adressen

Auf dieser Seite

Die kurze Antwort

BR-63 schlägt fehl, wenn die elektronische Adresse des Käufers, cac:AccountingCustomerParty/cac:Party/cbc:EndpointID, kein Attribut schemeID hat. Ergänzen Sie das Attribut mit dem Code des Schemas, zu dem die Kennung des Käufers gehört.

Anders als auf der Seite des Verkäufers ändert sich dieser Wert von Dokument zu Dokument. Ein Kunde wird vielleicht per GLN adressiert, der nächste per nationaler Organisationsnummer, daher muss das Schema je Kunde gespeichert und nicht einmalig konfiguriert werden.

Was die Regel prüft

Die Regel wählt die cbc:EndpointID des Käufers aus und verlangt daran ein Attribut schemeID. Enthält das Dokument keine cbc:EndpointID des Käufers, meldet sie nichts; diese Lücke ist PEPPOL-EN16931-R010.

Geprüft wird nur die Existenz. Ein vorhandenes, aber leeres Attribut, schemeID="", besteht BR-63 und scheitert stattdessen an den Codelistenregeln: BR-CL-25 und PEPPOL-EN16931-CL008 im Peppol-Prüfschritt.

Eine cbc:EndpointID des Käufers ohne Inhalt und ohne Attribut meldet BR-63 und, für das leere Element, PEPPOL-EN16931-R008.

BegriffBedeutungUBL-Element
BT-49Elektronische Adresse des Käuferscac:AccountingCustomerParty/cac:Party/cbc:EndpointID
BT-49Elektronische Adresse des Käufers: Attribut für die Kennung des Schemascac:AccountingCustomerParty/cac:Party/cbc:EndpointID/@schemeID

Wie es in einer Integration dazu kommt

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

  • Der Kundendatensatz hat ein einziges Feld für die elektronische Adresse und keinen Platz für das Schema.
  • Kunden wurden aus einer Liste importiert, die nur die Kennungen enthielt, daher ist die Schemaspalte bei diesen Datensätzen leer.
  • Das Mapping setzt das Schema für Kunden im Inland fest ein und gibt für alle anderen nichts aus.
  • Das Schema wird in schemeName oder ein anderes Attribut geschrieben. Nur schemeID zählt, und schemeName ergibt zusätzlich die Warnung UBL-DT-08.

So korrigieren Sie das Dokument

  1. Fragen Sie den Käufer, unter welcher Kennung und welchem Schema er Dokumente empfängt, und erfassen Sie beides. Leiten Sie das Schema nicht aus Länge oder Aussehen der Kennung ab.
  2. Ergänzen Sie im Kundendatensatz ein Schemafeld, falls es keines gibt, und machen Sie es zur Pflicht, sobald eine elektronische Adresse eingegeben wird.
  3. Bilden Sie das Schema auf das Attribut schemeID ab und die Kennung auf den Inhalt von cac:AccountingCustomerParty/cac:Party/cbc:EndpointID.
  4. Prüfen Sie den gespeicherten Code schon bei der Eingabe gegen die EAS-Codeliste, damit BR-CL-25 nicht erst später beim Versand auftaucht.

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 EndpointID des Käufers hat keine schemeID

<cac:AccountingCustomerParty>
  <cac:Party>
    <cbc:EndpointID>7300010000001</cbc:EndpointID>
    <!-- postal address and legal entity omitted from this fragment -->
  </cac:Party>
</cac:AccountingCustomerParty>

Ausschnitt der korrigierten Rechnung: Die EndpointID des Käufers gibt ihr Schema an

<cac:AccountingCustomerParty>
  <cac:Party>
    <cbc:EndpointID schemeID="0088">7300010000001</cbc:EndpointID>
    <!-- postal address and legal entity omitted from this fragment -->
  </cac:Party>
</cac:AccountingCustomerParty>

Das Attribut schemeID="0088" an der cbc:EndpointID des Käufers ist der ganze Unterschied; die Kennung ist unverändert. Das fehlerhafte Dokument meldet nur BR-63, im Prüfschritt EN 16931, und sein Peppol-Prüfschritt besteht. Die cbc:EndpointID des Verkäufers in derselben Datei behält ihr Attribut, deshalb wird BR-62 nicht gemeldet.

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 UBL Invoice und CreditNote. Dieselbe Änderung an einer Gutschrift meldet denselben einzelnen Befund.
  • Die Regel deckt nur die Partei des Käufers ab. Eine cbc:EndpointID beim Verkäufer ist BR-62.
  • Sie gehört zu EN 16931 und meldet in diesem Prüfschritt. Peppol verlangt zusätzlich, dass das Element überhaupt vorhanden ist.

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-20.

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