Der Import ist tolerant: Gültige Zeilen werden übernommen, fehlerhafte einzeln abgewiesen – mit Zeilennummer, betroffenem Feld und Grund. Das gilt für den Kommandozeilen-Client ebenso wie für eine Datei, die Sie in der App auf die Auftragsliste ziehen; dort sehen Sie nach dem Import, welche Zeilen nicht übernommen wurden und warum.

Häufige Gründe:

• Pflichtfeld fehlt oder hat ein ungültiges Format (z. B. Datum).
• Postleitzahl ohne Partnerzuordnung – oft ein Zahlendreher.
• Unplausible Werte, etwa ein Geburtsdatum, das mehr als 120 Jahre zurückliegt.
• Unbekannter Auftraggeber.

Korrigieren Sie die betroffenen Zeilen und spielen Sie die Datei einfach erneut ein. Das ist unschädlich: Bereits vorhandene Aufträge werden über Ihr Aktenzeichen wiedererkannt und aktualisiert, nicht doppelt angelegt, und bereits erfasste Ergebnisse bleiben erhalten. Auf dieselbe Weise spielen Sie auch nachträgliche Korrekturen (etwa eine geänderte Anschrift) ein. Bitte halten Sie das Aktenzeichen dafür über alle Lieferungen stabil.

Ja. Über die REST-API legen Sie Aufträge an, lesen und listen sie und ändern sie – aus jeder Programmiersprache. Jede Anfrage meldet sich mit einem API-Schlüssel an. Den Schlüssel stellt ein Administrator für ein Konto aus; er wird nur einmal angezeigt und handelt mit den Rechten dieses Kontos.

Die vollständige Beschreibung mit Leitfaden und einem Beispiel je Endpunkt finden Sie unter API, auf Deutsch und Englisch, als Webseite, PDF und OpenAPI-Datei. Beschrieben ist nur der freigegebene Teil. Auf ihn können Sie sich verlassen, er wird nur erweitert.

Es gibt zwei Wege:

• In der App: In der Auftragsliste lädt der Download-Knopf die aktuell angezeigten Aufträge als CSV-Datei herunter.

• Mit livectl: Für regelmäßige oder automatisierte Exporte, zum Beispiel zurück in Ihre Fachanwendung:

  livectl assignments --dto fsg3 -f csv > auftraege.csv

Der Export enthält Auftrags- und Ergebnisdaten im FSG3-Format, siehe Aufträge (FSG3). Die Dokumente, die der Außendienst zu einem Auftrag ablegt, laden Sie im Auftrag selbst herunter.

Ein Export braucht eine Verbindung zum Server. Dauert er ungewöhnlich lange oder wird nicht fertig, melden Sie sich bitte beim Support – mit Uhrzeit und dem verwendeten Filter.

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, 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.

Nach dem Einspielen ordnet inkasso.live jeden Auftrag anhand der Postleitzahl des Schuldners automatisch dem zuständigen Partner zu. Der Auftrag steht dann auf „zu bestätigen". Der Partner bestätigt ihn und bearbeitet ihn mit seinem Außendienst. Ab Version 1.6 kann die ausführende Seite einen Auftrag zusätzlich gezielt einer Kollegin oder einem Kollegen aus der eigenen Firma zuweisen.

Der grobe Ablauf:

1. zu bestätigen – dem Partner zugeordnet, noch nicht angenommen
2. bestätigt – angenommen, in Bearbeitung
3. bearbeitet – der Außendienst hat seine Ergebnisse eingetragen und abgeschlossen; das Backoffice prüft und schließt ab

Welche Aktionen Sie sonst sehen, hängt von Ihrer Rolle ab. Fehlt Ihnen ein Knopf, ist er für Ihr Konto nicht freigeschaltet. Ihr Administrator kann das prüfen.