...

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 zgn. 'big bang' (zie ook 3. Migreren?).

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:

...

Door nu reeds over te schakelen naar deze nieuwe adresvoorstelling, worden nieuwe aanpassingen vermeden, na het invoeren van de BeSt Add-gegevens in 2020.

Een vergelijking van de mapping voor de hoofdverblijfplaats tussen de GeefPersoon 2.0 en GeefPersoon 02.02 is te vinden in onderdeel "OSLO adressenstructuur" op de pagina  Verschillen met vorige versie.

2.5      Toevoeging wettelijke informatietypes

...

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. Daarnaast is het oproepen van de basisgegevens ook een optionele opvraging geworden bij de KSZ. Het is echter noodzakelijk om bij het gebruik van 'KSZ' als bron minimaal 1 element onder OpvragingenKSZ aan te duiden in de vraag.

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. Dit om het mogelijk te maken om eerst de basisgegevens op te vragen en daarna, gescheiden, extra informatie op te vragen over deze persoon zonder dat de basis persoonsgegevens opnieuw moeten opgevraagd.
Indien je hierin interesse hebt, vragen we je om de MAGDA Helpdesk te contacteren via helpdesk.magda@vlaanderen.be.

3        

...

Migreren?

KSZ plant de 'big bang', de migratie van de Belgische adressen uit 'hoofdverblijfplaats' naar 'contactadres', op 27 september 2019. De uitrol zal starten om 17u, de gegevensmigratie zal aansluitend starten en zal het ganse weekend in beslag nemen. De diensten blijven beschikbaar zowel voor consultatie als voor creatie en bijwerkingen, maar bijwerkingen van tijdelijke Belgische adressen zullen falen voor data die nog niet gemigreerd zijn.

Dit betekent dat in principe afnemers die voor die datum niet naar de nieuwe 02.02-diensten zijn gemigreerd, de Belgische adressen van personen uit het BIS- of RAD-register niet meer kunnen raadplegen, geen BIS-nummers meer kunnen aanmaken met een Belgisch adres en geen hoofdverblijfplaats meer kunnen bijwerken met een Belgisch adres. Echter om elke onderbreking in de dienstverlening te vermijden, heeft KSZ eind augustus 2019 beslist om alsnog hun bestaande diensten, waarvan de MAGDA-02.00-diensten gebruik maken, aan te passen, opdat ze bijna zoals "nu werken", ook na de migratie van de Belgische adressen naar het blok contactadres. Bijna, omdat er niettemin een aantal beperkingen bestaan, zoals het feit dat de raadplegingsdiensten van de historiek nooit rekening houden met de contactadressen in de historiek van de hoofdverblijfplaats of dat het niet mogelijk is om een adres bij te werken met een Belgisch adres wanneer er reeds een adres in het buitenland bestaat.

GeefPersoon-02.00 en GeefHistoriekPersoon-02.00

• bij de raadpleging van een BIS/RAD-nummer met enkel een contactadres, wordt dit contactadres opgestuurd;
• bij de raadpleging van een BIS/RAD-nummer met enkel een verblijfsadres, wordt dit verblijfsadres opgestuurd;
• bij de raadpleging van een BIS/RAD-nummer met een verblijfsadres én een contactadres, wordt enkel het verblijfsadres opgestuurd;

GeefHistoriekPersoon-02.00

• bij de raadpleging van de historiek van een BIS/RAD-nummer, worden enkel de adressen in het buitenland verstuurd. Het is immers veel te complex om een historiek aan te maken met adressen in het buitenland en met contactadressen. De diensten “historiek” worden dus niet aangepast en compatibel gemaakt.

ZoekPersoonOpNaam-02.00

• bij de fonetische opzoeking is er geen impact, het (contact)adres is hierbij niet van belang
• er gebeurt een "verrijking" van de resultaten met de personen alsof ze geconsulteerd werden, dus de mapping van het contactadres naar adres zal gebeuren zoals hierboven beschreven voor GeefPersoon-02.00.

ZoekPersoonOpAdres-02.00

• geen impact, geeft enkel resultaten terug van personen die hun huidige hoofdverblijfplaats in België hebben (Rijksregister).

CreëerBIS-02.00

• bij de aanmaak van een BIS-nummer wordt, wanneer de aanvrager een Belgisch adres aangeeft, dit adres ingebracht in het dossier van het BIS-nummer als een contactadres van het type “onbepaald”.

WijzigKSZPersoon-02.00

• indien men bij de bijwerking een adres in het buitenland wenst toe te voegen/te wijzigen, wordt deze aanvraag aanvaard (volgens de bestaande voorwaarden) en indien er een contactadres bestaat, blijft dit adres ongewijzigd en actief.
• indien men bij de bijwerking een adres in België wenst toe te voegen/te wijzigen en er geen adres in het buitenland en geen contactadres bestaat of indien er geen adres in het buitenland maar wel een contactadres bestaat, dan wordt de aanvraag aanvaard (volgens de bestaande voorwaarden).
• indien men bij de bijwerking een adres in België wenst toe te voegen/te wijzigen en er een adres in het buitenland bestaat, dan wordt de aanvraag geweigerd. 

PubliceerMutatiesPersoon-02.00

• bij aanmaak/wijziging van een verblijfsadres en zelfs indien er een contactadres bestaat, wordt een mutatie met het verblijfsadres verstuurd;
• bij aanmaak /wijziging van een contactadres, terwijl er reeds een verblijfsadres bestaat, wordt geen mutatie verstuurd;
• bij wijziging van een contactadres en indien er geen verblijfsadres bestaat, wordt een mutatie verstuurd.

Samengevat, het verblijfsadres primeert op het contactadres maar er worden mutaties verstuurd in verband met het contactadres indien er geen verblijfsadres bestaat.

Tijdens de migratie van de Belgische adressen, worden mutaties m.b.t. adreswijzigingen verstuurd, ook al blijkt er niets gewijzigd te zijn.

Indien je in je business processen dus (tijdelijke) Belgische adressen van personen in de KSZ-registers (BIS-, RAD- en RAN-register) nodig hebt, is de overschakeling het aangeraden zo snel mogelijk te migreren 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 02.02-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  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 zijn beschikbaar komen in de MAGDA Gebruikersomgeving (momenteel nog niet beschikbaar!). Je zal hier ook steeds de meest recente informatie over dit project terugvinden:

• Algemene informatie
• XSD’s
• Handleidingen

5         Vragen of problemen?

Vragen of problemen m.b.t. de 02.02-diensten kunnen gemeld worden via de Kruispuntbank Vlaanderen Service Desk – ‘testing persoonsdiensten-02.02’: (https://vlaamseoverheid.atlassian.net/servicedesk/customer/portal/9/group/13/create/142).