Zum Inhalt springen

Ironfang Finance - Regelreferenz

BR-Z-03: Eine Umsatzsteuer-Identifikationsnummer des Verkäufers ergänzen, wenn ein Nachlass auf Dokumentenebene zum Nullsatz ist

Ein Nachlass auf Dokumentenebene in der Umsatzsteuerkategorie Z verlangt eine Steuerkennung in der Verkäuferpartei oder die Umsatzsteuer-Identifikationsnummer eines Steuervertreters.

EN 16931Fehler: Das Dokument ist ungültigUmsatzsteuerBeteiligte und AdressenNachlässe und Zuschläge

Auf dieser Seite

Die kurze Antwort

BR-Z-03 schlägt fehl, wenn ein Nachlass eine cac:TaxCategory mit cbc:ID gleich Z im Schema VAT trägt und das Dokument weder eine Steuerkennung des Verkäufers, in welchem Schema auch immer, noch eine Umsatzsteuer-Identifikationsnummer eines Steuervertreters enthält. Stellen Sie das cac:PartyTaxScheme des Verkäufers mit seiner Nummer wieder her, oder ergänzen Sie den Vertreter, der die Umsatzsteuer abrechnet.

Im aufgezeichneten Beispiel mindert der Mengenrabatt über 2.50 Leistungen zum Nullsatz, und die Position zum Nullsatz daneben löst für dieselbe fehlende Kennung BR-Z-02 aus. Ein einziges cac:PartyTaxScheme des Verkäufers behebt beide.

Was die Regel prüft

Die Regel sucht einen Nachlass, also cbc:ChargeIndicator gleich false, dessen cac:TaxCategory die cbc:ID Z und ein Steuerschema hat, das nach Kürzen und Großschreibung VAT lautet. Im Versuch meldete der Rabatt mit dem Schema vat weiterhin diese Regel, mit BR-Z-02.

Auf Seiten des Verkäufers genügt ein cbc:CompanyID in irgendeinem cac:PartyTaxScheme des Verkäufers, ebenso ein cac:TaxRepresentativeParty/cac:PartyTaxScheme/cbc:CompanyID im Schema VAT. Im Versuch wurde die fehlerhafte Rechnung gültig, als ein Vertreter mit GB987654321 im Schema VAT hinzukam.

Ein Vertreter in einem anderen Schema zählt nicht. Mit TAX als Schema des Vertreters meldete die Rechnung mit Rabatt diese Regel, BR-Z-02 und BR-56.

Der Nachlass muss nicht auf Dokumentenebene stehen. Im Versuch meldete eine Rechnung zum Nullsatz ohne Kennung des Verkäufers, deren einziger Nachlass zum Nullsatz in ihrer Position stand, diese Regel und BR-Z-02, mit der Warnung UBL-CR-558.

BegriffBedeutungUBL-Element
BT-95Code der Umsatzsteuerkategorie des Nachlasses auf Dokumentenebenecac:AllowanceCharge[cbc:ChargeIndicator = false]/cac:TaxCategory/cbc:ID
BT-31Umsatzsteuer-Identifikationsnummer des Verkäuferscac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID (tax scheme VAT)
BT-32Steuernummer des Verkäuferscac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID (a tax scheme other than VAT)
BT-63Umsatzsteuer-Identifikationsnummer des Steuervertreters des Verkäuferscac:TaxRepresentativeParty/cac:PartyTaxScheme/cbc:CompanyID

Wie es in einer Integration dazu kommt

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

  • Die Verkäuferpartei wird aus einem Datensatz ohne Umsatzsteuer-Identifikationsnummer geschrieben, und auf einer Rechnung zum Nullsatz lenkt nichts in den Summen die Aufmerksamkeit auf die Lücke.
  • Ein Mengen- oder Handelsrabatt wird in einem eigenen Preisschritt hinzugefügt, der die Kategorie zum Nullsatz von den Positionen übernimmt, während die Verkäuferdaten aus einer unvollständigen Vorlage stammen.
  • Die Nummer des Steuervertreters wird unter einem lokalen Schemanamen gesendet.
  • Die Nummer des Verkäufers steht in cac:PartyLegalEntity/cbc:CompanyID statt in cac:PartyTaxScheme.

So korrigieren Sie das Dokument

  1. Bestätigen Sie die umsatzsteuerliche Registrierung des Verkäufers und nehmen Sie die Nummer mit Länderpräfix aus dem Datensatz des Verkäufers.
  2. Fügen Sie der Verkäuferpartei ein cac:PartyTaxScheme mit diesem cbc:CompanyID und cac:TaxScheme/cbc:ID gleich VAT hinzu, zwischen cac:PostalAddress und cac:PartyLegalEntity.
  3. Rechnet ein Vertreter die Umsatzsteuer ab, senden Sie cac:TaxRepresentativeParty mit Name, Postanschrift und einem cac:PartyTaxScheme im Schema VAT.
  4. Validieren Sie erneut: Dieselbe Änderung behebt BR-Z-02 für die Positionen zum Nullsatz und BR-Z-04, falls das Dokument auch einen Zuschlag zum Nullsatz hat.

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: ein Mengenrabatt zum Nullsatz und eine Verkäuferpartei ohne PartyTaxScheme

<cac:AccountingSupplierParty>
  <cac:Party>
    <cbc:EndpointID schemeID="0088">7300010000001</cbc:EndpointID>
    <!-- postal address omitted from this fragment -->
    <cac:PartyLegalEntity>
      <cbc:RegistrationName>Example Supplier Ltd</cbc:RegistrationName>
      <cbc:CompanyID>12345678</cbc:CompanyID>
    </cac:PartyLegalEntity>
  </cac:Party>
</cac:AccountingSupplierParty>

<cac:AllowanceCharge>
  <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
  <cbc:AllowanceChargeReasonCode>95</cbc:AllowanceChargeReasonCode>
  <cbc:AllowanceChargeReason>Volume discount</cbc:AllowanceChargeReason>
  <cbc:Amount currencyID="GBP">2.50</cbc:Amount>
  <cac:TaxCategory>
    <cbc:ID>Z</cbc:ID>
    <cbc:Percent>0</cbc:Percent>
    <cac:TaxScheme>
      <cbc:ID>VAT</cbc:ID>
    </cac:TaxScheme>
  </cac:TaxCategory>
</cac:AllowanceCharge>

Ausschnitt der korrigierten Rechnung: die Umsatzsteuer-Identifikationsnummer des Verkäufers wieder in der Verkäuferpartei

<cac:AccountingSupplierParty>
  <cac:Party>
    <cbc:EndpointID schemeID="0088">7300010000001</cbc:EndpointID>
    <!-- postal address omitted from this fragment -->
    <cac:PartyTaxScheme>
      <cbc:CompanyID>GB123456789</cbc:CompanyID>
      <cac:TaxScheme>
        <cbc:ID>VAT</cbc:ID>
      </cac:TaxScheme>
    </cac:PartyTaxScheme>
    <cac:PartyLegalEntity>
      <cbc:RegistrationName>Example Supplier Ltd</cbc:RegistrationName>
      <cbc:CompanyID>12345678</cbc:CompanyID>
    </cac:PartyLegalEntity>
  </cac:Party>
</cac:AccountingSupplierParty>

Die korrigierte Rechnung hat ein cac:PartyTaxScheme des Verkäufers mit GB123456789 im Schema VAT, das der fehlerhaften fehlt; sonst unterscheidet sich nichts. Das fehlerhafte Dokument meldet außerdem BR-Z-02 für seine Position zum Nullsatz. Der Rabatt, die Aufschlüsselung zum Nullsatz über 22.50 und die Summen sind in beiden Dokumenten gleich.

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. Die aus dem aufgezeichneten Beispiel gebaute Gutschrift meldete im Versuch BR-Z-02 und BR-Z-03.
  • Wird vom Prüfschritt EN 16931 als fataler Befund an der Dokumentwurzel gemeldet.
  • Zuschläge deckt BR-Z-04 ab, Nachlässe zum Normalsatz BR-S-03.
  • Der Satz des Nachlasses ist eine gesonderte Prüfung: Ein Nachlass zum Nullsatz muss nach BR-Z-06 bei 0 liegen.

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-28.1: Quelle geprüft am 2026-09-28, Erklärung zuletzt aktualisiert am 2026-09-28.

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