BT-117: Umsatzsteuerkategorie-Steuerbetrag
BT-117 steht in der XRechnung für Umsatzsteuerkategorie-Steuerbetrag. Es ist für Steuerlogik, Summenprüfung und länderspezifische Vorgaben der XRechnung relevant. Fehlt der Wert oder passt er fachlich nicht, scheitert die Validierung oft direkt. Beträge sollten aus den Einzelwerten berechnet statt manuell überschrieben werden.
Pflicht, Definition und Praxiskontext
Dieses Feld sollte im Export technisch erzwungen werden. Fehlt der Wert, scheitert die XRechnung in vielen Empfänger-Workflows sofort.
[BR-CO-14]-Invoice total VAT amount (BT-110) = Σ VAT category tax amount (BT-117).
Offizielle Regelreferenzen (validator v2026-01-31, schematron v2.5.0): BR-CO-14, BR-46, BR-CO-17, BR-DEC-20, BR-AE-09, BR-E-09, BR-G-09, BR-IC-09
- Es ist für Steuerlogik, Summenprüfung und länderspezifische Vorgaben der XRechnung relevant.
- Pflichtfelder sollten bereits beim Erstellen der Rechnung technisch erzwungen werden und nicht erst kurz vor dem Export.
- Beträge sollten aus den Einzelwerten berechnet statt manuell überschrieben werden.
Typische Fehler bei BT-117
- Den Wert nur visuell im PDF zu pflegen, aber nicht sauber ins XML zu übertragen.
- Beträge manuell nachzuziehen, statt sie aus Positionen, Nachlässen und Steuern zu berechnen.
- Abhängige Felder und verbundene Regeln nicht gemeinsam zu prüfen, obwohl genau dort viele Validator-Fehler entstehen.
Werte, Format und Eingabehinweise
- Nur aus Positions- und Summenlogik berechnen, nicht manuell glattziehen.
- Maximal die erlaubte Dezimalgenauigkeit verwenden und Rundungen nachvollziehbar halten.
- Betragsfelder müssen zur Rechnungswährung und zu den Steuerbeträgen passen.
XML-Mapping für UBL und CII
cac:TaxTotal/cac:TaxSubtotal//ram:ApplicableHeaderTradeSettlement/ram:ApplicableTradeTaxOriginalregeln und deutsche Einordnung
Originaltext bleibt als Referenz sichtbar[BR-CO-14|fatal|EN16931-UBL] [BR-CO-14]-Invoice total VAT amount (BT-110) = Σ VAT category tax amount (BT-117).
[BR-46|fatal|EN16931-UBL] [BR-46]-Each VAT breakdown (BG-23) shall have a VAT category tax amount (BT-117).
Verwandte BT-Felder mit direktem Einfluss
Gesamte USt
BT-110 fasst die gesamte Umsatzsteuer der Rechnung zusammen und verbindet Positionslogik mit den steuerlichen Summen auf Dokumentenebene. Schon kleine Rundungsfehler oder inkonsistente Steuersätze schlagen hier sofort sichtbar durch.
Umsatzsteuerkategorie-Steuerbemessungsgrundlage
BT-116 steht in der XRechnung für Umsatzsteuerkategorie-Steuerbemessungsgrundlage. Es ist für Steuerlogik, Summenprüfung und länderspezifische Vorgaben der XRechnung relevant. Fehlt der Wert oder passt er fachlich nicht, scheitert die Validierung oft direkt. Texte sollten fachlich präzise sein und keine leeren Platzhalter oder PDF-Reste enthalten.
Umsatzsteuerkategorie-Satz
BT-119 steht in der XRechnung für Umsatzsteuerkategorie-Satz. Es ist für Steuerlogik, Summenprüfung und länderspezifische Vorgaben der XRechnung relevant. Das Feld ist nicht immer verpflichtend, beeinflusst aber oft Annahme, Nachvollziehbarkeit und Automatisierung. Texte sollten fachlich präzise sein und keine leeren Platzhalter oder PDF-Reste enthalten.
Umsatzsteuerkategorie-Code
BT-118 steht in der XRechnung für Umsatzsteuerkategorie-Code. Es ist für Steuerlogik, Summenprüfung und länderspezifische Vorgaben der XRechnung relevant. Fehlt der Wert oder passt er fachlich nicht, scheitert die Validierung oft direkt. Kennungen sollten exakt aus dem führenden System übernommen und nicht nachträglich formatiert werden.
Aus Theorie sofort eine valide XML machen
Nutze BT-117 nicht nur als Nachschlagepunkt. Prüfe den Feldwert direkt im Generator oder lass bestehende XMLs gegen die KoSIT-Regeln validieren, bevor der Empfänger ablehnt.
FAQ zu BT-117 vor dem XML-Versand
Antworten zu Kategorie, Pflichtgrad und typischen Validator-Fallen auf Basis offizieller XRechnung- und Peppol-Quellen.
Wie trage ich BT-117 Umsatzsteuerkategorie-Steuerbetrag korrekt in der XRechnung ein?Aufklappen
Für BT-117 gelten immer der offizielle Feldbegriff, der Datentyp Amount und die Kardinalität 1..1. 1..1 bedeutet für BT-117 genau einmal. Der Wert muss maschinenlesbar im XML stehen und darf nicht nur im PDF sichtbar sein. Beträge direkt aus dem Rechenwerk übernehmen, sauber runden und mit der passenden Währung ausgeben. Direkt mitprüfen sollten Sie BT-110, BT-116, BT-119 und BT-118.
Was muss ich bei BT-117 in der Kategorie Steuerbeträge besonders beachten?Aufklappen
BT-117 gehört zur Kategorie Steuerbeträge. Genau hier prüft XRechnung besonders streng auf Währung, Rundung und rechnerische Ableitung. Sobald Steuerbuchhaltungswährung, Steueraufschlüsselung oder Steuersumme nicht konsistent zusammenpassen, schlägt der Validator sehr schnell an. Besonders relevant auf dieser Seite sind die Regelreferenzen BR-CO-14, BR-46 und BR-CO-17.
Was passiert, wenn BT-117 als Pflichtfeld fehlt?Aufklappen
BT-117 gehört zu den Pflichtangaben und sollte technisch bereits vor dem Export erzwungen werden. Fehlt der Wert, ist die Rechnung in der Praxis oft schon in der Grundvalidierung oder im Empfänger-Workflow blockiert. Besonders relevant auf dieser Seite sind die Regelreferenzen BR-CO-14, BR-46 und BR-CO-17.
Wie vermeide ich bei BT-117 einen Validator-Fehler oder eine Ablehnung?Aufklappen
Am sichersten ist ein direkter XML-Export aus dem führenden System statt manueller Nacharbeit. Prüfe BT-117 immer zusammen mit Datentyp, Format, Häufigkeit und den gekoppelten Feldern. Beträge direkt aus dem Rechenwerk übernehmen, sauber runden und mit der passenden Währung ausgeben. Direkt mitprüfen sollten Sie BT-110, BT-116, BT-119 und BT-118.