Wie bekomme ich Daten ins System - und wie wieder heraus?

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:

  1. 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.csv

    Der Import ist standardmäßig tolerant: gültige Zeilen werden übernommen, fehlerhafte einzeln mit Zeile und Grund gemeldet (in der App als „Ungültig" sichtbar und korrigierbar). Mehr dazu auf der Seite Command Line Interface.

  2. REST-API (synchron) Über die HTTP(S)-REST-API unter /api ist ein synchroner Austausch mit beliebigen Fremdsystemen möglich — die Programmiersprache ist dabei unerheblich (wir testen u. a. mit Go, Python und sogar curl auf der Kommandozeile). Die Authentifizierung erfolgt über ein Bearer-/ApiKey-Token (mit livectl login bzw. livectl bearer zu erzeugen). Der Datenimport läuft über die generische Import-Schnittstelle mit dem jeweiligen DTO (fsg1/fsg2/fsg3); für den empfohlenen Weg nutzen Sie den CLI.

  3. Manuell in der App Sie können Ihre Daten auch direkt in unserer App erfassen. Die App läuft im Browser auf Windows, Mac, Linux, Android und iOS (installierbar als PWA), bietet Offline-Erfassung und -Recherche und ist — wie auch die anderen Schnittstellen — durch Multi-Faktor-Authentifizierung und starke Verschlüsselung geschützt.