Voertuiginformatie

Voertuiginformatie ophalen

Alle kenteken gebaseerde producten worden berekend op basis van de informatie die over een voertuig beschikbaar is. Het is dan ook belangrijk dat er afdoende voertuiginformatie aan de berekening wordt meegegeven om tot een juiste calculatie te komen. Hiervoor zijn twee methodes beschikbaar: 1. op basis van kenteken of 2. zonder kenteken, op basis van een Merk-Model-Type combinatie.

Op basis van kenteken

Wanneer de consument een kenteken invult wordt er geadviseerd om deze te valideren. Dat kan met behulp van voertuiginformatie:/kentekens/{kenteken}, dit endpoint retourneert of het kenteken bekend is en wat voor type voertuig eraan gekoppeld is. Het kenteken kan vervolgens gebruikt worden om meer gedetailleerde voertuiginformatie op te vragen via voertuiginformatie:/voertuigen/{kenteken}.

Let op: De API verwacht een kenteken zonder scheidingstekens.
Correct: 81XXX1
Foutief: 81-XXX-1

1. Kenteken / meldcode valideren

Aanvankelijk kan de kentekenvalidatie ook direct gebruikt worden om de meldcode te valideren. Dit is een optionele parameter welke aan het endpoint kan worden meegegeven.

/kentekens/{kenteken}

2. Voertuiginformatie ophalen

/voertuigen/{kenteken}

Zonder kenteken

Wanneer er geen kenteken bekend is moet men een Merk-Model-Type combinatie opstellen om tot een berekening te komen. De eerste stap in dit proces is het selecteren van het merk, eventueel in combinatie met het bouwjaar.

Let op: Bij het gebruik van een Merk-Model-Type berekening kunnen enkel indicatieve premies worden gegeven. Om de berekening om te zetten naar een aanvraag is uiteindelijk een kenteken vereist.

1a. Merken ophalen voor Aanhangwagen, Fiets, Stacaravan, Toercaravan, Vouwwagen

/merken

1b. Merken ophalen voor Bestelauto, Bromfiets, Motorfiets, Personenauto

/voertuigen/{bouwdatum}/merken

Let op: Om een lijst van alle beschikbare merken op te halen, ongeacht het brandstoftype, dient de waarde NietVanToepassing gebruikt te worden.

Let op: bouwdatum is een verplicht veld. In het jaar 2000 hadden we bijvoorbeeld nog geen Tesla's.

2. Modellen ophalen

Met behulp van het gekozen merk kunnen vervolgens de bijbehorende modellen opgevraagd worden.

/voertuigen/{bouwdatum}/merken/{merkid}/modellen

3. Types ophalen

Met behulp van het gekozen merkid kunnen de bijhorende types worden opgevraagd. Dit zijn als het ware alle varianten die van het model bekend zijn.

/voertuigen/{bouwdatum}/merken/{merkid}/modellen/{modelid}/types

4a. Voertuiginformatie ophalen

Uiteindelijk kan met behulp van het typeid soortgelijke voertuiginformatie worden opgehaald zoals wanneer het kenteken bekend is. Deze informatie kan vervolgens gebruikt worden voor de berekening wanneer het kenteken niet bekend is.

/voertuigen/{bouwdatum}/types/{typeid}/details

5a. Cataloguswaarde berekenen

Berekent de cataloguswaarde inclusief btw en bpm en de cataloguswaarde inclusief btw op basis van de cataloguswaarde exclusief btw en bpm

/voertuigen/{bouwdatum}/prijs/cataloguswaarde/exclusief-btw-en-bpm

5b. Cataloguswaarde berekenen

Geeft de cataloguswaarde exclusief btw en bpm op basis van een cataloguswaarde inclusief btw en bpm terug.

/voertuigen/{kenteken}/prijs/cataloguswaarde-exclusief-btw-en-bpm

5c. Cataloguswaarde berekenen

Berekent de cataloguswaarde inclusief btw en bpm en de cataloguswaarde exclusief btw en bpm op basis van de cataloguswaarde exclusief btw.

/voertuigen/{bouwdatum}/prijs/cataloguswaarde/exclusief-btw

5d. Cataloguswaarde berekenen

Berekent de cataloguswaarde exclusief btw en bpm en de cataloguswaarde exclusief btw op basis van de cataloguswaarde inclusief btw en bpm.

/voertuigen/{bouwdatum}/prijs/cataloguswaarde/inclusief-btw-en-bpm

6a. Dagwaarde berekenen

Berekent de dagwaarde inclusief btw op basis van de dagwaarde exclusief btw.

/voertuigen/{bouwdatum}/prijs/dagwaarde/exclusief-btw

6b. Dagwaarde berekenen

Berekent de dagwaarde exclusief btw op basis van de dagwaarde inclusief btw.

/voertuigen/{bouwdatum}/prijs/dagwaarde/inclusief-btw

6c. Dagwaarde berekenen

Geeft de dagwaarde exclusief btw op basis van de dagwaarde inclusief btw terug.

/voertuigen/{kenteken}/prijs/dagwaarde-exclusief-btw