MAGDA Werk

Inleiding

Diensten die arbeidsgegevens, zoals informatie over loopbanen en werkrelaties, bevatten.

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.

Werk specifiek

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

Eigenschap	Beschrijving
Geen specifieke eigenschappen.	Geen specifieke eigenschappen.

Services en functies

giveDmfa

Gegevens opvragen met betrekking tot loon- en arbeidstijdgegevens voor een bepaalde persoon.

Workflow expressie

${magda.giveDmfa(String insz, String uri, String begin, String end, String dossierId)}

Input

Inputparameters	Data type	Voorbeeld	Uitleg
insz	String	‘85010212345’	Rijksregisternummer
uri	String	-	Aansluiting bij Magda (deze info verkrijg je tijdens het onboardingproces bij Magda)
begin	String	‘2020-01-01’	Startdatum referteperiode
end	String	‘2025-07-31'	Einddatum referteperiode
dossierId	String (GUID)	-	Unieke id van het dossier binnen de Skryv applicatie (met oog op logging van de call)

Output

Je krijgt een object GeefDmfaVoorWerknemerResponse met loon- en arbeidstijdsgegevens voor een bepaald persoon.

Magda-documentatie

Technische info GeefDmfaVoorWerknemer-03.00.

giveDmfaVoorWerknemer

Gegevens opvragen met betrekking tot loon- en arbeidstijdgegevens voor een bepaalde persoon.

Workflow expressie

${magda.geefDmfaVoorWerknemer(String insz, String uri, String hc, String begin, String end, String dossierId)}

Input

Inputparameters	Data type	Voorbeeld	Uitleg
insz	String	‘85010212345’	Rijksregisternummer
uri	String	-	Aansluiting bij Magda (deze info verkrijg je tijdens het onboardingproces bij Magda)
hc	String	-	IDPC-code bij Magda (deze info verkrijg je tijdens het onboardingproces bij Magda)
begin	String	‘2020-01-01’	Startdatum referteperiode
end	String	‘2025-07-31'	Einddatum referteperiode
dossierId	String (GUID)	-	Unieke id van het dossier binnen de Skryv applicatie (met oog op logging van de call)

Output

Je krijgt een object GeefDmfaVoorWerknemerResponse met loon- en arbeidstijdsgegevens voor een bepaald persoon.

Magda-documentatie

Technische info GeefDmfaVoorWerknemer-03.00.

geefLoopbaanARZA

Vraag loopbaangegevens op voor een zelfstandige.

Workflow expressie

${magda.geefLoopbaanARZA(String ssin, String uri, String startDate, String endDate, String hoedanigheid)}

Input

Inputparameters	Data type	Voorbeeld	Uitleg
ssin	String	‘85010212345’	Rijksregisternummer
uri	String	-	Aansluiting bij Magda (deze info verkrijg je tijdens het onboardingproces bij Magda)
startDate	String	‘2020-01-01’	Startdatum voor de referteperiode
endDate	String	‘2025-07-31'	Einddatum voor de referteperiode
hoedanigheid	String	-	IDPC-code, uniek aansluitingsnummer bij Magda (deze info verkrijg je tijdens het onboardingproces bij Magda)

Output

Je krijgt een object GeefLoopbaanARZAResponse met loopbaangegevens voor een zelfstandige.

Magda-documentatie

Technische documentatie GeefLoopbaanARZA-02.01.

geefWerkrelaties

Zoek arbeidsrelaties op voor een persoon (DIMONA-aangifte).

Workflow expressie

${magda.geefWerkrelaties(String uri, String hoedanigheid, String insz, String startDate, String endDate, UUID referte)}

Input

Inputparameters	Data type	Voorbeeld	Uitleg
uri	String	-	Aansluiting bij Magda (deze info verkrijg je tijdens het onboardingproces bij Magda)
hoedanigheid	String	-	IDPC-code, uniek aansluitingsnummer bij Magda (deze info verkrijg je tijdens het onboardingproces bij Magda)
insz	String	‘85010212345’	Rijksregisternummer
startDate	String	‘2020-01-01’	Startdatum referteperiode
endDate	String	‘2025-07-31'	Einddatum referteperiode
referte	UUID	-	-

Output

Je krijgt een object GeefWerkrelatiesResponse met arbeidsrelaties voor de opgegeven werknemer.

Magda-documentatie

Technische documentatie GefWerkrelaties-02.00.

geefWerkrelatiesWithInterim

Zoek arbeidsrelaties op voor een persoon (DIMONA-aangifte), inclusief interimcontracten.

Workflow expressie

${magda.geefWerkrelatiesWithInterim(String uri, String hoedanigheid, String insz, String startDate, String endDate, UUID referte)}

Input

Inputparameters	Data type	Voorbeeld	Uitleg
uri	String	-	Aansluiting bij Magda (deze info verkrijg je tijdens het onboardingproces bij Magda)
hoedanigheid	String	-	IDPC-code, uniek aansluitingsnummer bij Magda (deze info verkrijg je tijdens het onboardingproces bij Magda)
insz	String	‘85010212345’	Rijksregisternummer
startDate	String	‘2020-01-01’	Startdatum referteperiode
endDate	String	‘2025-07-31'	Einddatum referteperiode
referte	UUID	-	-

Output

Je krijgt een object GeefWerkrelatiesResponse met arbeidsrelaties voor de opgegeven werknemer, inclusief interimcontracten.

Magda-documentatie

Technische documentatie GefWerkrelaties-02.00.