DIGITAAL VLAANDEREN
Interface (Mobiliteit.CheckVoertuiglijst-02.00)
- Laurens Debackere (Deactivated)
- Bert Van Kets
- Pedro Devogelaere (Deactivated)
Algemeen
De afnemer kan een lijst van geflitste voertuigen in csv formaat aanleveren op een afnemer specifieke locatie.
Deze lijst zal op het Magda platform opgepikt en getransformeerd worden naar een geldig formaat voor aanroep van de ControleerToegangOpDatum 02.00 dienst (batchversie).
In de flitslijst dienen per te controleren voertuig volgende vraagparameters te worden opgegeven:
Referte: optioneel, bijvoorbeeld referte van de foto van het geflitste voertuig
Nummerplaat: verplicht, nummerplaat van het voertuig
LandISOcode: verplicht, ISO land code waar het voertuig is ingeschreven
DatumControle: verplicht, datum waarop de toegang tot de LEZ moet gecontroleerd worden
De resultaten van de toegangscontrole zullen vervolgens terug getransformeerd worden naar csv formaat, verdeeld over 3 resultaatbestanden in functie van het resultaat: toegelaten, niet toegelaten en te controleren. Er zullen steeds 3 bestanden worden afgeleverd op een afnemer specificatie locatie. Indien geen enkel voertuig in aanmerking komt voor een bepaald resultaat, zal een leeg bestand worden afgeleverd.
In elk resultaatbestand zullen de vraagparameters van het voertuig terug te vinden zijn, aangevuld met het resultaat van de controle voor het voertuig in kwestie.
Bronbestand flitslijst
Locatie
Opmerking:
De exacte locatie wordt pas meegedeeld tijdens het aansluitingsproces.
Naamgeving
<Prefix>_<Naam LEZ inrichter>_<Naam Magda BD> _<Referte UUID>_<Tijdstip aanmaak bestand>.<Extensie>
Gegeven | Omschrijving | Voorbeeld |
|---|---|---|
Prefix | Verwijzing naar Lage Emissie Zone, steeds “CTOD_LEZ” | CTOD_LEZ |
Naam LEZ inrichter | De naam van de LEZ inrichter | Antwerpen |
Naam Magda BD | Naam van de Magda dienst die na FTF moet worden aangeroepen, in dit geval steeds “ControleerToegangOpDatum” | ControleerToegangOpDatum |
Referte UUID | Unieke referte van de aangeleverde flitslijst, 128-bit, 36 tekens, structuur 8-4-4-4-12 | dbe35915-53c7-4726-a58f-af8e0a89b21b |
Tijdstip aanmaak bestand | Datum en tijdstip van aanmaak bestand, formaat YYYYMMDDHHMMSSSSS | 20160923134012345 |
Extensie | Extensie waarmee het bronbestand wordt aangeleverd, in dit geval “csv” | “csv” |
Inhoud
Algemeen
De standaard CSV richtlijnen dienen gevolgd te worden:
UTF-8 encoding
Alle velden tussen dubbele quotes
Velden gescheiden door puntkomma
Lege velden worden opgenomen als lege string tussen dubbele quotes
Geen line feed na de laatste datalijn, bestand eindigt m.a.w. bij het laatste karakter van de laatste datalijn
Header
Niet van toepassing.
Data
Gegeven | Omschrijving | Voorbeeld |
|---|---|---|
Referte | Business referte m.b.t. het te controleren voertuig. | “Referte ABC” |
Nummerplaat | Nummerplaat in hoofdletters, zonder spaties of koppeltekens | “1XYZ123” |
LandISOCode | ISO land code waar het voertuig is ingeschreven, 2 lang, in hoofdletters | “BE” |
DatumControle | Datum waarop de toegang van het voertuig tot de LEZ dient gecontroleerd te worden, formaat YYYY-MM-DD | “2016-11-17” |
Footer
Niet van toepassing.
Voorbeeld
Bestandsnaam: CTOD_LEZ_Antwerpen_ControleerToegangOpDatum_dbe35915-53c7-4726-a58f-af8e0a89b21b_20160923134012345.csv
Inhoud:
Opmerking:
Niet herkende nummerplaten moeten met een onbekende LandISOCode worden aangeleverd. Vanuit het Magda platform wordt voorgesteld hiervoor de waarde “**” te gebruiken.
Resultaatbestand toegangscontrole flitslijst
Locatie
Opmerking:
De exacte locatie wordt pas meegedeeld tijdens het aansluitingsproces.
Naamgeving
<Prefix>_<Naam LEZ inrichter>_<Naam Magda BD>_<Resultaat>_<Referte UUID>_<Tijdstip aanmaak bestand>.<Extensie>
Gegeven | Omschrijving | Voorbeeld |
|---|---|---|
Prefix | Verwijzing naar Lage Emissie Zone, steeds “CTOD_LEZ” | CTOD_LEZ |
Naam LEZ inrichter | De naam van de LEZ inrichter | Antwerpen |
Naam Magda BD | Naam van de dienst die werd aangeroepen om het resultaat van de toegangscontrole te bepalen, in dit geval steeds “ControleerToegangOpDatum” | ControleerToegangOpDatum |
Resultaat | Aanduiding van het resultaat van de toegangscontrole. Voor elke mogelijk Resultaat parameter wordt er steeds een output bestand aangemaakt; deze parameter is opgenomen in de bijkomende configuratie. | Mogelijke waarden:
|
Referte UUID | Unieke referte van de aangeleverde flitslijst, 128-bit, 36 tekens, structuur 8-4-4-4-12 | dbe35915-53c7-4726-a58f-af8e0a89b21b |
Tijdstip aanmaak bestand | Datum en tijdstip van aanmaak bestand, formaat YYYYMMDDHHMMSSSSS | 20160923134012345 |
Extensie | Extensie waarmee de doelbestanden worden weggeschreven, in dit geval “csv” | “csv” |
Inhoud
Algemeen
De standaard CSV richtlijnen dienen gevolgd te worden:
UTF-8 encoding
Alle velden tussen dubbele quotes
Velden gescheiden door puntkomma
Header
Niet van toepassing.
Data
Gegeven | Omschrijving | Voorbeeld |
|---|---|---|
Referte | Business referte m.b.t. het te controleren voertuig. | “Referte ABC” |
Nummerplaat | Nummerplaat in hoofdletters, zonder spaties of koppeltekens | “1XYZ123” |
LandISOCode | ISO land code waar het voertuig is ingeschreven, 2 lang, in hoofdletters | “BE” |
DatumControle | Datum waarop de toegang van het voertuig tot de LEZ dient gecontroleerd te worden, formaat YYYY-MM-DD | “2016-11-17” |
Resultaat | Aanduiding van het resultaat van de controle van de toegang van het voertuig in de vraag. Mogelijke waarden:
| “Toegelaten” |
Footer
Niet van toepassing.
Voorbeeld
Toegelaten
Bestandsnaam: CTOD_LEZ_Antwerpen_ControleerToegangOpDatum_Toegelaten_dbe35915-53c7-4726-a58f-af8e0a89b21b_20160923134012345.csv
Bestand: CTOD_LEZ_Antwerpen_ControleerToegangOpDatum_Toegelaten_dbe35915-53c7-4726-a58f-af8e0a89b21b_20160923134012345.csv
Inhoud:
NietToegelaten
Bestandnaam: CTOD_LEZ_Antwerpen_ControleerToegangOpDatum_NietToegelaten_dbe35915-53c7-4726-a58f-af8e0a89b21b_20160923134012345.csv
Bestand: CTOD_LEZ_Antwerpen_ControleerToegangOpDatum_NietToegelaten_dbe35915-53c7-4726-a58f-af8e0a89b21b_20160923134012345.csv
Inhoud:
TeControleren
Bestandsnaam: CTOD_LEZ_Antwerpen_ControleerToegangOpDatum_GeenResultaat_dbe35915-53c7-4726-a58f-af8e0a89b21b_20160923134012345.csv
Bestand: CTOD_LEZ_Antwerpen_ControleerToegangOpDatum_GeenResultaat_dbe35915-53c7-4726-a58f-af8e0a89b21b_20160923134012345.csv
Codetabellen
Codetabellen MAGDA
Resultaat
Waarde | Omschrijving |
|---|---|
Toegelaten | Het gecontroleerde voertuig voldoet aan de voorwaarden om te worden toegelaten tot de LEZ. |
NietToegelaten | Het gecontroleerde voertuig voldoet niet aan de voorwaarden om te worden toegelaten tot de LEZ. |
TeControleren | Er zijn onvoldoende gegevens beschikbaar om toegang tot de LEZ te controleren. |
GeenResultaatBron | In het geval er controle elementen zouden ontbreken bij het oproepen van de achterliggende service bij LNE, zal de Magda business dienst de ontbrekende resultaten aanvullen in het antwoord met deze resultaat code. Er zal tevens een uitzondering van het type waarschuwing zijn opgenomen in het antwoord. |
Codetabellen Bron
LandISOCode
Op deze pagina
Binnen deze handleiding
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