Validation rules

UBL-CR-561 — UBL rule

An invoice line contains cac:TaxTotal. In EN 16931 VAT is broken down at document level only (BG-23) — lines state just their category and rate (BT-151/BT-152).

Rule: UBL-CR-561 — official EN 16931 / XRechnung rule
Severity: warning
Detected by: tier 3 — KoSIT validator (authoritative)
Reachability: Only reachable when validating your own XML — normbill-generated documents cannot trigger it

normbill computes the document-level VAT breakdown from the lines; generated lines never carry TaxTotal.

How to fix it

Remove the line-level TaxTotal; put the VAT breakdown into the document-level cac:TaxTotal/cac:TaxSubtotal elements.

UBL-CR-561 auf Deutsch — was bedeutet der Fehler?

Der KoSIT-Validator meldet eine Warnung, weil eine Rechnungsposition cac:TaxTotal enthält. In der EN 16931 wird die Umsatzsteuer nur auf Dokumentebene aufgeschlüsselt (BG-23) — Positionen nennen lediglich Kategorie und Satz (BT-151/BT-152).

So beheben Sie den Fehler

Entfernen Sie das TaxTotal auf Positionsebene; die Steueraufschlüsselung gehört in die dokumentweiten cac:TaxTotal/cac:TaxSubtotal-Elemente.

Related rules

UBL-CR-646 — An invoice line contains cac:SubInvoiceLine. XRechnung prohibits sub-invoice lines — the KoSIT validator…
UBL-CR-006 — cbc:IssueTime is present. The EN 16931 core model works with dates only (BT-2) — a time of day is not part…
UBL-CR-002 — cbc:UBLVersionID is present with a value other than 2.1. EN 16931 invoices are UBL 2.1 — omit the element or…
UBL-CR-001 — The document contains ext:UBLExtensions. Extensions are valid UBL but not part of the EN 16931 core model —…

Official sources

Every 422 from the API lists the rule id, the path in your request JSON, a plain-language message and a suggested fix — see the docs overview for the report format.

Or try it live: drop any XRechnung XML on the free validator — same KoSIT-backed report, no account.