Algemeen

Het antwoord van de webservice bestaat uit:

Referte: de referte zoals opgegeven in de vraag
Afhankelijk van de verwerking een Inhoud blok met één of meerdere KindVoordeel elementen met hierin de kinderbijslag gegevens afkomstig van de authentieke bronnen die geconsulteerd werden
De eventuele (business) uitzonderingen

XSD Visueel

Detail

Opmerking:

Het antwoord bestaat standaard uit Context, Referte en Antwoord zoals beschreven in Gebruik Magda Webservices 02.00. Verder zal enkel aandacht besteed worden aan het specifieke Antwoord element.

Antwoord Kindvoordelen

Bevat alle kinderbijslag gegevens die voldoen aan de vraag criteria.

Element	Subelement	Opmerkingen
KindVoordeel		Eén specifiek blok van kinderbijslag gegevens afkomstig van een geconsulteerde bron.
	Bron	De bron waaruit dit blok van KindVoordeel gegevens opgehaald werden. Mogelijke waarden: VLAANDEREN WALLONIE BRUSSEL OOST-BELGIE FEDERAAL
	INSZ	INSZ van de persoon van wie de gegevens opgevraagd worden
	KindVoordeelFonds	De gegevens m.b.t. het kinderbijslagfonds waar het dossier gekend is.
	Dossiernummer	Het dossiernummer.
	Rechthebbende	Het INSZ van de rechthebbende. Niet aanwezig voor gegevens afkomstig uit het Vlaamse Groeipakket.
	Begunstigden	De natuurlijke personen die als begunstigde gekend zijn in het dossier. Dit blok is niet aanwezig indien geen enkele begunstigde een natuurlijk persoon is. Binnen de Vlaamse Groeipakket gegevens kunnen maximaal twee begunstigden in een dossier voorkomen.
	Kinderen	De kinderen waarvoor het recht geopend is in dit dossier; per dossier kan er slechts één kind voorkomen binnen de Vlaamse Groeipakket gegevens. Dit blok is enkel niet aanwezig in het geval van geboorte -of adoptiepremie, wanneer het kind nog niet gekend/geboren is.

Antwoord KindVoordeelFonds

Element	Omschrijving
Ondernemingsnummer	KBO nummer van het kinderbijslagfonds. K&G zal gebruik maken van het KBO nummer om het kinderbijslagfonds te identificeren.
Code	Code die het fonds identificeert. Type: 3 cijfers K&G zal geen gebruik maken van codes om het kinderbijslagfonds te identificeren. Codes en de naam van het kinderbijslagfonds: 901: FONS (Vlaanderen) 902: Infino (Vlaanderen) 903: KidsLife (Vlaanderen) 904: MyFamily (Vlaanderen) 905: Parentia (Vlaanderen) 212: Infino Brussels (Brussel) 219: Acerta Infino (Brussel) 232: Securex Infino (Brussel) 233: Partena Bruxelles (Brussel) 241: Caisse Bruxelloise d'Allocations Familiales UCM (Brussel) 280: Kidslife Brussel (Brussel) 299: Caisse publique Bruxelles (Brussel) 199: Fons. (Federaal) 312: Infino Wallonie (Wallonië) 333: Parentia Wallonie (Wallonië) 341: Caisse Wallonne d'Allocations Familiales Camille (Wallonië) 380: Kidslife Wallonie (Wallonië) 399: Famiwal (Wallonië) 499: Caisse publique Ostbelgiën (Oost-België)
Omschrijving	Omschrijving van het kinderbijslagfonds o.b.v. de taalcode opgegeven in de vraag criteria. Deze omschrijving zal in principe niet aanwezig zijn voor de Vlaamse Groeipakket gegevens.
@Taal	Niet aanwezig

Antwoord Begunstigde

Element	Omschrijving
Begunstigde	De natuurlijke personen die als bijslagtrekkende/begunstigde gekend zijn in het dossier. Dit is niet aanwezig indien geen enkele begunstigde een natuurlijk persoon is.
INSZ	INSZ van de begunstigde.
Bonussen - Bonus - Betalingsdatum	De datum waarop de bonus uitgekeerd werd. Formaat: JJJJ-MM-DD
Bonussen - Bonus - Categorie - Code	Code die het type bonus identificeert. Formaat: maximaal 50 tekens, combinatie van hoofdletters en “_” Mogelijke waarden: VOORAFBETALING_GEBOORTE GEBOORTE ADOPTIE (deze waarde wordt nog niet aangeleverd door bron Vlaanderen)
Bonussen - Bonus - Categorie - Omschrijving	Omschrijving van het type bonus o.b.v. de taalcode opgegeven in de vraag criteria, zoals die gekend is op het Magda platform. Indien de omschrijving niet gekend is op het Magda platform, is het Omschrijving element niet aanwezig.
Bonussen - Bonus - Categorie - Omschrijving - @Taal	Niet aanwezig
Betalingsperiodes - Betalingsperiode - Periode - BeginMaand	Startdatum van het recht op een betalingsperiode. Formaat: JJJJ-MM
Betalingsperiodes - Betalingsperiode - Periode - EindeMaand	Einddatum van het recht op een betalingsperiode. Formaat: JJJJ-MM
Betalingsperiodes - Betalingsperiode - Categorie - KindVoordeelCategorieCode - Code	Code die het type betalingsperiode identificeert. Mogelijke waarden: BASIS KINDERBIJSLAG (enkel voor bronnen verschillend van VLAANDEREN) ZORG_SPECIALE_NODEN ZORG_WEES ZORG_PLEEG PARTICIPATIE_UNIVERSEEL PARTICIPATIE_SELECTIEF KINDEROPVANG KLEUTER ONDERSTEUNINGSTOESLAG Merk op dat het type SOCIAAL niet meer aanwezig is (in tegenstelling tot in de 02.00 versie van deze dienst). Dit type heeft nu zijn element gekregen, namelijk KindVoordeelBetalingsperiodeCategorieSociaal. Zie Verschillen tegenover vorige versie - Gezin.GeefKindVoordelen - 02.01 voor meer info.
Betalingsperiodes - Betalingsperiode - Categorie - KindVoordeelCategorieCode - Omschrijving	Omschrijving van het type betalingsperiode o.b.v. de taalcode opgegeven in de vraag criteria. Indien de omschrijving niet kon worden opgehaald, is het Omschrijving element niet aanwezig.
Betalingsperiodes - Betalingsperiode - Categorie - KindVoordeelCategorieCode - Omschrijving - @Taal	Niet aanwezig
Betalingsperiodes - Betalingsperiode - Categorie - KindVoordeelBetalingsperiodeCategorieSociaal	De aanwezigheid van dit element geeft aan dat het type betalingsperiode ‘Sociale Toeslag’ is.
Betalingsperiodes - Betalingsperiode - Categorie - KindVoordeelBetalingsperiodeCategorieSociaal - typeSocialeToeslag	Type sociale toeslag Moet nog aangevuld worden met lijst van mogelijke waarden & beschrijving
Betalingsperiodes - Betalingsperiode - Categorie - KindVoordeelBetalingsperiodeCategorieSociaal - Omschrijving
Betalingsperiodes - Betalingsperiode - Categorie - KindVoordeelBetalingsperiodeCategorieSociaal - Omschrijving - @Taal	Niet aanwezig

Antwoord Kinderen

Element	Omschrijving
Kind	De kinderen die het recht geopend hebben in dit dossier. Dit is enkel niet aanwezig in het geval van geboorte -of adoptiepremie, wanneer het kind nog niet gekend/geboren is. Voor dossier van Kind en Gezin kan er maximaal 1 kind aanwezig zijn in het dossier.
INSZ	INSZ van het kind.
Bonussen - Bonus - Betalingsdatum	De datum waarop de bonus uitgekeerd werd. Formaat: JJJJ-MM-DD
Bonussen - Bonus - Categorie - Code	Code die het type bonus identificeert. Formaat: maximaal 50 tekens, combinatie van hoofdletters en “_” Mogelijke waarden: VOORAFBETALING_GEBOORTE GEBOORTE ADOPTIE
Bonussen - Bonus - Categorie - Omschrijving	Omschrijving van het type bonus o.b.v. de taalcode opgegeven in de vraag criteria. Indien de omschrijving niet kon worden opgehaald, is het Omschrijving element niet aanwezig.
Bonussen - Bonus - Categorie - Omschrijving - @Taal	Niet aanwezig
Bonussen - Bonus - Begunstigden	Lijst van begunstigden voor deze bonus; dit is enkel aanwezig voor Kind en Gezin dossiers. Dit betekent niet dat de persoon het geld ontvangen heeft. Er kunnen maximaal 2 begunstigden gekoppeld zijn aan de bonus.
Bonussen - Bonus - Begunstigden - Begunstigde	INSZ van de begunstigde van de bonus.
Betalingsperiodes - Betalingsperiode - Periode - BeginMaand	Startdatum van het recht op een betalingsperiode. Formaat: JJJJ-MM
Betalingsperiodes - Betalingsperiode - Periode - EindeMaand	Einddatum van het recht op een betalingsperiode. Formaat: JJJJ-MM
Betalingsperiodes - Betalingsperiode - Categorie- KindVoordeelCategorieCode - Code	Code die het type betalingsperiode identificeert. Mogelijke waarden: BASIS KINDERBIJSLAG (enkel voor bronnen verschillend van VLAANDEREN) ZORG_SPECIALE_NODEN ZORG_WEES ZORG_PLEEG PARTICIPATIE_UNIVERSEEL PARTICIPATIE_SELECTIEF KINDEROPVANG KLEUTER ONDERSTEUNINGSTOESLAG Merk op dat het type SOCIAAL niet meer aanwezig is (in tegenstelling tot in de 02.00 versie van deze dienst). Dit type heeft nu zijn element gekregen, namelijk KindVoordeelBetalingsperiodeCategorieSociaal. Zie Verschillen tegenover vorige versie - Gezin.GeefKindVoordelen - 02.01 voor meer info.
Betalingsperiodes - Betalingsperiode - Categorie -KindVoordeelCategorieCode - Omschrijving	Omschrijving van het type betalingsperiode o.b.v. de taalcode opgegeven in de vraag criteria. Indien de omschrijving niet kon worden opgehaald, is het Omschrijving element niet aanwezig.
Betalingsperiodes - Betalingsperiode - Categorie -KindVoordeelCategorieCode - Omschrijving - @Taal	Niet aanwezig
Betalingsperiodes - Betalingsperiode - Categorie - KindVoordeelBetalingsperiodeCategorieSociaal	De aanwezigheid van dit element geeft aan dat het type betalingsperiode ‘Sociale Toeslag’ is.
Betalingsperiodes - Betalingsperiode - Categorie - KindVoordeelBetalingsperiodeCategorieSociaal - typeSocialeToeslag	Type sociale toeslag Moet nog aangevuld worden met lijst van mogelijke waarden & beschrijving
Betalingsperiodes - Betalingsperiode - Categorie - KindVoordeelBetalingsperiodeCategorieSociaal - Omschrijving
Betalingsperiodes - Betalingsperiode - Categorie - KindVoordeelBetalingsperiodeCategorieSociaal - Omschrijving - @Taal	Niet aanwezig
Betalingsperiodes - Betalingsperiode - Begunstigden	Lijst van begunstigden voor deze betalingsperiode; dit is enkel aanwezig voor Kind en Gezin dossiers. Dit betekent niet dat de persoon het geld ontvangen heeft. Er kunnen maximaal 2 begunstigden gekoppeld zijn aan de betalingsperiode.
Betalingsperiodes - Betalingsperiode - Begunstigden -Begunstigde	INSZ van de begunstigde van de betalingsperiode.

Voorbeeld

<Antwoord>
	<Referte>5000aa93-f7d1-4c7e-bcf7-9e3ae23682a4</Referte>
	<Inhoud>
		<KindVoordelen>
			<KindVoordeel>
				<Bron>VLAANDEREN</Bron>
				<INSZ>00000000100</INSZ>
				<KindVoordeelFonds>
					<Ondernemingsnummer>0411696011</Ondernemingsnummer>
					<Omschrijving>Partena Onafhankelijk Ziekenfonds Vlaanderen</Omschrijving>
				</KindVoordeelFonds>
				<Begunstigden>
					<Begunstigde>
						<INSZ>00000000100</INSZ>
						<Betalingsperiodes>
							<Betalingsperiode>
								<Periode>
									<BeginMaand>2018-01</BeginMaand>
									<EindeMaand>2018-02</EindeMaand>
								</Periode>
								<Categorie>
									<Code>ZORG_SPECIALE_NODEN</Code>
									<Omschrijving>Toeslag voor kinderen met een specifieke ondersteuningsbehoefte </Omschrijving>
								</Categorie>
							</Betalingsperiode>
						</Betalingsperiodes>
					</Begunstigde>
				</Begunstigden>
				<Kinderen>
					<Kind>
						<INSZ>00000000100</INSZ>
						<Betalingsperiodes>
							<Betalingsperiode>
								<Periode>
									<BeginMaand>2018-01</BeginMaand>
									<EindeMaand>2018-02</EindeMaand>
								</Periode>
								<Categorie>
								    <KindVoordeelCategorieCode>
										<Code>ZORG_SPECIALE_NODEN</Code>
										<Omschrijving>Toeslag voor kinderen met een specifieke ondersteuningsbehoefte </Omschrijving>
									</KindVoordeelCategorieCode>
								</Categorie>
								<Begunstigden>
									<Begunstigde>00000000100</Begunstigde>
								</Begunstigden>
							</Betalingsperiode>
						</Betalingsperiodes>
					</Kind>
				</Kinderen>
			</KindVoordeel>
		</KindVoordelen>
	</Inhoud>
</Antwoord>

Codetabellen Antwoord

Element - Kindvoordeelfonds

De code zal enkel aanwezig zijn voor oude dossiers. Vanaf 1/1/2019 zullen het KBO nummers zijn. De codes zijn opgenomen in deze handleiding.

Element-Bonus/Categorie

Code	Omschrijving
VOORAFBETALING_GEBOORTE	Startbedrag voorafbetaling geboorte
GEBOORTE	Startbedrag geboorte
ADOPTIE	Startbedrag adoptie

Element-Betalingsperiode/Categorie

Code	Omschrijving
BASIS	Basisbedrag
KINDERBIJSLAG	Kinderbijslag (enkel een mogelijke waarde voor bronnen die niet VLAANDEREN zijn)
ZORG_SPECIALE_NODEN	Toeslag kinderen met specifieke ondersteuningsbehoefte
ZORG_WEES	Toeslag (half) wezen
ZORG_PLEEG	Toeslag geplaatste kinderen
PARTICIPATIE_UNIVERSEEL	Schoolbonus
PARTICIPATIE_SELECTIEF	Schooltoeslag
KINDEROPVANG	Kinderopvangtoeslag
KLEUTER	Kleutertoeslag
ONDERSTEUNINGSTOESLAG	Ondersteuningstoeslag

Op deze pagina

1 Algemeen
2 XSD Visueel
3 Detail
- 3.1 Antwoord Kindvoordelen
- 3.2 Voorbeeld
4 Codetabellen Antwoord

Binnen deze handleiding

Met vragen kunt u steeds terecht bij de MAGDA Service Desk.

MAGDA Gebruikersomgeving

Beschrijving Antwoord Gezin.GeefKindVoordelen - 02.01