GEBRUIKERSHANDLEIDING DOMEIN MOBILITEIT GEEFVOERTUIG 2.0. Versie /// 2.0 Publicatiedatum /// /// Gebruikershandleiding

Transcriptie

1 /// Gebruikershandleiding GEBRUIKERSHANDLEIDING DOMEIN MOBILITEIT GEEFVOERTUIG 2.0 Versie /// 2.0 Publicatiedatum ///

2 Informatie Vlaanderen /// Auteur: Elin Vanlierde Datum aanmaak: Wijzigingsdatum: Datum afdruk: Interne bestandsnaam: Gebruikershandleiding GeefVoertuig 2.0 Documenthistoriek: Versie Opmerking Datum Auteur Status 0.1 Aanmaak gebruikershandleiding Jan Van Geert Concept 1.0 Publicatie Jan Van Geert Finale versie 2.0 Nieuwe lay-out Elin Vanlierde Finale versie 2 /// /// Gebruikershandleiding Domein Mobiliteit GeefVoertuig 2.0

3 /// Informatie Vlaanderen INHOUD Inhoud Inleiding Definities en afkortingen Doel Algemeen Omgevingsinformatie Gegevensbronnen Batch Interface Algemeen Vraag Visueel Detail Voorbeeld Antwoord XSD visueel Detail Voorbeeld Uitzonderingen Functionele fouten Runtime gerelateerde fouten Codetabel Euronorm Werking Aandachtspunten Opties Gebruikershandleiding - Domein Mobiliteit GeefVoertuig 2.0 /// /// 17

4 Informatie Vlaanderen /// 4.3 FAQ Testgegevens en Voorbeelden Testgegevens Voorbeelden Algemene Magda documentatie Contactgegevens /// /// Gebruikershandleiding Domein Mobiliteit GeefVoertuig 2.0

5 /// Informatie Vlaanderen 1 INLEIDING 1.1 DEFINITIES EN AFKORTINGEN Term/Afkorting LEZ Magda DIV Omschrijving Lage Emissie Zone Maximale gegevensdeling tussen administraties Dienst voor Inschrijvingen van Voertuigen 1.2 DOEL Dit document beschrijft het gebruik en de werking van de webservice GeefVoertuig zoals deze door Agentschap Informatie Vlaanderen op het MAGDA platform aangeboden wordt. Deze dienst maakt gebruik van twee diensten bij DIV: ConsultTitPlate en ConsultVehicle. Gebruikershandleiding - Domein Mobiliteit GeefVoertuig 2.0 /// /// 17

6 Informatie Vlaanderen /// 2 ALGEMEEN 2.1 OMGEVINGSINFORMATIE Naam: GeefVoertuig Versie: Functioneel domein: Mobiliteit 1 Classificatie: Privacygevoelig 2.2 GEGEVENSBRONNEN De gegevens worden zijn opgeslagen bij de (authentieke) gegevensbron DIV. Agentschap Informatie Vlaanderen is dan ook afhankelijk van deze externe bron voor de kwaliteit en de beschikbaarheid van de gegevens. 2.3 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. 1 Context informatie over dit domein zijn opgenomen in Domeincontext [DC] 6 /// /// Gebruikershandleiding Domein Mobiliteit GeefVoertuig 2.0

7 /// Informatie Vlaanderen 3 INTERFACE 3.1 ALGEMEEN 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: 1) De afnemer vult de nummerplaat in van het voertuig en de datum waarop deze gegevens van toepassing zijn 2) Deze gegevens worden gebruikt om de dienst ConsultTitPlate aan te spreken, deze dienst geeft de eigenaarsgegevens op een bepaalde datum terug en het chassisnummer van het voertuig. 3) Dit chassisnummer wordt automatisch ingevuld in de vraag, nu wordt de vraag gebruikt om de dienst ConsultVehicle aan te spreken, deze dienst geeft de technische gegevens van het voertuig terug. 4) De dienst GeefVoertuig 2.0 bundelt de antwoorden van deze diensten en geeft dit terug in het antwoord. 3.2 VRAAG Visueel Gebruikershandleiding - Domein Mobiliteit GeefVoertuig 2.0 /// /// 17

8 Informatie Vlaanderen /// Detail Naam Inhoud Beschrijving Criteria/ Nummerplaat Datum /Criteria Taal De nummerplaat waarvoor men de gegevens wenst op te zoeken, deze dient zonder speciale tekens ingevoerd te worden. Datum waarop de gegevens van toepassing zijn Taal waarin de omschrijvingen van de codes weergegeven moeten worden. Mogelijke waarden zijn: nl, fr en de Voorbeeld <Vragen> <Vraag> <Referte> </Referte> <Inhoud> <Criteria> <Nummerplaat>1AAA123</Nummerplaat> <Datum> </Datum> </Criteria> <Taal>nl</Taal> </Inhoud> </Vraag> </Vragen> 8 /// /// Gebruikershandleiding Domein Mobiliteit GeefVoertuig 2.0

9 /// Informatie Vlaanderen 3.3 ANTWOORD XSD visueel Detail Element Nummerplaat Chassisnummer Beschrijving De nummerplaat van het voertuig Chassisnummer van het voertuig Gebruikershandleiding - Domein Mobiliteit GeefVoertuig 2.0 /// /// 17

10 Informatie Vlaanderen Eigenaar INSZ Ondernemingsnummer CommercieleNaam Een identificatienummer, dit wordt toegevoegd bij niet-unieke chassisnummers Bevat de gegevens van de eigenaar, dit kan diens INSZ zijn OF het ondernemingsnummer INSZ van de eigenaar Ondernemingsnummer van de eigenaar De commerciële naam van het voertuig, bijvoorbeeld Opel Corsa Kleur Code De kleur van het overtuig, bevat een code en een omschrijving De code die de kleur van het voertuig weergeeft Omschrijving Categorie Code Omschrijving Euronorm Code Omschrijving DatumEersteInschrijving De omschrijving van de code van de kleur van het voertuig De categorie van het voertuig, bevat een code en een omschrijving De code die de categorie van het voertuig weergeeft De omschrijving van de code van de categorie van het voertuig Element dat de Euronorm van het voertuig weergeeft, bevat een code en een omschrijving. De omschrijving wordt door MAGDA ingevuld. De code die de euronorm van het voertuig weergeeft Omschrijving van de code, ingevuld door MAGDA De datum van de eerste inschrijving van het voertuig Voorbeeld <Inhoud> <Voertuig> <Nummerplaat>1AAA123</Nummerplaat> <Chassisnummer>2FTJW35GXRCA04699</Chassisnummer> <Eigenaar> <INSZ> </INSZ> </Eigenaar> <CommercieleNaam>OPEL CORSA</CommercieleNaam> <Kleur> <Code>J</Code> <Omschrijving>Oranje</Omschrijving> </Kleur> 10 /// /// Gebruikershandleiding Domein Mobiliteit GeefVoertuig 2.0

11 /// Informatie Vlaanderen <Categorie> <Code>M1</Code> <Omschrijving>VOERTUIGEN BESTEMD VOOR PERSONENVERVOER-TEN HOOGSTE 8 ZITPLAATSEN-BESTUURDER NIET MEEGEREKEND</Omschrijving> </Categorie> <Euronorm> <Code>6</Code> <Omschrijving>Euro 6</Omschrijving> </Euronorm> <DatumEersteInschrijving> </DatumEersteInschrijving> </Voertuig> </Inhoud> 3.4 UITZONDERINGEN Functionele fouten Identificatie Niveau Type Diagnose Oorsprong FOUT De toegang tot de gegevens is geweigerd MAGDA FOUT Geen gegevens gevonden voor de vraag MAGDA FOUT Kan antwoord van de bron niet interpreteren MAGDA FOUT Bron is tijdelijk niet beschikbaar MAGDA Runtime gerelateerde fouten Identificatie Niveau Type Diagnose Oorsprong 3 FOUT Broncode niet aanwezig voor opgegeven Magda code in de vraag, contacteer VIP MAGDA 3 FOUT Magda code niet aanwezig voor teruggekomen MAGDA broncode, contacteer VIP 3 WAARSCHUWING Magda beschrijving voor code niet aanwezig, MAGDA contacteer VIP Opmerking: toevoeging annotatie met node en code! 3 FOUT Ongekende foutcode van de bron, contacteer VIP MAGDA Gebruikershandleiding - Domein Mobiliteit GeefVoertuig 2.0 /// /// 17

12 Informatie Vlaanderen /// 3.5 CODETABEL Euronorm Dit gegeven wordt door MAGDA zelf aangevuld op basis van de Euronorm/Code die de dienst terugkrijgt van DIV. Euronorm/Code Euronorm/Omschrijving 0 N/A 1 Euro 1 2 Euro 2 3 Euro 3 4 Euro 4 5 Euro 5 6 Euro 6 5a 5b 6a 6b I II III IV V VI EEV P1 P2 P3A P3B Euro 5a Euro 5b Euro 6a Euro 6b Euro I Euro II Euro III Euro IV Euro V Euro VI Euro EEV Phase I Phase II Phase IIIA Phase IIIB 12 /// /// Gebruikershandleiding Domein Mobiliteit GeefVoertuig 2.0

13 /// Informatie Vlaanderen P4 6c Phase IV Euro 6c Gebruikershandleiding - Domein Mobiliteit GeefVoertuig 2.0 /// /// 17

14 Informatie Vlaanderen /// 4 WERKING 4.1 AANDACHTSPUNTEN De afnemer is zelf verantwoordelijk voor correct aanroepen van de dienst. Dit door gebruik te maken van de nummerplaat, zonder speciale tekens. 4.2 OPTIES 4.3 FAQ Er zijn geen gekende problemen. 14 /// /// Gebruikershandleiding Domein Mobiliteit GeefVoertuig 2.0

15 /// Informatie Vlaanderen 5 TESTGEGEVENS EN VOORBEELDEN 5.1 TESTGEGEVENS Voor deze dienst zijn er bij MAGDA geen testgegevens beschikbaar. Hiervoor wordt verwezen naar DIV. 5.2 VOORBEELDEN Voorbeeld Inhoud Bestandsnaam Voorbeeld 1 Correcte verwerking Vraag en Antwoord 1 Voorbeeld 2 Geen gegevens gevonden voor de vraag Vraag en Antwoord 2 Voorbeeld 3 Ongekende foutcode van de bron Vraag en Antwoord 3 Gebruikershandleiding - Domein Mobiliteit GeefVoertuig 2.0 /// /// 17

16 Informatie Vlaanderen /// 6 ALGEMENE MAGDA DOCUMENTATIE Onderwerp Logging Generieke foutcodes Magda uitzonderingen Authenticatie & autorisatie Prefixen voor batch gebruik Verwante diensten Website Magda platform /// /// Gebruikershandleiding Domein Mobiliteit GeefVoertuig 2.0

17 /// Informatie Vlaanderen 7 CONTACTGEGEVENS Informatie Vlaanderen is elke werkdag bereikbaar van 9.00 tot uur. Postadres: Herman Teirlinckgebouw - Havenlaan 88, 1000 Brussel Virginie Lovelinggebouw - Koningin Maria Hendrikaplein 70, 9000 Gent Tel: 02/ helpdesk.magda@vlaanderen.be Gebruikershandleiding - Domein Mobiliteit GeefVoertuig 2.0 /// /// 17