Aufträge#

Die Aufträge sind Zusammenstellungen der Aufträge vom Einspeisenden bzw. für den Ausführenden.

Die Felder bestehen aus den Daten der Neuaufträge, dem aktuellen Status und den Außendienstergebnissen. Zusätzlich sind die FSG-/IADB-Daten enthalten, etwa die IADB-Auftragsnummer, das Einstelldatum oder die Abrechnungs-/Rechnungsdaten.

Seit Version 1.5.1035 ist FSG3 nicht mehr nur Export-, sondern auch Importformat: Auftrags- und Ergebnisdaten lassen sich in einem Schritt einspielen — der empfohlene Weg für die Migration von Bestandsaufträgen aus einem Altsystem (siehe Zugang).

Auftragsstatus#

IADB Daten#

Bedeutung der Bearbeitungs-Datumsspalten:

Abschlussdatum ist neu: Damit sehen Sie im Export, wann der Ausführende einen Auftrag abgeschlossen hat. Nur nach diesem Datum lässt sich „abgeschlossen seit …" auswerten (siehe CLI → Filtern); das Bearbeitungsende ist die geplante Frist, nicht der Abschluss.

Die IADB-/Betriebsdaten-Spalten dieser Tabelle sind export-only: Beim FSG3-Import werden sie stillschweigend ignoriert, denn die Workflow-Datumsfelder gehören dem System und werden über die Statusaktionen gesetzt. Eine unveränderte FSG3-Exportdatei ist damit direkt wieder importierbar. Historische Daten übernehmen Sie ausschließlich über die original*-Spalten (siehe Migration von Bestandsaufträgen).

Beauftragung#

Forderung#

Aktendaten#

Konto Einspeisender#

Gläubigerdaten#

Schuldnerdaten#

101 Ratenzahlungsvereinbarung#

301 Schweigepflichtenentbindungserklärung#

320 Einrichtung eines Dauerauftrags#

321 Ermächtigung Lastschrift#

330 Meldung Stammdatenänderung Schuldner#

340 Außendienst-Protokoll#

350 Barinkasso Vollzahlung#

351 Barinkasso Teilzahlung#

352 Barinkasso Teilzahlung unter 20 Euro#

401 Sicherungsabrede#

801 Recherche verwertbare Ansprüche: Arbeitgeber#

802 Recherche verwertbare Ansprüche: Bankverbindung#

803 Recherche verwertbare Ansprüche: Krankenkasse#

804 Recherche verwertbare Ansprüche: Rentenversicherung#

805 Recherche verwertbare Ansprüche: Vermieter#

806 Recherche Stammdatenergänzung: Telefonnummer#

807 Recherche Stammdatenergänzung: e-Mail-Adresse#

808 Recherche Stammdatenergänzung: Sterbedatum#

809 Recherche Stammdatenergänzung: Insolvenzdatum#

810 Beantwortung besondere Fragestellung#

815 Verifizierte neue Anschrift#

900 Protokoll 3. Außendienstbesuch#

Achtung: Feldnamen
Der Feldname 3ADP... ist nur bei csv Dateien erlaubt, in yaml, xml etc. dürfen Feldnamen nicht mit einer Ziffer beginnen. Wenn Sie für den Import eins dieser Formate verwenden wollen, stellen sie die Ziffer nach hinten also z.B. ADP3_angetroffen1_JN.

Migration von Bestandsaufträgen (original*-Felder)#

Beim normalen Import eines Neuauftrags berechnet das System die Workflow-Felder selbst: Es setzt den Status auf zu bestätigen und vergibt die Zeitstempel (Anlage, Zustellung, Bestätigung …) anhand des Imports.

Wenn Sie hingegen Bestandsdaten aus einem Altsystem übernehmen wollen, sollen der historische Status und seine historischen Daten erhalten bleiben. Dafür dürfen Sie zusätzliche original*-Spalten mitgeben, die die berechneten Werte überschreiben. Diese Felder sind rein optional – ohne sie verhält sich der Import wie bisher.

Empfohlener Migrationsweg ist seit Version 1.5.1035 der FSG3-Import (Auftrags- und Ergebnisdaten in einem Schritt); die original*-Spalten funktionieren aber genauso auf dem FSG1-Import:

livectl assignments import bestand.csv --tenant-id <mandant> --dto fsg3

Alles-oder-nichts. Sobald Sie originalStatus oder eines der original…-Datumsfelder setzen, verlangt das System den vollständigen, zum Status passenden Satz. Fehlt davon auch nur ein Feld, wird die Zeile mit folgender Meldung abgelehnt:

requires a complete original* envelope when any original status field is set

Immer Pflicht (sobald der Status mitgegeben wird): originalStatus und originalCreated (Anlagedatum). Abhängig vom Status zusätzlich:

originalDeliveryDate ist das Zustell-/Übergabedatum. originalDueDate ist kein Pflichtfeld und ersetzt originalDeliveryDate nicht – ein häufiger Grund für die obige Fehlermeldung ist, dass bei Status bestätigt zwar das Bestätigungsdatum, aber kein Zustelldatum gesetzt ist.

Optional und nur überschreibend, falls gesetzt: originalDueDate, originalAutoConfirmAt, originalCompletionDate.

Datumswerte werden im gewohnten deutschen Format (TT.MM.JJJJ) oder als ISO-Datum akzeptiert.

Partner-Übernahme (unabhängig vom Status)#

originalRef (die Alt-Auftragsreferenz) sowie der Partner-Override (originalPartnerId / originalPartnerRef) sind vom Status-Envelope entkoppelt und dürfen allein stehen, ohne die obigen Pflichten auszulösen. Mit ihnen übernehmen Sie den historischen Ausführenden direkt, statt ihn über die Schuldner-PLZ zuordnen zu lassen.

Die original*-Felder beim Import und der zugehörige Export (siehe unten) sind Administratoren des Mandanten vorbehalten.

Zugang#

CLI (empfohlen)#

Aufträge werden mit dem DTO fsg3 gelesen — der Export ist der Lese-Befehl, einen eigenen export-Unterbefehl für Aufträge gibt es nicht:

# in die Standardausgabe (z. B. per Umleitung in eine Datei)
livectl assignments --dto fsg3 -f csv > auftraege.csv

# oder direkt mit Zieldatei
livectl assignments list auftraege.csv --dto fsg3 -f csv

# einzelner Auftrag als JSON
livectl assignments read <id> --dto fsg3 -f json

Das Format steuern Sie über -f (csv, json, yaml, xml).

Seit Version 1.5.1035 lassen sich FSG3-Dateien auch importieren — Auftrags- und Ergebnisdaten in einem Schritt, idempotent (Upsert: wiederholtes Einspielen aktualisiert statt abzubrechen und erhält erfasste Ergebnisse):

livectl assignments import auftraege.csv --tenant-id <mandant> --dto fsg3

Die IADB-/Betriebsdaten-Spalten werden dabei ignoriert (export-only); historische Status-, Datums- und Partner-Stände übernehmen Sie über die original*-Spalten (nur für Administratoren des Mandanten).

Programmatischer Zugang#

Die REST-API ist unter /api erreichbar (Authentifizierung per Bearer-Token, siehe API). Empfohlen und am einfachsten ist der Weg über den CLI.

Migrations-Vorlage mit original*-Spalten#

Für eine Bestandsmigration erzeugen Sie sich am einfachsten eine passende Vorlage, indem Sie den Export um die original*-Spalten erweitern. Die so erzeugte Datei ist round-trip-fähig: Sie können sie ausfüllen und unverändert wieder importieren.

livectl assignments list vorlage.csv --dto fsg3 -f csv --original-fields

--original-fields ist Administratoren des Mandanten vorbehalten; Nicht-Admins erhalten 403.