Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

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

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:

  1. Als beschrijving: Collecte

  2. 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:

  1. als beschrijving “Creatie”. Omschrijving is “ModificationDetailsCreation”

  2. als beschrijving “Correctie”. Omschrijving is “ModificationDetailsCorrection”

  3. als beschrijving ”Suppressie”. Omschrijving is “ModificationDetailsSuppression”

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

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