• 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

Motorfietsverzekering

Data model

Een motorfietsverzekering wordt aangestuurd middels een product:MotorfietsProfiel. 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|MotorfietsProfiel
> Voorbeeld|MotorfietsProfiel:sample

! Een Motorfietsverzekering kan enkel aangevraagd worden binnen het particuliere marktsegment.

! Bij afwijkende bestuurder (t.o.v. aanvrager) is RelatieTotVerzekeringnemer een verplicht veld.

Additionele toelichting datamodel

AfgiftedatumRijbewijs

Het attribuut AfgiftedatumRijbewijs ( product:Bestuurder ), 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

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

Particulier: Verzekeringsnemer
Particulier: Niet verzekeringsnemer
AttribuutWaarde
RelatieTotVerzekeringsnemern.v.t.
Inwonendn.v.t.
BezitVroCertificaattrue/false ( optioneel )
AttribuutWaarde
RelatieTotVerzekeringsnemer[ Kind, Partner, Overig ]
Inwonendtrue/false
BezitVroCertificaattrue/false ( optioneel )

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 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 lager ligt dan de dagwaarde vanuit Audascan de API deze weigert en een validatiefout retourneert.

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 – 6.000 km6000
6.001 km – 8.000 km8000
8.001 km – 12.000 km12000
12.001 km – 15.000 km15000
15.001 km – 20.000 km20000
Meer dan 20.000 km20001

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.

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}/motorfietsproducten/{productid}

Aanvullende verzekeringen

Een motorfietsverzekering 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 motorfietsverzekering.

MotorfietsProfiel
DekkingAttribuutWaarde
Helm/kleding/schoenen*MinimaalVerzekerdBedragHelmKledingSchoenen0 - 1500 (stappen van 250)
Ongevallen opzittendenMinimaleVerzekerdeSomInvaliditeit0 / 10000
Ongevallen opzittendenMinimaleVerzekerdeSomOverlijden0 / 5000
Rechtsbijstand**MinimaleRechtsbijstandDekkingsvormMotorrijtuigen/Verhaal
Schade opzittendenMinimaalVerzekerdBedragSchadeOpzittenden0 / 75000 / 150000

* Het meeverzekeren van helm/kleding/schoenen is niet van toepassing bij een WA verzekering.
** Het attribuut VerhaalsrechtsbijstandMeeverzekeren is deprecated, in het vervolg dient MinimaleRechtsbijstandDekkingsvorm gebruikt te worden.

Het attribuut product:MotorfietsProfiel: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 motorfietsverzekering 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
← KampeerautoPersonenauto →
  • Data model
    • Additionele toelichting datamodel
  • Product informatie
  • Aanvullende verzekeringen
  • Aanvullende dekkingen
  • Acceptatievragen
Docs
AanvraagAuthorisatieBerekeningPersonenauto
Handige links
Voogd & VoogdAPI Devportal
Contact
E   api@voogd.com
Copyright © 2025 Voogd & Voogd