TA 05 – Hämta patientinformation

Denna tillämpningsanvisning beskriver hämtning av aktuell information om patienten.



1. Verksamhetsbeskrivning

Syftet med denna tillämpningsanvisning är att beskriva hämtning av aktuell information om patienten.

Den returnerade informationen används för att verifiera att det är rätt patient samt att det angivna personnumret motsvarar rätt uppgift i folkbokföringen. I den returnerade informationen finns även en markering som anger om personen har någon typ av skyddade personuppgifter (skyddad folkbokföring eller sekretessmarkering) eller är avliden. Returnerad information innehåller en patientreferens som ska användas för all vidare hämtning och registrering av information.

Funktionen ska användas bland annat:

  • vid förskrivning
  • för ändamål direktåtkomst

1.1. Behörighetsroller

Följande behörighetsroller berörs av denna tillämpningsanvisning:

  • Hälso- och sjukvårdspersonal
    • Förskrivare
    • Sjuksköterska
    • Farmaceut inom hälso- och sjukvård
    • Dietist
  • Apotekspersonal
    • Farmaceut på apotek
    • Icke-legitimerad apotekspersonal 
  • Privatperson
    • Patient, vårdnadshavare eller ombud.

En definition av behörighetsrollerna finns på sidan Roller.

1.2. Termer och definitioner

En beskrivning av samtliga termer som används i denna tillämpningsanvisning går att hitta på sidan Termer och begrepp i handboken.

1.3. Resurser

I tabell 1 nedan listas de informationsresurser, FHIR-resurser och FHIR-profiler som hämtas i denna tillämpningsanvisning.

Se Generell beskrivning av FHIR för en mer generell beskrivning av FHIR-resurser och FHIR-profiler i Nationella läkemedelslistan.

Tabell 1 - Informationsresurser

Informationsresurs

FHIR-Resurs

FHIR-Profil
Patient Patient NLLPatient

2. Delfunktioner och varianter av tillämpningsanvisningen

2.1. Förkrav

Innan en delfunktion kan tillämpas måste följande krav vara uppfyllda:

2.2. Delfunktion 1: Hämta patientuppgifter – Vård 

För att uppfylla vårdens ändamål behöver Hälso- och sjukvårdspersonal hämta patientuppgifter. Detta i syfte att verifiera uppgifterna samt få en patientreferens som ska användas för all vidare åtkomst i Nationella läkemedelslistan.

2.2.1. Variant 1.1 Hämta patientuppgifter med personnummer

Krav-ID: 05:1:1.1

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar en patients uppgifter med ett personnummer enligt angivna ändamål och åtkomsttyper under 3.1 Meddelandehuvud och sökvillkor under 3.2 Sökning och hämtning per resurs.

Berörd resurs: Patient

Returnerad resurs: Patient

Resurser som returneras beskrivs under 3.3 Hämtade informationsresurser.

2.2.2. Variant 1.2 Hämta patientuppgifter med patientreferens

Krav-ID: 05:1:1.2

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar en patients uppgifter med en patientreferens enligt angivna ändamål och åtkomsttyper under 3.1 Meddelandehuvud och sökvillkor under 3.2 Sökning och hämtning per resurs.

Berörd resurs: Patient

Returnerad resurs: Patient

Resurser som returneras beskrivs under 3.3 Hämtade informationsresurser.

2.3. Delfunktion 2: Hämta patientuppgifter – Apotek

För att uppfylla apotekens ändamål behöver Apotekspersonal hämta patientuppgifter. Detta i syfte att verifiera uppgifterna samt få en patientreferens som ska användas för all vidare åtkomst i Nationella läkemedelslistan.

2.3.1. Variant 2.1 Hämta patientuppgifter med personnummer

Krav-ID: 05:2:2.1

Beskrivning av tillämpning

Apotekspersonal hämtar en patients uppgifter med personnummer enligt angivna ändamål och åtkomsttyper under 3.1 Meddelandehuvud och sökvillkor under 3.2 Sökning och hämtning per resurs.

Berörd resurs: Patient

Returnerad resurs: Patient

Resurser som returneras beskrivs under 3.3 Hämtade informationsresurser.

2.3.2. Variant 2.2 Hämta patientuppgifter med patientreferens

Krav-ID: 05:2:2.2

Beskrivning av tillämpning

Apotekspersonal hämtar en patients uppgifter med en patientreferens enligt angivna ändamål och åtkomsttyper under 3.1 Meddelandehuvud och sökvillkor under 3.2 Sökning och hämtning per resurs.

Berörd resurs: Patient

Returnerad resurs: Patient

Resurser som returneras beskrivs under 3.3 Hämtade informationsresurser.

2.4. Delfunktion 3: Hämta patientuppgifter – Privatperson

I samband med åtkomst till Nationella läkemedelslistan hämtar behörig användare patientuppgifter. Behörig användare kan vara patienten själv eller dess ombud (vårdnadshavare eller via fullmakt).

2.4.1. Variant 3.1 Hämta patientuppgifter med personnummer

Krav-ID: 05:3:3.1

Beskrivning av tillämpning

Privatperson hämtar en patients uppgifter med personnummer enligt angivna ändamål och åtkomsttyper under 3.1 Meddelandehuvud och sökvillkor under 3.2 Sökning och hämtning per resurs.

Berörd resurs: Patient

Returnerad resurs: Patient

Resurser som returneras beskrivs under 3.3 Hämtade informationsresurser.

2.4.2. Variant 3.2 Hämta patientuppgifter med patientreferens

Krav-ID: 05:3:3.2

Beskrivning av tillämpning

Privatperson hämtar en patients uppgifter med en patientreferens enligt angivna ändamål och åtkomsttyper under 3.1 Meddelandehuvud och sökvillkor under 3.2 Sökning och hämtning per resurs.

Berörd resurs: Patient

Returnerad resurs: Patient

Resurser som returneras beskrivs under 3.3 Hämtade informationsresurser.

3. Hanterad information 

3.1. Meddelandehuvud

Information  i meddelandehuvudet ska för denna tillämpningsanvisning anges enligt regler i tillämpningsmönster 2.2.2. Hämta med säkerhetsintyg med åtkomsttyp och ändamål  Informationsspecifikation – meddelandehuvud. 

Ändamål och åtkomst anges enligt kombination för aktuell resurs för mer information se:

3.2. Sökning och hämtning per resurs 

Här anges sökparametrar och hämtningar via logiska id som returnerar olika resurser.

För teknisk information om sökning och hämtning, se avsnittet "Query Operations" för respektive resurs i  Simplifier Guide för Nationella läkemedelslistan.

3.2.1. Patient sökparametrar

Tabell 3 - Sökning via personnummer

Term

Villkor

Kommentar
Personnummer Obligatoriskt. Används vid första sökning på patient för att erhålla ett logiskt-id för patientreferensen  samt information om namn, folkbokföringsort mm.

Tabell 4 - Hämtning via logiskt id

Term

Villkor

Kommentar

Patientreferens

Obligatoriskt. Valideras enligt VR095

Logiskt id för patient som erhållits vid ett tidigare tillfälle

3.3. Hämtade informationsresurser

3.3.1. Informationsresurs Patient

Beskrivning av resursen "Patient" finns i informationsspecifikationen Patient – NLLPatient.

Patientresursen returneras enligt R001.

Om personen har skyddade personuppigfter returneras information enligt R002.

Attributet "Aktiv" sätts enligt R003.

Attributet "Folkbokförd" sätts enligt R004.

4. Regler och kontroller

4.1. Generella verksamhetsregler

Verksamhetsregler beskriver validering och verksamhetslogik som E-hälsomyndigheten ansvarar för. Generella verksamhetsregler är de som används i flera tillämpningsanvisningar. Alla dessa finns beskrivna i Generella verksamhetsregler.

Tabell 5 - Generella verksamhetsregler för denna tillämpningsanvisning

Regel-id

Regelnamn

VR095

 Validering av patient i meddelandehuvud mot patient i sökvillkor

4.2. Automatiska kompletteringar

Inga automatiska kompletteringar finns för denna tillämpningsanvisning. 

4.3. Specifika verksamhetsregler

Verksamhetsregler beskriver validering och verksamhetslogik som E-hälsomyndigheten ansvarar för. 

Tabell 6 - Specifika verksamhetsregler i denna tillämpningsanvisning

Id

Regelnamn

Beskrivning av regel

Felmeddelande
R001 Kontroll att angiven patient finns i folkbokföringen

Vid sökning med patientreferens eller personnummer kontrolleras att patient finns i folkbokföringen.

Kommentar

  • Om Skatteverkets folkbokföringsregister  är nere returneras patientresurs med status aktiv och folkbokförd okänd. För information om status aktiv och folkbokförd se R003 och R004 samt presentationskrav 05:P.1
  • Kontroll utförs även vid tillämpning av reservlösning (delayed call med personnummer)

2-26-20 Efterfrågad persons uppgifter ej tillgängliga i Nationella läkemedelslistan
R002 Filtrering  av uppgifter för patient med skyddade personuppgifter Om patient har skyddade personuppgifter i folkbokföringen returneras endast uppgift om logiskt id, personnummer, markering om skyddade personuppgifter (skyddad folkbokföring eller sekretessmarkering) samt eventuell markering om patienten är avliden, samt i redigerat namn anges "Personuppgift skyddad".
R003 Status "Aktiv"

Beroende på om patientresursen är markerad som Aktiv (true/sann) eller Inaktiv (false/falsk) påverkar det om information i patientens läkemedelslista går att läsa, registrera eller uppdatera.

Markering Aktiv eller Inaktiv förändras beroende på information från folkbokföringen hos Skatteverket. 

Aktiv

Patientresurs är markerad som aktiv för patient som är folkbokförd eller utvandrad, patient med markering för skyddad folkbokföring eller sekretessmarkering, eller för patient som är overifierad i de fall verifiering inte kunnat ske mot Skatteverkets folkbokföringsregister av tekniska skäl (se även R004), samt om angiven patientreferens eller personnummer är en testperson.  

Inaktiv

Patientresurs är markerad som inaktiv om patient i folkbokföringen är rapporterad avliden, försvunnen, tekniskt avregistrerad, avregistrerad som falsk identitet eller avregistrerad på grund av gammalt personnummer vid personnummerbyte.

När patientresursen är markerad som inaktiv går det enbart att läsa patientens uppgifter i Nationella läkemedelslistan (se undantag för markerad avliden nedan). 

Är patienten markerad avliden returneras information som är kopplad till patientens läkemedelslista i tre månader endast för ändamålet Expediering med syfte att backa eller kreditera en expediering. För alla andra ändamål visas inga uppgifter i patientens läkemedelslista.  Se Valideringsregler för apoteksändamål (VAL010) under "Ändamål, åtkomsttyper, resurser och behörigheter"

 
R004 Status "Folkbokförd"

Om "Folkbokförd" = "YES/Ja" har angivet personnummer bekräftats ha varit eller är folkbokförd i Sverige.

Om "Folkbokförd" = "NO/Nej" har angivet personnummer bekräftats inte ha varit och är inte folkbokförd i Sverige. Det gäller även patientresurser som används i testsyfte. 

Om "Folkbokförd" = "UNKNOWN/Okänd" kan personnumret inte bekräftas som folkbokförd på grund av tekniska skäl.

  • Status Folkbokförd" = "UNKNOWN/Okänd används exempelvis för person med personnummer som inte tidigare har uppgift i Nationella läkemedelslistan och det samtidigt inte varit tekniskt möjligt att bekräfta personnumret i Folkbokföringen. 
  • Syftet med status Folkbokförd" = "UNKNOWN/Okänd är att möjliggöra förskrivning till personer som saknar tidigare uppgifter i Nationella läkemedelslistan samtidigt som E-hälsomyndigheten inte fått kontakt med Folkbokföringen för att bekräfta folkbokföringsstatus. Resursen som returneras saknar namn och adressuppgifter men har status "Aktiv" = "TRUE/Sann"


4.4. AFF-kontroller och kontrollsamlingar

Automatiska format- och författningskontroller (AFF-kontroller) är valideringar som säkerställer kvaliteten på informationen i Nationella läkemedelslistan. AFF-kontrollerna och kontrollsamlingarna beskrivs detaljerat på sidan Automatiska format- och författningskontroller (AFF-kontroller).

Inga AFF-kontroller körs i denna tillämpningsanvisning. 

4.5. Valideringsregler

Valideringsregler beskriver validering vid hämtning av information från Nationella läkemedelslistan. Alla regler finns beskrivna på sidan Valideringsregler.

Tabell 7. Valideringsregler för denna tillämpningsanvisning

Regel-id

Regelnamn
VAL002 Validering av åtkomsttyp "Vårdnadshavare"    
VAL003 Validering av åtkomsttyp "Köpfullmakt"    
VAL005 Validering av åtkomsttyp "Egna uppgifter"
VAL013 Giltig kombination av ändamål, åtkomsttyp och behörighetsroll

4.6. Filtreringregler

Inga filtreringsregler i denna tillämpningsanvisning

5. Presentationskrav

Följande presentationskrav gäller vid visning av information som hämtas enligt denna tillämpningsanvisning. Generella presentationskrav för patient finns i Generella presentationskrav för anslutande aktör och system

Tabell 8.  Presentationskrav 

Krav Beskrivning av krav Krav gäller Kommentar
05:P.1

När patientresursen indikerar att resursen inte är bekräftad mot folkbokföringen (se attribut Folkbokförd i resursen Patient – NLLPatient) ska användaren uppmärksammas på detta.

Vård

Apotek

 Om status för Folkbokförd är "Okänd" rekommenderas att en kontroll görs att man angivit rätt personnummer innan en ny förskrivning registreras.

6. Rekommendationer

REKOMMENDATION

Om patient som hämtas är en testpatient rekommenderas att det tydligt visas i anslutande system. Hur testpatient identifieras framgår av informationsspecifikationen Patient – NLLPatient.


Versionshistorik

Version

Datum

Release

Kommentar
1.0 2021-11-27 21.0 Ny handbok vård- och apotekstjänster
1.1 2022-02-02 Lagt till två nya specifika verksamhetsregler R003 och R004 för attributen "Aktiv" respektive "Folkbokförd". Ändrat ordalydelse för R002.
1.2 2022-11-10 21.4

Ändrat beskrivning av R002 och i Verksamhetsbeskrivning med uppgift om att skyddade personuppgifter kan markeras med Skyddade personuppgifter eller Sekretessmarkering.

Lagt till en kommentar till presentationskrav 05:P.1.

I meddelandehuvud hänvisat till tillämpningsmönster för meddelandehuvud i informationsspecifikation meddelandehuvud.
1.3 2023-05-04 21.5 Förtydligat R003 status Aktiv och Inaktiv
1.4 2024-04-16 21.8 Kapitel 6. Rekommendationer tillagd med rekommendation avseende presentation av testpatient.
Under kapitel 5 lagt till hänvisning till generella presentationskrav
1.5 2025-02-13 21.12

Ändringar i dokumentation:

  • Behörighetsroll Sjuksköterska utan förskrivningsrätt har ny benämning sjuksköterska
1.6 2025-04-29 21.13

Förbättringar dokumentation

  • Lagt till kapitel 4.5 Valideringsregler
  • Lagat till kapitel 4.6 Filtreringsregler
  • Döpt om regel R002 till "Filtrering av uppgifter vid skyddade personuppgifter"
  • Lagt till hänvisning till giltiga kombinationer av ändamål och åtkomst under kapielt 3.1 Meddelandehuvud.
  • Förtydligat regel R001