Zum Inhalt springen

Ironfang Finance - Regelreferenz

BR-18: Den Namen des Steuervertreters des Verkäufers angeben

Eine cac:TaxRepresentativeParty muss einen Namen in cac:PartyName/cbc:Name tragen. Ein leerer Name schlägt fehl, und ein cbc:RegistrationName zählt nicht.

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

Auf dieser Seite

Die kurze Antwort

BR-18 schlägt fehl, wenn cac:TaxRepresentativeParty kein cac:PartyName/cbc:Name hat oder der Name leer ist. Tragen Sie den Namen des Steuervertreters, also der Partei, die im Namen des Verkäufers für die Umsatzsteuer verantwortlich ist, in cac:PartyName/cbc:Name als erstes Kindelement von cac:TaxRepresentativeParty ein.

Die Namen von Verkäufer und Käufer gehören in cac:PartyLegalEntity/cbc:RegistrationName; der Name des Steuervertreters nicht. Im Versuch ließ ein Name in einer cac:PartyLegalEntity innerhalb des Vertreters BR-18 weiter fehlschlagen und fügte die Warnung UBL-CR-335 hinzu, weil das Modell für diese Partei keine juristische Person vorsieht.

Was die Regel prüft

Die Regel läuft einmal für jede cac:TaxRepresentativeParty und meldet an diesem Element, daher wird eine Rechnung ohne Steuervertreter nie geprüft.

Sie entfernt den umgebenden Leerraum aus dem Text von cac:PartyName/cbc:Name und schlägt fehl, wenn nichts übrig bleibt. Im Versuch meldeten ein leerer Name und ein Name aus drei Leerzeichen beide BR-18, zusammen mit PEPPOL-EN16931-R008 für das leere Element.

Jeder sichtbare Text erfüllt sie. Die Regel kann nicht erkennen, ob es der Name ist, unter dem der Vertreter bestellt wurde.

BegriffBedeutungUBL-Element
BG-11Steuervertreter des Verkäuferscac:TaxRepresentativeParty
BT-62Name des Steuervertreters des Verkäuferscac:TaxRepresentativeParty/cac:PartyName/cbc:Name

Wie es in einer Integration dazu kommt

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

  • Der Block des Vertreters wird aus einem Umsatzsteuer-Registrierungsdatensatz erzeugt, der Umsatzsteuer-Identifikationsnummer und Anschrift des Vertreters enthält, aber nicht seinen Namen.
  • Ein Party-Builder, der mit Verkäufer und Käufer geteilt wird, schreibt den Namen nur in cac:PartyLegalEntity/cbc:RegistrationName, was für diese richtig und hier falsch ist.
  • Der Block wird für jede Rechnung eines im Ausland registrierten Verkäufers geschrieben, mit leeren Feldern, wenn kein Vertreter bestellt wurde.

So korrigieren Sie das Dokument

  1. Prüfen Sie, ob der Verkäufer für diese Rechnung tatsächlich einen Steuervertreter hat. Falls nicht, lassen Sie cac:TaxRepresentativeParty weg; die Gruppe ist optional.
  2. Nehmen Sie den Namen des Vertreters aus dem Bestellungs- oder Registrierungsdatensatz und schreiben Sie ihn als cac:TaxRepresentativeParty/cac:PartyName/cbc:Name, vor cac:PostalAddress.
  3. Vervollständigen Sie den Rest der Gruppe aus demselben Datensatz: Der Vertreter braucht außerdem eine Umsatzsteuer-Identifikationsnummer (BR-56), eine Postanschrift (BR-19) und einen Ländercode in dieser Anschrift (BR-20).
  4. Fügen Sie dem Vertreter keine cac:PartyLegalEntity hinzu; sie liegt außerhalb des Modells und führt zu einer Warnung.

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: Der Steuervertreter beginnt mit seiner Anschrift und hat keinen Namen

<cac:TaxRepresentativeParty>
  <cac:PostalAddress>
    <cbc:StreetName>4 Example Street</cbc:StreetName>
    <!-- rest of the address omitted from this fragment -->
  </cac:PostalAddress>
  <cac:PartyTaxScheme>
    <cbc:CompanyID>GB987654321</cbc:CompanyID>
    <!-- tax scheme omitted from this fragment -->
  </cac:PartyTaxScheme>
</cac:TaxRepresentativeParty>

Ausschnitt der korrigierten Rechnung: PartyName steht im Steuervertreter an erster Stelle

<cac:TaxRepresentativeParty>
  <cac:PartyName>
    <cbc:Name>Example Fiscal Representative Ltd</cbc:Name>
  </cac:PartyName>
  <cac:PostalAddress>
    <cbc:StreetName>4 Example Street</cbc:StreetName>
    <!-- rest of the address omitted from this fragment -->
  </cac:PostalAddress>
  <cac:PartyTaxScheme>
    <cbc:CompanyID>GB987654321</cbc:CompanyID>
    <!-- tax scheme omitted from this fragment -->
  </cac:PartyTaxScheme>
</cac:TaxRepresentativeParty>

Die korrigierte Rechnung beginnt cac:TaxRepresentativeParty mit cac:PartyName, das Example Fiscal Representative Ltd enthält; sonst unterscheidet sich nichts. Das fehlerhafte Dokument meldet nur BR-18, weil sein Vertreter weiterhin eine Anschrift mit Ländercode und eine Umsatzsteuer-Identifikationsnummer hat.

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

  • Der Steuervertreter ist in einer CreditNote gleich aufgebaut. Im Versuch meldete eine Gutschrift, deren Vertreter keinen Namen hatte, nur BR-18.
  • Eine Regel aus EN 16931. Im aufgezeichneten Beispiel ist der Name das Einzige, was fehlt, und der Peppol-Prüfschritt hat keinen Befund.
  • Die Namensregeln für Verkäufer und Käufer, BR-06 und BR-07, lesen cbc:RegistrationName. Ein gemeinsames Party-Mapping muss für den Vertreter auf cac:PartyName umschalten.

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