Algemeen

Het antwoord bestaat uit 1 tot 7 Onderwerp-elementen met in elk Onderwerp één MutatieNotificatie. Eveneens verkrijgt men in het antwoord een Ontvangstreferte. Zijn er geen mutaties beschikbaar bekomt men een uitzondering.

XSD Visueel

Detail

Opmerking:

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

Antwoord in detail

Element					Opmerkingen
INSZ					Het rijksregisternummer van de persoon
GeannuleerdINSZ					In geval van annulatie: het rijksregisternummer dat geannuleerd werd
NieuwINSZ					In geval van annulatie: het rijksregisternummer dat vanaf nu geldig is voor de persoon
Type					Type mutatie notificatie
	Code				Code voor het type wijziging
		@Beschrijving			Beschrijving van het type
	Omschrijving				Omschrijving van het type
DatumCreatie					De datum waarop de collecte in de computer van het Rijksregister geregistreerd werd, en waarop voor betrokken persoon een rijksregisternummer werd toegekend. Formaat: jjjj-mm-dd
DatumModificatie					De datum waarop de laatste bijwerking in het bestand van het Rijksregister geregistreerd werd. Formaat: jjjj-mm-dd
Informaties					Groepering van de Informaties
	Informatie				Groepering van de informatie
		DatumModificatie			Datum van wijziging, formaat: jjjj-mm-dd
		Identificatie			Nummer van het informatietype. Bij voorbeeld: 000 voor IT000, 120 voor IT120, enz.
			Code		Code van de identificatie
			Omschrijving		Omschrijving van de identificatie
		TypeMutaties			Groepering van de types mutaties
			TypeMutatie		Duidt aan of het een creatie, correctie, supressie of annulatie betreft
				Code	Code van het type mutatie
				Omschrijving	Omschrijving van het type mutatie

Opvraging cases

Initiële opvraging

Op het moment dat de afnemer beslist om de voor hem beschikbare mutatienotificaties op te halen moet bij de eerste keer dat de webservice wordt aangeroepen, de opvraging gebeuren zonder ontvangstreferte. Dit is logisch daar er nog geen ontvangstreferte gekend is. In het antwoord worden de eerste beschikbare mutatienotificaties teruggegeven alsook een ontvangstreferte.

<Vragen>
	<Vraag>
		<Referte>152487454-441</Referte>
		<Inhoud>
			<Identificatie>Afzender-A</Identificatie>
			<Hoedanigheid>188</Hoedanigheid>
		</Inhoud>
	</Vraag>
</Vragen>

<Inhoud>
	<Onderwerpen>
		<Onderwerp>
			<Referte>8842445a-ae44-47c6-8ca5-30dbda8452ce</Referte>
			<Inhoud>
				persoonmutatienotificatie
			</Inhoud>
		</Onderwerp>
	</Onderwerpen>
	<Ontvangstreferte>7fca0fe5-5d0e-4875-ac50-3e1cf0982284</Ontvangstreferte>
</Inhoud>

<Uitzonderingen>
	<Uitzondering>
		<Identificatie>30016</Identificatie>
		<Oorsprong>MAGDA</Oorsprong>
		<Type>FOUT</Type>
		<Tijdstip>
			<Datum>2012-08-23</Datum>
			<Tijd>14:15:05.242</Tijd>
		</Tijdstip>
		<Diagnose>Geen verdere gegevens beschikbaar</Diagnose>
	</Uitzondering>
</Uitzonderingen>

Opvraging bij gegevens in antwoord

Bevinden zich in het antwoord gegevens (dus minstens één MutatieNotificatie), dan moet de volgende opvraging, met de in dat antwoord ontvangen ontvangstreferte, uitgevoerd worden. Door het opgeven van de ontvangstreferte bevestigt men de goede ontvangst en verwerking van de gegevens en verkrijgt men de volgende set van gegevens.

De ontvangstreferte in het antwoord dient gebruikt te worden in de volgende vraag.

Opvraging na ‘geen verdere gegevens beschikbaar’ (30016)

Bevat het antwoord uitzondering 30016 ‘geen verdere gegevens beschikbaar’, dan zijn alle op dat moment te verdelen mutatienotificaties doorgegeven. De volgende keer dat er dan mutatienotificaties worden opgevraagd, dient de vraag gesteld te worden zonder ontvangstreferte. Er kan immers geen ontvangstreferte opgegeven worden daar er geen ontvangst van gegevens te bevestigen is. Er bevonden zich namelijk geen gegevens in het vorige antwoord, noch een ontvangstreferte.

Zie ook de uitzonderingen op Uitzonderingen (GeefPersoonMutatieNotificatie-02.00)

Opvraging na foutieve verwerking of niet correcte ontvangst

Er kunnen zich in dit proces een drietal probleemscenario’s voordoen :

De afnemer heeft een probleem gekend met de verwerking van de mutatienotificaties en heeft MAGDA geen ontvangstbevestiging kunnen bezorgen.
De ontvangstbevestiging van de afnemer is niet toegekomen bij MAGDA. Bijgevolg heeft MAGDA de ontvangstbevestiging niet kunnen verwerken en heeft de afnemer dus ook geen antwoord gekregen.
De ontvangstbevestiging werd goed ontvangen, maar het daaropvolgende antwoord van MAGDA is niet toegekomen bij de afnemer.

Was er tijdens de verwerking van de gegevens of de ontvangst ervan een probleem, dan kan men de gegevens opnieuw opvragen. In dat geval wordt er een nieuwe vraag gesteld zonder ontvangstreferte.

In deze gevallen zal het antwoord bestaan uit de reeds doorgestuurde mutatienotificaties tezamen met de melding dat deze al reeds doorgegeven werden maar nog niet bevestigd. Een ontvangstreferte is eveneens ook aanwezig

In de volgende vraag dient de verkregen ontvangstreferte dan terug opgenomen te worden.

Opvraging na archivering

Informatie Vlaanderen is in de mogelijkheid gearchiveerde mutaties terug beschikbaar te stellen. Dit natuurlijk enkel indien de gevraagde mutaties nog beschikbaar zijn op het MAGDA-platform. Na enige tijd worden deze namelijk verwijderd. Om mutaties terug beschikbaar te maken moet er contact opgenomen worden met de MAGDA-helpdesk. Zie Contact opnemen met de MAGDA helpdesk.

Van zodra Informatie Vlaanderen bevestigd heeft dat de gevraagde mutaties terug beschikbaar zijn, kunnen deze als volgt opgehaald worden:

voer een vraag uit zonder ontvangstreferte. Als antwoord worden de oudst beschikbare mutaties verkregen, dit zijn de terug beschikbaar gestelde gearchiveerde mutaties. Het antwoord bevat een ontvangstreferte en de melding dat deze gegevens al opgehaald werden maar nog niet bevestigd (Uitzondering 30017).
volg het proces zoals hierboven beschreven (opvraging bij gegevens in het antwoord). Zolang het antwoord de beschikbaar gestelde gearchiveerde mutaties bevat, blijft de melding komen dat deze gegevens reeds opgehaald waren maar nog niet bevestigd.

Opvraging met foutieve ontvangstreferte

Wordt er een opvraging uitgevoerd met een foutieve ontvangstreferte, dan bevat het antwoord een uitzondering 30014. Het antwoord bevat geen ontvangstreferte. Bijgevolg, de volgende vraag gebeurt zonder ontvangstreferte. Het antwoord zal dan de vorige opgevraagde mutaties bevatten, met een ontvangstreferte en met de melding dat deze mutaties al opgevraagd waren. De volgende vraag gebeurt dan terug met de ontvangen ontvangstreferte.

Zie ook de uitzonderingen op Uitzonderingen (GeefPersoonMutatieNotificatie-02.00)

Codetabellen Antwoord

Type

Code	Beschrijving	Omschrijving
1	Collecte	C
2	Mutatie	M

Informatie/Identificatie

Code	Beschrijving	Omschrijving
000	INSZ	000
001	Beheerder	001
002	Referentiedossier	002
003	Bepaling hoofdverblijfplaats	003
004	Verandering geslacht	004
005	Aangifte wijziging verblijfplaats / Aangifte van aanvraag tot inschrijving	005
006	Plaats van herkomst	006
010	Namen	010
011	Pseudoniem	011
012	Adellijke titel	012
013	Wijziging van de naam, van de voornamen en van de adellijke titel	013
018	Adressen - Aangifte adres buitenland	018
019	Adressen - Aangifte adreswijziging	019
020	Adressen - Hoofdverblijfplaats	020
021	Gedeeld verblijf	021
022	Adressen - Verblijfplaats buitenland	022
023	Adressen - Postadres buitenland	023
024	Adressen - Referentieadres	024
026	Adressen - Tijdelijke afwezigheid	026
027	Wettelijke woonplaats	027
028	Voorlopige inschrijving	028
031	Nationaliteiten	031
031	Nationaliteiten	032
100	Geboorte	100
100	Geboorte	101
110	Afstamming	110
111	Statuut persoon vertegenwoordigd / bijgestaan wordt	111
113	Persoon die vertegenwoordigt of bijstaat	113
114	Afstamming in dalende lijn	114
120	Burgerlijke staat	120
123	Wettelijke samenwoning	123
140	Referentiepersoon	140
141	Gezinsleden	141
150	Overlijden	150
150	Overlijden	151
180	Bestaan van het identiteits- en handtekenings-certificaat	180
195	Identiteitsbewijs	195
196	Sociale zekerheidskaart	196
197	Beroepskaart (vreemdelingen)	197
198	Arbeidskaart (vreemdelingen)	198
200	Nummer van de Dienst Vreemdelingenzaken	200
202	Wettig verblijf	202
205	Type vluchteling	205
206	Administratieve toestand	206
207	Plaats inschrijving	207
208	Voorlopig inschrijvingsnummer	208
210	Register	210
211	Identiteitsdocument	211
212	Gekozen woonplaats	212
213	Andere naam of pseudoniem	213
214	Opgegeven adres	214
247	Contactgegevens	247
252	Niet mededeelbaar adres	252
253	Datum creatie	253
254	Datum modificatie	254

Opmerking:

Het is de machtiging van de afnemer die bepaalt welke informatietypes zullen terugkomen in de publicatie.

TypeMutatie

Code	Beschrijving	Omschrijving	Extra informatie
1	Creatie	ModificationDetailsCreation	Aanduiding dat een nieuwe informatie voor het IT toegevoegd werd. Bv. een IT020 wordt gecreëerd om aan te duiden dat een persoon naar een nieuwe hoofdverblijfplaats verhuist.
2	Correctie	ModificationDetailsCorrection	Aanduiding dat een bestaande informatie voor het IT gecorrigeerd werd. Bv. indien voor een hoofdverblijfplaats een verkeerd huisnummer ingegeven werd dan wordt het bestaand IT020 gecorrigeerd.
3	Suppressie	ModificationDetailsSuppression	Aanduiding dat een bestaande informatie voor het IT gesupprimeerd werd. Bv. indien een gezinslid niet langer deel uitmaakt van het gezin van de referentiepersoon, dan wordt het IT140 van deze persoon gesupprimeerd in het dossier van de referentiepersoon.
4	Annulatie	ModificationDetailsCancellation	Aanduiding dat een bestaande informatie voor het IT geannuleerd werd. Bv. indien een persoon ten onrechte als gezinslid van een referentiepersoon werd genoteerd, dan wordt het IT140 van deze persoon geannuleerd in het dossier van de referentiepersoon.

Op deze pagina

1 Algemeen
2 XSD Visueel
3 Detail
- 3.1 Antwoord in detail
- 3.2 Opvraging cases
4 Codetabellen Antwoord
- 4.1 Type
- 4.2 Informatie/Identificatie
- 4.3 TypeMutatie

Binnen deze handleiding

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

MAGDA Gebruikersomgeving

Beschrijving Antwoord (GeefPersoonMutatieNotificatie-02.00)

Algemeen

XSD Visueel

Detail

Opmerking:

Antwoord in detail

Opvraging cases

Initiële opvraging

Opvraging bij gegevens in antwoord

Opvraging na ‘geen verdere gegevens beschikbaar’ (30016)

Opvraging na foutieve verwerking of niet correcte ontvangst

Opvraging na archivering

Opvraging met foutieve ontvangstreferte

Codetabellen Antwoord

Type

Informatie/Identificatie

Opmerking:

TypeMutatie

Related pages

De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid