Personenautoverzekering
Data model
Een personenautoverzekering wordt aangestuurd middels een voordeelpakketberekening:PersonenautoProfiel
. Hierin zijn de productattributen en de keuzes rondom aanvullende dekkingen opgenomen. Het opgebouwde profiel kan naderhand gebruikt worden om de voordeelpakketberekening:Berekening
bij te werken, zie ook Berekening wijzigen.
> Structuur|PersonenautoProfiel > Voorbeeld|PersonenautoProfiel:sample
! Personenautoverzekeringen zijn beschikbaar voor zowel het particuliere als het zakelijke marktsegment.
! Bij afwijkende bestuurder (t.o.v. aanvrager) is RelatieTotVerzekeringnemer een verplicht veld.
Additionele toelichting datamodel
Afhankelijk van de context waarin het product opgevoerd wordt kan het gedrag van attributen wijzigen. Selecteer hieronder de gewenste context om het gedrag van de attributen in te zien.
- Zakelijk
- Particulier
AanwezigeAlarmklasse
Hieronder de opties die de API kent, en de bijbehorende omschrijvingen, in de logische volgorde van klein naar groot.
Weergave | Waarde |
---|---|
Geen alarm | null |
CCV klasse 1 | StartonderbrekerMetEigenAuthorisatie |
CCV klasse 2 | Alarmsysteem |
CCV klasse 3 | AlarmsysteemMetHellingshoekdetectie |
CCV klasse 3 + CCV klasse Terugvindsysteem | AlarmsysteemMetHellingshoekdetectieEnTerugvindsysteem |
Af-fabriekbeveiliging + CCV klasse Terugvindsysteem | AfFabriekMetTerugvindsysteem |
CCV klasse 4 | VoertuigvolgsysteemPlus |
CCV klasse 5 | VoertuigvolgsysteemPlusInCombinatieMetAlarmsysteemMetHellingshoekdetectie |
CCV klasse 5 + CCV klasse Terugvindsysteem | VoertuigvolgsysteemPlusMetPeilsysteemOpBasisVanRadiosignalen |
AfgiftedatumRijbewijs
Het attribuut AfgiftedatumRijbewijs
( voordeelpakketberekening:BestuurderPersonenauto
), ookwel gevraagd als "Aantal jaren rijbewijs", is in basis optioneel. Wanneer deze vraag echter niet beantwoord is kan dit leiden tot het hoger uitvallen of het ontbreken van sommige tarieven.
Bestuurder
Afhankelijk van het opgegeven Gebruik
dienen bepaalde attributen in het voordeelpakketberekening:BestuurderPersonenauto
model wel/niet ingevuld te worden.
Attribuut | Waarde |
---|---|
Inwonend | true / false |
IsZzp | n.v.t. |
RelatieTotVerzekeringsnemer | [ Partner / Kind / Overig ] |
Attribuut | Waarde |
---|---|
Inwonend | n.v.t. |
IsZzp | true / false |
RelatieTotVerzekeringsnemer | [ EigenBedrijf / Werknemer ] |
Afhankelijk van de opgevoerde bestuurder en haar context dienen bepaalde attributen in het voordeelpakketberekening:BestuurderPersonenauto
model wel/niet ingevuld te worden.
Attribuut | Waarde |
---|---|
Inwonend | n.v.t. |
IsZzp | n.v.t. |
RelatieTotVerzekeringsnemer | n.v.t. |
Attribuut | Waarde |
---|---|
Inwonend | true / false |
IsZzp | n.v.t. |
RelatieTotVerzekeringsnemer | [ Kind, Partner, Overig ] |
Branche
Het attribuut Branche
is enkel van toepassing indien de waarde van het attribuut Gebruik
gelijk is aan Zakelijk.
Cataloguswaarde
De cataloguswaarde van een voertuig wordt door de API bepaald op basis van Audascan. Het kan zijn dat het in sommige gevallen wenselijk is om deze waarde te overrulen, hiervoor kan het attribuut Cataloguswaarde
worden gebruikt.
Het voordeelpakketberekening:Product:Meldingen
attribuut retourneert of de opgegeven Cataloguswaarde
geaccepteerd is. Deze kan de volgende waardes bevatten:
AfwijkendeCataloguswaarde | Melding |
Waarde via profiel opgegeven is hoger dan Audascan of de huidige polis. De profielwaarde wordt gebruikt. | De opgegeven cataloguswaarde is afwijkend van de waarde vanuit een algemeen voertuigenbestand. |
OpgegevenCataloguswaardeGenegeerd | |
Waarde via profiel opgegeven is lager dan Audascan of de huidige polis. De profielwaarde is genegeerd. De waarde van Audascan of de huidige polis is gebruikt. | De opgegeven cataloguswaarde is genegeerd. De waarde vanuit het algemene voertuigenbestand is gebruikt. |
VerrijkteCataloguswaardeGebruikt | |
Waarde niet via profiel opgegeven. De waarde van Audascan of de huidige polis is gebruikt. | De waarde vanuit het algemene voertuigenbestand is gebruikt. |
DagelijksGebruik
Het attribuut DagelijksGebruik
is enkel verplicht wanneer aanvraagwebapi:Voertuig:Soort
gelijk is aan Oldtimer.
Dagwaarde
De dagwaarde van een voertuig wordt door de API bepaald op basis van Audascan. Het kan zijn dat het in sommige gevallen wenselijk is om deze waarde te overrulen, hiervoor kan het attribuut Dagwaarde
worden gebruikt. Let wel: wanneer de opgegeven waarde ( inclusief btw en bpm ) lager ligt dan de dagwaarde vanuit Audascan de API deze weigert en een validatiefout retourneert.
Gebruik
Initieel dient er een keuze selectie getoond te worden voor de doeleinden ( Gebruik
) van het voertuig. Afhankelijk van de gekozen optie kan de verplichting voor Branche
differentieren.
Weergave | API Waarde |
---|---|
Koerier | Koerier |
Lesvoertuig | Lesvoertuig |
Maaltijdbezorging | Maaltijdbezorging |
Taxi | Taxi |
Verhuur | Verhuur |
Overig zakelijk | Zakelijk |
Particulier ( incl woon-werkverkeer ) | Particulier |
Jaarkilometrage
Voor de gebruiksvriendelijkheid van het proces wordt geadviseerd om de Jaarkilometrage
op te vragen middels diverse ranges. Het datamodel vereist echter een integer als ingevulde waarde; onderstaand staat een tabel met de ranges welke vanuit Voogd geadviseerd worden met de daarbij horende waardes voor de API.
Weergave | Waarde |
---|---|
Tot en met 5.000 km | 5000 |
5.001 km – 10.000 km | 10000 |
10.001 km – 15.000 km | 15000 |
15.001 km – 20.000 km | 20000 |
20.001 km – 25.000 km | 25000 |
25.001 km – 40.000 km | 40000 |
Meer dan 40.000 km | 40001 |
Kilometerstand
De Kilometerstand
wordt gebruikt om de dagwaarde van het voertuig te bepalen. Slechts bij enkele tarieven is de dagwaarde bepalend voor de premie, het opgeven van de Kilometerstand
wordt daarmee dan ook niet als verplicht gesteld.
PercentageCommercieleKorting
Het attribuut PercentageCommercieleKorting
mag enkel toegekend worden door Voogd & Voogd; dit attribuut is dan ook niet bedoeld voor externe doeleinden.
TypeInformatie
Wanneer het kenteken van een voertuig niet bekend is dient TypeInformatie
ingevuld te worden, zie ook Voertuig informatie. Op basis van TypeInformatie
kunnen indicatieve premies worden gegeven. Het is niet mogelijk de berekening om te zetten naar een aanvraag, hiervoor is uiteindelijk een kenteken vereist.
WijzeAantonenSchadevrijeJaren
Het attribuut WijzeAantonenSchadevrijeJaren
in de voordeelpakketberekening:VoertuigAcceptatievragen
dient ten alle tijden opgegeven te worden, ook wanneer er geen sprake is van schadevrijejaren ( waarde = 0 ). Heeft de bestuurder geen eerdere verzekeringen gehad dan kan de waarde OpgaveVorigeVerzekeringsmaatschappij
opgevoerd worden.
Reden van deze verplichting is dat de API via Roy-data controleert op het aantal schadevrije jaren. Dit om te voorkomen dat de bestuurder er met 0 schadevrije jaren doorheen probeert te komen wanneer hij eigenlijk met een negatief aantal schadevrije jaren geregistreerd staan.
Verplichte attributen
Onderstaande verplichten zijn van toepassing afhankelijk van de product context, staat het attribuut niet specifiek vermeld houd dan de regulatie uit het datamodel aan.
- Zakelijk
- Particulier
Attribuut | Verplicht | Afhankelijk van |
---|---|---|
AantalSchadevrijeJaren | Ja | |
BestuurderPersonenauto/Adres | Ja | |
BestuurderPersonenauto/Geboortedatum | Ja | |
BestuurderPersonenauto/Inwonend | Potentieel | Gebruik |
BestuurderPersonenauto/IsZzp | Ja | |
BpmVerrekenen | Ja | |
Branche | Potentieel | Gebruik |
BtwVerrekenen | Ja | |
DagelijksGebruik | n.v.t. | |
Gebruik | Ja | |
Kenteken | Potentieel | TypeInformatie |
Ingangsdatum | Ja | |
Jaarkilometrage | Ja | |
Leaseauto | Ja | |
TypeInformatie | Potentieel | Kenteken |
Attribuut | Verplicht | Afhankelijk van |
---|---|---|
AantalSchadevrijeJaren | Ja | |
BestuurderPersonenauto/Adres | Ja | |
BestuurderPersonenauto/Geboortedatum | Ja | |
BestuurderPersonenauto/IsZzp | n.v.t. | |
BpmVerrekenen | n.v.t. | |
Branche | n.v.t. | |
BtwVerrekenen | n.v.t | |
DagelijksGebruik | Potentieel | Soort |
Ingangsdatum | Ja | |
Jaarkilometrage | Ja | |
Kenteken | Potentieel | TypeInformatie |
Leaseauto | n.v.t. | |
TypeInformatie | Potentieel | Kenteken |
Product informatie
Na het aanmaken van de voordeelpakketberekening:Berekening
wordt er een product opgesteld op basis van het samengestelde profiel. Indien er vanuit de applicatie behoefte is om aanvullende informatie over het product te tonen kan deze informatie opgehaald worden via een aanvullend endpoint. Meer informatie...
/berekeningen/{berekeningid}/personenautoproducten/{productid}
Aanvullende verzekeringen
Een personenautoverzekering wordt doorgaans gecombineerd met onderstaande verzekeringen. Bij het combineren van meerdere verzekeringen kunnen er gunstigere tarieven ontstaan voor de consument.
Verzekering |
---|
Aansprakelijkheidsverzekering |
Rechtsbijstandsverzekering |
Aanvullende dekkingen
Naast de basisverzekeringen kunnen er ook aanvullende dekkingen worden afgenomen door de consument; onderstaand een lijst met de aanvullende dekkingen welke beschikbaar zijn voor een personenautoverzekering.
Dekking | Attribuut | Waarde |
---|---|---|
Schade inzittenden | SchadeInzittendenMeeverzekeren | true / false |
Ongevallen inzittenden | MinimaleVerzekerdeSomInvaliditeit | 0 / 22500 / 45000 |
Ongevallen inzittenden | MinimaleVerzekerdeSomOverlijden | 0 / 7500 / 15000 |
Rechtsbijstand* | MinimaleRechtsbijstandDekkingsvorm | Verhaal / Motorrijtuigen |
Pechhulp | MinimaalPechhulpDekkingsgebied | Nederland / Europa |
Pechhulp | PechhulpAanhangerMeeverzekeren | true / false |
Pechhulp | PechhulpWoonplaatsMeeverzekeren | true / false |
No claim garantie** | NoClaimGarantieMeeverzekeren | true / false |
Aanschafwaarde / Nieuwwaardegarantie*** | MinimaleGarantieTermijnInMaanden | 12 / 24 / 36 |
Keuzevrijheid hersteller | VrijeKeuzeHerstel | true / false |
* Het attribuut VerhaalsrechtsbijstandMeeverzekeren
is deprecated, in het vervolg dient MinimaleRechtsbijstandDekkingsvorm
gebruikt te worden.
** De API bied geen mogelijkheden voor no-claim beschermers bij nieuwe polissen, omdat veel maatschappijen daarmee gestopt zijn. Dit veld is enkel beschikbaar in de API voor migratie/mutatie doeleinden van bestaande polissen.
*** De API bepaalt zelf of het de aanschafwaarde of nieuwwaarde wordt o.b.v. de datum tenaamstelling van het kenteken (eerste eigenaar ja/nee).
Het attribuut voordeelpakketberekening:PersonenautoProfiel:GewensteTarieven
kan gebruikt worden om het gewenste tarief te specificeren, als er meerdere aanbieders zijn voor een aanvullende dekking.
Acceptatievragen
Bij het afsluiten van een personenautoverzekering dienen er aanvullende acceptatievragen ingevuld te worden. Welke vragen vereist zijn worden aangeduid met onderstaande attributen binnen het aanvraagwebapi:Bestuurder
en aanvraagwebapi:Voertuig
model.
NederlandGeldigRijbewijsAcceptatievraagStellen
RijvaardigheidBeinvloedAcceptatievraagStellen
AantekeningenOpRijbewijsAcceptatievraagStellen
VraagNaamGeslachtBestuurderStellen
GebruiktInGebiedVereist
GebruiktBinnenKorteAfstandVanVestigingsplaatsVereist
MeldcodeVereist
LangerDan14DagenOnverzekerdGeweestVraagStellen
WijzeAantonenSchadevrijeJarenVereist
De vragenlijst is gedefinieerd vanuit Voogd & Voogd en is hier terug vinden, zie ook het Juridisch normenkader.
Model | Acceptatievragen | Pad |
---|---|---|
aanvraagwebapi:Bestuurder | aanvraagwebapi:BestuurderAcceptatievragen | Aanvraag > Bestuurders > Bestuurder |
aanvraagwebapi:Voertuig | aanvraagwebapi:VoertuigAcceptatievragen | Aanvraag > Bestuurders > Bestuurder > Voertuigen > Voertuig |
/aanvragen/{aanvraagId}/bestuurders/{bestuurderId}/acceptatievragen
/aanvragen/{aanvraagId}/bestuurders/{bestuurderId}/voertuigen/{voertuigId}/acceptatievragen