Administration on INKASSO.live

Konten

Mon, 01 Jan 0001 00:00:00 +0000

Konten verwalten#

Konten (Accounts) sind die Zugänge der einzelnen Anwender. Sie verwalten sie über das Aggregat accounts (Alias acc). Es gilt das gleiche Verb-Schema wie bei allen Stammdaten: import (patchen), export, list, read, archive, remove, restore, purge.

Es gibt kein delete. Zum Entfernen verwenden Sie remove (wiederherstellbar) bzw. purge (endgültig).

Konten bearbeiten#

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

Auftraggeber

Mon, 01 Jan 0001 00:00:00 +0000

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 clients list

Mit -f wide werden zusätzliche Spalten (u. a. die vollständige ID) angezeigt.

Datenaustausch

Mon, 01 Jan 0001 00:00:00 +0000

Datenaustausch#

Der Datenaustausch umfasst den Import und Export von Aufträgen sowie von Stammdaten (Auftraggeber, Partner, Postleitzahlen). Empfohlener Weg ist der Kommandozeilen-Client livectl (siehe CLI-Einrichtung).

Für programmatischen Zugang gibt es eine REST-API unter /api (Authentifizierung über ein per livectl login erzeugtes Token). Der Datenimport läuft dort über die generische Import-Schnittstelle mit dem jeweiligen DTO (fsg1/fsg2/fsg3). Der einfachste und empfohlene Weg bleibt jedoch der CLI.

Aufträge#

Aufträge tauschen Sie über den Befehl assignments (Aliase: assignment, ass, t) und das passende DTO aus.

Partner

Mon, 01 Jan 0001 00:00:00 +0000

Partner (Ausführende) verwalten#

Ein Partner (Rolle „Ausführender") ist eine Organisation, die Aufträge im Außendienst bearbeitet. Sie pflegen die Partner über das Aggregat partners.

Es gibt kein delete. Zum Entfernen verwenden Sie remove/archive (wiederherstellbar) bzw. purge (endgültig).

Partner auflisten#

livectl partners list

Import / Export#

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

Bestand exportieren
```
livectl partners export partner.yaml -f yaml
```
Für eine tabellarische Ansicht (ohne Re-Import) exportieren Sie zusätzlich -f csv oder -f xlsx.

Onboarding

Mon, 01 Jan 0001 00:00:00 +0000

Onboarding#

Einen neuen Zugang richten Sie in zwei Schritten ein: Der Administrator erzeugt ein Registrierungstoken, der Anwender registriert und meldet sich anschließend damit an.

Registrierungstoken erzeugen (Administrator)#

Ein Registrierungstoken für ein bestehendes Konto erzeugen Sie über das Aggregat accounts:

livectl accounts token <konto-id>

Optional steuern --multi-use (mehrfach verwendbar) und --ttl-days <tage> (Gültigkeit) das Token. Geben Sie das erzeugte Token sicher an den neuen Anwender weiter. Vorhandene Tokens listen Sie mit livectl tokens list; livectl tokens create <datei> legt Token-Zeilen gesammelt aus einer YAML-Datei an.