Doel: Met dit sjabloon kan u eenvoudig een nieuwe diensthandleiding aanmaken in Confluence. Gebruik de onderstaande knoppen om nieuwe componenten binnen de handleiding aan te maken. To do: - Vul de onderstaande handleidingsparagrafen in - Maak o.b.v. de specificaties van de dienst relevante subpagina's aan - Verwijder lege of niet-gebruikte paragrafen & pagina's - Let op: Gebruik de volledige naam van de dienst (Domein.DienstNaam-Versie).

De afnemer kan een lijst van geflitste voertuigen in CSV formaat aanleveren op een afnemersspecifieke locatie. Deze lijst zal op het MAGDA platform opgepikt en getransformeerd worden naar een geldig formaat voor aanroep van de ControleerToegangOpDatum 02.00 dienst in batch.

Situering

Deze dienst kadert binnen het domein Mobiliteit van het MAGDA platform, het kadert binnen LEZ - Lage-emissiezone totaaloplossing.

Verwante diensten

Voor de andere diensten die binnen de MAGDA totaaloplossing LEZ - Lage-emissiezone kaderen kan u de relevante documentatiepagina raadplegen via de link.

Gegevensbronnen

Van waar komen de gegevens in deze dienst? NOOT: Verwijder indien er geen externe gegevensbronnen zijn of deze mededeling niet relevant is onderstaande informatiebel.

De gegevens worden opgevraagd/opgeslagen bij volgende (authentieke) gegevensbron(nen):

• FOD Mobiliteit: inschrijvingsgegevens voertuigen via een Magda kopie van de DIV voertuiggegevens.

• Departement LNE: regels inzake toegang tot de LEZ

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

Gebruiksvoorwaarden

Heeft de afnemer speciale toelatingen / machtigingen nodig voor consumeren van deze dienst?

Om gebruik te kunnen maken van deze dienst dient men een machtiging te hebben die toegang geeft tot deze gegevens en een aansluitingsprocedure te doorlopen.

Batch

Is deze dienst in batchvorm beschikbaar? Zo ja, laat deze paragraaf staan met generieke informatie over batchdiensten en voeg eventueel relevante dienstspecifieke informatie toe.

De toegangscontrole tot de LEZ voor een flitslijst maakt gebruik van de batch variant van de ControleerToegangOpDatum service.

Functionaliteiten

Ruimte voor een korte beschrijving van de functionaliteiten van deze dienst voor zover die relevant zijn?

Vraag

De afnemer kan een lijst van geflitste voertuigen in CSV-formaat aanleveren op een afnemersspecifieke locatie.

Antwoord

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.

Het antwoord kan maximum 1 dag op zich laten wachten, indien het langer is dan contacteer je best onze Service Desk.

Werking

Aandachtspunten

De afnemer is zelf verantwoordelijk voor het opgeven van een zinvolle controle datum. Er wordt wel gecheckt of de controle datum in de vraag een geldig formaat heeft, maar er wordt niet gecontroleerd of de controle datum in het verleden ligt.

Opties

Volgende configuratieparameters kunnen ingesteld worden in functie van de machtigingen en de wensen van de afnemer:

Zijn er specifieke parameters die ingesteld kunnen worden?

• Configuratieparameters op het MAGDA platform zijn voor deze dienst niet van toepassing

Opvraging

Met deze dienst kan de afnemer een CSV lijst bezorgen aan MAGDA platform, vervolgens worden de nodige transformaties op dit bestand uitgevoerd zodat het een correct formaat heeft om de Batch-variant van Mobiliteit.ControleerToegangOpDatum-02.00 mee aan te roepen. De XML-respons van deze dienst wordt vervolgens omgezet in 3 CSV-bestanden die als respons worden teruggegeven

De verwerking van een flitslijst doorloopt een aantal stappen op het Magda platform:

1. File-to-file scheduler: transformatie van bronbestand flitslijst van csv formaat naar xml formaat

2. Disp scheduler + ControleerToegangOpDatum dienst: batch verwerking van de toegangscontrole van de flitslijst

3. File-to-file scheduler: transformatie van resultaatbestand in xml formaat naar csv formaat

Logging

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