1 Waarom nieuwe diensten?
MAGDA bouwt een nieuwe versie van het merendeel van de diensten binnen het domein ‘Persoon’. Alle consultatie-, creatie- en wijzigingsdiensten zijn geïmpacteerd, evenals de mutatiediensten m.u.z. van de notificatiediensten.
De belangrijkste reden voor de bouw van de nieuwe diensten is de overschakeling bij de Kruispuntbank Sociale Zekerheid (KSZ) van de ‘V3’ naar de ‘V4’ registers online webservices en publicaties. De nieuwe KSZ-versie werd hoofdzakelijk ontwikkeld voor de volgende nieuwigheden:
- Introductie van het contactadres in de KSZ-registers
- Minimale persoonsgegevens i.p.v. verrijking
- Standaardisatie van de KSZ-webservices
Uit de analyse binnen MAGDA is gebleken dat deze wijzigingen brekend zijn en het niet mogelijk was om de huidige persoonsdiensten-02.00 backwards compatible te houden, zoals we dit de voorbije 8 jaar wel hebben kunnen doen, ondanks de regelmatige wijzigingen bij de bronnen. Bijgevolg is de bouw van nieuwe diensten een noodzaak.
MAGDA maakt tevens van de gelegenheid gebruik om enkele optimalisaties door te voeren aan de structuur van de webservices en kiest voor duidelijke, functionele elementen. Er worden ook enkele nieuwe elementen geïntroduceerd, zoals de ontbrekende wettelijke informatietypes uit het Rijksregister en het OSLO-adres.
We trachten hierbij de impact voor de afnemers zo minimaal mogelijk te houden. Desalniettemin zullen jullie ook de nodige aanpassingen dienen uit te voeren in jullie applicaties.
2 Wat wijzigt er?
2.1 Bronaanpassingen bij de KSZ
2.1.1 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 element ‘Hoofdverblijfplaats’ 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 element ‘Hoofdverblijfplaats’ opgeslagen kunnen worden. Om de bestaande toestand recht te trekken zullen tussen 27 en 30 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
- ZoekPersoonOpAdres
- ZoekPersoonOpNaam
- CreëerBIS
- WijzigKSZPersoon
- PubliceerMutatiePersoon
- PubliceerMutatieGezinssamenstelling
2.1.2 Minimale persoonsgegevens i.p.v. verrijking
De KSZ heeft voor bepaalde diensten gekozen voor minimale persoonsgegevens i.p.v. verrijking, dit o.a. omwille van performantie, privacy (proportionaliteit) en relevantie (niet alle gegevens nodig). Dit betekent dat verschillende datablokken, zoals bijvoorbeeld Overlijden, Nationaliteiten, Geboorteplaats en BurgerlijkeStaten, zullen verdwijnen en dat voor bepaalde diensten het Overlijden zal beperkt worden tot een boolean (ja/neen).
Dit heeft impact op volgende diensten:
- ZoekPersoonOpNaam
- INSZ
- Geslacht & geboortedatum
- Naam & voornamen
- Adres (incl. contactadres) & beheerder
- IsOverleden (deceased=”true”)
- ZoekPersoonOpAdres
- INSZ
- Geslacht & geboortedatum
- Naam & voornamen
- Adres & beheerder
- (Geen overleden personen mogelijk)
- CreëerBIS en WijzigKSZPersoon
- INSZ
- Geslacht & geboortedatum
- Naam & voornamen
- Adres (incl. contactadres) & beheerder
- IsOverleden (deceased=”true”)
- GeefGezinssamenstelling en GeefHistoriekGezinssamenstelling
- INSZ of fictief nummer
- Geslacht
- Naam & voornamen
- Adres enkel voor gezinshoofd, enkel actueel
2.1.3 Kleinere wijzigingen
- Toevoegen van het type register “RAN” (Register der geannuleerden)
- Verlenging naamsveld (familienaam) van 48 naar 128 tekens
- Uitbreiding gezinssamenstelling:
- Aantal gezinssamenstellingen 50 -> 250
- Aantal gezinsleden 25 -> 250
- Aantal gezinshoofden 50 -> 250
- Toevoegen van BeSt Add-adresgegevens door KSZ (nog niet actief)
- Toevoegen isFictief attribuut aan het INSZ-nummer voor fictieve INSZ-nummers gebruikt door KSZ
- Toevoegen nieuwe Uitzonderingcodes wegens nieuwe anomalieën KSZ
2.2 Wijziging van de structuur van de XSD-bestanden
Om de structuur in de XSD-bestanden te optimaliseren, wordt ze vereenvoudigd en zal ze gebaseerd zijn op functie i.p.v. op type element. Dit betekent initieel meer werk, maar maakt het voor jullie, afnemers, eenvoudiger om nieuwe structuren te gebruiken en gemakkelijker om te migreren. Ook het onderhoud van applicaties wordt eenvoudiger.
Dit heeft impact op alle persoonsdiensten-02.02.
2.3 Wijziging van de namespace van de XSD-bestanden
De namespaces van de XSD-bestanden waren verouderd. Deze zijn vernieuwd en consistent gemaakt met een betere, logische structuur.
Dit heeft impact op alle persoonsdiensten-02.02.
2.4 Implementatie OSLO-adres
MAGDA wil inzetten op semantische interoperabiliteit en zal zich hiervoor enten op de OSLO-standaarden. Er is gekozen om in eerste instantie het OSLO-adres te implementeren in de persoonsdiensten-02.02.
Een adres is in de eerste plaats een op zichzelf staand object met een eigen identificator en levensloop. Dat geldt ook voor adrescomponenten zoals straatnaam en gemeentenaam. Het adresobject dat zo ontstaat noemen we een gestructureerd adres. In tweede orde is een adres een attribuut, bv. het adres van een gebouw of een adreslabel op kaart. Het is in dat geval niet nodig om het adres te structureren, een opsomming van zijn componenten volstaat. Dit is de zgn. adresvoorstelling.
MAGDA zal in de persoonsdiensten-02.02 een uitgebreide OSLO-adresvoorstelling implementeren en niet de volledige OSLO-structuur. Deze OSLO-adresvoorstelling bevat dezelfde data als het huidige MAGDA-adres. De structuur is echter vlakker. Daarnaast zal de uitgebreide OSLO-adresvoorstelling de nodige (BeSt Add) ID’s bevatten, waarmee, indien gewenst, het gestructureerd OSLO-adres kan opgevraagd worden via de webservices van BOSA of het Vlaamse adressenregister.
Door nu reeds over te schakelen naar deze nieuwe adresvoorstelling, worden nieuwe aanpassingen vermeden, na het invoeren van de BeSt Add-gegevens in 2020.
2.5 Toevoeging wettelijke informatietypes
Voor elke persoon in het Rijksregister worden verschillende informatiegegevens bijgehouden, onderverdeeld in verschillende informatietypes. Deze 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, zullen toegevoegd worden in de persoonsdiensten-02.02.
Dit heeft impact op onderstaande diensten:
- GeefPersoon
- GeefHistoriekPersoon
- PubliceerMutatiePersoon
2.6 Toevoeging extra data vanuit KSZ
Bij de Kruispuntbank Sociale Zekerheid (KSZ) is de extra persoonsinformatie opgesplitst in verschillende diensten. Wanneer je bijvoorbeeld de Geef(Historiek)Persoon-dienst raadpleegt via de KSZ, krijg je enkel de basisgegevens door. Om deze informatie uit te breiden - en daardoor meer in lijn te komen met de informatie die ontvangen wordt vanuit het Rijksregister - zullen ook de bijkomende KSZ-diensten, die informatie geven uit het wachtregister, over buitenlanders (beroepskaart, arbeidskaart, wettig verblijf), afstamming in dalende en stijgende lijn en identiteitsbewijzen, aangeroepen worden.
Deze uitbreiding heeft geen impact op de structuur van het XSD-schema. Er wordt enkel meer informatie doorgegeven bij het gebruik van ‘KSZ’ als bron, indien je daarvoor de nodige toelating(en) hebt.
Dit heeft impact op onderstaande diensten:
- GeefPersoon
- GeefHistoriekPersoon
Deze uitbreiding werd geïnitieerd vanuit Kind & Gezin. Indien je hierin interesse hebt, vragen we je om de MAGDA Helpdesk te contacteren via helpdesk.magda@vlaanderen.be.
3 Overschakelen?
Indien je in je business processen (tijdelijke) Belgische adressen van personen in de KSZ-registers (BIS-, RAD- en RAN-register) nodig hebt, is de overschakeling naar de nieuwe 02.02-diensten voor jou noodzakelijk. Afnemers die deze gegevens niet (onmiddellijk) nodig hebben, kunnen de overstap nog even uitstellen. Let wel, de huidige 02.00-diensten ondersteunen we tot september 2020. Alle afnemers zullen dus voor deze datum moeten aansluiten op de nieuwe diensten. De concrete timing zal dus afhankelijk zijn van afnemer tot afnemer.
Om de aansluitingen zo vlot mogelijk te laten verlopen, vernemen we graag of jullie de tijdelijke Belgische adressen van personen in de KSZ-registers (contactadres) nodig hebben en dus graag snel overschakelen naar de nieuwe diensten. Contacteer hiervoor de MAGDA Helpdesk via helpdesk.magda@kb.vlaanderen.be (graag voor 30 april 2019). We bekijken vervolgens met jou de concrete planning.
4 Documentatie
De specificaties van de nieuwe diensten zullen geleidelijk aan beschikbaar komen in de MAGDA Gebruikersomgeving (momenteel nog niet beschikbaar!). Je zal hier ook steeds de meest recente informatie over dit project terugvinden:
