MAGDA Gezin

Inleiding

Gegevens opvragen over voordelen en/of toeslagen verkregen voor kinderen binnen het kader van het groeipakket.

Setup

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.

Gezin specifiek

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

Eigenschap	Beschrijving
Geen specifieke eigenschappen.	Geen specifieke eigenschappen.

Services en functies

giveKindVoordelen

Basisvoordelen toegekend aan gezinnen met kinderen.

Workflow expressie 1

${magda.giveKindVoordelen(String insz, String startDate, String endDate, String dossierId)}

Input

Inputparameters	Data type	Voorbeeld	Uitleg
insz	String	‘85010212345’	Identificatienummer voor de sociale zekerheid (rijksregisternummer)
startDate	String (date format: YYYY-MM)	'2025-07'	Startdatum referteperiode
endDate	String (date format: YYYY-MM)	‘2025-07'	Einddatum referteperiode
dossierId	String (GUID)	-	Unieke id van het dossier binnen de Skryv applicatie (met oog op logging van de call)

Workflow expressie 2

Variant waarbij de magda aansluitingsgegevens expliciet worden meegegeven.

${magda.giveKindVoordelen(String insz, String startDate, String endDate, String uri, String hoedanigheid, String dossierId)}

Input

Inputparameters	Data type	Voorbeeld	Uitleg
insz	String	‘85010212345’	Identificatienummer voor de sociale zekerheid (rijksregisternummer)
startDate	String (date format: YYYY-MM)	'2025-07'	Startdatum referteperiode
endDate	String (date format: YYYY-MM)	‘2025-07'	Einddatum referteperiode
uri	String	-	Deze info verkrijg je tijdens het onboardingproces bij Magda
hoedanigheid	String	-	IDPC-code (deze info verkrijg je tijdens het onboardingproces bij Magda)
dossierId	String (GUID)	-	Unieke id van het dossier binnen de Skryv applicatie (met oog op logging van de call)

Output

Je krijgt een object GeefKindVoordelenResponse terug met alle informatie over toegekende voordelen binnen de opgegeven referteperiode.

Magda-documentatie

Technische documentatie voor GeefKindVoordelen-02.01.

giveZorgtoeslag

Bijkomende voordelen toegekend aan gezinnen met kinderen die een extra zorgbehoefte met zich meebrengen.

Workflow expressie 1

${magda.giveZorgtoeslag(String insz, String date, String dossierId)}

Inputparameters	Data type	Voorbeeld	Uitleg
insz	String	‘85010212345’	Identificatienummer voor de sociale zekerheid (rijksregisternummer)
date	String (date format: YYYY-MM-DD)	'2025-07-31'	Refertedatum
dossierId	String (GUID)	-	Unieke id van het dossier binnen de Skryv applicatie (met oog op logging van de call)

Workflow expressie 2

Variant waarbij de magda aansluitingsgegevens expliciet worden meegegeven.

${magda.giveZorgtoeslag(String insz, String date, String uri, String hoedanigheid, String dossierId)}

Input

Inputparameters	Data type	Voorbeeld	Uitleg
insz	String	‘85010212345’	Identificatienummer voor de sociale zekerheid (rijksregisternummer)
date	String (date format: YYYY-MM-DD)	'2025-07-31'	Refertedatum
uri	String	-	Deze info verkrijg je tijdens het onboardingproces bij Magda
hoedanigheid	String	-	IDPC-code (deze info verkrijg je tijdens het onboardingproces bij Magda)
dossierId	String (GUID)	-	Unieke id van het dossier binnen de Skryv applicatie (met oog op logging van de call)

Output

Je krijgt een object GeefZorgtoeslagResponse terug met alle informatie over toegekende zorgtoeslagen.

Magda-documentatie

Technische documentatie voor giveZorgtoeslag-02.00.