Auftraggeber (Clients) verwalten#

Ein Auftraggeber (engl. Client, Rolle „Einspeisender") ist eine Organisation, die Aufträge in das System einspeist. Im FSG-Kontext entspricht das der einspeisenden Stelle (Auftraggeber = IADB-Nummer des Einspeisenden). Sie pflegen die Auftraggeber über das Aggregat clients.

Es gibt kein delete. Zum Entfernen verwenden Sie remove (wiederherstellbar per restore) oder archive, zum endgültigen Löschen purge.

Auftraggeber auflisten#

$ livectl --admin clients list
ID  Referenz  Name                   E-Mail               Ort
--  --------  ---------------------  -------------------  ---------
a4  AG-4201   Beispiel Inkasso GmbH  kontakt@beispiel.de  Detmold
dc  AG-4202   Muster Forderungen AG  info@muster.de       Bielefeld

Die Spalte ID zeigt den kürzesten eindeutigen Anfang der ID; er genügt für alle weiteren Befehle. Mit -f wide werden zusätzliche Spalten (Telefon, Land, Geschäftsführung, USt-IdNr., Notizen) angezeigt, die vollständige ID liefern die Export-Formate (-f csv, -f json).

Import / Export#

Der übliche Weg ist Export → Bearbeiten → Import. Der Import liest strukturierte Dateien (YAML oder JSON); CSV/XLSX sind reine Export- und Ansichtsformate.

  1. Bestand exportieren

    livectl clients export clients.yaml -f yaml

    Für eine tabellarische Ansicht (ohne Re-Import) exportieren Sie zusätzlich -f csv oder -f xlsx.

  2. Bearbeiten

    Ändern Sie die Auftraggeber in der YAML-Datei.

  3. Wieder importieren

    livectl --admin clients import clients.yaml

    import patcht bestehende Auftraggeber (Auflösung über id, sonst ref). Neue Auftraggeber legen Sie mit livectl clients create neue-clients.yaml an.

Entfernen / Archivieren#

livectl clients remove <id>      # wiederherstellbar (restore)
livectl clients archive <id>     # archivieren
livectl clients purge <id>       # endgültig löschen