Interface (PubliceerPersoonMutatieNotificatie-02.00)
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 |
---|
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
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:
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:
|
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.
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 GeefPersoon 02.02 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 |
032 | ||
100 | Geboorte | 100 |
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 |
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 |
Informatie type mutatie
Heeft betrekking tot het element “Informatie/TypeMutaties/TypeMutatie”.
Code | Beschrijving | Omschrijving* |
---|---|---|
1 | Creatie | ModificationDetailsCreation |
2 |