/// Rapport IMPACTANALYSE MAGDA 2.0 KSZ-SSDN DIENSTEN Versie /// 1.0 Publicatiedatum /// 28-8-2017 www.vlaanderen.be/informatievlaanderen
Informatie Vlaanderen /// Auteur: Elin Vanlierde Datum aanmaak: 18 augustus 2017 Datum afdruk: 28 augustus 2017 Interne bestandsnaam: Impactanalyse KSZ-SSDN Documenthistoriek: Versie Opmerking Datum Auteur Status 0.1 Impactanalyse 23/08/2017 Michael Loedts Ontwerp 1.0 Revisie 28/08/2017 Elin Vanlierde Finale versie Informatie Vlaanderen Hoofdzetel Boudewijnlaan 30, 1000 Brussel +32 (0)2 553 72 02 Regionale zetel Koningin Maria Hendrikaplein 70, 9000 Gent +32 (0)9 276 15 00 informatie.vlaanderen@vlaanderen.be 2 /// 11 28.08.17 /// /Titel document/
/// Informatie Vlaanderen INHOUD Inhoud... 3 1 Inleiding... 5 2 Technische Achtergrond... 5 3 Afkortingen... 7 4 Status en planning... 7 5 Impact Analyse... 7 5.1 Geefpersoon 02.00... 7 5.1.1 Burgerlijke staat/partner... 7 5.1.2 Adres/ AangifteAdresBuitenland... 8 5.1.3 Naamgegevens: splitsing... 8 5.1.4 Naamgegevens: lengte... 9 5.1.5 Landen en Belgische gemeente- en straatnamen... 9 5.1.6 Karakterset... 9 5.1.7 Fictieve postcodes... 10 5.1.8 Register... 10 5.2 PubliceerMutatiePersoon 02.00... 10 5.2.1 Specifieke wijzigingen/aandachtspunten... 10 5.3 ZoekPersoonOpAdres 02.00... 10 5.3.1 Specifieke wijzigingen/ Aandachtspunt... 10 5.4 ZoekPersoonOpnaam 02.00... 11 5.4.1 Specifieke wijzigingen/ Aandachtspunt... 11 5.4.2 Specifiek: aantal resultaten... 11 /Titel document/ /// 28.08.17 3 /// 11
/// 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-SSDN 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/ /// 28.08.17 5 /// 11
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. Met de MAGDA-diensten die de verschillende versies van diensten ondersteunen, geef je vanuit de applicatie die de MAGDA-webservices oproept, 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 SSDN versie van de KSZ diensten. 6 /// 11 28.08.17 /// /Titel document/
/// 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 2017 5 IMPACT ANALYSE 5.1 GEEFPERSOON 02.00 De persoon inhoudelijk zal na de migratie bij bepaalde gegevens verschillen met de persoon van voor de migratie. De XSD blijft echter ongewijzigd. 5.1.1 Burgerlijke staat/partner 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/ /// 28.08.17 7 /// 11
Informatie Vlaanderen /// 5.1.2 Adres/ AangifteAdresBuitenland 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) landcode in het Tekst-element wordt niet doorgegeven 5.1.3 Naamgegevens: splitsing Heeft betrekking op: Naam van de opgevraagde persoon Naam van partner in burgerlijke staat Familienaam: Teruggegeven in hoofdletters. Eerste Voornaam-element: Eerste voornaam voor personen in het KSZ-register, eerste en tweede voornaam voor personen in het rijksregister. Teruggegeven in hoofdletters. Tweede Voornaam-element: Tweede en volgende voornamen voor personen in het KSZ-register, niet ingevuld voor personen in het rijksregister. Teruggegeven in hoofdletters. De familienaam en de voornamen met de schrijfwijze in hoofd- en kleine letters teruggegeven worden voor personen in het Rijksregister Eerste voornaam Voornaam (1) Tweede voornaam Voornaam (2); Spaties mogelijk in tweede voornaam Alle andere voornamen komen niet terug Voorbeeld: RR: Cathérine Marie Claire Renée Mélina Florence Wordt in GeefPersoon: 1 : Cathérine Marie Claire Renée 2 : Mélina 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 8 /// 11 28.08.17 /// /Titel document/
/// Informatie Vlaanderen 5.1.4 Naamgegevens: lengte - Indien lengte namen binnen Rijksregister > 48 KSZ SSDN laat door GeefPersoon xsd heeft voor een naam -element een maximumlengte van 48 Gevolg: deze personen kunnen niet meer doorgegeven worden (validatie XSD faalt), een foutmelding wordt gegeven. 5.1.5 Landen en Belgische gemeente- en straatnamen Volledige naam in hoofdletters Eerste letter in hoofdletter, de rest in kleine letters 5.1.6 Karakterset - Rijksregister heeft verschillende nieuwe tekens toegevoegd - Geïmpacteerde gegevensgroepen: naam, voornamen, buitenlandse plaatsen - Conversie uitzondering: Namen uit de KSZ-registers komen nog steeds in hoofdletters terug Tekens die niet geconverteerd kunnen worden, worden gefilterd 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 /Titel document/ /// 28.08.17 9 /// 11
Informatie Vlaanderen /// 5.1.7 Fictieve postcodes - Rijksregister kent fictieve postcodes 1031, 1041, 1051, 1071 Echte postcode is 10x0 Fictieve postcode wordt gegeven Echte postcode wordt gegeven 5.1.8 Register De registercode 2 (bevolkingsregister) wordt altijd doorgegeven, ook voor Belgen door geboorte waarvoor deze code niet expliciet aanwezig is in het Rijksregister De registercode 2 wordt enkel doorgegeven indien expliciet aanwezig in het Rijksregister. De register code is voor Belgen door geboorte meestal niet aanwezig. 5.2 PUBLICEERMUTATIEPERSOON 02.00 Heeft betrekking op het Persoon-object. Voor de impactanalyse, zie 5.1 Geefpersoon 02.00. 5.2.1 Specifieke wijzigingen/aandachtspunten - Geen specifieke wijzigingen op deze dienst - Opgelet: naamgegevens lengte Persoon XSD heeft voor een naam -element een maxlengte van 48 Bijgevolg: indien vanuit KSZ een naam-element ontvangen wordt met een inhoud langer dan 48 karakters zal deze persoonsmutatie niet doorgegeven worden! 5.3 ZOEKPERSOONOPADRES 02.00 Heeft betrekking op het Persoon-object (indien minstens één persoon in het RR gevonden werd). Voor de impactanalyse, zie 5.1 Geefpersoon 02.00. 5.3.1 Specifieke wijzigingen/ Aandachtspunt - Geen specifieke wijzigingen op deze dienst - Opgelet: naamgegevens lengte Persoon XSD heeft voor een naam -element een maxlengte van 48 Bijgevolg: indien vanuit KSZ een naam-element ontvangen wordt met een inhoud langer dan 48 karakters zal deze persoonsmutatie niet doorgegeven worden! 10 /// 11 28.08.17 /// /Titel document/
/// Informatie Vlaanderen 5.4 ZOEKPERSOONOPNAAM 02.00 Heeft betrekking op het Persoon-object (indien minstens één persoon in het RR gevonden werd). Voor de impactanalyse, zie 5.1 Geefpersoon 02.00. 5.4.1 Specifieke wijzigingen/ Aandachtspunt - Geen specifieke wijzigingen op deze dienst - Opgelet: naamgegevens lengte Persoon XSD heeft voor een naam -element een maxlengte van 48 Bijgevolg: indien vanuit KSZ een naam-element ontvangen wordt met een inhoud langer dan 48 karakters zal deze persoonsmutatie niet doorgegeven worden! 5.4.2 Specifiek: aantal resultaten - Het aantal resultaten uit het Rijksregister wordt beperkt tot 20 (vroeger 30) - Aantal resultaten uit KSZ-registers: nog steeds 50 /Titel document/ /// 28.08.17 11 /// 11