TA 08 – Kontrollera Vårdnadshavare

Denna tillämpningsanvisning beskriver hur expedierande apotekspersonal kan kontrollera att en person är vårdnadshavare till ett barn under 18 år. Funktionen används också av privatperson i samband med e-handel på apotek.





1. Verksamhetsbeskrivning

Syftet med denna tillämpningsanvisning är att beskriva hur expedierande apotekspersonal kan kontrollera att en person är vårdnadshavare till ett barn under 18 år. Funktionen används också av privatperson i samband med e-handel på apotek. En vårdnadshavarrelation är en förutsättning för att vårdnadshavare ska få åtkomst till barnets läkemedelslista.

Finns en vårdnadshavarrelation mellan patient och vårdnadshavare i folkbokföringen returneras resurs för vårdnadshavarrelationen (NLLRelatedPerson). 

1.1. Behörighetsroller

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

  • Farmaceut på apotek
  • Icke-legitimerad apotekspersonal
  • Privatperson

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

Resurs

FHIR-Resurs

FHIR-Profil

Patient Patient

NLLPatient

Vårdnadshavarrelation RelatedPerson

NLLRelatedPerson

2. Delfunktion och varianter i tillämpningsanvisningen

2.1. Förkrav

N/A

2.2. Delfunktion 1 – Kontrollera vårdnadshavare 

Finns en vårdnadshavarrelation mellan patient och vårdnadshavare i folkbokföringen returneras resurs för vårdnadshavarrelationen (NLLRelatedPerson).

2.2.1. Variant 1.1 Kontrollera vårdnadshavare

Krav-ID: 08:1:1.1

Beskrivning av tillämpning

En person vill nyttja sin behörighet som vårdnadshavare för sitt barn som är under 18 år.
Syftet med den här delfunktionen är att kontrollera att person är vårdnadshavare för barn under 18 år.

Det går att söka på personnummer eller patientreferens enligt angivna ändamål och åtkomsttyper i  Meddelandehuvud och Sökning och hämtning.

Berörd resurs: Vårdnadshavarrelation

Returnerad resurs: Vårdnadshavarrelation

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  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.  Kontrollera vårdnadshavarrelation

Tabell 2. Attribut indata, Kontrollera vårdnadshavare

Term

Villkor

Kommentar

Patientens identitet

Obligatoriskt att ange antingen Personnummer eller Patientreferens

Avser barnets identitet eller logiska id


Vårdnadshavarens identitet

Obligatoriskt med vårdnadshavarens personnummer


3.2.2. Hämta via logiskt id för resurs.

Tabell 3. Attribut indata, Kontrollera vårdnadshavare

Term

Villkor

Kommentar

vårdnadshavarrelations-id

Obligatoriskt



3.3.
Hämtade informationsresurser

3.3.1. Informationsresurs Vårdnadshavarrelation

Returneras om det finns en vårdnadshavarrelation.

Beskrivning av resursen "Vårdnadshavarrelation" finns i informationsspecifikationen Vårdnadshavarrelation - NLLRelatedPerson.

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 4. Generella verksamhetsregler för denna tillämpningsanvisning

Regel-id

Regelnamn

VR025 Validering av anropande apotek mot EXPO

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 5. Specifika verksamhetsregler i denna tillämpningsanvisning

Regel-id

Regelnamn

Beskrivning av regel 

Felkod och felmeddelande
R001

Finns patient och vårdnadshavare i folkbokföringen

Vid sökning med patientreferens  eller personnummer kontrolleras att  personerna finns i folkbokföringen samt att de har giltig status.

2-26-20 Efterfrågad persons uppgifter ej tillgängliga i nationella läkemedelslistan.

2-26-42 Person/er finns inte i Befolkningsregistret.

R002

Patient Patient ska vara under 18 år. 2-26-43 Vårdnadshavare är ifylld men person har fyllt 18 år.
R003 Vårdnadshavarrelation finns 

Vid sökning med patientreferens  eller personnummer. 

Om det finns en vårdnadshavarrelation mellan patient under 18 år samt vårdnadshavare returneras resurs för vårdnadshavarrelation.

2-26-41 Person är inte registrerad som vårdnadshavare för patient i folkbokföringen.
R004 Vårdnadshavarrelation finns  vid sökning med logiskt-id

Vid sökning med vårdnadshavarrelations-id (logiskt.id). Kontrolleras att en vårdnadshavarrelation finns.

2-26-127  %s is not a valid ID for RelatedPerson. Should be '-'.

4.4. AFF-kontroller och kontrollsamlingar

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

4.5. Valideringsregler

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

Tabell 6. Valideringsregler för denna tillämpningsanvisning

Regel-id

Regelnamn

VAL013 Giltig kombination av ändamål, åtkomsttyp och behörighetsroll

4.6. Filtreringsregler

Ingen filtrering sker.

5. Presentationskrav

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


Versionshistorik

Version

Datum

Release

Kommentar

1.0 2021-11-27
Ny handbok vård- och apotekstjänster
1.1 2022-03-30
Rättat icke-fungerande interna länkar.
1.2 2022-10-04
Förtydligat regler för sökning och hämtning av resurs i tabell 3 och 4.
1.3 2022-11-10

Förbättring dokumentation:

  • I kapitel Specifika verksamhetsregler
    • Lagt till kolumn för felkod och felmeddelande
  • I meddelandehuvud:
    • hänvisat till tillämpningsmönster för meddelandehuvud i informationsspecifikation meddelandehuvud.
1.4 2025-04-29 21.13

Förbättring av dokumentation

  • Förtydligat att det är en vårdnadshavarrelation som hämtas inte en vårdnadshavare
  • Lagt till kapitel  3.2.2 Hämta via logiskt-id
  • Förtydligat och bytt namn på regel R001
  • Förtydligat och bytt namn på regel R003
  • Förtydligat och bytt namn på regel R004
  • Lagt till kolumn felkod och felmeddelande i tabell 4.  Specifika verksamhetsregler.
  • Lagt till kapitel 4.5 Valideringsregler
  • Lagt till hänvisning till giltiga kombinationer av ändamål och åtkomst under kapielt 3.1 Meddelandehuvud.