Validation rules

BR-S-04

A document-level charge uses VAT category S (standard rated), which requires the seller VAT identifier (BT-31) or tax registration number (BT-32).

Rule
BR-S-04official EN 16931 / XRechnung rule
Severity
error
Business term
BT-31 — Seller VAT identifier
Field in your JSON
invoice.seller.vat_id
Detected by
tier 3 — KoSIT validator (authoritative)
Reachability
Triggerable from your request JSON (generate & validate)

How to fix it

Set invoice.seller.vat_id (e.g. "DE123456789") or invoice.seller.tax_number.

BR-S-04 auf Deutsch — was bedeutet der Fehler?

Ein Zuschlag auf Dokumentebene verwendet die Kategorie S (Normalsatz); dafür ist die USt-IdNr. (BT-31) oder Steuernummer (BT-32) des Verkäufers Pflicht.

So beheben Sie den Fehler

Setzen Sie invoice.seller.vat_id (z. B. "DE123456789") oder invoice.seller.tax_number.

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.

Spotted something?

Bug, missing feature, wrong validation result — tell us. The page you're on is attached automatically; email optional.