Diese Endpunkte liefern Verträge und Kunden und erlauben es, Kundendaten aus einem Drittsystem anzulegen, zu ändern und zu löschen. Typisch sind der Abgleich mit einem Bestandsführungssystem, eigene Auswertungen und die Stammdatenpflege aus einem CRM. Dokumente: siehe File.
Voraussetzungen: Freischaltung von Connect und ein API-Key mit den passenden Scopes (Verträge lesen sowie Kunden lesen, anlegen, ändern, löschen). Die Kunden-Endpunkte sind als „experimental“ gekennzeichnet.
Verträge abrufen
Verträge lassen sich einzeln oder als Liste abrufen. Die Liste filtert u.a. nach Abschluss- und Änderungszeitraum, Status, Organisation und Kennung des Fremdsystems. Sie liefert bis zu 1000 Verträge je Seite, je Vertrag mit Kunde und Bearbeiter. Der Einzelabruf enthält diese Daten nicht.
Sieht das Produkt es vor, kommt das versicherte Risiko als lesbare Kurzbeschreibung mit, z.B. die Bezeichnung der Veranstaltung oder die Anschrift des versicherten Orts. Importierte Verträge tragen keine Produktkennung.
Die Dokumente eines Vertrags liefert ein eigener Aufruf. Er findet den Vertrag über Kennung, Vertragsnummer oder Vorgangsnummer.
Kundendaten anlegen und ändern
Adressen, Ansprechpartner, E-Mail-Adressen und Bankverbindungen werden mitgegeben. Es gelten diese Regeln:
Von übergebenen E-Mail-Adressen ist genau eine primär und genau eine Rechnungsadresse, von Ansprechpartnern genau einer primär.
Eine Kundennummer des Fremdsystems darf je Organisation nur einmal vorkommen. Die Organisation muss existieren.
Die Adresse beim Anlegen gilt als Haupt- und Postadresse.
Kundentyp (Privat- oder Firmenkunde) und Organisation lassen sich später nicht mehr ändern.
Übergebene Listen ersetzen den bisherigen Stand vollständig. Bankverbindungen werden über ihre externe Kennung abgeglichen, nicht mehr übergebene gelten als gelöscht.
IBANs werden geprüft, doppelte externe Kennungen von Bankverbindungen abgewiesen.
Kunden abrufen und löschen
Kunden lassen sich u.a. nach Kundennummer, Änderungs- und Erstellzeitraum und Organisation filtern, bis zu 1000 je Seite. Gelöschte Kunden kommen nur auf ausdrückliche Anforderung mit.
Löschen lässt sich ein Kunde nur ohne bestehende Vorgänge, also ohne Vertrag, Angebot, Entwurf, Anfrage, Schadenmeldung, Kommunikation und Jahresfragebogen. Sonst nennt die Ablehnung den betroffenen Bestand. Gelöschte Kunden bleiben für Auskünfte erhalten, erscheinen aber nicht mehr in Listen.
Hinweise und Besonderheiten
Datumsfilter erwarten ein vollständiges Datum mit Uhrzeit.
Die Kennung des Fremdsystems an Kunde und Vertrag wird nicht auf Eindeutigkeit geprüft.
Ein Dokument mit der Dokumentart „Maklervollmacht“ gilt in der Verwaltung als hinterlegte Vollmacht des Kunden (siehe Kundenverwaltung).