• Docs
  • FAQ
  • API Devportal
  • Changelog
  • Contact

›Producten

Getting Started

  • Introductie
  • API Devportal
  • Autorisatie

VoordeelPakket

  • Flow

Berekening

  • Adresinformatie
  • Voertuiginformatie
  • Bedrijfsinformatie
  • Berekening aanmaken
  • Tarief selectie
  • Provisie instellingen
  • Voorwaarden vergelijken
  • Premie Geldigheid

Aanvraag

  • Verwerken
  • Muteren
  • Persoonsgegevens
  • Communicatie

Polis

  • Inzage
  • Muteren

Producten

  • Aanhangwagen
  • Aansprakelijkheid
  • Bestelauto
  • Bromfiets
  • Caravan
  • Doorlopende reis
  • Fiets
  • Gezinsongevallen
  • Inboedel
  • Kampeerauto
  • Motorfiets
  • Personenauto
  • Rechtsbijstand
  • Recreatiewoning
  • Woonhuis

PakketProlongatieCheck

  • Inzage
  • Opvolging
  • Communicatie

Webmodule

  • Installatie
  • Configuratie
  • Demo

Personenautoverzekering

Data model

Een personenautoverzekering wordt aangestuurd middels een product:PersonenautoProfiel. Hierin zijn de productattributen en de keuzes rondom aanvullende dekkingen opgenomen. Het opgebouwde profiel kan naderhand gebruikt worden om de product: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.

WeergaveWaarde
Geen alarmnull
CCV klasse 1StartonderbrekerMetEigenAuthorisatie
CCV klasse 2Alarmsysteem
CCV klasse 3AlarmsysteemMetHellingshoekdetectie
CCV klasse 3 + CCV klasse TerugvindsysteemAlarmsysteemMetHellingshoekdetectieEnTerugvindsysteem
Af-fabriekbeveiliging + CCV klasse TerugvindsysteemAfFabriekMetTerugvindsysteem
CCV klasse 4VoertuigvolgsysteemPlus
CCV klasse 5VoertuigvolgsysteemPlusInCombinatieMetAlarmsysteemMetHellingshoekdetectie
CCV klasse 5 + CCV klasse TerugvindsysteemVoertuigvolgsysteemPlusMetPeilsysteemOpBasisVanRadiosignalen

AfgiftedatumRijbewijs

Het attribuut AfgiftedatumRijbewijs ( product: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 product:BestuurderPersonenauto model wel/niet ingevuld te worden.

Particulier gebruik
Overig gebruik
AttribuutWaarde
Inwonendtrue / false
IsZzpn.v.t.
RelatieTotVerzekeringsnemer[ Partner / Kind / Overig ]
AttribuutWaarde
Inwonendn.v.t.
IsZzptrue / false
RelatieTotVerzekeringsnemer[ EigenBedrijf / Werknemer ]

Afhankelijk van de opgevoerde bestuurder en haar context dienen bepaalde attributen in het product:BestuurderPersonenauto model wel/niet ingevuld te worden.

Verzekeringsnemer
Niet verzekeringsnemer
AttribuutWaarde
Inwonendn.v.t.
IsZzpn.v.t.
RelatieTotVerzekeringsnemern.v.t.
AttribuutWaarde
Inwonendtrue / false
IsZzpn.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 product:Product:Meldingen attribuut retourneert of de opgegeven Cataloguswaarde geaccepteerd is. Deze kan de volgende waardes bevatten:

AfwijkendeCataloguswaardeMelding
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.

WeergaveAPI Waarde
KoerierKoerier
LesvoertuigLesvoertuig
MaaltijdbezorgingMaaltijdbezorging
TaxiTaxi
VerhuurVerhuur
Overig zakelijkZakelijk
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.

WeergaveWaarde
Tot en met 5.000 km5000
5.001 km – 10.000 km10000
10.001 km – 15.000 km15000
15.001 km – 20.000 km20000
20.001 km – 25.000 km25000
25.001 km – 40.000 km40000
Meer dan 40.000 km40001

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.

SbiCode

Via de company information API kunnen de Sbi codes van een bedrijf worden opgevraagd. De Sbi code kan dan worden meegegeven aan het profiel om het gebruik verder te specifiëren.

Voor meer informatie zie Bedrijfsinformatie

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 product: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
AttribuutVerplichtAfhankelijk van
AantalSchadevrijeJarenJa
BestuurderPersonenauto/AdresJa
BestuurderPersonenauto/GeboortedatumJa
BestuurderPersonenauto/InwonendPotentieelGebruik
BestuurderPersonenauto/IsZzpJa
BpmVerrekenenJa
BranchePotentieelGebruik
BtwVerrekenenJa
DagelijksGebruikn.v.t.
GebruikJa
KentekenPotentieelTypeInformatie
IngangsdatumJa
JaarkilometrageJa
LeaseautoJa
TypeInformatiePotentieelKenteken
Toon flowchart
Zakelijk
Kenteken
Let op: om een aanvraag in te dienen is uiteindelijk een kenteken vereist. De typeinformatie kan echter gebruikt worden om indicatieve premies te berekenen.
TypeInformatie
Gebruik
Branche
Bestuurder
Eigenaar bedrijf of Werknemer
Relatie
Bestuurder
Partner, Kind of Overig
Relatie
Inwonend
AttribuutVerplichtAfhankelijk van
AantalSchadevrijeJarenJa
BestuurderPersonenauto/AdresJa
BestuurderPersonenauto/GeboortedatumJa
BestuurderPersonenauto/IsZzpn.v.t.
BpmVerrekenenn.v.t.
Branchen.v.t.
BtwVerrekenenn.v.t
DagelijksGebruikPotentieelSoort
IngangsdatumJa
JaarkilometrageJa
KentekenPotentieelTypeInformatie
Leaseauton.v.t.
TypeInformatiePotentieelKenteken
Toon flowchart
Particulier
Kenteken
Let op: om een aanvraag in te dienen is uiteindelijk een kenteken vereist. De typeinformatie kan echter gebruikt worden om indicatieve premies te berekenen.
TypeInformatie
DagelijksGebruik

Product informatie

Na het aanmaken van de product: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.

PersonenautoProfiel
DekkingAttribuutWaarde
Schade inzittendenSchadeInzittendenMeeverzekerentrue / false
Ongevallen inzittendenMinimaleVerzekerdeSomInvaliditeit0 / 22500 / 45000
Ongevallen inzittendenMinimaleVerzekerdeSomOverlijden0 / 7500 / 15000
Rechtsbijstand*MinimaleRechtsbijstandDekkingsvormVerhaal / Motorrijtuigen
PechhulpMinimaalPechhulpDekkingsgebiedNederland / Europa
PechhulpPechhulpAanhangerMeeverzekerentrue / false
PechhulpPechhulpWoonplaatsMeeverzekerentrue / false
No claim garantie**NoClaimGarantieMeeverzekerentrue / false
Aanschafwaarde / Nieuwwaardegarantie***MinimaleGarantieTermijnInMaanden12 / 24 / 36
Keuzevrijheid herstellerVrijeKeuzeHersteltrue / 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 product: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.

ModelAcceptatievragenPad
aanvraagwebapi:Bestuurderaanvraagwebapi:BestuurderAcceptatievragenAanvraag > Bestuurders > Bestuurder
aanvraagwebapi:Voertuigaanvraagwebapi:VoertuigAcceptatievragenAanvraag > Bestuurders > Bestuurder > Voertuigen > Voertuig
/aanvragen/{aanvraagId}/bestuurders/{bestuurderId}/acceptatievragen
/aanvragen/{aanvraagId}/bestuurders/{bestuurderId}/voertuigen/{voertuigId}/acceptatievragen
← MotorfietsRechtsbijstand →
  • Data model
    • Additionele toelichting datamodel
    • Verplichte attributen
  • Product informatie
  • Aanvullende verzekeringen
  • Aanvullende dekkingen
  • Acceptatievragen
Docs
AanvraagAuthorisatieBerekeningPersonenauto
Handige links
Voogd & VoogdAPI Devportal
Contact
E   api@voogd.com
Copyright © 2025 Voogd & Voogd