Vorig onderwerp

Volgend onderwerp

Inhoud boek

Book Index

Meer mogelijkheden bij zoeken relatie (4.1.2.3)

relatie/api/v1/relaties 

Er zijn vier nieuwe queryparameters waarmee relaties gefilterd kunnen worden: 

Contract-zoekcriteria

Er zijn drie nieuwe queryparameters waarmee naar relaties gezocht kan worden op basis van gegevens in de verzekeringen waar ze verzekeringnemer zijn. Voor deze queryparameters gelden de volgende beperkingen:

  • Er moet altijd een BedrijfId opgegeven zijn in de header van de aanroep. Alleen verzekeringen en pakketten die bij dit bedrijf horen worden doorlopen.
  • Deze queryparameters kunnen niet gecombineerd worden met de queryparameters voor adresgegevens van de relatie (postcode, huisnummer

De nieuwe queryparameters zijn: 

polisnummerMaatschappijVolledig

Lever alle relaties die verzekeringnemer zijn bij een verzekering of pakket met dit polis- of pakketnummer. 

kentekenVolledig

Lever alle relaties die verzekeringnemer zijn bij een verzekering waarbij een auto wordt verzekerd met dit kenteken.

Het is toegestaan, maar niet noodzakelijk, om ‘-‘-tekens in het kenteken op te geven. 

Opmerking:

Dit werkt slechts voor verzekeringen die één auto verzekeren. Als een verzekering meerdere auto’s verzekert, dan werkt deze zoekactie slechts voor één van die kentekens. 

risicoAdresPostcodeVolledig

Lever alle relaties die verzekeringnemer zijn bij een verzekering waarbij een object wordt verzekerd met deze postcode.

Het is toegestaan, maar niet noodzakelijk, om een spatie in de postcode op te nemen. 

Opmerking:

Dit werkt slechts voor verzekeringen die één object met een postcode verzekeren. Als een verzekering meerdere objecten met postcodes verzekert, dan werkt de zoekactie slechts voor één van die kentekens. 

Relatie-zoekcriteria

De volgende nieuwe queryparameter is geïntroduceerd voor de relatiegegevens: 

volledigeNaamBevat

Lever alle relaties waarvan de opgegeven tekst ergens voorkomt in de volledige naam van de relatie. 

Dit is in tegenstelling tot de naam-queryparameter, die alleen zoekt of de achternaam van een relatie, of het tweede deel van de bedrijfsnaam, begint met de opgegeven tekst. Het zoeken op volledigeNaamBevat duurt echter wel langer dan zoeken op naam.

De opgegeven waarde voor volledigeNaamBevat moet minimaal drie karakters lang zijn.