Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

Mobiliteit.GeefBuitenlandsVoertuig-02.00

Informatie:

Voor de ontsluiting van een MAGDA 2.0 webservice, alsook het generieke proces binnen een 2.0 webservice, wordt verwezen naar Werking en gebruik MAGDA 2.0 Webservices.

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 Opvraging.

Opmerking:

Agentschap Digitaal Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens. 

Batch

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

Hiervoor moet men de Service-XSD gebruiken en niet de Webservice. Door de Service-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

Prefix

mobiliteit.geefbuitenlandsvoertuig-02.00

Voorbeeld

mobiliteit.geefbuitenlandsvoertuig-02.00_20131103115553530

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.

Opvraging

Momenteel laat de DIV dienst nog niet toe dat er gegevens opgevraagd kunnen worden in verschillende talen. DIV geeft ons nog geen technische gegevens terug van de voertuigen. DIV ontsluit 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

Opmerking:

De MAGDA response tijden zijn heel sterk afhankelijk van de response tijden van de bron. Als de brongegevens heel traag worden aangeleverd kan het MAGDA antwoord niet snel worden aangeleverd. 

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.

Op deze pagina


Binnen deze handleiding


Omgevingsinformatie

Domein

Mobiliteit

Classificatie

Persoonsgegevens


Verwante diensten


 


Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren

De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid

uitgegeven door Digitaal Vlaanderen