123
BT-123OptionalTier 3 · Langtail-Ausbau

BT-123: Gesamt-Umsatzsteuerbetrag

BT-123 steht in der XRechnung für Gesamt-Umsatzsteuerbetrag. Es gehört zur kritischen Summenlogik der Rechnung und darf nur aus konsistenten Einzelwerten entstehen. Das Feld ist nicht immer verpflichtend, beeinflusst aber oft Annahme, Nachvollziehbarkeit und Automatisierung. Beträge sollten aus den Einzelwerten berechnet statt manuell überschrieben werden.

Kategorie
Gesamtbeträge
Datentyp
Amount
Kardinalität
0..1
Regelreferenzen
0 Stück

Pflicht, Definition und Praxiskontext

Das Feld ist nicht in jeder Rechnung Pflicht, kann aber für Routing, Steuerlogik oder saubere Folgeprozesse trotzdem entscheidend sein.

Offizielle Definition / Regelkern

Offizieller XRechnung-Begriff für den Betrag Gesamt-Umsatzsteuerbetrag.

  • Es gehört zur kritischen Summenlogik der Rechnung und darf nur aus konsistenten Einzelwerten entstehen.
  • Optional heißt in der XRechnung nicht automatisch unwichtig: Viele Empfängerprozesse nutzen das Feld trotzdem operativ.
  • Beträge sollten aus den Einzelwerten berechnet statt manuell überschrieben werden.

Typische Fehler bei BT-123

  • Das Feld als optional zu behandeln, obwohl der jeweilige Empfängerprozess oder Sonderfall es faktisch benötigt.
  • 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

UBL 2.1XPath
Für dieses Feld liegt im aktuellen Bundle kein stabiler UBL-Pfad in den importierten Upstream-Daten vor.
UN/CEFACT CIIXPath
Für dieses Feld liegt im aktuellen Bundle kein stabiler CII-Pfad in den importierten Upstream-Daten vor.

Verwandte BT-Felder mit direktem Einfluss

BT-122

Rundungsbetrag

BT-122 steht in der XRechnung für Rundungsbetrag. Es gehört zur kritischen Summenlogik der Rechnung und darf nur aus konsistenten Einzelwerten entstehen. Das Feld ist nicht immer verpflichtend, beeinflusst aber oft Annahme, Nachvollziehbarkeit und Automatisierung. Beträge sollten aus den Einzelwerten berechnet statt manuell überschrieben werden.

BT-124

Gesamtbetrag mit Umsatzsteuer

BT-124 steht in der XRechnung für Gesamtbetrag mit Umsatzsteuer. Es gehört zur kritischen Summenlogik der Rechnung und darf nur aus konsistenten Einzelwerten entstehen. Fehlt der Wert oder passt er fachlich nicht, scheitert die Validierung oft direkt. Beträge sollten aus den Einzelwerten berechnet statt manuell überschrieben werden.

BT-121

Gesamter Vorauszahlungsbetrag

BT-121 steht in der XRechnung für Gesamter Vorauszahlungsbetrag. Es gehört zur kritischen Summenlogik der Rechnung und darf nur aus konsistenten Einzelwerten entstehen. Das Feld ist nicht immer verpflichtend, beeinflusst aber oft Annahme, Nachvollziehbarkeit und Automatisierung. Beträge sollten aus den Einzelwerten berechnet statt manuell überschrieben werden.

BT-125

Fälliger Zahlungsbetrag

BT-125 steht in der XRechnung für Fälliger Zahlungsbetrag. Es gehört zur kritischen Summenlogik der Rechnung und darf nur aus konsistenten Einzelwerten entstehen. Fehlt der Wert oder passt er fachlich nicht, scheitert die Validierung oft direkt. Beträge sollten aus den Einzelwerten berechnet statt manuell überschrieben werden.

Aus Theorie sofort eine valide XML machen

Nutze BT-123 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-123 vor dem XML-Versand

Antworten zu Kategorie, Pflichtgrad und typischen Validator-Fallen auf Basis offizieller XRechnung- und Peppol-Quellen.

FAQ
Wie trage ich BT-123 Gesamt-Umsatzsteuerbetrag korrekt in der XRechnung ein?Aufklappen

Für BT-123 gelten immer der offizielle Feldbegriff, der Datentyp Amount und die Kardinalität 0..1. 0..1 bedeutet für BT-123 höchstens 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-122, BT-124, BT-121 und BT-125.

Was muss ich bei BT-123 in der Kategorie Gesamtbeträge besonders beachten?Aufklappen

BT-123 gehört zur Kategorie Gesamtbeträge und ist Teil der zentralen Rechenlogik der Rechnung. Offizielle Regeln koppeln hier Summen, Steuerbeträge, Zahlungen und Rundung sehr eng. Schon kleine Abweichungen in Vorzeichen, Währung oder Dezimalstellen erzeugen schnell fatale Validator-Fehler. Auch bei Feldern ohne explizit eingespielte Detailregel gilt: Format, Häufigkeit und fachlicher Kontext müssen zur Spezifikation passen.

Wann sollte BT-123 trotz Optional-Status trotzdem gesetzt werden?Aufklappen

Optional heißt in XRechnung nicht nebensächlich. Setze BT-123, wenn der konkrete Geschäftsfall, der Empfängerprozess oder gekoppelte Daten es fachlich verlangen. Sobald das Feld im XML auftaucht, muss es vollständig, fachlich passend und regelkonform befüllt sein. Direkt mitprüfen sollten Sie BT-122, BT-124, BT-121 und BT-125.

Wann darf BT-123 leer bleiben und wann löst es Folgeprüfungen aus?Aufklappen

BT-123 kann leer bleiben, wenn Ihr Szenario die Angabe nicht benötigt und kein Empfänger sie vorgibt. Sobald Sie das Feld jedoch setzen, greifen die offiziellen Format-, Kardinalitäts- und Kopplungsregeln. Auch bei Feldern ohne explizit eingespielte Detailregel gilt: Format, Häufigkeit und fachlicher Kontext müssen zur Spezifikation passen.