Policen- und Jobsuche

Die Job- und Policy-APIs stellen Endpunkte bereit, mit denen nach Jobs bzw. Policen gesucht werden kann:

• /job/v1/search/jobs
• /policy/v1/search/policies

Um eine Suche auszuführen, kann ein Aufrufer eine POST-Anforderung an einen Suchendpunkt senden. Die Anforderungs-Nutzdaten müssen mindestens eine der folgenden Eigenschaften enthalten:

• companyName: Vollständiger Firmenname des Versicherten
• firstName und lastName: Vor- und Nachname des Versicherten
• jobNumber(nur bei der Jobsuche): Die Jobnummer
• officialId: Offizieller Identifikationscode
• phone: Eine Telefonnummer
• policyNumber: Die Policennummer
• producerCode.id: Eine gültige Vermittlernummer

Bei der Suche nach Jobs muss der Aufrufer auch die Eigenschaft jobType.code enthalten, die den Jobtyp (z. B. Antrag oder Verlängerung) angibt.

Die Antwort-Nutzdaten einer Suchanfrage können weiter gefiltert werden, indem eine der folgenden Eigenschaften zur Anforderung hinzugefügt wird:

• city: Ein mit einem Job oder einer Police verknüpfter Ort
• inForceOn (nur Policensuche): Eine Datumszeichenfolge (JJJJ-MM-TT), die ein Datum angibt, an dem die Police in Kraft ist
• jurisdiction.code: Ein Gerichtsbarkeit-Code
• postalCode: Eine mit einem Job oder einer Police verknüpfte Postleitzahl
• product.id: Eine Produkt-ID für die Sparte
• state.code: Ein mit einem Job oder einer Police verknüpftes/r Bundesland/Kanton
• street: Eine mit einem Job oder einer Police verknüpfte Straßenadresse

Um die Gesamtanzahl der Treffer für die Suche zu ermitteln, fügen Sie der Anforderung den Abfrageparameter &includeTotal=true hinzu. Weitere Informationen zur Steuerung der Paginierung finden Sie unter Steuerung der Paginierung.