Het doel van deze webservice op het MAGDA-platform is het beschikbaar stellen van de technische gegevens en eigenaar van een voertuig. Deze gegevens zijn afkomstig van DIV.
De dienst volgt een bepaalde flow:
De afnemer vult de volgende gegevens in:
het land van inschrijving van het voertuig
de nummerplaat (afhankelijk van het land van inschrijving 1 of 2 delen)
het tijdstip (datum + uur) waarop deze gegevens van toepassing zijn
Deze gegevens worden gebruikt om de dienst FmvEuConsultTitPlateV01 aan te spreken, deze dienst geeft de eigenaarsgegevens (en eventueel ook enkele eigenschappen van het voertuig terug) op een bepaalde datum.
De dienst GeefBuitenlandsVoertuig 02.00 geeft dit antwoord terug naar de afnemer.
XSD Visueel
Detail
Element
Functionele omschrijving
Nummerplaat
De nummerplaat van het voertuig
Deel1
Bevat de volledige nummerplaat.
Voor sommige landen (zoals Duitsland) bestaat een nummerplaat uit 2 delen: Het eerste deel is een district code, het 2e deel is de eigenlijke unieke identificator binnen dat district.
Deel2
Enkel in te vullen voor landen waar een nummerplaat in 2 delen opgesplitst is
Land
ISO-3 land code van het voertuig waarvan de geregistreerde gegevens opgevraagd worden
DatumTijd
Datum waarvoor de eigenaarsgegevens gewenst zijn.
Datum
YYYY-MM-DD
Tijd
HH:MM:SS.mmm (“HH:MM” zijn verplicht “:SS.mmm” zijn optioneel)
Taal
ISO 639-2 code van de taal in dewelke de data opgevraagd wordt.
Validaties op vraag
Volgende functionele validatie wordt uitgevoerd op de vraag:
Node element
Uit te voeren validatie
MAGDA Foutcode
Type Uitzondering
Annotatie
Vraag/Referte
De lengte van de vraag referte mag maximaal 20 karakters zijn
Reden: referte in brondiensten beperkt tot lengte 20