FSG (ehemals IADB)#

Die FSG-Formate bilden den Datenaustausch zwischen Einspeisenden, FSG/IADB und Ausführenden ab. Maßgeblich ist die Original-Spezifikation Aufbau der Dateien für den Datenaustausch mit der IADB — diese PDF ist der verbindliche Vertrag.

„IADB" ist die historische Bezeichnung. In den Formaten bleiben bestimmte Bezeichner bewusst erhalten (z. B. die Spalte IADB-Auftrag oder Auftraggeber = IADB-Nummer des Einspeisenden), damit die Verträge mit den Partnern stabil bleiben.

Es werden drei Formate unterstützt:

Neuaufträge (FSG1) — werden vom Einspeisenden importiert
Statusänderungen (FSG2) — inkl. Außendienstergebnis; Import mit Update sowohl vom Einspeisenden als auch vom Ausführenden
Aufträge (FSG3) — werden von der FSG / IADB als Export bereitgestellt; seit Version 1.5.1035 auch als Import für die Migration von Bestandsdaten

Aufträge (FSG3) sind die Zusammenführung: Sie enthalten sowohl die Felder der Neuaufträge als auch die der Statusänderungen, ergänzt um die FSG-/IADB-Daten.

Container-Regeln#

Alle drei Formate folgen denselben Regeln:

CSV und XLSX sind gleichwertige Container.
CSV: Semikolon-getrennt, UTF-8.
Beträge: mit Komma und ohne Währungszeichen (z. B. 182,55).
Datum: deutsche Form TT.MM.JJJJ (z. B. 01.05.2025); zusätzlich wird das ISO-Datum akzeptiert.
Boolesche Werte: J/N (J = ja).

Die übergreifenden Toleranz- und Container-Details finden Sie unter Formate. Sie können dieselben Daten auch als JSON, YAML oder XML austauschen.

Beispieldaten#

Die Daten unseres Demo-Servers im FSG-Auftragsformat (FSG3) als Beispiel in allen Containern:

Zugang#

Empfohlener Weg ist der CLI livectl. Die wichtigsten Befehle je Format:

# Neuaufträge importieren (FSG1)
livectl assignments import neuauftraege.csv --tenant-id <mandant> --dto fsg1

# Statusänderungen / Außendienstergebnis importieren (FSG2)
livectl assignments import status.csv --tenant-id <mandant> --dto fsg2

# Aufträge exportieren (FSG3)
livectl assignments --dto fsg3 -f csv > auftraege.csv

# Aufträge importieren / Bestand migrieren (FSG3, ab Version 1.5.1035)
livectl assignments import auftraege.csv --tenant-id <mandant> --dto fsg3

Eine vollständige Befehlsübersicht steht auf den jeweiligen Formatseiten.

Sollten Sie eine andere Import- oder Export-Möglichkeit benötigen, melden Sie sich gerne, damit wir die Optionen klären.