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#

Feld	Typ
IADB-Auftrag	Text
Auftragsstatus	Text

IADB Daten#

Feld	Typ
lupdate	Datum
EinspeisenderNr	Text
Einspeisender	Text
AusführenderNr	Text
Ausführender	Text
Einstelldatum	Datum
Bestätigungsdatum	Datum
Bearbeitungsende	Datum
Abschlussdatum	Datum
Rückgabedatum	Datum
Rechnungsdatum	Datum

Bedeutung der Bearbeitungs-Datumsspalten:

Spalte	Bedeutung
`Einstelldatum`	Anlage bzw. Übernahme des Auftrags.
`Bestätigungsdatum`	Bestätigung durch den Ausführenden.
`Bearbeitungsende`	Soll-Frist, bis zu der der Ausführende den Auftrag bearbeiten soll — nicht der Abschlusszeitpunkt.
`Abschlussdatum`	Zeitpunkt, an dem der Ausführende den Auftrag abgeschlossen hat (Aktion „Abschließen").
`Rückgabedatum`	Fachliche Rückgabe des Auftrags.
`Rechnungsdatum`	Abrechnung des Auftrags.

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#

Feld	Typ
Auftragsart	Text

Forderung#

Feld	Typ
Hauptforderung	Betrag
Kosten	Betrag
Zinsen	Betrag
Zahlungen	Betrag
Gesamtforderung	Betrag
Tageszinsen	Betrag
Forderungsbegründung	Text

Aktendaten#

Feld	Typ
Stadium	Text
Telefon	Text
AktenzeichenEinspeisender	Text
Bemerkung	Text
Vergleichsgrenze	Text
Ratenzahlungsgrenze	Text
AktenzeichenDesGlaeubigers	Text
BezeichnungRatenzahlungsvereinbarung	Text
GebuehrRatenzahlungsvereinbarung	Betrag
MwStGegenueberDemSchuldnerAusweisen	JN

Konto Einspeisender#

Feld	Typ
eBank	Text
eKontoinhaber	Text
eBIC	Text
eIBAN	Text

Gläubigerdaten#

Feld	Typ
gVorname	Text
gName1	Text
gName2	Text
gPLZ	Text(5)
gOrt	Text
gUrsprungsglaeubiger	Text
gSepaMandateReference	Text
gSepaClientIdentificationNumber	Text

Schuldnerdaten#

Feld	Typ
sAnrede	Text
sVorname	Text
sName1	Text
sName2	Text
sStrasse	Text
sPLZ	Text(5)
sOrt	Text
sVoradressen	Text
sGeburtsdatum	Datum
sGeburtsname	Text
sTelefon	Text
sEmail	Text
sFamilienstand	Text
sDatumEV	Datum
sDatumHaftbefehl	Datum
sBank	Text
sKontoinhaber	Text
sBIC	Text
sIBAN	Text
sKinder	Text
sEinkommen	Text
sArbeitgeber	Text
sLebensversicherung	Text
sBausparer	Text
sPKW	Text
sVermieter	Text
sSonstigesPfaendbaresVermoegen	Text

101 Ratenzahlungsvereinbarung#

Feld	Typ
RZV101_Unterschriftsdatum	Datum
RZV101_Bank	Text
RZV101_Vergleichsbetrag	Betrag
RZV101_ÜberweisungsdatumVoll	Datum
RZV101_Schuldanerkenntnis	Betrag
RZV101_Kosten	Betrag
RZV101_Ratenhöhe	Betrag
RZV101_ersteRate	Datum
RZV101_monatlichzum	1 bis 31
RZV101_Befristung	Datum
RZV101_Barinkasso	Betrag
RZV101_Quittung	Text

301 Schweigepflichtenentbindungserklärung#

Feld	Typ
SEE301_Krankenkasse_JN	JN
SEE301_Krankenkasse	Text
SEE301_Rentenversicherungsträger_JN	JN
SEE301_Rentenversicherungsträger	Text
SEE301_Rentenversicherungsnummer	Text
SEE301_Kreditinstitut_JN	JN
SEE301_Kreditinstitut	Text
SEE301_Unterschriftsdatum	Datum

320 Einrichtung eines Dauerauftrags#

Feld	Typ
DA320_sName	Text
DA320_sAdresse	Text
DA320_sBank	Text
DA320_sBLZ	Text
DA320_sKto	Text
DA320_sIBAN	Text
DA320_sBIC	Text
DA320_Ratenbetrag	betrag
DA320_Beginn	Datum
DA320_Intervall	Text
DA320_Unterschriftsdatum	Datum

321 Ermächtigung Lastschrift#

Feld	Typ
LS321_sName	Text
LS321_sAdresse	Text
LS321_sBank	Text
LS321_sBLZ	Text
LS321_sKto	Text
LS321_sIBAN	Text
LS321_sBIC	Text
LS321_Ratenbetrag	Betrag
LS321_Beginn	Datum
LS321_Intervall	Text
LS321_Unterschriftsdatum	Datum

330 Meldung Stammdatenänderung Schuldner#

Feld	Typ
MSA330_Anrede	Text
MSA330_Vorname	Text
MSA330_Name1	Text
MSA330_Name2	Text
MSA330_Strasse	Text
MSA330_Hausnummer	Text
MSA330_PLZ	Text
MSA330_Ort	Text
MSA330_Voradresse	Text
MSA330_Geburtsdatum	datum
MSA330_Geburtsname	Text
MSA330_Telefonnummer	Text
MSA330_Email	Text
MSA330_Familienstand	Text
MSA330_DatumEV	datum
MSA330_DatumHaftbefehl	datum
MSA330_Bank	Text
MSA330_BLZ	Text
MSA330_KontoNr	Text
MSA330_Kontoinhaber	Text
MSA330_BIC	Text
MSA330_IBAN	Text
MSA330_Kinder	Zahl
MSA330_Einkommen	Text
MSA330_Arbeitgeber	Text
MSA330_Lebensversicherung	Text
MSA330_Bausparer	Text
MSA330_PKW	Text
MSA330_Vermieter	Text
MSA330_sonstiges pfändbare Vermögen	Text
MSA330_Notizen	Text

340 Außendienst-Protokoll#

Feld	Typ
AD340_Ausweisnummer	Text
AD340_verstorben	Text
AD340_Wohnsituation	Text
AD340_Etage	Text
AD340_Tür	Text
AD340_Sonstiges	Text
AD340_Briefkasten	Text
neu AD340_Besuchsdatum1	Datum
AD340_angetroffen1_JN	JN
AD340_Vereinbarung1_JN	JN
AD340_bestritten_HF1_JN	JN
AD340_bestritten_NF1_JN	JN
AD340_Benachrichtigungskarte1_JN	JN
AD340_SonstigesBesuch1	Text
neu AD340_Besuchsdatum2	Datum
AD340_angetroffen2_JN	JN
AD340_Vereinbarung2_JN	JN
AD340_bestritten_HF2_JN	JN
AD340_bestritten_NF2_JN	JN
AD340_Benachrichtigungskarte2_JN	JN
AD340_SonstigesBesuch2
AD340_Rückruf	Text
AD340_Erfolgsaussicht	Zahl
AD340_Empfehlung	Text

350 Barinkasso Vollzahlung#

Feld	Typ
VZ350_VollzahlungBetrag	Betrag
VZ350_Datum	Datum
VZ350_Quittung	Text

351 Barinkasso Teilzahlung#

Feld	Typ
TZ351_TeilzahlungBetrag	Betrag
TZ351_Datum	Datum
TZ351_Quittung	Text

352 Barinkasso Teilzahlung unter 20 Euro#

Feld	Typ
TZ352_TeilzahlungBetrag	Betrag
TZ352_Datum	Datum
TZ352_Quittung	Text

401 Sicherungsabrede#

Feld	Typ
SAR401_SARDatum	Datum
SAR401_SARBesonderes	Text

801 Recherche verwertbare Ansprüche: Arbeitgeber#

Feld	Typ
RVAA_Arbeitgeber	Text
RVAA_Straße	Text
RVAA_Postleitzahl	Text
RVAA_Ort	Text
RVAA_Verdienst	Betrag

802 Recherche verwertbare Ansprüche: Bankverbindung#

Feld	Typ
RVAB_Bank	Text
RVAB_IBAN	Text

803 Recherche verwertbare Ansprüche: Krankenkasse#

Feld	Typ
RVAK_Krankenkasse	Text
RVAK_Straße	Text
RVAK_PLZ	Text
RVAK_Ort	Text

804 Recherche verwertbare Ansprüche: Rentenversicherung#

Feld	Typ
RVAR_Rentenversicherung	Text
RVAR_Straße	Text
RVAR_PLZ	Text
RVAR_Ort	Text

805 Recherche verwertbare Ansprüche: Vermieter#

Feld	Typ
RVAV_Vermieter	Text
RVAV_Straße	Text
RVAV_PLZ	Text
RVAV_Ort	Text
RVAV_Telefonnummer	Text

806 Recherche Stammdatenergänzung: Telefonnummer#

Feld	Typ
RSET_Telefonnummer	Text

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

Feld	Typ
RSEE_EMail	Text

808 Recherche Stammdatenergänzung: Sterbedatum#

Feld	Typ
RSES_Sterbedatum	Text

809 Recherche Stammdatenergänzung: Insolvenzdatum#

Feld	Typ
RSEI_Insolvenzdatum	Datum
RSEI_Amtsgericht	Text
RSEI_Aktenzeichen	Text

810 Beantwortung besondere Fragestellung#

Feld	Typ
BBFS_Antwort	Text

815 Verifizierte neue Anschrift#

Feld	Typ
VNA_Straße	Text
VNA_Postleitzahl	Text
VNA_Ort	Text

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.

Feld	Typ
neu 3ADP_Besuchsdatum1	Datum
3ADP_angetroffen1_JN	JN
3ADP_Vereinbarung1_JN	JN
3ADP_bestritten_HF1_JN	JN
3ADP_bestritten_NF1_JN	JN
3ADP_Benachrichtigungskarte1_JN	JN
neu 3ADP_Besuchsdatum2	Datum
3ADP_Angetroffen2_JN	JN
3ADP_Vereinbarung2_JN	JN
3ADP_bestritten_HF2_JN	JN
3ADP_bestritten_NF2_JN	JN
3ADP_Benachrichtigungskarte2_JN	JN
3ADP_Erfolgsaussicht	Text

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:

`originalStatus`	zusätzlich Pflicht
`to_confirm` (zu bestätigen)	`originalDeliveryDate`
`confirmed` (bestätigt)	`originalDeliveryDate`, `originalConfirmationDate`
`processed` (bearbeitet)	`originalDeliveryDate`, `originalConfirmationDate`, `originalProcessedDate`
`to_invoice` (abzurechnen)	`originalDeliveryDate`, `originalConfirmationDate`
`completed` (abgeschlossen)	`originalDeliveryDate`, `originalConfirmationDate`, `originalInvoiceDate`
`cancelled` (storniert)	`originalDeliveryDate`, `originalCancellationDate`
`returned` (zurückgewiesen)	`originalDeliveryDate`, `originalReturnDate`

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.

Gateway-Nummer an bestehenden Aufträgen nachtragen#

Legt ein Einspeisender Aufträge direkt in der App an, haben sie zunächst keine Gateway-Nummer: Die Spalte originalRef ist leer. Der Betreiber des Gateways exportiert diese Aufträge, trägt sie im Gateway ein und spielt die dort erzeugte Nummer anschließend zurück. Dafür genügt seit Version 1.6.1007 eine Datei mit zwei Spalten.

1. Betroffene Aufträge exportieren. Der FSG3-Export mit den original*-Spalten zeigt, welchen Aufträgen die Gateway-Nummer fehlt. In IADB-Auftrag steht dabei immer die Auftragsnummer der App, in originalRef die Gateway-Nummer (leer, solange keine eingetragen ist):

livectl --admin assignments export auftraege.csv --dto fsg3 -f csv --original-fields

2. Rückmeldedatei aufbauen. Je Auftrag eine Zeile mit der Auftragsnummer der App und der Gateway-Nummer, sonst nichts (Semikolon, UTF-8, wie bei allen FSG-Dateien). Die Nummern im Beispiel sind frei erfunden:

IADB-Auftrag;originalRef
100032;GW-0001

3. Im Admin-Modus einspielen (Ausgabe gekürzt):

livectl --admin assignments import gateway-nummern.csv --dto fsg3 --tenant-id <mandant>

Loaded 1 rows from gateway-nummern.csv
Uploading 1 rows
completed [1/1] Completed
Imported 1/1 rows
Done: patch 1/1 rows

Der Import findet den Auftrag über IADB-Auftrag und setzt nur originalRef. Alle übrigen Felder bleiben unverändert, und es entsteht kein zweiter Auftrag.

4. Prüfen. Ein erneuter Export wie in Schritt 1 zeigt die Gateway-Nummer in der Spalte originalRef; IADB-Auftrag bleibt die Auftragsnummer der App. Vergleichen Sie beide Exporte, unterscheidet sich die Zeile des Auftrags nur in originalRef.

Das Nachtragen ändert die Herkunftsdaten eines bestehenden Auftrags und verlangt deshalb den Admin-Modus (--admin) eines Administrators des Mandanten. Ohne den Schalter bricht der Import mit policy.missing_grant: Missing permission ab, und es wird nichts geändert.

Eine Zeile, deren IADB-Auftrag keinen bestehenden Auftrag trifft, wird abgewiesen und nicht als neuer Auftrag angelegt. Die Ausgabe sieht dann so aus (gekürzt):
Imported 0/1 rows, rejected 1
Done: patch 0/1 rows, rejected 1
Rejected row 2 (originalRef=GW-0002): creditorReference: Value is required.; clientReference: Value is required.; …
Die Meldung zählt die Pflichtfelder einer Neuanlage auf, weil die Zeile ohne passenden Auftrag als Neuanlage gelesen wird. Prüfen Sie in diesem Fall die Auftragsnummer. Der Befehl endet dabei trotzdem erfolgreich; achten Sie also auf die Zeile rejected.

Vorsicht beim Überschreiben einer bereits gesetzten Gateway-Nummer: Der Abgleich sucht zuerst über originalRef. Trägt ein anderer Auftrag die neue Nummer schon, trifft die Zeile diesen.