Kunde/Vertrag/Schaden lesen und hochladen/ändern
- Reiner Oslislo
- Teresa Kortmann
Per API können Sie alle Kunden/Verträge/Schäden abfragen. Welche Datensätze Sie sehen, wird vom Administrator in Ihrer Freischaltung festgelegt. Wenn Sie die Erlaubnis für AdminAccess haben, sehen Sie alle Datensätze.
Damit die Server auf beiden Seiten nicht zu stark belastet werden, sollten nicht zu viele Daten gleichzeitig abgefragt werden. Wir raten zum Beispiel davon ab, jeden Tag sämtliche Kunden zu lesen. Sollen alle Kunden, die sich seit dem Vortag geändert haben, gelesen werden, kann dies über den Parameter “newerThan” abgefragt werden. Beispiele hierfür finden Sie in der angehängten Dokumentation.
Achtung!
Bitte nutzen Sie nur die in der angehängten Dokumentation beschriebenen API-Einsprungspunkte! Diese sind stabil und dokumentiert. Weitere über Swagger zu findende API-Einsprungpunkte sind noch nicht finalisiert und als stabil für den externen Gebrauch freigegeben.
Die wichtigsten API-Abfragen zum Lesen von Kunde/Vertrag/Schaden sind beschrieben in “Assfinet_API_Kunde_Vertrag_Schaden_abfragen.pdf” (Kunde/Vertrag/Schaden lesen, Kunde/Vertrag/Schaden suchen, Adressen anzeigen, Brief anzeigen):
Ein Kunde (oder Vertrag oder Schaden) kann auch geändert werden. Alternativ kann auch ein neuer Kunde (oder Vertrag oder Schaden) per API erzeugt werden.
Dazu wird beim API-Aufruf ein Datensatz in der Kundenliste gefüllt. Wenn darin das Feld “ID” neu ist, wird ein neuer Kunde angelegt. Ist dagegen das Feld “ID” eine vorhandene Kunden-ID, so wird ein Kundendatensatz geändert:
Entsprechend wie beim Kunden kann auch einen Vertrag geändert oder neu hochgeladen werden. Dabei muss zum Vertrag auch immer der zugehörige Kunde mit im Transfer enthalten sein, damit dieser zugeordnet werden kann.
Gleiches gilt auch für Schäden. Dabei muss zum Schaden auch immer der zugehörige Kunde und Vertrag mit im Transfer enthalten sein, damit dieser zugeordnet werden kann.
Noch Fragen? Ist etwas unklar geblieben?
Sollten Sie noch weitere Fragen zu diesem Thema haben, die in diesem Artikel nicht behandelt oder erklärt wurden, wenden Sie sich gerne über unser Kundenportal an unseren Support.