Informatie:

De XML- en CSV-bestanden die via FTP gepubliceerd worden dienen te voldoen aan de MAGDA-richtlijnen. Voor meer informatie over hoe een Publicatie-dienst algemeen gebruikt dient te worden, bekijk Bestandsuitwisseling (Publicaties/batchverwerking).

Algemeen

De gegevens zijn beschikbaar in XML en opgebouwd volgens de MAGDA 2.0-richtlijnen. Dit betekent dat de XSD opgebouwd is volgens onderstaande structuur: een PubliceerPersoonMutatiesNotificaties/Publicatie/Onderwerpen/Onderwerp/ element met in Onderwerp telkens één PersoonMutatiesNotificaties.

Al de mutatienotificaties van een persoon worden gebundeld zodat elke persoon maar één keer voorkomt in het mutatiebestand. Eén persoon bevat veelal meerdere meldingen van gemuteerde informatietypes. Elke melding resulteert in een nieuw Informatie-element.

Bestandsnaam

Opmerking:

De exacte bestandsnaam wordt pas meegedeeld tijdens het aansluitingsproces. De gegevens die u hier vindt kunnen dus mogelijk wijzigen.

De bestandsnaam is van de vorm prefix_publicatienaam_timestamp.extensie.

Voorbeeld	PersMut_20140224155516000.xml PersMut_20140226082835551.zip

Publicatie in XML

Algemeen

Informatie:

De publicatie in XML bevat een standaard context zoals de andere MAGDA-publicaties. Dit naar analogie met de contextbeschrijving voor webservices, bekijk hiervoor eens de handleiding Webservices 02.00.

De inhoud van een publicatie bestaat uit één of meerdere PersoonMutatiesNotificaties-elementen. Dit element bevat buiten de identificatie van de persoon (rijksregisternummer) eveneens:

de datum van creatie en de datum van de laatste modificatie van het dossier van de persoon in het Rijksregister
het type mutatie zijnde de creatie of de wijziging van het dossier
de verschillende informatietypes die gewijzigd zijn (of gecreëerd, geannuleerd, …)

In het geval dat er een uitzonderingsbestand gevraagd werd en er zijn geen te publiceren gegevens, bevat het bestand de uitzondering “15015 - Geen te publiceren gegevens”.

XSD

De bestanden die worden aangeboden op de outputfolder zijn gevalideerd volgens de service-XSD horende bij deze dienst. De actuele XSD is ter beschikking op aanvraag.

Elementen

Informatie:

Voor een overzicht van alle elementen die in de gevraagde XML staan en eventuele beperkingen wordt er verwezen naar de XSD.

Visueel

Detail

Element	Beschrijving
INSZ	Het rijksregisternummer van de persoon zoals die gekend is bij de afnemer van MAGDA en ingeschreven in het repertorium.
GeannuleerdINSZ (1)	In geval van annulatie: het rijksregisternummer dat geannuleerd werd. Dit betekent dat het rijksregisternummer van de persoon, zoals die gekend is bij de afnemer van MAGDA, dit nummer vervangt.
NieuwINSZ (2)	In geval van annulatie: het rijksregisternummer dat vanaf nu geldig is voor de persoon. Dit betekent dat het rijksregisternummer van de persoon, zoals die gekend is bij de afnemer van MAGDA, vervangen is door dit nummer.
Type/Code	Type wijziging. Mogelijke codes: Als beschrijving: Collecte Als beschrijving: Mutatie Binnen Omschrijving zal een “C” staan in geval van Collecte, een “M” in geval van Mutatie.
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/Informatie/
DatumModificatie	Datum van wijziging, formaat: jjjj-mm-dd
Identificatie	Nummer van het informatietype. Bijvoorbeeld: 000 voor IT000, 120 voor IT120, enz. De volledige lijst is terug te vinden in de codetabellen. Ook het overzicht van de Beschrijvingen en Omschrijvingen is hier terug te vinden.
TypeMutatie/Code	Duidt aan of het een creatie, correctie, suppressie of annulatie betreft. Mogelijke codes: als beschrijving “Creatie”. Omschrijving is “ModificationDetailsCreation” als beschrijving “Correctie”. Omschrijving is “ModificationDetailsCorrection” als beschrijving ”Suppressie”. Omschrijving is “ModificationDetailsSuppression” als beschrijving “Annulatie”. Omschrijving is “ModificationDetailsCancellation”

Opmerkingen

Geannuleerd INSZ

Het “GeannuleerdINSZ” werd geannuleerd en vervangen door het nieuwe “INSZ “ met het “GeannuleerdINSZ” als referte. Dit komt dus voor als het nieuwe “INSZ“ al gekend is in het MAGDA-repertorium op het ogenblik dat MAGDA de lijst met ingeschreven INSZ-nummers opmaakt en dat het oud “GeannuleerdINSZ” in de loop van de voorbije week vervangen werd door het nieuwe “INSZ" bij het Rijksregister. Redenen van de annulaties zijn een verkeerde geboortedatum, een foutief geslacht, een dubbel dossier, …

Nieuw INSZ

Het “INSZ” werd vervangen door een “NieuwINSZ” met het “INSZ” als referte. Het “NieuwINSZ” vervangt dus het “INSZ” (dat gekend was in het MAGDA-repertorium en dat vervangen wordt door het “NieuwINSZ”). Dit komt voor als het oude “INSZ” ingeschreven is in het MAGDA-repertorium op het ogenblik dat MAGDA de lijst met ingeschreven rijksregisternummers opmaakt en dat dit oud rijksregisternummer in de loop van de voorbije week vervangen werd door het “NieuwINSZ” bij het Rijksregister. Dit nieuw Rijksregisternummer zou moeten ingeschreven worden in het MAGDA-repertorium en in het vervolg gebruikt worden als identificatie van het Rijksregisterdossier. Ter info: MAGDA schrijft het nieuw nummer dat in de mutatienotificatie ontvangen wordt niet automatisch in. Het Rijksregister heeft in dossier met het “INSZ” een IT002 (referentiedossier) aangemaakt dat verwijst naar het “ NieuwINSZ”.

TypeMutatie

Onderstaande tabel geeft meer uitleg over de betekenis van creatie, correctie, suppressie en annulatie.

Term	Omschrijving
Creatie	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.
Correctie	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.
Suppressie	Aanduiding dat een bestaande informatie voor het IT afgesloten werd, m.a.w. voor het IT wordt een einddatum ingevuld. 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.
Annulatie	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.

Sortering van Informatie-element binnen een PersoonMutatiesNotificaties.

De mutaties van een zelfde informatietype voor een zelfde persoon worden aflopend op het tijdstip van de aanmaak van de mutaties gesorteerd (oudste eerst).

Samen voorkomen van verschillende type mutaties (TypeMutatie)

Het is mogelijk dat er voor een zelfde persoon, een zelfde informatietype en een zelfde datummodificatie meerdere mutaties in een zelfde element voorkomen. Het is ook mogelijk dat er meerdere opeenvolgende mutaties van een zelfde informatietype met een zelfde datummodificatie voorkomen.

Dit doet zich voor bij autogeneratie (voorbeeld: een creatie en een suppressie).

Uitzonderingen

Indien er gekozen werd om een uitzonderingsbestand te ontvangen, komt er een Uitzondering terug met als foutcode 15015 – geen te publiceren gegevens.

Voorbeeld

<Uitzonderingen>
	<Uitzondering xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">
		<Identificatie>15015</Identificatie>
		<Oorsprong>MAGDA</Oorsprong>
		<Type>INFORMATIE</Type>
		<Tijdstip>
			<Datum>2014-02-24</Datum>
			<Tijd>15:56:16</Tijd>
		</Tijdstip>
		<Diagnose>Geen te publiceren gegevens</Diagnose>
	</Uitzondering>
</Uitzonderingen>

Codetabellen

Type wijziging

Heeft betrekking op het element “Type”.

Collecte is de creatie van de persoon in de databanken van het Rijksregister.

Code	Beschrijving	Omschrijving*
1	Collecte	C
2	Mutatie	M

Informatie identificatie

Heeft betrekking tot het element “Informatie/Identificatie” dat bestaat uit een Code en Beschrijving zoals MAGDA die gebruikt in de webservices /wiki/spaces/MDI/pages/174030851, GeefPersoon-02.02, /wiki/spaces/MDI/pages/355369437 en GeefHistoriekPersoon-02.02. De Omschrijving is het nummer van het Rijksregister-informatietype. Sommige MAGDA-codes en -beschrijvingen worden gebruikt voor meerdere Rijksregister informatietypes, bv. voor de MAGDA Code 031 Nationaliteiten zijn er in het Rijksregister 2 informatietypes 031 en 032.

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.

Informatie type mutatie

Heeft betrekking tot het element “Informatie/TypeMutaties/TypeMutatie”.

Code	Beschrijving	Omschrijving*
1	Creatie	ModificationDetailsCreation
2	Correctie	ModificationDetailsCorrection
3	Suppressie	ModificationDetailsSuppression
4	Annulatie	ModificationDetailsCancellation

Op deze pagina

Binnen deze handleiding

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

Interface (PubliceerPersoonMutatieNotificatie-02.00)

Informatie:

Algemeen

Bestandsnaam

Opmerking:

Publicatie in XML

Algemeen

Informatie:

XSD

Elementen

Informatie:

Visueel

Detail

Opmerkingen

Geannuleerd INSZ

Nieuw INSZ

TypeMutatie

Sortering van Informatie-element binnen een PersoonMutatiesNotificaties.

Samen voorkomen van verschillende type mutaties (TypeMutatie)

Uitzonderingen

Codetabellen

Type wijziging

Informatie identificatie

Opmerking:

Informatie type mutatie

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