Vad är Personuppgiftstjänsten

Inera Personuppgiftstjänst är en nationell infrastrukturtjänst som innehåller tre informationsmängder:

  1. Folkbokföringsuppgifter från Skatteverket (Navet), vilket till exempel omfattar namn och adressuppgifter till privatpersoner.

  2. Kontaktuppgifter till privatpersoner, till exempel telefon och epost, vilka insamlas genom samtycke.

  3. Reservidentiteter för personer där personnummer eller samordningsnummer är okänt eller saknas. Stöd finns för nationella reservidentiteter samt för lokala reservidentiteter.

De tre informationsmängderna tillgängliggörs aktörer inom hälso- och sjukvård, förutsatt att de uppfyller Ineras krav för att bli kund till Personuppgiftstjänsten. Speciell hänsyn tas till behandling av skyddade personuppgifter.

Syftet med Personuppgiftstjänsten

Många vård- och omsorgssystem och andra kommunala eller statliga system har behov av att hämta uppgifter om personer, som till exempel namn, adress, personnummer och kontaktuppgifter. Tidigare har detta ofta behövt ske via egna lokala personuppgiftstjänster, implementerade med egen arkitektur, informatik och funktionalitet - som dessutom har egna direktkopplingar mot Skatteverket. Information om kontaktuppgifter och reservidentiteter, för personer som saknar personnummer eller samordningsnummer, har byggts upp lokalt i många vårdinformationssystem och andra system, utan gemensam standard. Sammantaget är detta kostsamt, resurskrävande och gör det svårt att skapa samverkan mellan olika regioner.

Genom att ha en gemensam tjänst skapar vi istället en gemensam informatik, funktionalitet och kompetenscenter kring personuppgifter, kontaktuppgifter och reservidentiteter. Stöd för lokala reservidentiteter och en kopplingsfunktion gör att befintliga system kan anpassas gradvis till att använda nationella reservidentiteter. En beskrivning av de format som tjänsten stödjer för personidentiteter finns här.

Med en gemensam tjänst kan vi säkerställa följsamhet till standarder enligt internationella mönster och hög aktualitet för uppgifterna. Förutsättningarna ökar också att få en hög tillgänglighet till uppgifterna som ska stödja landets alla vård- och omsorgssystem. Det är också möjligt att samverka i regionala och nationella system.

Hur tjänsten görs tillgänglig

Åtkomst till Personuppgiftstjänsten ges via den Nationella Tjänsteplattformen (NTjP) som förvaltas av Inera. Genom denna plattform erbjuder Personuppgiftstjänsten ett flertal webbtjänster att anropa, vilka på Inera-språk kallas Tjänstekontrakt. Kommunikation med tjänstekontrakten görs via tekniken SOAP och anrop och svar följer standarden “Regler för Ineroperabilitet inom Vården” (RIV) som också förvaltas av Inera.

En komplett lista på Personuppgiftstjänstens tjänstekontrakt redovisas på hemsidan för RIV: rivta.se/tkview/#/domain/strategicresourcemanagement:persons:person

  • Notera där att det går att välja Domänversion högst upp på sidan. Detta eftersom det finns äldre versioner av Personuppgiftstjänstens tjänstekontrakt som lever parallellt med de senast tillgängliga versionerna. Som ny kund som ansluter mot Personuppgiftstjänsten bör ni välja den nyaste, högsta, versionen av Personuppgiftstjänsten om inte särskilda skäl finns.

  • Tjänstekontrakten beskrivs i enlighet med standarden för RIV genom dokumenten Informationsspecifikation (IS), vilken är verksamhetsnära, samt Tjänstekontraktbeskrivning (TKB) vilken är mer tekniknära. Dessa dokument finns att ladda ned längst ned på hemsidan för RIV enligt länk ovan.

  • De mest tekniska filerna som beskriver tjänstekontrakten, schemafilerna, finns tillgängligga i respektive domänversions “Releasepaket” vilket är nedladdningsbart längst ned på hemsidan för RIV enligt länk ovan. På samma sida finns även en länk till “Källkod” vilket är online-repositoryt för Personuppgiftstjänstens releaser.

  • Observera att det är upp till de organisationer som ansluter till Inera Personuppgiftstjänst att bygga upp och vidmakthålla kompetens inom RIV för att säkerställa att kommunikationen med tjänsten görs på ett korrekt sätt.

Läs mer om Nationella Tjänsteplattformen (NTjP): Nationella tjänsteplattformen och tjänstekontrakt - Öppen info: NTjP - Confluence (atlassian.net)

Läs mer om Tjänstekontrakt: Vad är tjänstekontrakt? - Öppen info: Tjänstekontrakt - Confluence (atlassian.net)

Som ett komplement till tjänstekontrakten erbjuder Personuppgiftstjänsten även ett antal webbtjänster som ej formellt följer RIV och därför tillgängliggörs utanför NTjP, vilkas syften är att möjliggöra bulkslagningar av stora informationsmängder samt hantering av bilagor på ett sätt som RIV ej har stöd för. Kommunikation med dessa webbtjänster görs via tekniken REST, och de dokumenteras på följande sida: Filhantering - Öppen info: Personuppgiftstjänsten - Confluence (atlassian.net)

Läs mer om versionshantering och end of life för Personuppgiftstjänstens tjänstekontrakt och REST-tjänster: Livscykel för versioner - Öppen info: Personuppgiftstjänsten - Confluence (atlassian.net)

Exempel på användningsfall

Beroende på behoven hos verksamheten som ansluter till Personuppgiftstjänsten kan olika typer av anrop göras, och för vissa användningsfall behöver flera av tjänsterna användas i en kedja. Nedan visas fyra sätt att hämta personposter, det vill säga information om personer som finns registrerade i personuppgiftstjänsten.

image-20240424-120553.png
Fall 1: Användaren känner till ett id-nummer (personnummer, samordningsnummer eller reservidentitet) och vill hämta uppgifter från Personuppgiftstjänsten om denna specifika person. Det aktuella tjänstekontraktet ger dock även möjliget att hämta uppgifter på upp till 500 id-nummer samtidigt.
För detta användningsfall krävs endast ett anrop mot tjänstekontraktet GetPersonsForProfile.
image-20240424-121914.png
Fall 2: Användaren söker efter en eller maximalt 500 personer som uppfyller vissa kriterer. Kriterierna kan vara till exempel namn, bostadslän/kommun, födelsedatum eller del av id-nummer.
För detta användningsfall krävs endast ett anrop mot tjänstekontraktet SearchPersonsForProfile.

Förutom de fyra sätten ovan att hämta personposter så erjbuder Personuppgiftstjänsten även andra tjänstekontrakt, för hantering av kontaktuppgifter och reservidentiteter. Se dokumentationen för de fullständiga möjligheter som erbjuds.

Filmer 

Här kan du ta del av de filmer som Inera har tagit fram för självstudier om Personuppgiftstjänsten.