|
|
|
|
|
Bij het royeren van een verzekering kon je nog geen specifieke gebeurteniscode opgeven. De code die bij het royement werd vastgelegd was altijd de standaard royement-gebeurtenis, ongeacht de reden van opzegging. Daardoor was het niet mogelijk om achteraf per royement te zien wat de reden van opzegging was.
Aan de royeer-aanroep is het optionele veld GebeurtenisId toegevoegd. Hiermee geef je de code aan die bij het royement wordt vastgelegd. Je kiest een gebeurteniscode van het type Royement. Beschikbare codes zijn op te vragen via het GET-endpoint in de tabel hieronder.
Gedrag
Het GebeurtenisId is optioneel. Als je geen GebeurtenisId opgeeft, werkt het royement op dezelfde manier als voorheen: de standaard royement-gebeurtenis wordt vastgelegd. Als je een geldig GebeurtenisId opgeeft, wordt die gebeurteniscode in de contractgebeurtenis opgeslagen.
Bij een ongeldig GebeurtenisId — een niet-bestaande code of een code van een ander type dan Royement — wordt het royement geweigerd met een foutmelding.
Betrokken endpoints
Endpoint |
Gebruik |
|---|---|
PUT levensverzekeringmaatschappijen |
Royeren van een losse verzekering |
PUT contract/api/v1/contracten/pakketten/wijzigen |
Royeren van een of meer verzekeringen binnen een pakket |
GET codering/api/v1/coderingen/gebeurtenissen |
Opvragen van beschikbare gebeurteniscodes, inclusief type |
Impact
Royementen zonder GebeurtenisId werken ongewijzigd. Wil je per royement vastleggen wat de reden van opzegging is, dan kun je voortaan een gebeurteniscode van het type Royement meegeven. Dit maakt het mogelijk om achteraf per royement te zien wat de reden van opzegging was.