inkasso.live bietet verschiedene Schnittstellen an, um Ihre Daten (Aufträge, Ergebnisse, Stammdaten, …) in das System zu importieren und auch wieder zu exportieren (Ergebnisse, Reports, Berichte, …).
Die drei wichtigsten Schnittstellen sind:
-
Datei-Im-/Export (asynchron) Daten werden als Datei eingelesen oder geschrieben — in den Formaten CSV, XLSX, JSON und XML. CSV und XLSX sind dabei gleichwertige Container. Der einfachste und empfohlene Weg dafür ist der Kommandozeilen-Client
livectl. Beispiele:# Neuaufträge importieren livectl assignments import auftraege.csv --tenant-id <mandant> --dto fsg1 # Statusänderungen / Außendienstergebnis importieren livectl assignments import status.csv --tenant-id <mandant> --dto fsg2 # Aufträge exportieren livectl assignments --dto fsg3 -f csv > auftraege.csvDer Import ist standardmäßig tolerant: gültige Zeilen werden übernommen, fehlerhafte einzeln mit Zeile, Feld und Grund gemeldet. Wiederholtes Einspielen derselben Datei ist unschädlich: Vorhandene Aufträge werden aktualisiert, nicht doppelt angelegt. Mehr dazu auf der Seite Command Line Interface.
-
REST-API (synchron) Über die HTTP(S)-REST-API unter
/apiist ein synchroner Austausch mit beliebigen Fremdsystemen möglich — die Programmiersprache ist dabei unerheblich (wir testen u. a. mit Go, Python und sogarcurlauf der Kommandozeile). Die Anmeldung erfolgt über einen API-Schlüssel, den ein Administrator für ein Konto ausstellt. Der Datenimport läuft über die generische Import-Schnittstelle mit dem jeweiligen DTO (fsg1/fsg2/fsg3). Die Beschreibung des freigegebenen Teils finden Sie unter API. -
Manuell in der App Sie können Aufträge direkt in unserer App erfassen oder eine CSV-Datei einfach auf die Auftragsliste ziehen. Die App läuft im Browser auf Windows, Mac, Linux, Android und iOS (installierbar als PWA), bietet Offline-Erfassung und -Recherche und ist durch Passkey bzw. Passwort mit Sicherheitscode und verschlüsselte Übertragung geschützt.