MAGDA Mobiliteit

Inleiding

Voertuiggegevens ophalen. Deze info kunnen gemeentes gebruiken voor het aanrekenen van parkeerretributies of GAS-boetes. Daarnaast zijn er ook use cases met betrekking tot lage emissie zones of voertuigkeuringen.

Protocol

Idem als bij alle Magda connectoren.

Applicatie eigenschappen

Algemeen

Opdat de connector toegang zou krijgen tot de MAGDA service, moet deze beschikken over de volgende informatie. De placeholder {service} moet je telkens vervangen door de specifieke service die je wil implementeren.

dosis (legacy connector)
ebox (magda documentendienst)
gc (ondernemingen - giveCompany)
ghp
gp (geefPersoon)
mobility (mobiliteit)
poc (kadaster)
ri (repertorium)
sme (ondernemingen - geefJaarrekeningen)
zoekeigendomstoestanden (kadaster)

URL-endpoint

Eigenschap

Beschrijving

skryv.connectors.magda.{service}.service-url

Geef het URL-endpoint.

Voorbeeld: https://magdapersoondienst.vlaanderen.be

Keys en certificaten

Eigenschap	Beschrijving
`skryv.aws.mutual-ssl.seed.enabled`	Indien `true`, dan haalt de applicatie de key en het certificaat op uit de AWS Secrets Manager en slaat deze lokaal in de applicatie op (zie de twee rijen hieronder). Indien `false`, dan neemt de applicatie rechtstreeks de lokaal gedefinieerde key en certificaat zonder eerst AWS Secrets manager te bevragen.
`aws.{service}.client.ssl.trustore-jks`	Lokale opslag van het certificaat. Voorbeeld: `wrp-trust-store.jks`
`aws.{service}.client.ssl.keystore-jks`	Lokale opslag van de key. Voorbeeld: `wrp-key-store.jks`
`aws.{service}.client.ssl.trust-store-path`	Bevat het pad naar het certificaat in AWS Secrets Manager.
`aws.{service}.client.ssl.private-key-path`	Bevat het pad naar de key in AWS Secrets Manager.
`aws.{service}.client.ssl.private-key-password-path`	Bevat het pad naar het wachtwoord voor de key in AWS Secrets Manager.

Hoedanigheid

Onderstaand is de default voor alle magda services. In de meeste gevallen wordt dit vervangen door een service specifieke eigenschap.

Eigenschap

Beschrijving

magda.default.hoedanigheid

Bevat de aansluitingscode of IPDC-code.

Uri

Onderstaand is de default voor alle magda services. In de meeste gevallen wordt dit vervangen door een service specifieke eigenschap.

Eigenschap

Beschrijving

magda.default.uri

Bevat het pad naar de aan te spreken service.

Specifiek

Specifieke applicatie eigenschappen, los van de eigenschappen die de toegang regelen.

Car

Enkel voor giveCar.

De aangesproken service wordt uitgefaseerd langs de kant van MAGDA. Gebruik bij voorkeur de overige functies binnen de mobiliteitsconnector.

Mobility

Voor de overige functies.

Eigenschap	Beschrijving
`skryv.connectors.magda.mobility.url`	Info die je ontvangt bij het onboardingsproces.
`skryv.connectors.magda.mobility.tokenUrl`	Info die je ontvangt bij het onboardingsproces.
`skryv.connectors.magda.mobility.scope`	Info die je ontvangt bij het onboardingsproces.
`skryv.connectors.magda.mobility.clientId`	Info die je ontvangt bij het onboardingsproces.
`skryv.connectors.magda.mobility.keyPath`	Info die je ontvangt bij het onboardingsproces.
`skryv.connectors.magda.mobility.isAWSSeedEnabled`	Info die je ontvangt bij het onboardingsproces.
`skryv.connectors.magda.mobility.awsKeyPath`	Info die je ontvangt bij het onboardingsproces.

Services en functies

giveCar

Vraag voertuiggegevens op op basis van nummerplaat.

De aangesproken service wordt uitgefaseerd langs de kant van MAGDA. Gebruik bij voorkeur de overige functies binnen de mobiliteitsconnector.

Workflow expressie

${magda.giveCar(String licensePlate, String date, String dossierId)}

Input

Inputparameters	Data type	Voorbeeld	Uitleg
licensePlate	String	‘ABC 123’	Nummerplaat voertuig
date	String (date format: YYYY-MM-DD)	‘2025-05-30’	Refertedatum

Output

Je krijgt een object terug met voertuiggegevens.

MAGDA-documentatie

Technische documentatie rond geefVoertuig

giveCrossbordertitularsByPlate

Vraag gegevens buitenlandse voertuigen op op basis van nummerplaat.

Workflow expressie 1

${magda.giveCrossbordertitularsByPlate(String plateNr1, String countryCode)}

Input

Inputparameters	Data type	Voorbeeld	Uitleg
plateNr1	String	‘ABC 123’	Nummerplaat voertuig
countryCode	String (hoofdletters volgens ISO 3166-1 alpha-2 landcode)	‘SE’	Landcode

Workflow expressie 2

${magda.giveCrossbordertitularsByPlate(String plateNr1, String countryCode, String dateTime)}

Input

Inputparameters	Data type	Voorbeeld	Uitleg
plateNr1	String	‘ABC 123’	Nummerplaat voertuig
countryCode	String (hoofdletters volgens ISO 3166-1 alpha-2 landcode)	‘SE’	Landcode
dateTime	String (formaat volgens ISO-8601 date-time)	' 2024-09-15T11:30:00Z'	Refertedatum

Output

Je krijgt een object terug met voertuiggegevens.

MAGDA-documentatie

Technische documentatie rond mobility/crossborderTitulars-v1

giveRegistrationsTitularByPlate

Vraag voertuiggegevens op op basis van nummerplaat.

Workflow expressie 1

${magda.giveRegistrationsTitularByPlate(String plateNr)}

Input

Inputparameters	Data type	Voorbeeld	Uitleg
plateNr	String	‘1ABC123’	Nummerplaat voertuig

Workflow epressie 2

${magda.giveRegistrationsTitularByPlate(String plateNr,String ssin)}

Input

Inputparameters	Data type	Voorbeeld	Uitleg
plateNr	String	‘1ABC123’	Nummerplaat voertuig
ssin	String	'85010212345’	Rijksregisternummer. Het antwoord zal extra info over de eigenaar bevatten.

Workflow epressie 3

${magda.giveRegistrationsTitularByPlate(String plateNr,String ssin,String dateTime)}

Input

Inputparameters	Data type	Voorbeeld	Uitleg
plateNr	String	‘1ABC123’	Nummerplaat voertuig
ssin	String	'85010212345’	Rijksregisternummer. Het antwoord zal extra info over de eigenaar bevatten.
dateTime	String (formaat volgens ISO-8601 date-time)	' 2024-09-15T11:30:00Z'	Refertedatum

Output

Je krijgt een object terug met voertuigggevens.

Magda-documentatie

Technische documentatie rond mobility/registrationsTitular-v1