Algemeen

Hieronder worden de veranderingen gedocumenteerd die gedaan zijn met het invoeren van de Persoon 02.02 diensten. Niet alle aanpassingen zijn relevant voor alle persoonsdiensten. Welke diensten geïmpacteerd zijn is vermeld. Daarnaast is het mogelijk dat binnen een dienst specifieke aanpassingen gedaan zijn die niet van toepassing zijn op de gegevens in het Type Persoon 02.02 object. Deze aanpassingen worden vermeld in de dienst zelf.

Gebruik van een nieuwe namespaces

Webservices

De namespace voor webservices is nu in het formaat  http://magda.vlaanderen.be/[domein]/soap/[dienstnaam]/v[versie]

Voorbeeld : http://magda.vlaanderen.be/persoon/soap/zoekpersoonopnaam/v02_02

Batch verwerking en publicaties

De namespace voor batch verwerking of publicaties is in het formaat http://magda.vlaanderen.be/[domein]/file/[dienstnaam]/v[versie]

Voorbeeld : http://magda.vlaanderen.be/persoon/file/zoekpersoonopnaam/v02_02

Generieke onderdelen

Om de gebruikte objecten in de verschillende XSD documenten te vereenvoudigen en te abstraheren is er beslist om met een bibliotheek te maken waarvan de versie los staat van de versie van de diensten zelf. De structuur van de data is eenvoudiger en gemakkelijker te implementeren. Het aantal verschillende types van generieke elementen is zwaar teruggeschroefd.

Om een duidelijk onderscheid te kunnen maken met de vorige methode om elementen te noteren is een nieuwe namespace gebruikt voor deze dienst en de generieke bibliotheek.

Voorbeeld : http://magda.vlaanderen.be/generiek-v3

Toevoeging van het contactadres

De Kruispuntbank Sociale Zekerheid (KSZ) voert een nieuw adrestype in in haar registers, het contactadres. De buitenlandse adresinformatie die in de huidige manier van werken van de KSZ in het buitenlandse adrestype opgeslagen wordt, wordt ook "misbruikt" om tijdelijke verblijven in België op te slaan. In de toekomst zal het contactadres gebruikt worden om de tijdelijke verblijven in België op te slaan en zal KSZ controleren dat geen Belgische adressen meer in het buitenlands adrestype opgeslagen kunnen worden. Om de bestaande toestand recht te trekken zullen in september 2019 ongeveer 400.000 tijdelijke Belgische verblijven gemigreerd worden naar het contactadres.

De toevoeging van het contactadres heeft impact op onderstaande diensten, maar is beperkt tot opvragingen van personen in de KSZ-registers, zoals het RAD- en BIS-register:

• GeefPersoon

• GeefHistoriekPersoon

• GeefGezinssamenstelling

• GeefHistoriekGezinssamenstelling

• ZoekPersoonOpNaam

• ZoekPersoonOpAdres

• CreëerBIS

• WijzigKSZPersoon

Toevoeging van wettelijke identificatietypes

Voor elke persoon in het Rijksregister worden verschillende informatiegegevens, onderverdeeld in verschillende informatietypes, bijgehouden. De informatietypes (IT) karakteriseren het administratief statuut van een persoon en kunnen wijzigingen in de loop van zijn leven.

De ‘wettelijke’ informatiegegevens, zijn de gegevens bedoeld in artikel 3, eerste en tweede lid, van de wet van 8 augustus 1983. De in de MAGDA-persoonsdiensten nog ontbrekende informatietypes die behoren tot deze ‘wettelijke’ informatiegegevens, zijn toegevoegd in de persoonsdiensten-02.02.

De extra opgenomen elementen in het persoon object zijn

• IT004 : Geslachtsverandering

• IT005 : Aangifte van wijziging verblijfplaats of aanvraag tot inschrijving

• IT012 : Adellijke titel

• IT013 : Wijziging van naam, voornaam of adellijke titel

• IT027 : Wettelijke woonplaats

• IT028 : Voorlopige inschrijving

• IT151 : Verklaring van overlijden

• IT180 : Identiteits- en handtekingscerticicaat

• IT195 : Identiteitsbewijs

• IT208 : Voorlopig inschrijvingsnummer

• IT211 : Identiteitsdocument

• IT212 : Gekozen woonplaats

• IT213 : Alias

Dit heeft impact op onderstaande diensten:

• GeefPersoon

• GeefHistoriekPersoon

• PubliceerMutatiePersoon

Kleinere aanpassingen 

Type register RAN

KSZ zal binnenkort zijn RAN register opnemen in de resultaten. MAGDA heeft zich reeds voorzien op de ondersteuning van dit register.

Verlenging van de familienaam

KSZ stuurt nu de familienaam ook door in 128 karakters, net zoals Rijksregister. MAGDA heeft deze lengte overgenomen. Dit heeft tot gevolg dat er minder afkortingen van de familienaam zullen voorvallen.

Het fictief identificatienummer

KSZ gebruikt voor het identificeren van personen die geen INSZ nummer hebben een fictief identificatienummer. Dit nummer heeft, net als het INSZ, een lengte van 11 cijfers. Er wordt echter geen checksum97 validatie gedaan. De laatste twee cijfers zijn geen controlegetal. Dit kan bijvoorbeeld nodig zijn als een Belgisch persoon gehuwd is met een persoon van buitenlandse origine.

Als een identificatienummer van een persoon een fictief identificatienummer is wordt dit aangeduid door een isFictief attribuut op 1 te zetten onder het INSZ nummer. Indien het INSZ geen fictief identificatienummer is zal het attribuut niet aanwezig zijn.

Hieronder een voorbeeld : de partner onder de burgerlijke staat kan een persoon zijn van buitenlandse origine en heeft in dat geval een fictief identificatienummer.

Open

Uitbreiding van gezinssamenstelling

Aantal gezinssamenstellingen

KSZ heeft het aantal gezinssamenstellingen verhoogd van 50 naar 250

Aantal gezinsleden

KSZ heeft het aantal gezinsleden verhoogd van 25 naar 250

Aantal gezinshoofden

KSZ heeft het aantal gezinshoofden verhoogd van 50 naar 250

BeStAdd adresgegevens

KSZ heeft in zijn v4 diensten ondersteuning voorzien voor de BeStAdd identificatoren. Deze identificatoren bestaan op 3 niveau's:

• Adresniveau - opgenomen in het VerwijstNaar element

• Gemeenteniveau - opgenomen in het GemeenteBeStAddId element

• Straatniveau - opgenomen in het StraatBeStAddId element

KSZ stuurt nog geen BeSt Add gegevens door. Ten laatste eind 2020/begin 2021 zullen deze gegevens beschikbaar gesteld worden. KSZ zal beginnen met het BeStAdd gegevens door te sturen eind maart 2024. Hierbij zal enkel op het adresniveau een ID worden doorgestuurd, niet op gemeente- of straatniveau. Dit BeStAdd AdresID zit in het element VerwijstNaar.

Deze BeSt Add identificatoren zullen tot dan niet ingevuld worden en er is hiervoor ook geen testdata beschikbaar.

Wel kunnen de datastructuren reeds opgenomen in applicatie ontwikkelingen.

OSLO adressenstructuur

Hoofdverblijfplaats, OpgegevenAdres en Contactadres worden doorgegeven in een uitgebreide OSLO adresvoorstelling formaat. Dit is de OSLO Adresvoorstelling, zoals bepaald door het OSLO team op hun website. Deze adresvoorstelling is uitgebreid met de adres-elementen die in de vorige versie van deze dienst werd doorgegeven en niet opgenomen zijn in het OSLO adres. Daarnaast zijn ook de BeStAdd identificatoren in deze uitbreiding opgenomen (zie ook hierboven).

Open

Het OSLO adres is voorzien van een adresvoorstelling welke de basisgegevens van een adres bevat  Deze adresvoorstelling komt in grote lijnen overeen met een reguliere Belgische adresnotatie maar waarbij alle gegevens onder mekaar zijn opgelijst. Deze OSLO adresvoorstelling bevat optioneel een "VerwijstNaar" element welke de ID bevat waarmee het volledige OSLO adres kan opgevraagd worden. Deze identificator komt overeen met het BeStAdd AdresID.

Deze OSLO adresvoorstelling bevat geen ISO- of NISCodes, noch BeStAdd gegevens voor de straat en de gemeente. Deze informatie wordt opgenomen in een AdresvoorstellingUitbreiding met als doel dezelfde informatie door te geven als vroegere Belgische adressen in het MAGDA formaat bevatten.

Het straatnaam en gemeentenaam element mag pas ingevuld worden als de informatie uit een authentieke bron komt. Zolang we de adressen die we van KSZ of Rijksregister doorkrijgen niet uit een officieel adressenregister komen zonder dat een BeStAddID aanwezig is, mogen deze elementen niet ingevuld worden. Om toch dezelfde adresgegevens door te geven als in vorige versies van de diensten zijn in de AdresvoorstellingUitbreiding extra elementen toegevoegd: NietGestandaardiseerdeStraatnaam en NietGestandaardiseerdeGemeente. In deze elementen wordt de naam van de straat en de gemeente ingevuld als er bij het adres geen verwijzing naar een officieel register wordt doorgegeven in het VerwijstNaar element. Indien er wel een identificator wordt doorgegeven in het VerwijstNaar element komt het adres uit een officieel register en zal de straat- en gemeentenaam ingevuld worden in de Straat en Gemeente elementen respectievelijk.

Hieronder is een voorbeeld van de verandering in de datastructuur van een oud MAGDA hoofdverblijfplaats adres naar de nieuwe uitgebreide OSLO adresvoorstelling structuur. Niet alle elementen van het OSLO adres kunnen ingevuld worden omdat de gegevens door de bron niet worden doorgegeven.

Minimale persoonsgegevens i.p.v. verrijking

In de 02.00 persoonsdiensten werd gebruik gemaakt van een universeel Persoon-object in de datastructuur. Daar dit universeel object uitgebreid is met een grote hoeveelheid data en daarnaast KSZ het persoon-object heel erg verkleind heeft is beslist om een basis persoon-object aan te maken en hierop vereenvoudigde datastructuren te bouwen.

Op deze pagina

Binnen deze handleiding