• 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

Bestelautoverzekering

Data model

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

! Bestelautoverzekeringen 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

Aanvankelijk 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

AccessoiresWaarde

Het verzekerde bedrag wordt bepaald op basis van de Cataloguswaarde in combinatie met de AccessoiresWaarde. Aanvankelijk van de opgegeven waarde in BtwVerrekenen dient AccessoiresWaarde inclusief of exclusief opgegeven te worden, het bedrag mag echter niet meer beslaan dan 25% van de dagwaarde of nieuwwaarde van het voertuig.

AfgiftedatumRijbewijs

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

Beveiligingssysteem

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

Branche

Het attribuut Branche is enkel van toepassing indien de waarde van het attribuut Gebruik gelijk is aan één van de onderstaande waardes. Afhankelijk van de gekozen optie kan de verplichting voor SoortVervoerdeZaken differentieren.

  • Personenvervoer
  • VervoerEigenGoederen
  • VervoerGevaarlijkeStoffen
  • VervoerGoederen
  • 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.

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 ( GebruikBestelauto ) van het voertuig. Afhankelijk van de gekozen optie kunnen de verplichting voor Bestuurder, Branche, GrensoverschrijdendVervoer & GebruiktAlsVerkoopwagen differentieren.

WeergaveAPI Waarde
KoerierKoerier
LesvoertuigLesvoertuig
MaaltijdbezorgingMaaltijdbezorging
Onbetaald personenvervoerPersonenvervoer
VerhuurVerhuur
Vervoer eigen goederenVervoerEigenGoederen
Vervoer goederen derdenVervoerGevaarlijkeStoffen
Vervoer gevaarlijke stoffenVervoerGoederen
Overig zakelijkZakelijk
ParticulierParticulier

GebruiktAlsVerkoopwagen

Het attribuut GebruiktAlsVerkoopwagen is verplicht wanneer de waarde van het attribuut Gebruik gelijk is aan één van de onderstaande waardes:

  • VervoerEigenGoederen
  • Zakelijk

GrensoverschrijdendVervoer

Het attribuut GrensoverschrijdendVervoer is verplicht wanneer de waarde van het attribuut Gebruik gelijk is aan één van de onderstaande waardes:

  • Koerier
  • VervoerEigenGoederen
  • Zakelijk

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.

MinimaleVerzekerdeSomTransport

Het attribuut MinimaleVerzekerdeSomTransport is enkel van toepassing indien de waarde van het attribuut Gebruik gelijk is aan één van de onderstaande waardes.

  • VervoerEigenGoederen
  • Zakelijk

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

SoortVervoerdeZaken

Het attribuut SoortVervoerdeZaken is enkel van toepassing indien de waarde van het attribuut Branche gelijk is aan één van de onderstaande waardes.

  • AlgemeneIndustrie
  • Bouwbedrijf
  • HorecaAlgemeen
  • RecreatieCultuurEnAmusement

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 aanvankelijk van de product context, staat het attribuut niet specifiek vermeld houd dan de regulatie uit het datamodel aan.

  • Zakelijk
  • Particulier
AttribuutVerplichtAfhankelijk van
AantalSchadevrijeJarenJa
BestuurderBestelauto/AdresJa
BestuurderBestelauto/GeboortedatumJa
BestuurderBestelauto/InwonendPotentieelGebruik
BestuurderBestelauto/IsZzpJa
BpmVerrekenenJa
BranchePotentieelGebruik
BtwVerrekenenJa
GebruikJa
GebruiktAlsVerkoopwagenPotentieelGebruik
GrensoverschrijdendVervoerPotentieelGebruik
KentekenPotentieelTypeInformatie
IngangsdatumJa
JaarkilometrageJa
LeaseautoJa
SoortVervoerdeZakenPotentieelBranche
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
GebruiktAlsVerkoopwagen
GrensoverschrijdendVervoer
Bestuurder
Eigenaar bedrijf of Werknemer
Relatie
Bestuurder
Partner, Kind of Overig
Relatie
Inwonend
Branche
SoortVervoerdeZaken
AttribuutVerplichtAfhankelijk van
AantalSchadevrijeJarenJa
BestuurderBestelauto/AdresJa
BestuurderBestelauto/GeboortedatumJa
BestuurderBestelauto/IsZzpn.v.t.
BpmVerrekenenn.v.t.
Branchen.v.t.
BtwVerrekenenn.v.t
GebruiktAlsVerkoopwagenn.v.t.
GrensoverschrijdendVervoern.v.t.
KentekenPotentieelTypeInformatie
IngangsdatumJa
JaarkilometrageJa
Leaseauton.v.t.
MinimaleVerzekerdeSomTransportn.v.t.
SoortVervoerdeZakenn.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

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

Aanvullende verzekeringen

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

BestelautoProfiel
DekkingAttribuutWaarde
Schade inzittendenSchadeInzittendenMeeverzekerentrue / false
Ongevallen inzittendenMinimaleVerzekerdeSomInvaliditeit0 / 15000 / 22500
Ongevallen inzittendenMinimaleVerzekerdeSomOverlijden0 / 5000 / 7500
RechtsbijstandMinimaleRechtsbijstandDekkingsvormVerhaal / Motorrijtuigen
PechhulpMinimaalPechhulpDekkingsgebiedNederland / Europa
PechhulpPechhulpAanhangerMeeverzekerentrue / false
PechhulpPechhulpWoonplaatsMeeverzekerentrue / false
TransportMinimaleVerzekerdeSomTransport0 / 5000 / 10000 / 15000 / 20000
Aanschafwaarde / Nieuwwaardegarantie*MinimaleGarantieTermijnInMaanden12 / 24 / 36
Keuzevrijheid herstellerVrijeKeuzeHersteltrue / false

* 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:BestelautoProfiel: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 bestelautoverzekering 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
Bestuurderaanvraagwebapi:BestuurderAcceptatievragenAanvraag > Bestuurders > Bestuurder
Voertuigaanvraagwebapi:VoertuigAcceptatievragenAanvraag > Bestuurders > Bestuurder > Voertuigen > Voertuig
/aanvragen/{aanvraagId}/bestuurders/{bestuurderId}/acceptatievragen
/aanvragen/{aanvraagId}/bestuurders/{bestuurderId}/voertuigen/{voertuigId}/acceptatievragen
← AansprakelijkheidBromfiets →
  • 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