Algemeen
De vragen worden opgegeven in een CSV formaat. Elke lijn bevat 1 vraag.
Hieronder een overzicht van de flow die op deze pagina behandeld wordt.
CSV input formaat
Het bestand dat aangeleverd wordt moet voldoen aan al volgende richtlijnen
ISO-8859-1 encoding
Geen header rij. De eerste rij moet effectieve gegevens bevatten
De volgorde van de velden moet voldoen aan onderstaande lijst
De velden worden afgebakend met dubbele aanhalingstekens (")
De velden worden gescheiden door een punt-komma (;)
Lege velden worden steeds weergegeven door twee opeenvolgende dubbele aanhalingstekens. Velden worden nooit weggelaten
Geen line feed na de laatste datalijn, bestand eindigt m.a.w. bij het laatste karakter van de laatste datalijn
Bestandsnaam
<Prefix>_<Naam LEZ inrichter>_<Naam Magda BD> _<Referte UUID>_<Tijdstip aanmaak bestand>.<Extensie>
Gegeven | Omschrijving | Voorbeeld |
|---|---|---|
Prefix | Verwijzing naar Lage Emissie Zone, steeds “LEZ” | LEZ |
Naam LEZ inrichter | Naam van de LEZ inrichter. Kan dus Antwerpen of Gent zijn op dit moment | Antwerpen |
Naam Magda BD | Naam van de dienst die moet worden aangeroepen | RegistreerLEZGegevens |
Referte UUID | Unieke referte van de aangeleverde lijst, 128-bit, 36 tekens, structuur 8-4-4-4-12. | 78852dd8-69d2-11e6-8b77-86f30ca893d3 |
Tijdstip aanmaak bestand | Datum en tijdstip van aanmaak bestand, formaat YYYYMMDDHHMMSSSSS | 20190524081035123 |
Extensie | Extensie waarmee het bronbestand wordt aangeleverd | CSV |
Voorbeeld
LEZ_Antwerpen_RegistreerLEZGegevens_78852dd8-69d2-11e6-8b77-86f30ca893d3_20160824081035123.csv
Detail
Alle datums in onderstaande lijst worden opgegeven in het formaat jjjj-mm-dd (vb. 2019-05-01)
De eerste 4 velden moeten steeds ingevuld zijn. Daarna moet 1 en slechts 1 van de 4 gekleurde blokken ingevuld worden. De kardinaliteit slaat op de verplichting indien het blok ingevuld wordt. Indien het blok niet ingevuld wordt moeten de waarden meegegeven worden als lege strings ("").
Dus:
De eerste vier velden invullen
En
Veld 5 tot en met 18 invullen
Of
Veld 19 tot en met 21 invullen
Of
Veld 22 en 23 invullen
Of
Veld 24 invullen
Veld | Kardinaliteit | Omschrijving | |
|---|---|---|---|
| 1 | Referte | [1..1] | UUID, unieke referte per vraag (wordt niet gevalideerd). Deze referte wordt gebruikt om de vraag aan het antwoord te koppelen |
| 2 | Bron | [1..1] | De bron die gegevens wil registeren |
| 3 | Nummerplaat | [1..1] | Nummerplaat van het voertuig waarvoor we gegevens willen registreren. |
| 4 | LandISOCode | [1..1] | ISO land code van het voertuig waarvoor we gegevens willen registreren. |
| 5 | DatumLokaleRegistratieVoertuig | [1..1] | De datum waarop het buitenlands voertuig lokaal geregistreerd wordt. |
| 6 | GeldigTotEnMetVoertuig | [0..1] | |
| 7 | Categorie | [0..1] | Dit is de DIV voertuig categorie die aangeeft om welk type voertuig het gaat, bvb bromfiets. |
| 8 | Aard | [0..1] | De aard van het voertuig, bvb gaat het om een Sedan of een Cabriolet. |
| 9 | MassaRijklareToestandKg | [0..1] | De massa rijklare toestand, uitgedrukt in aantal Kg. |
| 10 | HoogstToegelatenGewicht | [0..1] | Het hoogst toegelaten gewicht, uitgedrukt in aantal Kg |
| 11 | VermogenKW | [0..1] | |
| 12 | AantalZitplaatsen | [0..1] | Het aantal zitplaatsen |
| 13 | Brandstof | [0..1] | Het brandstoftype van de wagen. |
| 14 | Co2UitstootGrPerKm | [0..1] | Het aantal gram uitstoot aan Co2 gas van de wagen per gereden km |
| 15 | Euronorm | [0..1] | Deze kan worden omgezet naar de corresponderende DIV code. |
| 16 | DatumEersteInschrijving | [0..1] | De eerste datum dat het voertuig ingeschreven was |
| 17 | DatumLaatsteInschrijving | [0..1] | De laatste datum dat het voertuig ingeschreven was. Moet groter zijn dan DatumEersteInschrijving indien ingevuld |
| 18 | Roetfilter | [0..1] | Waarde die aangeeft of er een roetfilter aanwezig is of niet:
|
| 19 | VrijstellingReden | [1..1] | De reden van de vrijstelling, het kan bvb gaan om een prioritair voertuig. |
| 20 | VrijstellingBegin | [1..1] | Begindatum dat de vrijstellingsregistratie geldig is |
| 21 | VrijstellingEinde | [1..1] | Als de vrijstelling niet permanent geldig is, dan is dit de datum dat de vrijstelling voor dit type voertuig eindigt. Indien ingevuld moet deze datum groter zijn dan de begin datum. |
| 22 | EuronormDatum | [1..1] | De datum waarop de Euronorm van kracht wordt. |
| 23 | Euronorm | [1..1] | Euronormcode die correspondeert met een DIV Code. |
| 24 | RoetfilterDatum | [1..1] | De datum waarop de roetfilter actief in de wagen geplaatst is |
Validaties
In de verwerking van de het CSV bestand wordt geen inhoudelijke validatie gedaan, enkel de validatie op de CSV structuur en of de gegevens ingevuld zijn. De validatie van de formattering en logische validatie worden gedaan in de RegistreerLEZGegevens 02.00 dienst. Deze dienst kan bij de verwerking van de gegevens ook uitzonderingen teruggeven welke in het Resultaat document worden opgenomen.
Bij volgende situaties zal de verwerking van het CSV bestand stoppen en zal mogelijks een manuele verwerking van het CSV bestand noodzakelijk zijn.
Omschrijving | Beschrijving |
|---|---|
CSV importeer fout | Deze fout wordt gegooid als het CSV bestand niet kan ingelezen worden. Indien deze uitzondering gegooid wordt kan geen enkele dataregel verwerkt worden en zal het output bestand slecht 1 regel bevatten met deze uitzondering |
Niet correct aantal kolommen in het CSV bestand | Nadat de CSV ingelezen is kan het aantal kolommen gecontroleerd worden. Indien dit aantal niet gelijk is aan het aantal kolommen in de bovenstaande lijst (22) wordt deze uitzondering gegooid. Indien deze uitzondering gegooid wordt kan geen enkele dataregel verwerkt worden en zal het output bestand slecht 1 regel bevatten met deze uitzondering |
Verplichte velden niet ingevuld | Deze fout wordt gegooid als de eerste drie velden niet ingevuld zijn. |
Minstens 1 datablok moet ingevuld zijn | Deze uitzondering wordt gegooid als na het doorlopen van de verschillende datablokken geen data gevonden is volgens de logica bovenaan deze pagina. |
Voorbeelden
Registratie Buitenlands Voertuig
Registratie Vrijstelling
Registratie Euronorm
Registratie Roetfilter
Excel bestand met bovenstaande data en CSV exporteer macro
OPGELET
De macro in dit Excel bestand is getest binnen MAGDA en dient enkel als voorbeeld om een correct CSV bestand aan te maken. MAGDA biedt geen support op deze code.
Op deze pagina
Binnen deze handleiding
- Beschrijving Vraag (RegistreerLEZGegevens-02.00 - CSV batch verwerking)
- Beschrijving Antwoord (RegistreerLEZGegevens-02.00 - CSV batch verwerking)
- Verschillen tegenover vorige versie (RegistreerLEZGegevens-02.00 CSV batch)
Met vragen kunt u steeds terecht bij de MAGDA Service Desk.
