IMPACTANALYSE MADGA 2.0 KSZ-SOA DIENSTEN

Transcriptie

1 /// Rapport IMPACTANALYSE MADGA 2.0 KSZ-SOA DIENSTEN Versie /// 1.0 Publicatiedatum ///

2 Informatie Vlaanderen /// Auteur: Elin Vanlierde Datum aanmaak: 18 augustus 2017 Datum afdruk: 28 augustus 2017 Interne bestandsnaam: Impactanalyse KSZ-SOA Documenthistoriek: Versie Opmerking Datum Auteur Status 0.1 Impactanalyse 22/08/17 Michaël Loedts Ontwerp 1.0 Revisie 28/8/2017 Elin Vanlierde Finale Versie Informatie Vlaanderen Hoofdzetel Boudewijnlaan 30, 1000 Brussel +32 (0) Regionale zetel Koningin Maria Hendrikaplein 70, 9000 Gent +32 (0) /// /// /Titel document/

3 /// Informatie Vlaanderen INHOUD Inhoud Inleiding Technische Achtergrond Afkortingen Status en planning Impact Analyse GeefPersoon Burgerlijke Staat/ Partner Adres/ AangifteAdresBuitenland Naamgegevens: splitsing Naamgegevens: overige Karakterset Fictieve postcodes Register Nieuwe uitzonderingen PubliceerMutatiePersoon Specifieke wijzigingen ZoekPersoonOpAdres ZoekPersoonOpNaam Specifiek: aantal resultaten CreëerBis Specifiek: Fonetische opzoeking GeefGezinssamenstelling Specifiek: Actuele gezinssamenstelling Specifiek: fictieve identificatienummers Nieuwe uitzondering GeefHistoriekGezinssamenstelling Specifiek: samenstelling gezin Specifiek: fictieve identificatienummers Nieuwe uitzondering GeefHistoriekPersoon Adres: historiek IT022 en IT /Titel document/ /// /// 13

4

5 /// Informatie Vlaanderen 1 INLEIDING De Kruispuntbank Sociale Zekerheid (KSZ) voerde een aantal wijzigingen door aan hun systemen. Die hebben een impact op de MAGDA-dienstverlening. Dit rapport bevat, op basis van de verkregen documentatie van de authentieke bron (KSZ), de impactanalyse van deze wijzigingen op de verschillende MAGDA 2.0 KSZ-SOA diensten. MAGDA-diensten die niet opgenomen zijn in dit rapport, ondervinden geen hinder van de wijzigingen. 2 TECHNISCHE ACHTERGROND De KSZ haalt haar persoonsgegevens uit het Rijksregister (RR), maar ook uit de registers voor personen die ze zelf beheren (BIS-register en/of RAD-register). De KSZ voerde enkel wijzigingen door aan de diensten die gegevens halen uit het Rijksregister. Dit zijn dan ook de enige die aangepast zijn, en ook een impact hebben op de MAGDA²-diensten. De XSD verkregen via MADGA²-diesnten blijft ongewijzigd, maar inhoudelijk kunnen er verschillen optreden. De KSZ gebruikte voor de consultatie van gegevens uit het Rijksregister de webservice WS70. Het Rijksregister ondersteunt de WS70 webservice echter niet langer. Daardoor moet de KSZ overgaan naar de webservice XM25 voor de opzoekingen op basis van het INSZ, naar de webservice XM40 voor de opzoeking op naam en naar de webservice XM36 voor de opzoeking op adres. Deze overgang heeft een impact op de inhoud van de gegevens, niet op de xsd van de webdiensten van de MAGDA-persoonsdiensten. Figuur 1: Dataflow via webservices van RR naar KSZ over MAGDA naar afnemer. De webservice WS70 van Rijksregister naar KSZ wordt stopgezet en vervangen door de websverices XM25, XM36 en XM40. /Titel document/ /// /// 13

6 Informatie Vlaanderen /// Figuur 2: Dataflow via batchbestanden van RR naar KSZ over MAGDA naar afnemer. De bestanden in het WS70 formaat van Rijksregister naar KSZ worden stopgezet en vervangen door bestanden in het XM25 formaat. De MAGDA persoonsdiensten gebruiken twee mogelijke versies van de KSZ diensten: de oudere SSDN versie en de meest recente SOA versie. In de MAGDA-diensten die de verschillende versies van diensten ondersteunen, geef je de gewenste versie aan met de bron parameter in de vraagstelling of werd de versie geconfigureerd tijdens de aansluitingsprocedure op het MAGDA-platform. De meeste klanten maken dus eenduidig gebruik van één van beide versies. Als je niet weet welke versie je gebruikt, zoek je dat op in de bronparameter van je vraag XSD. KSZ voor de KSZ SSDN versie van de dienst SOA voor de KSZ SOA versie van de dienst. Dit document handelt over de impactanalyse op de SOA versie van de KSZ diensten. 6 /// /// /Titel document/

7 /// Informatie Vlaanderen 3 AFKORTINGEN - BIS-register: Personen die niet ingeschreven zijn in het Rijksregister, maar toch een dossier hebben bij een Belgische openbare overheid, ongeacht of deze federaal, regionaal, provinciaal of lokaal is, worden bijgehouden in de kruispuntbankregisters ( het BIS-register ) van de KSZ. Het BIS-register is complementair en subsidiair aan het Rijksregister. Voor zover de betrokken natuurlijke personen niet beschikken over een Rijksregisternummer, kent de Kruispuntbank hen bij de inschrijving in het BISregister zelf een identificatienummer toe. Dit is het BIS-nummer. Het gebruik van het BIS-nummer is vrij en dus niet aan machtiging onderworpen. Consultatie van gegevens uit het BIS-register is aan een machtiging van het bevoegde sectoraal comité onderworpen. - RR: Rijksregister - KSZ: Kruispuntbank Sociale Zekerheid - RAD-register: Dit register houdt de gegevens bij van personen die ooit in het Rijksregister zijn ingeschreven, maar waarover het Rijksregister de gegevens niet meer actualiseert. Deze gegevens worden initieel verkregen van het Rijksregister en nadien bijgewerkt door de instellingen van de sociale zekerheid. - SSDN/SOA: Achterliggende KSZ-architectuur - XSD: beschrijving XML-bericht 4 STATUS EN PLANNING - Reeds op acceptatie beschikbaar - In productie stelling: 2 oktober IMPACT ANALYSE 5.1 GEEFPERSOON De persoon inhoudelijk zal na de migratie bij bepaalde gegevens verschillen met de persoon van voor de migratie. De XSD blijft echter ongewijzigd Burgerlijke Staat/ Partner Voor migratie Na migratie INSZ van de partner altijd aanwezig Indien persoon weduwnaar/weduwe (code 30) is, meestal geen INSZ en namen van de partner doorgegeven o Tenzij bij fictief INSZ o Voor gescheiden (code 40, 41, 50, 51): idem /Titel document/ /// /// 13

8 Informatie Vlaanderen /// Adres/ AangifteAdresBuitenland Voor migratie Indien geen voorlopig adres in het buitenland gekend maar wel het land, landcode tussen haakjes in het Tekstelement o Bijvoorbeeld: Land/NISCode: 109 Tekst: (109) Na migratie landcode in het Tekst-element wordt niet doorgegeven Naamgegevens: splitsing - Heeft betrekking op: Naam van de opgevraagde persoon Naam van partner in burgerlijke staat - KSZ splitst voornamen op spatie Voor migratie Laatste voornaam in 3 e Voornaamelement Voorlaatste voornaam in 2e Voornaamelement De andere voornamen in 1e Voornaamelement Na migratie Eerste voornaam in 1 e Voornaamelement Tweede voornaam in 2 e Voornaamelement Derde voornaam in 3 e Voornaam-element Alle andere voornamen komen niet terug Spaties mogelijk in 2 e en 3 e Voornaamelement Voorbeeld: Rijksregister WS70: Cathérine Marie Claire Renée Mélina Florence Wordt in GeefPersoon: 1 : Cathérine Marie Claire Renée 2 : Mélina 3 : Florence Voorbeeld: Antwoord Rijksregister (elke voornaam apart) 1 : Cathérine 2 : Marie Claire 3 : Renée 4 : Mélina 5 : Florence 6 : Elise Wordt in GeefPersoon 1 : Cathérine 2 : Marie Claire Renée 8 /// /// /Titel document/

9 /// Informatie Vlaanderen Naamgegevens: overige - Indien lengte namen binnen Rijksregister > 48 Naam wordt afgeknipt (door KSZ) + Uitzondering (zie Nieuwe uitzonderingen) DatumBegin zal aanwezig zijn voor de naamgegevens Karakterset Voor migratie Na migratie Beperkte tekenset > Rijksregister laat verschillende nieuwe tekens toe, bijv. Å Æ å æ(unicode Latin-1 Supplement) ă Ĉ ĉ Đ đ/ð ę ĝ Ğ ğ ģ ĥ ī ĺ Ł ņ œ Ŝ ŝ Ş ş Š Ţ Ż (Unicode Latin Extended-A) ǧ Ǩ ǵ ȳ (Unicode Latin Extended-B) Lijst is niet exhaustief! KZS converteert deze tekens zoals voorheen GeefPersoon kan al deze nieuwe tekens bevatten Fictieve postcodes - Rijksregister kent fictieve postcodes 1031, 1041, 1051, 1071 Echte postcode is 10x0 Voor migratie Na migratie Fictieve postcode wordt gegeven Echte postcode wordt gegeven Register Voor migratie De registercode 2 (bevolkingsregister) wordt altijd doorgegeven, ook voor Belgen door geboorte waarvoor deze code niet expliciet aanwezig is in het Rijksregister Na migratie De registercode 2 wordt enkel doorgegeven indien expliciet aanwezig in het Rijksregister. De register code is voor Belgen door geboorte meestal niet aanwezig. /Titel document/ /// /// 13

10 Informatie Vlaanderen /// Nieuwe uitzonderingen Code Omschrijving - Sinds aanpassing Rijksregister medio december, diplomatieke post als geboorteplaats (bug rijksregister) Nieuwe KSZ anomaliecode ongeldige (geboorte)locatie - MAGDA: Ongeldige (geboorte)locatie - Definitieve oplossing voor probleem met postcode 0 IT001 = Dienst vreemdelingenzaken (21099) Schijnhuwelijk (subregister 9 ) - Adresgegevens worden gefilterd Nieuwe KSZ warning fictief verblijfsadres gefilterd - MAGDA: Fictief verblijfadres gefilterd. - In XM25, blanco voornamen mogelijk Nieuwe KSZ anomaliecode blanco voornaam gefilterd - MAGDA: Blanco voornaam gefilterd Bestaande uitzondering - In XM25, (te) lange namen mogelijk o Nieuwe KSZ anomaliecode naam werd afgeknipt - MAGDA: Gegevens van de bron ingekort wegens te lang - In XM25, (Decl.:) mogelijk in de naam (anomalie, moet in IT013 staan) o Wordt gefilterd, nieuwe KSZ anomaliecode naaminhoud is ongeldig - MAGDA Naaminhoud is ongeldig - In XM25 is het mogelijk om een suppressiedatum te krijgen voor een actuele situatie (anomalie) - Gegevensgroepen: voornamelijk burgerlijke staat (met code 51) en subregister o Nieuwe anomaliecode situatie voor migratie bevat een einddatum - MAGDA: situatie voor migratie bevat een einddatum 10 /// /// /Titel document/

11 /// Informatie Vlaanderen 5.2 PUBLICEERMUTATIEPERSOON Heeft betrekking op het Persoon-object. Voor de impactanalyse, zie 5.1 GeefPersoon Specifieke wijzigingen - Geen specifieke wijzigingen op deze dienst 5.3 ZOEKPERSOONOPADRES Heeft betrekking op het Persoon-object (indien minstens één persoon in het RR gevonden werd). Voor de impactanalyse, zie Fout! Verwijzingsbron niet gevonden. Fout! Verwijzingsbron niet gevonden.. Ook is er een impact op de uitzonderingen (zie Nieuwe uitzonderingen). 5.4 ZOEKPERSOONOPNAAM Heeft betrekking op het Persoon-object (indien minstens één persoon in het RR gevonden werd). Voor de impactanalyse, zie Fout! Verwijzingsbron niet gevonden. Fout! Verwijzingsbron niet gevonden.. Ook is er een impact op de uitzonderingen (zie Nieuwe uitzonderingen) Specifiek: aantal resultaten - Het aantal resultaten uit het Rijksregister wordt beperkt tot 20 (vroeger 30) - Aantal resultaten uit KSZ-registers: nog steeds CREËERBIS CreeerBIS 2.0 zal bij creatie van een persoon een fonetische opzoeking uitvoeren bij het RR (en KSZ) ter controle of de persoon al dan niet bestaat. - Heeft betrekking op het Persoon-object (indien minstens één persoon in het RR gevonden werd). Voor de impactanalyse, zie Fout! Verwijzingsbron niet gevonden. Fout! Verwijzingsbron niet gevonden.. - Ook is er een impact op de uitzonderingen (zie Nieuwe uitzonderingen) Specifiek: Fonetische opzoeking - Bij een positieve fonetische opzoeking in het RR (dit ter controle of de te creëren persoon bestaat) zal het aantal gevonden personen beperkt zijn tot 20 (vroeger 30). - Het aantal personen die kunnen terugkomen vanuit de KSZ-registers is nog steeds 50 /Titel document/ /// /// 13

12 Informatie Vlaanderen /// 5.6 GEEFGEZINSSAMENSTELLING Heeft betrekking op het Persoon-object. Voor de impactanalyse, zie 5.1 GeefPersoon Ook is er een impact op de uitzonderingen (zie Nieuwe uitzonderingen) Specifiek: Actuele gezinssamenstelling - Het Rijksregister stelt in WS70 geen TI 400 (actuele gezinssamenstelling) meer ter beschikking - Samenstelling actuele gezinssamenstelling gebeurt achterliggend door KSZ, dit op basis van TI 140 (gezinshoofd) en TI 141 (gezinsleden) - Gevolg: anomalieën mogelijk waarvan Uitzondering blokkerend Specifiek: fictieve identificatienummers - Binnen een gezinssamenstelling kunnen nu ook fictieve identificatienummers (INSZ) voorkomen Nieuwe uitzondering Blokkerende uitzondering vanuit KSZ: Er is een overlap tussen de periodes van de gezinshoofden 5.7 GEEFHISTORIEKGEZINSSAMENSTELLING Heeft betrekking op het Persoon-object. Voor de impactanalyse, zie 5.1 GeefPersoon Ook is er een impact op de uitzonderingen (zie Nieuwe uitzonderingen) Specifiek: samenstelling gezin - Het Rijksregister stelt in WS70 geen TI 400 (gezinssamenstelling) meer ter beschikking - Samenstelling gezinssamenstelling gebeurt door KSZ, dit op basis van TI 140 (gezinshoofd) en TI 141 (gezinsleden) - Gevolg: anomalieën mogelijk waarvan Uitzondering blokkerend Specifiek: fictieve identificatienummers - Binnen een gezinssamenstelling kunnen nu ook fictieve identificatienummers (INSZ) voorkomen Nieuwe uitzondering Blokkerende uitzondering vanuit KSZ: Er is een overlap tussen de periodes van de gezinshoofden 12 /// /// /Titel document/

13 /// Informatie Vlaanderen 5.8 GEEFHISTORIEKPERSOON Heeft betrekking op het Persoon-object. Voor de impactanalyse, zie 5.1 GeefPersoon Ook is er een impact op de uitzonderingen (zie Nieuwe uitzonderingen) Adres: historiek IT022 en IT023 - Van IT022 (Verblijfplaats in het buitenland) en IT023 (Postadres in het buitenland) is historiek beschikbaar /Titel document/ /// /// 13