Algemeen

Het antwoord bestaat uit 1 tot 7 Onderwerp-elementen met in elk Onderwerp één PersoonMutatiesNotificaties. Eveneens verkrijgt men in het antwoord een Ontvangstreferte. Als er geen mutaties beschikbaar zijn, 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 ../Antwoord/Inhoud									Opmerkingen
Onderwerpen
	Onderwerp
		Inhoud
			PersoonMutatiesNotificaties
				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
Ontvangstreferte									Referte die wordt doorgegeven in de volgende request om de goede ontvaangst te bevestigen

Opvraging proces

Stap 1 : 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.

Initiële vraag

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

Antwoord bij beschikbare data

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

Antwoord indien geen data beschikbaar is

<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>

Stap 2 : volgende data opvragen

Bevinden zich in het antwoord gegevens (dus minstens één PersoonMutatieNotificatie, maximaal 7), 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.

Vraag met bevestiging van voordien ontvangen data

De ontvangstreferte in in deze vraag heeft de waarde van het in stap 1 ontvangen antwoord met data. Zolang er nog data beschikbaar is zal een antwoord data bevatten en een nieuwe ontvangstreferte

<Vragen>
	<Vraag>
		<Referte>152487454-441</Referte>
		<Inhoud>
			<Identificatie>Afzender-A</Identificatie>
			<Hoedanigheid>188</Hoedanigheid>
			<Ontvangstreferte>7fca0fe5-5d0e-4875-ac50-3e1cf0982284</Ontvangstreferte>
		</Inhoud>
	</Vraag>
</Vragen>

Antwoord met data

<Inhoud>
	<Onderwerpen>
		<Onderwerp>
			<Referte>8842445a-ae44-47c6-8ca5-30dbda8452ce</Referte>
			<Inhoud>
				persoonmutatienotificatie
			</Inhoud>
		</Onderwerp>
	</Onderwerpen>
	<Ontvangstreferte>c1c07dc1-551e-4fe6-8fd6-767d3424e393</Ontvangstreferte>
</Inhoud>

Stap 3 : geen verdere data beschikbaar

Indien geen verdere data beschikbaar is zal het antwoord enkel een uitzondering 30016 ‘geen verdere gegevens beschikbaar’ bevatten. Alle PersoonMutatieNotificatie gegevens die beschikbaar zijn, zijn reeds ontvangen.

De vraag bevat de ontvangstreferte van het laatste antwoord waarin PersoonMutatiesNotificaties zijn ontvangen.

<Vragen>
	<Vraag>
		<Referte>152487454-441</Referte>
		<Inhoud>
			<Identificatie>Afzender-A</Identificatie>
			<Hoedanigheid>188</Hoedanigheid>
			<Ontvangstreferte>c1c07dc1-551e-4fe6-8fd6-767d3424e393</Ontvangstreferte>
		</Inhoud>
	</Vraag>
</Vragen>

Het antwoord bevat de uitzondering 30016

<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>

Zie ook de uitzonderingen op Uitzonderingen (GeefPersoonMutatieNotificatie-02.00)

De volgende keer dat er dan mutatienotificaties worden opgevraagd, dient de vraag gesteld te zoals worden zonder ontvangstreferte zoals in stap 1. 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.

Foutverwerking : gegevens niet correct verwerkt

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. De ontvangstreferte van de correct verwerkte PersoonMutatiesNotificaties gegevens wordt gebruikt.

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

In het antwoord wordt voordien doorgestuurde PersoonMutatieNotificatie data opgehaald met een melding data deze data reeds was doorgestuurd. Een nieuwe ontvangstreferte wordt doorgegeven, welke in de volgende vraag dient opgenomen te worden.

<Inhoud>
	<Onderwerpen>
		<Onderwerp>
			<Referte>18774-5412</Referte>
			<Inhoud>
				persoonmutatienotificatie
			</Inhoud>
		</Onderwerp>
	</Onderwerpen>
	<Ontvangstreferte>87451452-5d0e-4875-ac50-3e1cf0982284</Ontvangstreferte>
</Inhoud>
<Uitzonderingen>
	<Uitzondering>
		<Identificatie>30017</Identificatie>
		<Oorsprong>MAGDA</Oorsprong>
		<Type>WAARSCHUWING</Type>
		<Tijdstip>
			<Datum>2012-08-23</Datum>
			<Tijd>14:13:39.484</Tijd>
		</Tijdstip>
		<Diagnose>De gegevens in het antwoord werden eerder al opgevraagd maar nog niet bevestigd</Diagnose>
	</Uitzondering>
</Uitzonderingen>

Opvraging na archivering

Gearchiveerde data opnieuw opvragen

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.

<Inhoud>
	<Onderwerpen>
		<Onderwerp>
			<Referte>8842445a-ae44-47c6-8ca5-30dbda8452ce</Referte>
			<Inhoud>
				<Metadata>
					<Referte>1211</Referte>
					<Type>01</Type>
					<Datum>2007-07-26T00:00:00.000+02:00</Datum>
				</Metadata>
				<MutatieNotificatie>
					<INSZ>00000000128</INSZ>
					<Bron>VDAB</Bron>
				</MutatieNotificatie>
			</Inhoud>
		</Onderwerp>
	</Onderwerpen>
	<Ontvangstreferte>12458796-5d0e-4875-ac50-3e1cf0982284</Ontvangstreferte>
</Inhoud>
<Uitzonderingen>
	<Uitzondering>
		<Identificatie>30017</Identificatie>
		<Oorsprong>MAGDA</Oorsprong>
		<Type>WAARSCHUWING</Type>
		<Tijdstip>
			<Datum>2012-08-23</Datum>
			<Tijd>14:13:39.484</Tijd>
		</Tijdstip>
		<Diagnose>De gegevens in het antwoord werden eerder al opgevraagd maar nog niet bevestigd</Diagnose>
	</Uitzondering>
</Uitzonderingen>

Vraag met een reeds bevestigde ontvangstreferte

Indien een ontvangstreferte herbruikt wordt nadata deze al bevestigd geweest is (of dezelfde vraag wordt twee maal doorgestuurd) zal een Uitzondering 30015 'De ontvangst van gegevens gekoppeld aan deze ontvangstreferte waren al bevestigd bijgevolg zijn deze gegevens niet meer beschikbaar' worden doorgegeven in het antwoord

<Uitzonderingen>
	<Uitzondering>
		<Identificatie>30015</Identificatie>
		<Oorsprong>MAGDA</Oorsprong>
		<Type>FOUT</Type>
		<Tijdstip>
			<Datum>2012-08-23</Datum>
			<Tijd>14:23:03.905</Tijd>
		</Tijdstip>
		<Diagnose>De ontvangst van gegevens gekoppeld aan deze ontvangstreferte waren al bevestigd bijgevolg zijn deze gegevens niet meer beschikbaar</Diagnose>
	</Uitzondering>
</Uitzonderingen>

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.

<Vragen>
	<Vraag>
		<Referte>152487454-441</Referte>
		<Inhoud>
			<Identificatie>Afzender-A</Identificatie>
			<Hoedanigheid>188</Hoedanigheid>
            <Ontvangstreferte>98745632-5d0e-4875-ac50-3e1cf0982284</Ontvangstreferte>
		</Inhoud>
	</Vraag>
</Vragen>

Het antwoord bevat een uitzondering 30014 'Ongeldige ontvangstreferte'. Het proces om data op te vragen moet dan hervat worden zonder ontvangstreferte (zie stap 1 hierboven)

<Uitzonderingen>
	<Uitzondering>
		<Identificatie>30014</Identificatie>
		<Oorsprong>MAGDA</Oorsprong>
		<Type>FOUT</Type>
		<Tijdstip>
			<Datum>2012-08-23</Datum>
			<Tijd>14:16:15.289</Tijd>
		</Tijdstip>
		<Diagnose>Ongeldige ontvangstreferte</Diagnose>
	</Uitzondering>
</Uitzonderingen>