Innehåll:
Inledning
Detta är svar på vanligt förekommande frågor om Personuppgiftstjänstens funktionalitet och teknik. Avsikten är inte att vara heltäckande när det gäller de regler och den informatik som finns för folkbokföringen i Sverige. Skatteverket förvaltar den källa, Navet, som Personuppgiftstjänsten grundar sig på. Svar på frågor kan finnas här https://www.skatteverket.se/foretagochorganisationer/myndigheter/informationsutbytemellanmyndigheter/navethamtauppgifteromfolkbokforing.4.18e1b10334ebe8bc80001754.html, alternativt så går det bra att skicka frågor direkt till Skatteverket navet.solna@skatteverket.se
Fråga: om jag vill veta mera om Personuppgiftstjänsten i syfta att ansluta en tjänst till den, var hittar jag information om funktionalitet och teknik?
- Ett snabbt sätt att få en överblick över vad Personuppgiftstjänsten erbjuder är att se på dessa övergripande filmer
https://www.youtube.com/playlist?list=PLofvkub1C51f0tS5queZoacObpcycCXXN - Det finns också en sammanfattande presentation
http://www.inera.se/globalassets/tjanster/personuppgiftstjansten/dokumentblock/presentationer/personuppgiftstjanst_sammanfattning.pdf - För den som vill integrera mot Personuppgiftstjänsten är den viktigaste tekniska beskrivningen de tjänstkontrakt som står till buds
http://rivta.se/domains/strategicresourcemanagement_persons_person.html
- Översiktliga förklaringar till de vanligast använda tjänstekontrakten finns i dessa filmer
https://www.youtube.com/playlist?list=PLofvkub1C51dlBeIFp_Qo9-DphCkf11JF - Finns det ett behov av att hämta aviseringsfiler från Personuppgiftstjänsten för att t ex ersätta Skatteverkets aviseringar, beskrivs detta här
https://confluence.cgiostersund.se/display/PU/Filhantering
och i en av filmerna som beskriver tjänstekontrakten
https://www.youtube.com/playlist?list=PLofvkub1C51dlBeIFp_Qo9-DphCkf11JF - Information om de senast tillagda funktionerna i Personuppgiftstjänstens tjänstekontrakt hittar du här
https://confluence.cgiostersund.se/display/PU/Versioner
- Inera har tagit fram ett dokument som beskriver hur e-tjänsterna ska hantera ReservID när man använder Personuppgiftstjänstens tjänstekontrakt, inklusive hur länkade identiteter ska hanteras.
Vägledning för användning av personidentifierare i nationell samverkan - Här kan man kan hitta ytterligare information om tjänsten
https://www.inera.se/Fordjupning/fordjupad-information-om-vara-tjanster/personuppgiftstjansten/
Fråga: vilka format på personidentiteten stödjer Personuppgiftstjänsten och vad är skillnaden mellan dem?
- Personuppgiftstjänsten stödjer ett antal format: personnummer, samordningsnummer, nationell Reservidentitet och även lokala reservidentiteter, här kan du läsa mer
https://confluence.cgiostersund.se/display/PU/Identitetsformat - Det går också att lägga till nya format genom att skicka in ett ärende till kundservice@inera.se. Finns inget OID för det nya formatet kommer Inera att sätta ett. Vi föredrar att formatbeskrivning görs i ett reguljärt uttryck.
Fråga: Skatteverket har sina benämningar och Personuppgiftstjänsten har andra, var hittar jag översättningen mellan Skatteverket och Personuppgiftstjänsten?
- Informationsspecifikationen för Personuppgiftstjänsten innehåller mappning mellan Personuppgiftstjänsten och Skatteverkets tjänst Navet. Via länken nedan hittar du dokumentet.
- http://rivta.se/domains/strategicresourcemanagement_persons_person.html
Fråga: hur ska befintliga nationella tjänster som inte hanterar samtliga typer av personidentifierare i dagsläget förändras?
Befintliga nationella tjänster som Inera förvaltar kommer att anpassas medstöd för nationellt ReservID, dvs. få stöd för de nationellt accepterade PNR (personnummer), SNR (samordningsnummer), och NRID (nationellt ReservID)
Fråga: kommer nationella e-tjänster, exempelvis NPÖ göras ett anrop per tjänstekontrakt per PNR+SNR+NRID?
- Nej, dessa e-tjänster kommer att följa den generella riktlinjen enligt Vägledning för användning av personidentifierare i nationell samverkansarkitektur. http://rivta.se/documents/ARK_0049/
- Riktlinjen innebär i praktiken att e-tjänst som agerar tjänstekonsument (t.ex. NPÖ) ska anropa tjänstekontraktet enbart en gång med angivande av personens huvudidentitet (vilken fås via Personuppgiftstjänst).
Fråga: hur påverkas engagemangsindex (EI)? Kommer samtliga format stödjas och ska EI skapas även för NRID? Rensas EI med NRID när koppling har gjorts med SNR/PNR?
Engagemangsindex stödjer att registrera indexposter med PNR, SNR eller NRID som nyckel. Dokumentationen i tjänstedomän för EI har uppdaterats för att tydliggöra stödet för NRID.EI-poster i de aktuella tjänstedomänerna ska skapas även då NRID är huvudidentiteten.
http://rivta.se/domains/domain-itintegration_engagementindex.htmlFör detaljer om regelverket se tjänstekontraktsbeskrivning för Engagemangsindex .
Regelverk kopplat till tjänstedomänen för Engagemangsindex reglerar vad tjänstekonsumenter/producenter behöver stödja relativt NRID, samt hur hantera indexuppdateringar när individens kopplingsinformation ändras, t.ex. då det sker en lokal koppling av NRID till PNR för en individ.
Fråga: finns något tänkt kring att propagera ut förändringar på persons huvudidentitet till de olika parterna?
Huvudregeln är att uppgift om huvudidentitet aktualiseras genom uppslag till Personuppgiftstjänst. Uppgift om huvudidentitet ingår i den minsta valbara svarsprofilen, dvs. det går att minimera den information som behöver hämtas. Normalt mellanlagras uppgifterna i en cache hos det system som efterfrågar dem för att minimera antalet externa anrop.
Det här är ett område som förvaltningen av Inera Personuppgiftstjänst kommer att följa för att se om ytterligare tjänster efterfrågas, och i så fall är möjliga att realisera både juridiskt och tekniskt.Via Personuppgiftstjänstens aviseringsflöde kan alla ändringar av huvudidentitet utläsas, för de personer som finns inom befolkningsområdet (i praktiken de områden man avtalat om att få aviseringar på). I Personuppgiftstjänstens nästa release (2019) kommer aviseringar av ändrade personposter även omfatta personer som endast har NRID som huvudidentitet, samt kontaktuppgifter.
Fråga: vad skiljer Ineras aviseringsflöde gentemot Skatteverkets?
- Från och med Personuppgiftstjänst 4.0 kommer Ineras aviseringsflöde även inkludera kontaktuppgifter och personer med reservidentitet, vilket inte finns någon motsvarighet till hos Skatteverket.
- Personuppgiftstjänstens aviseringsflöde bygger på användning av tjänstekontrakt där verksamheten agerar tjänstekonsument. Presentationen beskriver summariskt aviseringsflödet som gäller från och med 4.0. Aviseringsflöde 4.0
- En detalj med Personuppgiftstjänstens aviseringsflöde från 4.0 är att hela svaret överförs i en fil, därför är antal filreferenser i svaret frånGetFilesForOrderId lika med ett.
- Se release notes för Personuppgiftstjänsten för mera detaljer https://confluence.cgiostersund.se/display/PU/Versioner.
Fråga: hur skapas ett nationellt Reservid (NRID)?
- Personuppgiftstjänsten genererar ett nationellt Reservid, se https://confluence.cgiostersund.se/display/PU/Nationellt+Reservidformat. Se Tjänstkontraktsbeskrivningen för hur man använder tjänstkontrakt för detta ändamål http://rivta.se/domains/strategicresourcemanagement_persons_person.html
Fråga: tjänsten ska kunna hantera bilder som bilagor när man skapar ReservID men det står inte i tjänstekontraktsbeskrivningen hur det går till, står det någon annanstans?
- För att lägga till bilder så använder man en kombination av tjänstekontrakt och REST-tjänster. Beskrivningen för hur det går till finns här https://confluence.cgiostersund.se/display/PU/Filhantering
Fråga: vad menas med linkedIdentity och primaryIdentity? Dessa refereras till i Tjänstekontraktsbeskrivningen http://rivta.se/domains/strategicresourcemanagement_persons_person.html
- De används för för att koppla olika identiteter till varandra, t ex om det finns en koppling mellan ett personnummer och ett nationellt Reservid.
- Flaggan primaryIdentity indikerar om identiteten är en huvudidentitet. Detta är speciellt viktigt att notera eftersom det kan finnas flera länkade identiteter men bara en av dem är en huvudidentitet.
Fråga: i kontraktet getPersonsForProfile så kan man välja om man vill ha exakt den identitet som man efterfrågar genom att sätta ignoreReferredIdentity till true, om man vill ha huvudidentiteten sätts flaggan till false. Hur fungerar detta med SearchPersonsForProfile och -Order?
- Kontrakten returnerar alltid de eftersökta identiteterna via det villkor man sätter i queryLanguage, dvs som om ignoreReferredIdentity är satt till true i anropet.
Fråga: hur hanteras koppling av NRID när inget SNR/PNR håller ihop dessa? Finns risk att många NRID inte blir kopplade?
- NRID kan i tjänsten kopplas till PNR, SNR eller annat NRID (vilket blir den nya huvudidentiteten). Som stöd till verksamheten att återsöka samma individ trots avsaknad av PNR/SNR, finns i tjänsten sökbar information med legitimeringsuppgifter (passnummer eller dylikt), namn, adress, ålder, kön mm.
- Det finns också ett gemensamt verksamhetsramverk som bl.a. syftar till att ge vägledning till hur hantera personidentifiering och koppling av personidentifierare. http://www.inera.se/globalassets/tjanster/personuppgiftstjansten/dokumentblock/ramverk/nationellt_ramverk_for_hantering_av_reservidentiteter_version_1.1.pdf
Fråga: finns det en fördröjning när kopplingen görs?
- Nej, när kopplingen är gjord så finns informationen tillgänglig i Personuppgiftstjänsten.
Fråga: går det att registrera lokala reservidentiteter i Personuppgiftstjänsten och koppla dessa? Ska man göra det?
- Huruvida man ska överföra befintliga lokala kopplingar mellan personidentifierare eller ej till den gemensamma tjänsten är primärt en verksamhetsfråga.Det finns dock funktioner i Personuppgiftstjänsten för att registrera lokala kopplingar, både i användargränssnitt och i tekniska systemgränssnitt (tjänstekontrakt för koppling).
- Det finns också ett gemensamt verksamhetsramverk som bl.a. syftar till att ge vägledning till hur hantera personidentifiering och koppling av personidentifierare. http://www.inera.se/globalassets/tjanster/personuppgiftstjansten/dokumentblock/ramverk/nationellt_ramverk_for_hantering_av_reservidentiteter_version_1.1.pdf
- Kopplingarna i Personuppgiftstjänsten kan endast göras till de nationellt accepterade PNR, SNR eller NRID. En lokal reservidentitet kan alltså kopplas till personens huvudidentitet, men inte kopplas till en annan lokal reservidentitet i Personuppgiftstjänsten. Om PNR eller SNR saknas, kräver en koppling av en lokal reservidentitet alltså uttag av ett NRID.
- I tjänstekontraktsbeskrivningen hittar du information om de tekniska gränssnitten.
http://rivta.se/domains/strategicresourcemanagement_persons_person.html - Se även filmer för att använda tjänstens administrationsgränssnitt för att koppla identiteter.
https://www.youtube.com/playlist?list=PLofvkub1C51e0kCIguNHg6WD7NYGe4Dly
Fråga: hur samexisterar de kopplingar som Skatteverket gör i folkbokföringen med de kopplingar som görs i tjänsten?
- Personuppgiftstjänsten håller reda på kopplingar som görs av Skatteverket och de kopplingar som görs av verksamheten. I filmen som visar hur man använder administrationsgränssnittet för att koppla identiteter finns det exempel som visar på hur tjänsten håller reda på kopplingar och alltid har en huvudidentitet för en person.
https://www.youtube.com/playlist?list=PLofvkub1C51e0kCIguNHg6WD7NYGe4Dly
Fråga: hur hanterar Skatteverket felaktiga kopplingar mellan samordningsnummer och personnummer?
- Kopplingen tas bort av Skatteverktet och samordningsnummret blir åter gällande.
Fråga: Aktör (actor) ska anges för vissa kontrakt men fältet kan också utelämnas. Vad är tanken med det?
- När en invånare via 1177 lägger in sina kontaktuppgifter agerar invånaren utan att tillhöra någon organisation, då kan aktör utelämnas. När t ex en vårdorganisation gör någon uppdatering i tjänsten så ska aktör finnas med.
Fråga: hur hanteras personer med skyddad identitet när personen har flera olika personidentifierare?
- Personuppgiftstjänsten kontrollerar med hjälp av information från Skatteverkets Navet om personen har fått en sekretessmarkering i folkbokföringen. I dessa fall lämnas inte känsliga uppgifter ut vid uppslag mot Personuppgiftstjänsten och det signaleras till det verksamhetssystem som används för uppslag att sekretess gäller kring denna person.
- Från och med Personuppgiftstjänst 4.0 kommer det att vara möjligt att få ut kompletta uppgifter även för personer med sekretessmarkering, om det finns ett verksamhetsbehov.
Fråga: enligt tjänstekontraktsbeskrivningen returneras länskod för sekretessmarkerade personer, blir det 99 när en sekretessmarkerad person flyttar till annat län?
- Nej, Personuppgiftstjänsten returnerar 01-25 som länskod. 99 aviseras visserligen till den region som som personen flyttar ifrån men eftersom Personuppgiftstjänsten får alla aviseringar så kommer det i slutändan bli 01-25.
Fråga: har fall med nytt personnummer, efter t.ex. byte av juridiskt kön, beaktats? Kan även vara kombinerat med skyddad identitet.
- Via Skatteverkets Navet får Personuppgiftstjänsten uppgift om ev. byten av personnummer, tidigare personnummer blir då ett s k hänvisningsnummer kopplat till personens nya huvudidentitet. Personuppgiftstjänsten speglar alltså här uppgifterna i folkbokföringen.
- Finns en sekretessmarkering i folkbokföringen för personen slår den också till i Personuppgiftstjänsten.
- Från och med Personuppgiftstjänst 4.0 kommer det att vara möjligt att få ut kompletta uppgifter även för personer med sekretessmarkering, om det finns ett verksamhetsbehov.
- Noteras kan att vid särskilt allvarliga hot kan person få byta till fingerade personuppgifter med nytt personnummer. I dessa sällsynta fall finns ingen information om bytet i vare sig Skatteverkets Navet eller i Personuppgiftstjänsten.
Fråga: om man ska t ex till en slutanvändare visa vilket kön som en person har, vilken information som finns i Personuppgiftstjänsten ska jag då använda?
- Personuppgiftstjänsten hantererar kön lite olika beroende på identitet, se kapitlet som handlar om kön i dokumentet nedan
https://confluence.cgiostersund.se/pages/viewpage.action?pageId=159408113
Fråga: hur får nyfödda ett nytt personnummer och namn?
- Inera förvaltar en tjänst som heter Födelseanmälan där man via ett journalsystem, som ansluts till tjänsten Födelseanmälan, elektroniskt kan anmäla ett barns födelse och som svar få tillbaka ett personnummer, se https://www.inera.se/tjanster/Fodelseanmalan
- Förnamn måste föräldrarna anmäla till Skatteverket.
- Beroende på vilka som är föräldrar och deras status vad gäller giftemål får barnet ett efternamn, regler för detta finns i namnlagen https://www.riksdagen.se/sv/dokument-lagar/dokument/svensk-forfattningssamling/lag-20161013-om-personnamn_sfs-2016-1013
Fråga: vid avregistreringsorsak AV, vad står avregistreringsdatumet för då?
- I detta fall är avregistreringsdatumet lika med dödsdatum.
- Observera att Personuppgiftstjänsten även stödjer Anträffad död https://confluence.cgiostersund.se/display/PU/3.0.5+Release+Notes
Fråga: vid avregistrering ser det ut som avregistreringsorsak (deregistrationReasonCode) och avregistreringsdatum (deregistrationDate) är optionella i svaret från t ex GetPersonsForProfile. När kan det inträffa?
- Personuppgiftstjänsten följer Skatteverkets regler för detta, som säger att dessa fält kan utelämnas i svaret men i praktiken sker detta aldrig, dock kan avregrestringsdatum vara 0.
Fråga: stödjer Personuppgiftstjänsten fälten Anträffad död och Skyddad folkbokföring som Skatteverket införde 2019-01-01?
- Ja, se https://confluence.cgiostersund.se/display/PU/3.0.5+Release+Notes för detaljer.
Fråga: hur påverkas relationer (relationship) vid avregistrering?
- Avregistrering påverkar inte relationer för någon typ av avregistrering, oavsett om den görs av Personuppgiftstjänsten själv eller Skatteverket. Det enda undantaget är avregistreringsorsaken GN (Skatteverket) från gammalt tll nytt personnummer, då endast personnummer och namn finns kvar.
Fråga: i vilka fall saknas länskod (countyCode)?
- Personposter med ReservID och Samordningsnummer samt personer som är avregistrerade saknar länskod.
- En sekretessmarkerad person har 01-25 eller 99 som länskod.
Fråga: i vilka lägen kan civilstånd (maritalStatus) utelämnas i svaret på tjänstekontraktet getPersonsForProfile?
- Personuppgiftstjänsten följer Skatteverkets aviseringsfiler och där kan teoretiskt civilstånd utelämnas. I praktiken sker detta aldrig, civilstånd finns alltid för alla folkbokföringsposter, med civilståndskod (maritalStatusCode).
- Civilståndsdatum (maritalStatusDate) finns för alla personposter från Skatteverket, utom för personer med civilståndskod lika med OG (ogift).
Finns det historisk information om personer, t ex var de har bott tidigare?
- Via Personuppgiftstjänsten kan man få ut den historiska information som finns i folkbokföringsregistret. Tjänsten har ingen egen historik. Tjänstekontraktet för Personuppgiftstjänsten är konstruerat så att via en profilhantering så kan man styra hur mycket som tjänsten ska returnera efter anrop. Detta finns beskrivet i tjänstekontraktsbeskrivningen
http://rivta.se/domains/strategicresourcemanagement_persons_person.html
Fråga: är tanken att NRID ska "buffras" lokalt dvs. att ett antal NRID tas ut i förväg i händelse av katastrof- och nödsituationer?
Alla verksamheter ska ha lokala rutiner för driftstopp och katastrof- och nödsituationer, så det är primärt en verksamhetsfråga.
Det kommer vara möjligt för verksamheterna att ta ut ett antal NRID i förväg för att använda i katastrof- och nödsituationer. Dessa tas alltid ut via den nationella Personuppgiftstjänsten.
När mer information om personerna som tilldelats en sådan NRID framkommit, kan uppgifterna kompletteras i Personuppgiftstjänsten.
Det finns också ett gemensamt verksamhetsramverk som bl.a. syftar till att ge vägledning för detta. http://www.inera.se/globalassets/tjanster/personuppgiftstjansten/dokumentblock/ramverk/nationellt_ramverk_for_hantering_av_reservidentiteter_version_1.1.pdf
Fråga: hur realiseras uppdatering av patiententens kontaktuppgifter via 1177? När är de tillgängliga för vården?
- Det finns specifika tjänstkontrakt (de som innehåller ordet "contact") som ska användas för uppdatering av patientens kontaktuppgifter. Se http://rivta.se/domains/strategicresourcemanagement_persons_person.html
- Kontaktuppgifterna lagras i Personuppgiftstjänsten och blir efter uppdatering omedelbart tillgänglig för vårdsystemen via tjänstekontrakt för läsning.
Fråga: I tjänstekontraktsbeskrivningen för UpdatePersonContactInformation så är är kardinaliteten för versionToUpdate 0..1 trots att det står att man ska ange den, hur fungerar det?
- versionToUpdate måste alltid anges för kontraktet UpdatePersonContactInformation. Annars får man ett fel tillbaka. Tjänstekontraktsbeskrivningen kommer att korrigeras i nästa majorversion.
Fråga: i tjänstekontraktsbeskrivningen finns fältet GivenNameIndicator, motsvarande Skatteverkets Tilltalsnamnsmarkering. Värdemängden är 10-99 som beskriver vilka förnamn som är tilltalsnamn. Förutom det som står i informationsspecifikationen, finns det andra restriktioner kring värdemängden?
- Den andra siffran är antingen lika med 0 eller har ett värde som är större än den första siffran. Dvs värden som 51 förekommer inte. 10, 16 och 89 är värden som kan förekomma.
Fråga: Viss informatik i informationsspecifikationen, t ex koder, är hämtad från Skatteverket, var hittar jag mera information?
- Personuppgiftstjänsten använder sig av Navet som källa för personuppgiftstjänsten. Via länk nedan hittar du mera information.
https://www.skatteverket.se/foretagochorganisationer/myndigheter/informationsutbytemellanmyndigheter/navethamtauppgifteromfolkbokforing.4.18e1b10334ebe8bc80001754.html
Fråga: I informationsspecifikationen finns en bild på informationsmodellen men den är svårläst, finns motsvarande bild i bättre upplösning?
Klicka för bättre upplöst bild nedan
Fråga: finns det någon test-suite?
- Ja se mockservice för GetPersonsForProfile
Mockservice GetPersonsForProfile