MAGDA Inkomen

Inleiding

Gegevens opvragen over de personenbelasting.

Setup

Idem als bij alle Magda connectoren.

Specifieke applicatie eigenschappen

Geen.

Services en functies

givePersonalIncomeTax

Basisvoordelen toegekend aan gezinnen met kinderen.

Workflow expressie 1

Variant waarbij je terugvalt op de magda aansluitingsgegevens.

${magda.givePersonalIncomeTax(String insz, String year, String source, String startDate, String endDate, String ipcalcodes, String dossierId)}

Input

Inputparameters	Data type	Voorbeeld	Uitleg
insz `verplicht`	String	‘85010212345’	Identificatienummer voor de sociale zekerheid (rijksregisternummer)
year `verplicht`	String	‘2025’	Inkomensjaar
source `verplicht`	String	‘FODFIN’	Enkel “FODFIN” en “KSZ” mogelijk als bron. Indien er een andere bron opgegeven wordt bekomt men een XSD validatie fout (SOAP Fault). Geeft men een niet toegelaten bron op, dan bekomt men een uitzondering.
startDate `verplicht` indien bron ‘KSZ’ `optioneel` indien bron ‘FODFIN’	String (date format: YYYY-MM)	'2025-07'	Startdatum referteperiode
endDate `verplicht` indien bron ‘KSZ’ `optioneel` indien bron ‘FODFIN’	String (date format: YYYY-MM)	‘2025-07'	Einddatum referteperiode
ipcalcodes `optioneel`	String	-	Filter op codes die gebruikt worden in het aanslagbiljet. Mogen niet opgegeven worden door de afnemer!
dossierId `verplicht`	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.givePersonalIncomeTax(String insz, String year, String source, String startDate, String endDate, String ipcalcodes, String uri, String hoedanigheid, String dossierId)}

Input

Inputparameters	Data type	Voorbeeld	Uitleg
insz `verplicht`	String	‘85010212345’	Identificatienummer voor de sociale zekerheid (rijksregisternummer)
year `verplicht`	String	‘2025’	Inkomensjaar
source `verplicht`	String	‘FODFIN’	Enkel “FODFIN” en “KSZ” mogelijk als bron. Indien er een andere bron opgegeven wordt bekomt men een XSD validatie fout (SOAP Fault). Geeft men een niet toegelaten bron op, dan bekomt men een uitzondering.
startDate `verplicht` indien bron ‘KSZ’ `optioneel` indien bron ‘FODFIN’	String (date format: YYYY-MM)	'2025-07'	Startdatum referteperiode
endDate `verplicht` indien bron ‘KSZ’ `optioneel` indien bron ‘FODFIN’	String (date format: YYYY-MM)	‘2025-07'	Einddatum referteperiode
ipcalcodes `optioneel`	String	-	Filter op codes die gebruikt worden in het aanslagbiljet. Mogen niet opgegeven worden door de afnemer!
uri `verplicht`	String	-	Deze info verkrijg je tijdens het onboardingproces bij Magda
hoedanigheid `verplicht`	String	-	IDPC-code (deze info verkrijg je tijdens het onboardingproces bij Magda)
dossierId `verplicht`	String (GUID)	-	Unieke id van het dossier binnen de Skryv applicatie (met oog op logging van de call)

Output

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

Magda-documentatie

Technische documentatie voor GeefAanslagbiljetPersonenbelasting-02.00.