Premie Geldigheid

Premie geldigheid bepaalt hoe lang de berekende premies van een VoordeelPakket geldig blijven. Dit voorkomt dat premies verlopen of onjuist worden bij het wijzigen van een aanvraag (concept).

Benodigde API

Voor het correct toepassen van premie geldigheid en het uitvoeren van mutaties zijn de volgende API's vereist:

APIVersie
productv2
productmutatiev1

Zorg dat je applicatie is aangemeld en geabonneerd op beide API's via de API Devportal. Heb je geen toegang, neem dan contact op met Voogd & Voogd.

Let op: Gebruik altijd de nieuwste product v2 API voor het aanmaken en wijzigen van berekeningen. Gebruik niet de oude berekeningvoordeelpakket v1 API.

Hoe werkt premie geldigheid?

  • Bij het aanmaken van een nieuwe berekening via de API wordt de premie geldigheid automatisch ingesteld op de aanmaakdatum + 30 dagen.
  • Vanuit een berekening kan een aanvraag worden aangemaakt. Deze krijgt de status concept en kan nog worden aangepast.
  • Elke wijziging van een concept-aanvraag (bijvoorbeeld via het mutatie-endpoint) zorgt ervoor dat de premie geldigheid opnieuw wordt ingesteld op 30 dagen vanaf het moment van de wijziging.
  • Zolang de premie geldigheid niet is verlopen, blijven de bestaande premies geldig. Is de geldigheid verlopen, dan worden alle premies opnieuw berekend bij de eerstvolgende wijziging.
/aanvraag/maakmutatieberekening

Wil je meer weten over het mutatieproces? Lees dan verder op de pagina Mutatie flow.

Endpoint details: /aanvraag/maakmutatieberekening

Input (request)

Het endpoint accepteert een optionele queryparameter aanvraagId (UUID van de aanvraag) en een verplichte body met de gewenste ingangsdatum:

Query parameter:

ParameterTypeVerplichtOmschrijving
aanvraagIdstringneeHet aanvraagId van de aanvraag (UUID)

Request body:

{
    "ingangsdatum": "2025-08-15T00:00:00Z"
}
ParameterTypeVerplichtOmschrijving
ingangsdatumstringjaDe datum waarop de mutatie wordt gestart (ISO 8601 formaat)

Output (response)

Bij een succesvolle aanvraag wordt een object teruggegeven met o.a. het id van de nieuwe berekening en statusinformatie:

{
    "id": "45dbb3cc-9d47-4e5e-82aa-909955e9c2b6",
    "isAfwijkendVerzekeringnemerAdresAangepast": true,
    "isSvjGewijzigd": false,
    "isTariefBeperkingToegepast": false,
    "openstaandeAanvraagId": "6676ee5f-e1c2-4532-917f-54b019071eb1"
}
ParameterTypeOmschrijving
idstringId van de aangemaakte berekening
isAfwijkendVerzekeringnemerAdresAangepastbooleanOf het adres van de verzekeringnemer is aangepast
isSvjGewijzigdbooleanOf schadevrije jaren zijn gewijzigd
isTariefBeperkingToegepastbooleanOf er een tariefbeperking is toegepast
openstaandeAanvraagIdstringId van de openstaande aanvraag (indien van toepassing)

Bij fouten wordt een standaard ProblemDetails object geretourneerd met details over de fout.

Aan de slag met premie geldigheid

  1. Maak een nieuwe berekening aan via de product v2 API (POST /product/v2/berekeningen).

  2. Maak vanuit deze berekening een aanvraag aan (status: concept).

  3. Wil je de aanvraag wijzigen zolang deze nog in concept is? Gebruik dan het endpoint:

    /aanvraag/maakmutatieberekening

    Hiermee wordt een nieuwe berekening aangemaakt en de premie geldigheid opnieuw op 30 dagen gezet.

    Let op: Is de premie geldigheid verlopen (ouder dan 30 dagen), dan worden alle premies opnieuw berekend. Dit kan ertoe leiden dat een hoger premiebedrag wordt gepresenteerd.

  4. Elke wijziging van een concept-aanvraag via dit endpoint verlengt de premie geldigheid.

Voorbeeld workflow

  1. Nieuwe berekening aanmaken
    POST /product/v2/berekeningen
    → De premie geldigheid wordt ingesteld op de aanmaakdatum + 30 dagen.

    Zie ook: Berekening aanmaken

  2. Aanvraag aanmaken vanuit de berekening
    POST /aanvraag
    → De aanvraag krijgt de status concept.

    Zie ook: Aanvraag aanmaken

  3. Aanvraag wijzigen zolang deze in concept is
    POST /productmutatie/v1/aanvraag/maakmutatieberekening
    → De premie geldigheid wordt opnieuw ingesteld op het moment van de wijziging + 30 dagen.

  4. Aanvraag indienen
    PUT /aanvragen/{id}/indienen

    Zie ook: Aanvraag indienen

Bij elke wijziging van een concept-aanvraag via het mutatie-endpoint wordt de premie geldigheid verlengd.

Samenvatting

  • Premie geldigheid = 30 dagen vanaf (laatste) berekening of wijziging
  • Gebruik altijd de nieuwste product v2 API
  • Wijzigingen aan een concept-aanvraag? Maak een nieuwe berekening aan via /productmutatie/v1/aanvraag/maakmutatieberekening
  • Zo voorkom je dat premies verlopen of onjuist worden toegepast
← Voorwaarden vergelijkenVerwerken →