Denna tillämpningsanvisning beskriver hur hälso- och sjukvårdspersonal, expedierande apotekspersonal samt privatperson kan få åtkomst till en patients dosunderlag och dess tillhörande händelser.

---

---

1. Verksamhetsbeskrivning

Syftet med denna tillämpningsanvisning är att beskriva hur hälso- och sjukvårdspersonal, expedierande apotekspersonal samt privatperson kan få åtkomst till en patients dosunderlag och dess tillhörande händelser.

Ett dosunderlag är ett underlag för beslut i samband med produktion av dosdispenserade läkemedel för dospatient. På dosapotek används dosunderlaget för att kontrollera om det skett förändringar i patientens läkemedelslista som dosapoteket måste ta ställning till före produktion. För hälso- och sjukvårdspersonal och öppenvårdsapotek ger dosunderlaget information om dosproducent. Privatperson har åtkomst till dosunderlaget för att få information om dosproducent.

Hälso- och sjukvårdspersonal kan få åtkomst till dosunderlag för ändamålen:

• åstadkomma säker ordination
• bereda vård och behandling
• komplettera journal

Expedierande apotekspersonal kan få åtkomst till dosunderlag för ändamålet expediering.

Privatperson kan få åtkomst till dosunderlag för ändamålet åtkomst till egna uppgifter.

1.1. Behörighetsroller

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

• Hälso- och sjukvårdspersonal
  • Förskrivare

  • Sjuksköterska utan förskrivningsrätt

  • Farmaceut inom hälso- och sjukvård

  • Dietist

• Expedierande apotekspersonal
  • Farmaceut på apotek
  • Icke-legitimerad apotekspersonal
• Privatperson
  • Patient
  • Vårdnadshavare
  • Fullmaktstagare

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.

Ändamål, åtkomsttyper, resurser och behörigheter innehåller en beskrivning av giltiga kombinationer av ändamål, åtkomsttyp, resurs och behörighetsroll.

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 - Resurser

2. Delfunktion och varianter av tillämpningsanvisningen

2.1. Förkrav

Innan delfunktioner i denna tillämpningsanvisning kan tillämpas måste följande krav vara uppfyllda:

• Patientreferens har hämtats enligt  TA 05 – Hämta patientinformation
• Uppgifter har hämtats från Nationella läkemedelslistan för att kunna göra relevanta sökningar och hämtning av resurser, t.ex. resursidentiteter eller referens till ombud.
• För att välja rätt ändamål och åtkomst, se regelverk och vägledning i Ändamål, åtkomsttyper, resurser och behörigheter.

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

Hälso- och sjukvårdspersonal hämtar dosunderlag och tillhörande händelser för ändamålen åstadkomma säker ordination, bereda vård och behandling samt komplettera journal.

Dosunderlaget och tillhörande händelser kan sökas med olika sökvillkor eller hämtas med en referens till en resurs.

2.2.1. Variant 1.1 Hämta dosunderlag med patientreferens

Krav-ID: 35:1:1.1

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar en patients dosunderlag med en patientreferens enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning. Den senaste versionen av dosunderlaget returneras. Det finns möjlighet att även inkludera hämtning av händelsen som tillhör den returnerade versionen av dosunderlaget.

Berörd resurs: Dosunderlag

Returnerad resurs: Dosunderlag

Möjlig inkluderad resurs: Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser. 

2.2.2. Variant 1.2 Hämta dosunderlag med logiskt id

Krav-ID: 35:1:1.2

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar en patients dosunderlag med en referens till dosunderlaget enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning. Den senaste versionen av dosunderlaget returneras. 

Berörd resurs: Dosunderlag

Returnerad resurs: Dosunderlag

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.2.3. Variant 1.3 Hämta händelser för ett dosunderlag

Krav-ID: 35:1:1.3

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar samtliga händelser som tillhör ett dosunderlag med en referens till dosunderlag enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning.

Berörd resurs: Dosunderlag

Returnerad resurs: Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.2.4. Variant 1.4 Hämta enskild dosunderlagshändelse

Krav-ID: 35:1:1.4

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar en händelse som tillhör ett dosunderlag med det logiska id:t för händelsen enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning, Hämta händelse med logiskt id.

Berörd resurs: Händelse

Returnerad resurs: Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.2.5. Variant 1.6 Hämta versioner av ett dosunderlag

Krav-ID: 35:1:1.6

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar en eller alla versioner av ett dosunderlag med det logiska id:t för dosunderlaget enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning, Hämta versioner av ett dosunderlag.

Berörd resurs: Dosunderlag

Returnerad resurs: Dosunderlag

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.3. Delfunktion 2: Hämta patients dosunderlag – Apotek

Apotekspersonal hämtar dosunderlag och tillhörande händelser för ändamålet expediering.

Dosunderlaget och tillhörande händelser kan sökas med olika sökvillkor eller hämtas med en referens till en resurs.

2.3.1. Variant 2.1 Hämta dosunderlag med patientreferens

Krav-ID: 35:2:2.1

Beskrivning av tillämpning

Expedierande apotekspersonal hämtar en patients dosunderlag med en patientreferens enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning. Den senaste versionen av dosunderlaget returneras. Det finns möjlighet att även inkludera hämtning av händelsen som tillhör den returnerade versionen av dosunderlaget.

Berörd resurs: Dosunderlag

Returnerad resurs: Dosunderlag

Möjlig inkluderad resurs: Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser. 

2.3.2. Variant 2.2 Hämta dosunderlag med logiskt id

Krav-ID: 35:2:2.2

Beskrivning av tillämpning

Expedierande apotekspersonal hämtar en patients dosunderlag med en referens till dosunderlaget enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning. Den senaste versionen av dosunderlaget returneras. 

Berörd resurs: Dosunderlag

Returnerad resurs: Dosunderlag

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.3.3. Variant 2.3 Hämta händelser för ett dosunderlag

Krav-ID: 35:2:2.3

Beskrivning av tillämpning

Expedierande apotekspersonal hämtar samtliga händelser för ett dosunderlag med en referens till ett dosunderlag enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning.

Berörd resurs: Dosunderlag

Returnerad resurs: Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.3.4. Variant 2.4 Hämta enskild dosunderlagshändelse

Krav-ID: 35:2:2.4

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar en händelse som tillhör ett dosunderlag med det logiska id:t för händelsen enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning, Hämta händelse med logiskt id.

Berörd resurs: Händelse

Returnerad resurs: Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.3.5. Variant 2.6 Hämta versioner av ett dosunderlag

Krav-ID: 35:2:2.6

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar en eller alla versioner av ett dosunderlag med det logiska id:t för dosunderlaget enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning, Hämta versioner av ett dosunderlag.

Berörd resurs: Dosunderlag

Returnerad resurs: Dosunderlag

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.4. Delfunktion 3: Hämta patients dosunderlag – Privat

Privatperson (patient, vårdnadshavare eller ombud) hämtar dosunderlag och tillhörande händelser för ändamålet "åtkomst till egna uppgifter".

Dosunderlaget och tillhörande händelser kan sökas med olika sökvillkor eller hämtas med en referens till en resurs.

2.4.1. Variant 3.1 Hämta dosunderlag med patientreferens

Krav-ID: 35:3:3.1

Beskrivning av tillämpning

Privatperson hämtar en patients dosunderlag med en patientreferens enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning. Den senaste versionen av dosunderlaget returneras. Det finns möjlighet att även inkludera hämtning av händelsen som tillhör den returnerade versionen av dosunderlaget.

Berörd resurs: Dosunderlag

Returnerad resurs: Dosunderlag

Möjlig inkluderad resurs: Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser. 

2.4.2. Variant 3.2 Hämta dosunderlag med logiskt id

Krav-ID: 35:3:3.2

Beskrivning av tillämpning

Privatperson hämtar en patients dosunderlag med en referens till dosunderlaget enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning. Den senaste versionen av dosunderlaget returneras. 

Berörd resurs: Dosunderlag

Returnerad resurs: Dosunderlag

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.4.3. Variant 3.3 Hämta händelser för ett dosunderlag

Krav-ID: 35:3:3.3

Beskrivning av tillämpning

Privatperson hämtar samtliga händelser för ett dosunderlag med en referens till ett dosunderlag enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning.

Berörd resurs: Dosunderlag

Returnerad resurs: Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.4.4. Variant 3.4 Hämta enskild dosunderlagshändelse

Krav-ID: 35:3:3.4

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar en händelse som tillhör ett dosunderlag med det logiska id:t för händelsen enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning, Hämta händelse med logiskt id.

Berörd resurs: Händelse

Returnerad resurs: Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.4.5. Variant 3.6 Hämta versioner av ett dosunderlag

Krav-ID: 35:3:3.6

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar en eller alla versioner av ett dosunderlag med det logiska id:t för dosunderlaget enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning, Hämta versioner av ett dosunderlag.

Berörd resurs: Dosunderlag

Returnerad resurs: Dosunderlag

Resurser som returneras beskrivs i 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 i Informationsspecifikation – meddelandehuvud. 

3.2. Sökning och hämtning per resurs

Här anges sökparametrar per resurs och hur de kan kombineras för sökning för att nå önskat resultat samt hur man kan hämta resurser via deras logiska identifierare. 

3.2.1. Dosunderlag

Sök dosunderlag för en viss patient

Tabell 2 - Sökparametrar hämta dosunderlag för patient

Hämta via logiskt id

Tabell 3 - Sökparameter hämta dosunderlag med dosunderlags-id

Hämta versioner av ett dosunderlag

Tabell 4 - Sökparametrar hämta version/versioner av dosunderlag

3.2.2. Händelse – sökparametrar

Hämtning av händelser tillhörande en resurs

Tabell 5 - Sökparametrar hämta händelse

Händelse – hämtning med logiskt id

Tabell 6 - Sökparameter hämtning med logiskt id

3.2.3. Hämta samling av resurs via annan resurs

En samling resurser av en viss resurstyp kan hämtas via en annan resurs. Se "compartment search" för respektive resurs i Simplifier guide.

Hämta händelser för ett dosunderlag

Tabell 7 - sökparametrar hämta händelser för ett dosunderlag

3.3. Hämtade informationsresurser

3.3.1. Informationsresurs Dosunderlag

Beskrivning av resursen "Dosunderlag" finns i informationsspecifikationen Dosunderlag – NLLMultiDoseDispensingBasis.

3.3.2. Informationsresurs Händelse

Beskrivning av resursen "Händelse" finns i informationsspecifikationen Händelse – NLLProvenance.

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 på sidan Generella verksamhetsregler.

Tabell 8 - Generella verksamhetsregler

4.2. Automatiska kompletteringar

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

4.3. Specifika verksamhetsregler 

Inga specifika verksamhetsregler finns för denna tillämpningsanvisning.

4.4. AFF-kontroller och kontrollsamlingar

Vid hämtning av denna resurs körs inga AFF-kontroller.

5. Presentationskrav

Följande presentationskrav gäller vid visning av information som hämtas enligt denna tillämpningsanvisning.

Tabell 9 - presentationskrav 

Versionshistorik