Zum Inhalt springen

Ironfang Finance - Regelreferenz

BR-CL-17: Einen zulässigen Code der Umsatzsteuerkategorie in jeder Steuerkategorie verwenden

Jede cac:TaxCategory/cbc:ID muss einer der Codes S, Z, E, AE, K, G, O, L, M oder B sein. Interne Steuercodes wie SR werden abgelehnt.

EN 16931Fehler: Das Dokument ist ungültigUmsatzsteuerCodelisten

Auf dieser Seite

Die kurze Antwort

BR-CL-17 schlägt für jede cac:TaxCategory/cbc:ID fehl, deren Wert kein zulässiger Code der Umsatzsteuerkategorie ist. Dieses Element steht in der Umsatzsteueraufschlüsselung und bei Nachlässen und Zuschlägen auf Dokumentenebene, und der Befund zeigt auf die betroffene cbc:ID. Ersetzen Sie den Wert durch den passenden Code: Im aufgezeichneten Beispiel steht in der Aufschlüsselung SR, wo der Code für den Normalsatz S ist.

Übersetzen Sie jeden internen Steuercode vor dem Export in einen der zehn zulässigen Codes. Die Codes in den Positionen werden gesondert geprüft, von BR-CL-18.

Was die Regel prüft

Die Regel läuft auf jeder cbc:ID, die direktes Kindelement einer cac:TaxCategory ist, wo auch immer diese Steuerkategorie steht. Sie liest cac:ClassifiedTaxCategory in den Positionen nicht.

Die akzeptierten Werte sind AE, L, M, E, S, Z, G, O, K und B. Umgebende Leerzeichen werden ignoriert, aber ein Leerzeichen innerhalb des Werts, falsche Groß- oder Kleinschreibung oder jeder andere Code schlägt fehl: Im Versuch wurden s, A und 20 alle abgelehnt.

Auch eine leere cbc:ID schlägt an dieser Regel fehl, und im Versuch brachte sie zusätzlich PEPPOL-EN16931-R008 für das leere Element mit sich.

Geprüft wird nur die Zugehörigkeit zur Liste. Ob die Kategorie zu den Artikeln passt, bleibt den Kategorieregeln überlassen, etwa BR-S-01 und BR-S-08 für den Normalsatz.

BegriffBedeutungUBL-Element
BT-118Code der Umsatzsteuerkategoriecac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:ID
BT-95Code der Umsatzsteuerkategorie des Nachlasses auf Dokumentenebenecac:AllowanceCharge[cbc:ChargeIndicator = false]/cac:TaxCategory/cbc:ID
BT-102Code der Umsatzsteuerkategorie des Zuschlags auf Dokumentenebenecac:AllowanceCharge[cbc:ChargeIndicator = true]/cac:TaxCategory/cbc:ID

Wie es in einer Integration dazu kommt

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

  • Ein Steuercode aus dem Buchhaltungssystem wie SR, T1 oder STD wird direkt ins XML geschrieben, statt übersetzt zu werden.
  • Der Code wird irgendwo in der Verarbeitungskette in Kleinbuchstaben umgewandelt.
  • Ein Code wird aus der vollständigen Liste UNCL5305 übernommen, die Codes enthält, die diese Regel nicht akzeptiert, etwa A.
  • Ein Steuersatz wie 20 wird in das Feld für den Kategoriecode geschrieben.

So korrigieren Sie das Dokument

  1. Ermitteln Sie anhand der Fundstelle des Befunds, welche Steuerkategorie den falschen Wert enthält: eine Aufschlüsselung unter cac:TaxTotal/cac:TaxSubtotal oder ein cac:AllowanceCharge auf oberster Ebene.
  2. Ordnen Sie den internen Code seiner Umsatzsteuerkategorie zu: S Normalsatz, Z Nullsatz, E steuerbefreit, AE Umkehrung der Steuerschuldnerschaft, K innergemeinschaftliche Lieferung, G Ausfuhr außerhalb der EU, O nicht der Umsatzsteuer unterliegend, L und M für die Steuern der Kanarischen Inseln und von Ceuta und Melilla, B für das italienische Split-Payment-Verfahren.
  3. Verwenden Sie für dieselbe Leistung denselben Code in den Positionen, Nachlässen, Zuschlägen und der Aufschlüsselung, damit die Aufschlüsselung weiterhin zu den Posten passt, die sie summiert.
  4. Führen Sie die Zuordnung in einer einzigen Tabelle, und lassen Sie den Export bei jedem Code fehlschlagen, den sie nicht enthält.

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 Position ist mit S codiert, die Aufschlüsselung mit SR

<cac:TaxSubtotal>
  <cbc:TaxableAmount currencyID="GBP">25.00</cbc:TaxableAmount>
  <cbc:TaxAmount currencyID="GBP">5.00</cbc:TaxAmount>
  <cac:TaxCategory>
    <cbc:ID>SR</cbc:ID>
    <cbc:Percent>20</cbc:Percent>
    <cac:TaxScheme>
      <cbc:ID>VAT</cbc:ID>
    </cac:TaxScheme>
  </cac:TaxCategory>
</cac:TaxSubtotal>

<cac:Item>
  <cbc:Name>Example service</cbc:Name>
  <cac:ClassifiedTaxCategory>
    <cbc:ID>S</cbc:ID>
    <cbc:Percent>20</cbc:Percent>
    <!-- tax scheme omitted from this fragment -->
  </cac:ClassifiedTaxCategory>
</cac:Item>

Ausschnitt der korrigierten Rechnung: Die Aufschlüsselung verwendet den Code S für den Normalsatz

<cac:TaxSubtotal>
  <cbc:TaxableAmount currencyID="GBP">25.00</cbc:TaxableAmount>
  <cbc:TaxAmount currencyID="GBP">5.00</cbc:TaxAmount>
  <cac:TaxCategory>
    <cbc:ID>S</cbc:ID>
    <cbc:Percent>20</cbc:Percent>
    <cac:TaxScheme>
      <cbc:ID>VAT</cbc:ID>
    </cac:TaxScheme>
  </cac:TaxCategory>
</cac:TaxSubtotal>

Die fehlerhafte Rechnung schreibt SR in die cac:TaxCategory/cbc:ID der Aufschlüsselung, die korrigierte schreibt S; das ist der einzige Unterschied. Das fehlerhafte Dokument meldet außerdem BR-S-01: Seine Position ist weiterhin zum Normalsatz besteuert, und eine mit SR codierte Aufschlüsselung zählt nicht als Aufschlüsselung zum Normalsatz. Die Korrektur des Codes 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 für UBL Invoice und CreditNote. Eine Gutschrift mit SR in ihrer Aufschlüsselung meldete im Versuch dieselben zwei Regeln.
  • Bei einem Nachlass auf Dokumentenebene wirkt sich der Fehler auf die Beträge aus. Im Versuch wurde ein mit SR codierter Nachlass von dieser Regel und von BR-S-08 gemeldet, weil der Nachlass aus der Bemessungsgrundlage zum Normalsatz herausfiel.
  • Derselbe falsche Code in Position und Aufschlüsselung meldete im Versuch nur BR-CL-17 und BR-CL-18. Position und Aufschlüsselung stimmten miteinander überein, sodass keine Kategorieregel auslöste, aber das Dokument wird trotzdem abgelehnt.
  • Gemeldet vom Prüfschritt EN 16931; das aufgezeichnete Beispiel besteht den Peppol-Prüfschritt.

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-CL-17 (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.