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