Über die Schnittstelle legen Drittsysteme Umdeckungen an und erhalten je Offlinevertrag einen Umdeckungskandidaten mit Prüfergebnis. Planung, Kundeninformation, Widerspruchsfrist und Durchführung laufen danach in der Umdeckungsverwaltung oder zeitgesteuert.
Voraussetzungen:
Freischaltung von Connect und Umdeckung
API-Key mit dem Scope „Umdeckung anlegen“ (zum Auflisten „Umdeckungen lesen“, zum Löschen „Umdeckungen löschen“)
Zielprodukt mit hinterlegtem Umdeckungsprozess
Quellverträge als importierte Offlineverträge
Grundlegender Ablauf
Umdeckungsprozesse des Zielprodukts abfragen und den passenden wählen. Die Abfrage liefert auch die erwarteten Quelldaten.
Umdeckung mit Prozess, optionalen Zeitpunkten und Kontaktweg anlegen. Sie ist danach ein Entwurf ohne Verträge.
Verträge in Paketen von höchstens 100 nachreichen und die Antwort je Vertrag auswerten. Mit dem ersten Kandidaten wird die Umdeckung aktiv.
Unvollständige Kandidaten in der Umdeckungsverwaltung ergänzen, Planung und Durchführung laufen dort weiter.
Funktionsumfang
Anlage. Die Umdeckung bezieht sich auf einen am Produkt hinterlegten Umdeckungsprozess. Bei Produkten, deren Umdeckung im Code definiert ist, lässt sich stattdessen eine eigene Feldzuordnung übergeben. Für Studio-Produkte ist der gepflegte Prozess verbindlich.
Verträge nachreichen. Übergeben werden entweder Vertragskennungen oder Vertragsnummern, nicht beides. Ein wiederholter Aufruf legt nichts doppelt an. Aus jedem Vertrag entsteht genau ein Kandidat, auch bei mehreren Verträgen eines Kunden.
Ergebnis je Vertrag. Die Antwort nennt den angelegten Kandidaten oder den Ablehnungsgrund:
nicht gefunden
kein Offlinevertrag
bereits in dieser oder einer anderen Umdeckung
doppelt in der Liste
Quelldaten passen nicht zum erwarteten Schema (mit Feldfehlern)
Auch ein aufgenommener Kandidat kann unvollständig sein. Das Prüfergebnis „vollständig“ oder „unvollständig“ steht in der Antwort und in der Kandidatenliste der Verwaltung.
Zeitpunkte. Kundeninformation, Ende der Widerspruchsfrist und Durchführung lassen sich als fester Wert oder als Verweis auf ein Vertragsdatum vorgeben. Gesetzte Werte haben Vorrang vor der Produktkonfiguration. Fehlt das Fristende, verschiebt es sich mit dem Zeitpunkt der Kundeninformation.
Kontaktweg und Quellversicherer. Der Kontaktweg (Standard: E-Mail) ist ein Vorschlag, ohne E-Mail-Adresse wird auf Brief ausgewichen. Der Quellversicherer lässt sich über die VU-Nummer angeben, bei mehrdeutiger Nummer bleibt er leer.
Auflisten und Löschen. Umdeckungen lassen sich nach Zeitraum und Zielprodukt auflisten. Löschbar sind offene Kandidaten ohne Kommentare und Umdeckungen ohne Kandidaten.
Hinweise und Besonderheiten
Ein älterer Aufruf legt Umdeckung und Verträge in einem Schritt an und aktiviert sie sofort. Er prüft nicht, ob die Verträge Offlineverträge sind, und meldet unbekannte Kennungen nicht. Für neue Anbindungen den zweistufigen Weg nutzen.
Fällige Umdeckungen führt ein regelmäßiger Lauf aus, sofern der Kunde informiert wurde und kein Fehler vorliegt. Kandidaten mit Fehler werden in der Verwaltung von Hand nachgeholt.
Kunden widersprechen über eine Antwortseite, für die jeder Kandidat einen eigenen Zugang erhält.