↓ Zum Hauptinhalt springen
csv2zugferd

docs

BT-9 Fälligkeitsdatum in ZUGFeRD richtig mappen

BT-9 ist das Fälligkeitsdatum (Zahlungsziel) in ZUGFeRD und XRechnung. So setzen Sie es in csv2zugferd über paymentTerms.dueDate – mit CSV-Beispiel und typischen Fehlern.

BT-9 ist das Fälligkeitsdatum – der Tag, bis zu dem die Rechnung zu zahlen ist. In csv2zugferd setzen Sie es über paymentTerms.dueDate. Es macht das Zahlungsziel eindeutig, statt es nur in einer Freitext-Zahlungsbedingung zu beschreiben.

Was ist BT-9?
#

BT-9 (Payment due date) gibt das konkrete Datum an, bis zu dem die Zahlung erwartet wird. Es ist ein strukturiertes Datum und damit maschinell auswertbar – im Unterschied zu einer reinen Textangabe wie „zahlbar innerhalb von 14 Tagen".

Pflicht oder optional?
#

Optional nach EN 16931. Sinnvoll ist BT-9 überall dort, wo ein festes Zahlungsziel gilt. Dann kann der Empfänger das Datum direkt übernehmen, ohne es aus den Zahlungsbedingungen errechnen zu müssen.

YAML-Key in csv2zugferd
#

paymentTerms:
  description:
    value: "Zahlbar ohne Abzug bis zum Faelligkeitsdatum"
  dueDate:
    column: "INVOICE_DUEDATE"

dueDate entspricht BT-9. description ist die optionale Freitext-Zahlungsbedingung und ersetzt das strukturierte Datum nicht.

CSV-Beispiel
#

INVOICE_DATEINVOICE_DUEDATE
31.05.202624.06.2026

INVOICE_DUEDATE (24.06.2026) wird auf BT-9 gemappt. Das Datum muss dem in csv.dateFormat konfigurierten Format entsprechen.

So landet der Wert im ZUGFeRD-XML
#

paymentTerms.dueDate wird als Fälligkeitsdatum (SpecifiedTradePaymentTerms → DueDateDateTime) geschrieben. Wie alle Datumsfelder wird der Wert anhand von csv.dateFormat geparst.

Typischer Fehler
#

  • Zahlungsbedingung ohne strukturiertes Datum – nur ein Freitext in description, aber kein dueDate.
  • Datumsformat passt nicht zum konfigurierten csv.dateFormat.
  • Fälligkeitsdatum mit Lieferdatum verwechselt – BT-9 und BT-72 haben unterschiedliche Bedeutung.
  • IBAN nur im Text der Zahlungsbedingung – etwa „Zahlbar bis 24.06.2026 auf DE02 …“ in description. Die Bankverbindung gehört strukturiert in paymentMeans, sonst kann der Empfänger sie nicht automatisch übernehmen.

Praxishinweis für csv2zugferd
#

BT-9 regelt nur, wann gezahlt wird. Wohin gezahlt wird, steht getrennt davon im Block paymentMeans (ab Version 1.1.0): IBAN, BIC und Kontoinhaber des Verkäufers (BT-84 bis BT-86) sowie bei SEPA-Lastschrift Gläubiger-ID, Mandatsreferenz und IBAN des Käufers (BT-89 bis BT-91). Beide Blöcke stehen nebeneinander in der YAML-Datei – siehe Beispiel Bankverbindung und SEPA-Lastschrift.

Steht in der CSV kein eigenes Fälligkeitsdatum, kann – wie in der Demo – dieselbe Datumsspalte für Rechnungs- und Fälligkeitsdatum genutzt werden; sauberer ist eine eigene Spalte.

Weiterführende Links#

Häufige Fragen

Ist BT-9 ein Pflichtfeld?

Nein, BT-9 ist optional. Das Fälligkeitsdatum ist aber praxisüblich, weil es dem Empfänger ein eindeutiges Zahlungsziel nennt, statt es aus einer Freitext-Zahlungsbedingung ableiten zu müssen.

Worin unterscheidet sich BT-9 vom Lieferdatum?

BT-9 ist das Fälligkeitsdatum – bis wann die Rechnung zu zahlen ist. Das Lieferdatum BT-72 gibt dagegen an, wann geliefert oder die Leistung erbracht wurde. Beide dürfen nicht verwechselt werden.