Zum Inhalt springen

Ironfang Finance - Regelreferenz

BR-07: Den Namen des Käufers als RegistrationName des Kunden angeben

Die Partei des Kunden benötigt ein nicht leeres cbc:RegistrationName innerhalb von cac:PartyLegalEntity. Ein leeres Element schlägt fehl, ebenso ein fehlendes.

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

Auf dieser Seite

Die kurze Antwort

BR-07 schlägt fehl, wenn cac:AccountingCustomerParty/cac:Party/cac:PartyLegalEntity/cbc:RegistrationName fehlt oder leer ist. Schreiben Sie den vollständigen Namen des Kunden, dem die Rechnung gestellt wird, in dieses Element.

Sie ist das Gegenstück zu BR-06 für die andere Partei. Beide können im selben Dokument fehlschlagen, und beide Befunde werden am Wurzelelement verortet; prüfen Sie daher die Regel-ID, um zu sehen, welche Partei gemeint ist.

Was die Regel prüft

Die Regel nimmt cbc:RegistrationName aus cac:PartyLegalEntity des Kunden und schlägt fehl, wenn das Element nicht vorhanden ist oder nur Leerraum enthält. Ein Handelsname des Käufers in cac:PartyName/cbc:Name ist ein anderes Feld und erfüllt sie nicht.

Fehlend oder leer: Weder cac:PartyLegalEntity noch das darin enthaltene cbc:RegistrationName ist im UBL-Schema Pflicht, daher kommt ein Dokument ohne sie durch den XSD-Prüfschritt und meldet BR-07 allein. Im aufgezeichneten Beispiel ist das Element vorhanden, aber leer, wodurch PEPPOL-EN16931-R008 hinzukommt.

Der Inhalt wird nur darauf geprüft, dass er nicht leer ist. Die Regel vergleicht den Namen weder mit der elektronischen Adresse des Käufers noch mit einer Registernummer oder einem Verzeichnis.

BegriffBedeutungUBL-Element
BT-44Name des Käuferscac:AccountingCustomerParty/cac:Party/cac:PartyLegalEntity/cbc:RegistrationName

Wie es in einer Integration dazu kommt

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

  • Der Kundendatensatz hat eine Kontaktperson und eine Adresse, aber das Feld für den Firmennamen wurde nie ausgefüllt.
  • Der Kunde ist eine Privatperson, und das Mapping liest eine Spalte für den Firmennamen, die bei Personen leer ist.
  • Der Name wird aus der Lieferadresse oder vom bestellenden Kontakt übernommen, und dieser Datensatz ist unvollständig, während das Rechnungskonto den tatsächlichen Namen enthält.
  • Der Kundenname wird aus einem CRM- oder Stammdatendienst hinzugefügt, und die Verknüpfung liefert für archivierte oder zusammengeführte Konten nichts.
  • Der Serialisierer gibt cac:PartyLegalEntity aus, um die Registernummer des Käufers zu übermitteln, und schreibt den Namen als leeres Element, wenn der Wert null ist.

So korrigieren Sie das Dokument

  1. Legen Sie fest, welcher Quelldatensatz der Kunde ist, dem die Rechnung gestellt wird, normalerweise das Rechnungskonto, und nehmen Sie den Namen von dort.
  2. Schreiben Sie ihn in cbc:RegistrationName innerhalb von cac:PartyLegalEntity des Kunden. Verwenden Sie für eine Organisation ihren eingetragenen Namen, für eine Person ihren vollständigen Namen.
  3. Machen Sie den Namen dort zum Pflichtfeld, wo die Rechnung ausgestellt wird, damit die Lücke auffällt, bevor das XML erzeugt 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.

Kunde in der fehlerhaften Rechnung: Das Namenselement ist vorhanden und leer

<cac:AccountingCustomerParty>
  <cac:Party>
    <!-- endpoint and postal address omitted from this fragment -->
    <cac:PartyLegalEntity>
      <cbc:RegistrationName></cbc:RegistrationName>
      <cbc:CompanyID>87654321</cbc:CompanyID>
    </cac:PartyLegalEntity>
  </cac:Party>
</cac:AccountingCustomerParty>

Kunde in der korrigierten Rechnung: Der Käufer ist benannt

<cac:AccountingCustomerParty>
  <cac:Party>
    <!-- endpoint and postal address omitted from this fragment -->
    <cac:PartyLegalEntity>
      <cbc:RegistrationName>Example Buyer Ltd</cbc:RegistrationName>
      <cbc:CompanyID>87654321</cbc:CompanyID>
    </cac:PartyLegalEntity>
  </cac:Party>
</cac:AccountingCustomerParty>

Nur das cbc:RegistrationName des Kunden unterscheidet sich: In der fehlerhaften Rechnung ist es leer, in der korrigierten lautet es Example Buyer Ltd. Das fehlerhafte Dokument meldet außerdem PEPPOL-EN16931-R008, weil der leere Name ein Element ohne Kindelemente und ohne Text ist, was Peppol überall im Dokument verbietet. Den Käufer zu benennen 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 UBL Invoice und CreditNote. Eine Gutschrift mit leerem Käufernamen meldet BR-07 und PEPPOL-EN16931-R008, eine Gutschrift ohne das Element nur BR-07.
  • Ein gültiger Käufername sagt nichts darüber aus, ob der Käufer im Peppol-Netzwerk erreichbar ist. Das hängt von der elektronischen Adresse und der dahinterstehenden Registrierung ab.

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