Procesbeschrijving VKR

De VKR service omvat 2 processen:

1. versneld aanvragen van een kenteken bij RDW en het weer opvragen van gedane aanvragen 2. versturen van een kentekenplaat- en documentatieaanvraag naar een platendrukker

8.15.1. Versneld Aanvragen Kenteken

Om een kentekenaanvraag bij RDW te doen, is een aantal gegevens benodigd. Een aantal van deze gegevens is beschikbaar als referentielijst in de web service. Andere, voertuigspecifieke, gegevens dienen door de aanvrager te worden verschaft.

Opvragen Voertuigcategorieën

Opvragen Merken

Opvragen ETK Landcodes

Opvragen Kleurcodes

Opgeven Voertuigspecifieke Gegevens

Versturen VKR

Opvragen Inrichtingscodes Aanhangwagens

8.15.1.1. Opvragen Voertuigcategorieën

Een VKR kan worden uitgevoerd voor vier voertuigcategorieën:

1. Brom-/snorfietsen 2. Motorfietsen 3. Personenwagens 4. Aanhangwagens

Om te bepalen voor welke voertuigcategorieën een aanvraag kan worden gedaan, kan voor een eindgebruiker een lijst met de beschikbare voertuigcategorieën worden opgehaald.

Webmethode: opvragen_voertuigcategoriecodes

Inputbericht: xml_in_opvragen_voertuigcategoriecodes

Outputbericht: xml_out_opvragen_voertuigcategoriecodes

xmlMode Bible for Clients – versie 1.6 115

8.15.1.2. Opvragen Merken

Om te bepalen voor welke merken binnen een voertuigcategorie een aanvraag kan worden gedaan, kan voor een eindgebruiker een lijst met de beschikbare merken worden opgehaald.

Webmethode: opvragen_merkcodes

Inputbericht: xml_in_opvragen_merkcodes Outputbericht: xml_out_opvragen_merkcodes

8.15.1.3. Opvragen ETK Landcodes

Voor personenwagens moet een ETK landcode worden meegegeven. Een lijst met alle RDW landcodes kan worden opgehaald.

Webmethode: opvragen_etk_landcodes

Inputbericht: xml_in_opvragen_etk_landcodes Outputbericht: xml_out_opvragen_etk_landcodes

8.15.1.4. Opvragen Kleurcodes

Voor personenwagens moeten één of twee kleurcodes worden meegegeven. Een lijst met alle RDW kleurcodes kan worden opgehaald.

Webmethode: opvragen_kleurcodes

Inputbericht: xml_in_opvragen_kleurcodes Outputbericht: xml_out_opvragen_kleurcodes

8.15.1.5. Opvragen Inrichtingscodes Aanhangwagens/Opleggers

Voor aanhangwagens/opleggers moet een inrichtingscode worden aangegeven. Een lijst met alle inrichtingscodes voor aanhangwagens/opleggers kan worden opgehaald.

Webmethode: opvragen_inrichtingscodes_aanhangwagens

Inputbericht: xml_in_opvragen_inrichtingscodes_aanhangwagens Outputbericht: xml_out_opvragen_inrichtingscodes_aanhangwagens

8.15.1.6. Opgeven Voertuigspecifieke Gegevens Tot voertuigspecifieke gegevens behoren o.a.:

• Chassisnummer

• Typegoedkeuringsgegevens

• Handelsbenaming

De exacte samenstelling van voertuigspecifieke gegevens is per voertuigcategorie verschillend. Voor de samenstelling bij een voertuigcategorie, zie het bijbehorende voorbeeldbericht en de XML-elementenlijst.

8.15.1.7. Versturen VKR

Wanneer alle gegevens bekend zijn, kan een kentekenaanvraag worden gedaan bij RDW.

Webmethode: versturen_vkr_bromfiets

Inputbericht: xml_in_versturen_vkr_bromfiets Outputbericht: xml_out_versturen_vkr_bromfiets Webmethode: versturen_vkr_motorfiets

Inputbericht: xml_in_versturen_vkr_motorfiets Outputbericht: xml_out_versturen_vkr_motorfiets Webmethode: versturen_vkr_personenwagen

Inputbericht: xml_in_versturen_vkr_personenwagen

Outputbericht: xml_out_versturen_vkr_personenwagen

xmlMode Bible for Clients – versie 1.6 116

Webmethode: versturen_vkr_aanhangwagen

Inputbericht: xml_in_versturen_vkr_aanhangwagen Outputbericht: xml_out_versturen_vkr_aanhangwagen

In het antwoordbericht bevindt zich een <transactie> element, met daarin een <statuscode> element en een <kortemelding> element. Aan de hand hiervan kan worden bepaald of de verwerking

succesvol is verlopen.

8.15.1.7.1. Succesvolle verwerking

Indien het <statuscode> element de waarde ‘00’ bevat en het <kortemelding> element de waarde ‘OK’ bevat, is de transactie geslaagd. In dit geval zal ook een <vkr_resultaat> aanwezig zijn in het antwoordbericht, met daar in een <kenteken> element, dat het door RDW toegewezen kenteken bevat.

8.15.1.7.2. Niet succesvolle verwerking Er zijn twee foutscenario’s mogelijk:

• Afkeuring van de transactie door RDW

het <statuscode> element zal een waarde bevatten ongelijk aan ‘00’. Er zal zich geen kenteken in het antwoordbericht bevinden. Het <kortemelding> element zal een beschrijving bevatten van de opgetreden fout.

• Interne verwerkingsfout

Het kan voorkomen dat er een systeemfout optreedt bij de verwerking. In dit geval zal het antwoordbericht geen <transactie> element bevatten. Het antwoordbericht zal een

<extrainfo> element bevatten met daarin een omschrijving van de opgetreden fout.

8.15.2. Versturen Kentekenplaataanvraag

Wanneer, en alléén wanneer, een VKR aanvraag succesvol is afgerond, kan een aanvraag voor kentekenplaten bij het verkregen kenteken worden verstuurd naar een platendrukker.

N.B. Dit kan alleen indien een relatie met een platendrukker bekend is bij VWE.

Opvragen Beschikbaarheid Platendrukker

Platendrukker beschikbaar?

Opvragen Kentekenplaattypes ja nee

Versturen Kentekenplaataanvraag

8.15.2.1. Opvragen Beschikbaarheid Platendrukker

Om te bepalen of voor een eindgebruiker een platendrukker bekend is bij VWE, kan de beschikbaarheid

worden opgevraagd.

xmlMode Bible for Clients – versie 1.6 117

Webmethode: opvragen_beschikbaarheid_platendrukker

Inputbericht: xml_in_opvragen_beschikbaarheid_platendrukker Outputbericht: xml_out_opvragen_beschikbaarheid_platendrukker

Het antwoordbericht zal een <platendrukker_beschikbaar> element bevatten, met een waarde ‘true’

of ‘false’. De betekenis van deze waarde is als volgt:

true

Er is een platendrukker bekend voor de eindgebruiker. Het is mogelijk om een kentekenplaataanvraag te doen.

false

Er is géén platendrukker bekend voor de eindgebruiker. Het is niet mogelijk om een kentekenplaataanvraag te doen.

8.15.2.2. Opvragen Kentekenplaattypes

Wanneer voor de eindgebruiker een platendrukker bekend is bij VWE, kan een lijst met beschikbare kentekenplaattypes voor een voertuigcategorie worden opgevraagd.

Webmethode: opvragen_kentekenplaattypes

Inputbericht: xml_in_opvragen_kentekenplaattypes Outputbericht: xml_out_opvragen_kentekenplaattypes

8.15.2.3. Versturen Kentekenplaataanvraag

Om kentekenplaten en kentekenpapieren aan te vragen bij een platendrukker, kan op basis van een succesvolle VKR een kentekenplaataanvraag worden gedaan.

Webmethode: versturen_aanvraag_platendrukker

Inputbericht: xml_in_versturen_aanvraag_platendrukker Outputbericht: xml_out_versturen_aanvraag_platendrukker

8.15.2.3.1. Succesvolle verwerking

Wanneer de aanvraag voor de platendrukker succesvol is verwerkt, zal het antwoordbericht een

<aanvraagsuccesvol> element bevatten, met een waarde ‘true’.

8.15.2.3.2. Niet succesvolle verwerking

Wanneer de aanvraag voor de platendrukker niet succesvol is verwerkt, zal het antwoordbericht een

<aanvraagsuccesvol> element bevatten, met een waarde ‘false’. Tevens zal het antwoordbericht

een <extrainfo> element bevatten met daarin een omschrijving van de opgetreden fout.

In document XML Mode Bible for clients februari Versie 1.6.3 (pagina 114-117)