Dit document beschrijft het gebruik en de werking van de webservice GeefBuitenlandsVoertuig 02.00 zoals deze door Agentschap Digitaal Vlaanderen op het MAGDA platform aangeboden wordt.

Situering

Dit document beschrijft het gebruik en de werking van de webservice GeefBuitenlandsVoertuig 02.00 zoals deze door Agentschap Digitaal Vlaanderen op het MAGDA platform aangeboden wordt.

Deze dienst maakt gebruik van 1 dienst bij DIV: FmvEuConsultTitPlateV01.

Gegevensbronnen

De gegevens worden opgeslagen in verschillende landen, maar worden allen op vraag ontsloten via de (authentieke) gegevensbron DIV.

Meer informatie over hoe deze bronnen gebruikt worden in de opbouw van het antwoord vindt u onder Opvragingonder Opvraging.

Batch

Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML).

Hiervoor moet men de Service-xsd XSD gebruiken en niet de Webservice. Door de Service-xsd XSD te gebruiken zijn er meerdere vragen mogelijk in één bestand. De vraag-bestanden worden op de MAGDA FTP geplaatst in een afnemer specifieke folder. Deze folder wordt tijdens het aansluitingsproces toegekend.

Als prefix voor de batchbestanden wordt “mobiliteit.geefbuitenlandsvoertuig-02.00” gebruikt.

Het bestand zelf dient deze vorm te hebben:

mobiliteit.geefbuitenlandsvoertuig-02.00_datumtijdstip.extensie

Vb.         mobiliteit.geefbuitenlandsvoertuig-02.00_2018011809391234.xml

Functionaliteiten

Het doel van deze dienst is om gegevens van een buitenlands voertuig ter beschikking te stellen via het MAGDA platform. De bron voor deze gegevens is FOD Mobiliteit.

Deze dienst onderscheidt zich van de dienst GeefVoertuig 02.00 op verschillende vlakken:

• Het antwoord heeft een andere structuur

  • Er wordt voor buitenlandse nummerplaten geen gebruik gemaakt van een VO-cache

  • Dit antwoord bevat naam en adres gegevens van de ontvanger

  • Dit antwoord bevat niet steeds een Ondernemingsnummer of Rijksregister-nummer

  • Dit antwoord bevat niet altijd alle gegevens betreffende het voertuig

• Er wordt onderliggend een andere dienst bij het DIV opgeroepen

Werking

Aandachtspunten

De afnemer is zelf verantwoordelijk voor correct aanroepen van de dienst. Dit door gebruik te maken van de nummerplaat, zonder speciale tekens die dienen om nummerplaat delen van elkaar te onderscheiden.

De DatumTijd uit de vraag dient in het verleden te liggen.

Anchor
opvraging opvraging

Opvraging

Momenteel laat de DIV dienst nog niet toe dat er gegevens opgevraagd kunnen worden in verschillende talen. Momenteel DIV geeft DIV ons nog geen technische gegevens terug van de voertuigen. Momenteel DIV ontsluit DIV enkel gegevens uit Nederland en Frankrijk.

Momenteel dient men voor opvragingen van gegevens uit Nederland of Frankrijk de gehele nummerplaat in Nummerplaat>Deel1 mee te geven, zonder speciale tussentekens (zoals een steepje of een punt).

Responsetijden & Beschikbaarheid

Logging

De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven op de pagina "MAGDA logging".

Ondersteunde talen

MAGDA ondersteunt de Nederlandse taal.

Indien in de brongegevens de Nederlandse tekst niet beschikbaar is voor een bepaald element zal de eerste vertaling van de tekst in de brongegevens gebruikt worden, onafhankelijk van de taal waarin dit gegeven beschikbaar is.