TA 16 – Registrera dospatient
Denna tillämpningsanvisning är att beskriva hur hälso- och sjukvårdspersonal och farmaceut på dosapotek kan registrera en patient som patient med dossamtycke (dospatient) i Nationella läkemedelslistan.
1. Verksamhetsbeskrivning
Denna tillämpningsanvisning beskriver hur hälso- och sjukvårdspersonal och farmaceut på dosapotek kan registrera en patient som patient med dossamtycke (dospatient) i Nationella läkemedelslistan.
När en patient med dossamtycke (dospatient) registreras skapas ett dossamtycke och ett dosunderlag, båda är en förutsättning för att patienten ska kunna få sina läkemedel dosdispenserade. Registrering av en patient med dossamtycke (dospatient) kan utföras av hälso- och sjukvårdspersonal eller av farmaceut på dosapotek. Farmaceut på dosapotek utför alltid registreringen på uppdrag av personal inom hälso- och sjukvården. Förutom anslutning till Nationella läkemedelslistan krävs även en anslutning till tjänster som finns i Sortiment- och leveransinformation för dos (SOL).
1.1. Behörighetsroller
Följande behörighetsroller berörs av denna tillämpningsanvisning:
- Förskrivare
- Sjuksköterska utan förskrivningsrätt
- Farmaceut inom hälso- och sjukvård
- Farmaceut på apotek.
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 ska användas för 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 |
---|---|---|
Dossamtycke |
Consent | NLLMultiDoseDispConsent |
Händelse | Provenance |
NLLProvenance Specialiserade profiler NLLProvenanceConsentMultiDose NLLProvenanceBasicMultiDoseDispensingBasis |
Dosunderlag | Basic | |
Patient | Patient |
NLLPatient |
Personal |
Practitioner |
NLLPractitioner |
2. Delfunktion och varianter av tillämpningsanvisningen
2.1. Förkrav
Innan delfunktionen (delfunktionerna) kan tillämpas måste följande krav vara uppfyllda:
- Användaren har hämtat information om patienten enligt TA 05 – Hämta patientinformation, och erhållit en patientreferens som ska skickas in vid registrering av dossamtycke och dosunderlag.
- Patienten har blivit informerad om vad det innebär att vara patient med dossamtycke (dospatient) och vad samtycke till att bli dospatient medför.
- Användaren hämtar dossamtycke enligt TA 23 – Hämta dossamtycke och dosunderlag enligt TA 35 – Hämta dosunderlag för patienten för att kontrollera om dessa redan finns.
2.2. Delfunktion 1 – Registrera dossamtycke
Användaren registrerar ett dossamtycke som indikerar att patienten samtyckt till att kunna få sina förskrivna läkemedel dosdispenserade.
Variant 1.1 Registrera dossamtycke
Krav-ID: 16:1:1.1
Beskrivning av tillämpning
Registrering av dossamtycke för en patient som inte har varit dospatient tidigare, det finns inget återkallat samtycke.
Variant 1.2 Omregistrera dossamtycke
Krav-ID: 16:1:1.2
Beskrivning av tillämpning
Omregistrering av dossamtycke för en patient som har varit dospatient tidigare, patienten har ett återkallat samtycke som ännu inte har gallrats.
2.3. Efterfrågad information
FHIR-operation
Tabell 2
Beskrivning |
FHIR operation |
Kommentar |
---|---|---|
Registrera dossamtycke |
POST |
Används för Variant 1.1 Registrera samtycke |
Omregistrera dossamtycke | PUT | Används för Variant 1.2 Omregistrera samtycke |
Informationsresurs Dossamtycke
Tabell 3. Attribut Dossamtycke
Term |
Villkor variant 1.1 |
Villkor variant 1.2 |
Kommentar |
---|---|---|---|
Samtyckes-id | Sätts automatiskt. | Får inte ändras. | |
Patientreferens | Obligatoriskt. | Får inte ändras. | |
Giltigt från och med | Sätts automatiskt enligt R005. | Sätts automatiskt enligt R005. | |
Giltigt till och med | Får inte anges. | Får inte anges. | |
Samtyckestyp |
Obligatoriskt. Giltigt värde Dossamtycke |
Obligatoriskt. Giltigt värde Dossamtycke |
|
Samtyckesstatus | Angivet värde ignoreras. | Angivet värde ignoreras. | |
Tillämpningsområde | Angivet värde ignoreras. | Angivet värde ignoreras. |
Informationsresurs Händelse
En händelse måste alltid innehålla information om den som utför händelsen. I de fall en händelse utförs på uppdrag av någon annan ska information om uppdragsgivare anges.
Informationen hanteras i profilen händelse och ska refereras i meddelandehuvud X-Provenance, se Informationsspecifikation – meddelandehuvud.
Tabell 4. Attribut informationsresurs händelse, händelsetyp Registrera dossamtycke
Term |
Villkor |
Kommentar |
---|---|---|
Händelse-id | Sätts automatiskt enligt Auto33. | |
Händelsetidpunkt | Sätts automatiskt enligt Auto07. | |
Händelsetyp | Obligatorisk. Giltigt värde Registrera dossamtycke |
|
Händelseorsak | Får inte anges. | |
Beskrivning händelseorsak | Får inte anges. | |
Resursreferenser | Referens till dosunderlaget som skapas. Sätts automatiskt enligt VR105. | |
Utförare |
Valideras enligt VR138. |
Se informationsresurs Personal Förskrivare, Legitimerad vårdpersonal sjuksköterska, Legitimerad vårdpersonal farmaceut eller Farmaceut på apotek. |
Uppdragsgivare |
Valideras enligt VR138. |
Se informationsresurs Personal Förskrivare eller Legitimerad vårdpersonal sjuksköterska |
Specifika verksamhetsregler
Specifika verksamhetsregler som E-hälsomyndigheten tillämpar för denna variant.
Tabell 5. Specifika verksamhetsregler för dossamtycke
Regel-id |
Regelnamn |
---|---|
R002 |
Kontroll av personens status i folkbokföringen |
R005 |
Dossamtycke – Giltigt från och med |
R009 |
Validering vid registrering av dossamtycke |
2.4. Delfunktion 2 – Registrera dosunderlag
Användaren registrerar ett dosunderlag för att patienten ska kunna få sina förskrivna läkemedel dosdispenserade.
Variant 2.1 Registrera dosunderlag
Krav-ID: 16:2:2.1
Beskrivning av tillämpning
Ett nytt dosunderlag registreras för en patient som inte har varit dospatient tidigare det vill säga det finns inget dosunderlag med status Avregistrerat.
Variant 2.2 Omregistrera dosunderlag
Krav-ID: 16:2:2.2
Beskrivning av tillämpning
Omregistrering av dosunderlag för en patient som har varit dospatient tidigare det vill säga patienten har ett dosunderlag med status Avregistrerat som ännu inte har gallrats.
Efterfrågad information
FHIR-operation
Tabell 6. Attribut FHIR-Operation
Beskrivning |
FHIR operation |
Kommentar |
---|---|---|
Registrera dosunderlag |
POST |
Används för Variant 2.1 Registrera dosunderlag |
Omregistrera dosunderlag | PUT | Används för Variant 2.2 Omregistrera dosunderlag |
Informationsresurs Dosunderlag
Tabell 7. Attribut informationsresurs dosunderlag
Term |
Villkor variant 2.1 |
Villkor variant 2.2 |
---|---|---|
Dosunderlags-id | Sätts automatiskt. | Får inte ändras. |
Dosunderlagsversion | Sätts automatiskt enligt R006. |
Sätts automatiskt enligt R007. |
Patientreferens | Obligatorisk. | Får inte ändras. |
Resurstyp Dosunderlag | Obligatorisk. Giltigt värde är "multidosedispbasis". | Får inte ändras. |
Senaste statusändring | Sätts automatiskt enligt R006. | Sätts automatiskt enligt R007. |
Dosunderlagsstatus | Sätts automatiskt enligt R006. | Sätts automatiskt enligt R007. |
Dosproducent | Får inte anges. | Sätts automatiskt enligt R007. |
Akut förändring | Får inte anges. | Får inte anges. |
Informationsresurs Händelse
En händelse måste alltid innehålla information om den som utför händelsen. I de fall en händelse utförs på uppdrag av någon annan ska information om uppdragsgivare anges.
Informationen hanteras i profilen händelse och ska refereras i meddelandehuvud X-Provenance, se Informationsspecifikation – meddelandehuvud.
Tabell 8. Attribut informationsresurs händelse, händelsetyp Registrera dosunderlag
Term |
Villkor |
Kommentar |
---|---|---|
Händelse-id | Sätts automatiskt enligt Auto33. | |
Händelsetidpunkt | Sätts automatiskt enligt Auto07. | |
Händelsetyp | Obligatorisk. Giltigt värde är "Registrera dosunderlag". | |
Händelseorsak | Får inte anges. | |
Beskrivning händelseorsak | Får inte anges. | |
Resursreferenser | Innehåller referens till dosunderlaget som skapas. Sätts automatiskt enligt VR105. | |
Utförare |
Obligatorisk. Valideras enligt VR138. |
Se informationsresurs Personal |
Uppdragsgivare |
Valideras enligt VR138. |
Se informationsresurs Personal |
Specifika verksamhetsregler
Specifika verksamhetsregler som E-hälsomyndigheten tillämpar för denna variant.
Tabell 9. Specifika verksamhetsregler för dosunderlag
Regel-id |
Regel namn |
---|---|
R002 |
Kontroll av personens status i folkbokföringen |
R004 |
Validering vid registrering av dosunderlag |
R006 |
Dosunderlag skapas |
R007 | Omregistrera dosunderlag |
R008 |
Kontroll av dossamtycke vid skapande av dosunderlag |
2.5. Efterfrågad information (gäller både delfunktion 1 och 2)
Meddelandehuvud
Information i meddelandehuvudet ska för denna tillämpningsanvisning anges enligt regler i tillämpningsmönster 2.3 Skapa eller uppdatera resurser som beskrivs i Informationsspecifikation – meddelandehuvud.
Informationsresurs Resurssamling
För att hantera flera resurser i en transaktion kan resurssamling användas. Se informationsspecifikation Resurssamling-bundle för mer information om hur resurssamling kan tillämpas.
Informationsresurs Personal
Referens till informationsresurs Personal finns på informationsresurs Händelse ovan. Här beskrivs reglerna för informationen på möjliga förekomster vid registrera dossamtycke och dosunderlag.
Utförare
Tabell 10. Attribut informationsresurs personal på utföraren
Term Personal |
Villkor Apotek (Farmaceut på apotek) |
Villkor Vård (Förskrivare, Legitimerad vårdpersonal sjuksköterska, Legitimerad vårdpersonal farmaceut) |
Kommentar |
Yrkeskod |
Obligatoriskt att ange Yrkeskod eller Utökad yrkeskod enligt VR144 Valideras mot säkerhetsintyget enligt VR034 Valideras mot Legitimationsregistret (FORS) enligt VR033 Valideras enligt VR138 vid registrera dosunderlag och registrera dossamtycke |
Obligatoriskt att ange Yrkeskod eller Utökad yrkeskod enligt VR144 Valideras mot säkerhetsintyget enligt VR034 Valideras mot Legitimationsregistret (FORS) enligt VR033 Valideras enligt VR138 vid registrera dosunderlag och registrera dossamtycke |
|
Utökad yrkeskod |
Obligatoriskt att ange Yrkeskod eller Utökad yrkeskod enligt VR144 Valideras mot säkerhetsintyget enligt VR034 Valideras mot Legitimationsregistret (FORS) enligt VR033 Valideras enligt VR138 vid registrera dosunderlag och registrera dossamtycke |
Obligatoriskt att ange Yrkeskod eller Utökad yrkeskod enligt VR144 Valideras mot säkerhetsintyget enligt VR034 Valideras mot Legitimationsregistret (FORS) enligt VR033 Valideras enligt VR138 vid registrera dosunderlag och registrera dossamtycke |
|
Legitimationskod |
Obligatorisk för Farmaceut på apotek enligt VR033. Om ingen legitimationskod angivits kompletteras Legitimationskoden enligt VR041 Valideras mot säkerhetsintyget enligt VR034. Valideras mot Legitimationsregistret(FORS) enligt VR033. |
Obligatoriskt för sjuksköterska som saknar individuell förskrivarkod. Om ingen legitimationskod angivits kompletteras legitimationskoden enligt VR041. Valideras mot säkerhetsintyget enligt VR034. Valideras mot Legitimationsregistret (FORS) enligt VR033 |
Legitimationskod anges inte för icke- legitimerad apotekspersonal |
Individuell förskrivarkod |
Får inte anges. |
Obligatoriskt att ange antingen Individuell förskrivarkod eller Gruppförskrivarkod. Valideras mot säkerhetsintyget enligt VR034. Valideras mot Legitimationsregistret (FORS) enligt VR033. |
|
Gruppförskrivarkod |
Får inte anges. |
Obligatoriskt att ange antingen Individuell förskrivarkod eller Gruppförskrivarkod. Valideras mot säkerhetsintyget enligt VR034. Valideras mot Legitimationsregistret (FORS) enligt VR033. |
|
Användar-id | Obligatorisk. | Valfri. | |
Förnamn | Obligatorisk. | Obligatorisk. | |
Efternamn | Obligatorisk. | Obligatorisk. | |
Telefon |
Alla uppgifter om arbetsplatsen och dess kontaktuppgifter för apotek hämtas från EXPO vid läsning utifrån angiven GLN-kod på arbetsplatsen, de får därför inte anges. | Kontaktuppgift telefon är frivillig att ange. | |
Telefonnummer |
Får inte anges. |
Valfri. |
Om kontaktuppgift telefon anges måste Telefonnummer ha ett värde. |
Rangordning |
Får inte anges. |
Valfri. |
Om kontaktuppgift telefon anges måste Rangordning ha ett värde. |
Tillgänglig för patient |
Får inte anges. |
Valfri. |
Om kontaktuppgift telefon anges måste Tillgänglig för patient ha ett värde. |
Telefonnummer tillhör |
Får inte anges. |
Valfri. Person – anger att telefonnummer tillhör individ. Arbetsplats – anger att telefonnummer tillhör arbetsplats. |
Om kontaktuppgift telefon anges måste Telefonnummer tillhör ha ett värde. |
Arbetsplats
|
En arbetsplats samt adress och kontaktuppgifter kopplat till arbetsplatsen måste anges. | ||
Arbetsplatstyp |
Obligatorisk. Giltigt värde är "Apotek". Valideras enligt VR110. |
Obligatorisk. Giltigt värde är "Vårdenhet". Valideras enligt VR110. |
|
Arbetsplats-id |
Obligatorisk. Angiven GLN-kod valideras mot intyget VR039 och mot EXPO VR025. |
Valfri. Anmärkning: Arbetsplats-id ska alltid anges om det är möjligt. HSA-id ska anges för de som är HSA-anslutna, saknas det anges Organisationsnummer om sådant finns. |
|
Arbetsplats-id typ |
Obligatorisk. Ska vara GLN-kod för apotek |
Obligatorisk om arbetsplats-id anges. Giltiga värden är "HSA-id" eller "Organisationsnummer". |
|
Arbetsplatsnamn |
Får inte anges. | Obligatorisk. | |
Landskod | Får inte anges. | Får inte anges . | |
Adressuppgift
|
Alla uppgifter om arbetsplatsen och dess kontaktuppgifter för apotek hämtas från EXPO vid läsning utifrån angiven GLN-kod på arbetsplatsen, de får därför inte anges. |
Valfritt att ange en adress för arbetsplatsen vid dosunderlagshändelse. En besöksadress ska anges om möjligt, i andra hand kan en postadress anges. Endast en adress av varje adresstyp kan anges. |
|
Adresstyp |
Får inte anges. | Valfri. | Om kontaktuppgift adress anges måste Adresstyp, Adress, Postnummer och Postort ha ett värde |
Adress |
Får inte anges. |
Valfri. |
Om kontaktuppgift adress anges måste Adresstyp, Adress, Postnummer och Postort ha ett värde |
Postnummer |
Får inte anges. | Valfri. | Om kontaktuppgift adress anges måste Adresstyp, Adress, Postnummer och Postort |
Postort |
Får inte anges. | Valfri. | Om kontaktuppgift adress anges måste Adresstyp, Adress, Postnummer och Postort |
Uppdragsgivare
Tabell 11. Attribut informationsresurs personal på uppdragsgivaren
Term
|
Villkor Vård (Förskrivare, Legitimerad vårdpersonal sjuksköterska, Legitimerad vårdpersonal farmaceut) |
Kommentar |
Yrkeskod |
Obligatoriskt att ange Yrkeskod eller Utökad yrkeskod enligt VR144. Valideras mot Legitimationsregistret (FORS) enligt VR033. Valideras enligt VR138 vid registrera dosunderlag och registrera dossamtycke |
|
Utökad yrkeskod |
Obligatoriskt att ange Yrkeskod eller Utökad yrkeskod enligt VR144. Valideras mot Legitimationsregistret (FORS) enligt VR033. Valideras enligt VR138 vid registrera dosunderlag och registrera dossamtycke. |
|
Legitimationskod |
Valfri Valideras mot Legitimationsregistret (FORS) enligt VR033 |
|
Individuell förskrivarkod |
Obligatoriskt att ange Individuell förskrivarkod eller Gruppförskrivarkod Valideras mot Legitimationsregistret (FORS) enligt VR033 |
|
Gruppförskrivarkod |
Obligatoriskt att ange Individuell förskrivarkod eller Gruppförskrivarkod Valideras mot Legitimationsregistret (FORS) enligt VR033 |
|
Användar-id | Får inte anges. | |
Förnamn | Obligatorisk. | |
Efternamn | Obligatorisk. | |
Telefon |
Kontaktuppgift telefon är frivillig att ange. |
|
Telefonnummer |
Valfri. |
Om kontaktuppgift telefon anges måste Telefonnummer, ha ett värde |
Rangordning |
Valfri. |
Om kontaktuppgift telefon anges måste Rangordning ha ett värde |
Tillgänglig för patient |
Valfri. |
Om kontaktuppgift telefon anges måste Tillgänglig för patient ha ett värde |
Telefonnummer tillhör |
Valfri. Person – anger att telefonnummer tillhör individ. Arbetsplats – anger att telefonnummer tillhör arbetsplats. |
Om kontaktuppgift telefon anges måste Telefonnummer tillhör ha ett värde |
Arbetsplats
|
En arbetsplats måste anges. | Om en uppdragsgivare finns angiven kan även en arbetsplats kopplat till uppdragsgivaren finnas enligt regler nedan. |
Arbetsplatstyp |
Obligatorisk. Giltigt värde är "Vårdenhet". Valideras enligt VR110. |
|
Arbetsplats-id |
Valfri att ange Anmärkning: Arbetsplats-Id ska alltid anges om det är möjligt. HSA-id ska anges för de som är HSA-anslutna, saknas det anges Organisationsnummer om sådant finns. |
|
Arbetsplats id typ |
Villkor Måste anges om ett Arbetsplats-id anges. Giltigt värde är "HSA-id" eller "Organisationsnummer". |
|
Arbetsplatsnamn |
Obligatoriskt. | |
Adressuppgift | ||
Adresstyp |
Valfri. | |
Adress |
Valfri. | |
Postnummer |
Valfri. | |
Postort |
Valfri. | |
Landskod | Får inte anges. |
3. Regler och kontroller
3.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.
I tabell 12 nedan listas de generella verksamhetsregler som används i den här tillämpningsanvisningen.
Regel-id |
Regelnamn |
---|---|
VR025 | Validering av anropande apotek mot Expeditionsställeregistret |
VR033 | Validering av legitimation mot Legitimationsregistret |
VR034 | Validering av händelsens utförare mot intyget |
VR039 | Validering av anropande apotek mot intyget |
VR041 | Komplettera legitimationskod från Legitimationsregistret utifrån personnummer i intyget |
VR110 | Kontrollera arbetsplatstyp på Arbetsplats |
VR138 | Validering av yrkeskoder vid registrering av dossamtycke eller dosunderlag |
VR144 | Yrkeskod eller utökad yrkeskod måste anges |
VR194 |
Hantering av anrop via Resurssamling transaktion |
3.2. Automatiska kompletteringar
Automatisk komplettering innebär att E-hälsomyndigheten tillför information för vissa attribut vid vissa tillfällen. I tabell 14 nedan listas de automatiska kompletteringar som används i den här tillämpningsanvisningen. En detaljerad beskrivning av alla automatiska kompletteringar finns i Automatiska kompletteringar.
Tabell 13
Regel-id |
Regelnamn |
---|---|
Auto06 | Versionsnummer för patients läkemedelslista genereras |
Auto07 | Komplettering av tidpunkt för händelse |
3.3. Specifika verksamhetsregler
Verksamhetsregler beskriver validering och verksamhetslogik som E-hälsomyndigheten ansvarar för.
I tabell 14 nedan listas de specifika verksamhetsregler som bara används i denna tillämpningsanvisning.
Regel-id |
Regelnamn |
Beskrivning av regel |
Felkod och felmeddelande |
---|---|---|---|
R002 |
Kontroll av personens status i folkbokföringen |
Kontroll att personen som registreras som dospatient finns i Folkbokföringen med en giltig status. |
2-25-200 Personen har inte giltig status i folkbokföringen. |
R004 |
Validering vid registrering av dosunderlag |
Vid skapande av nytt dosunderlag:
Vid omregistrering av dosunderlag:
|
2-25-202 Personen är redan dospatient. |
R005
|
Dossamtycke – Giltigt från och med | När ett dossamtycke skapas kopplat till patienten gäller det från det datum och tidpunkt då registreringen görs (giltigt från och med sätts till datum och tidpunkt för registreringen). | N/A |
R006 |
Dosunderlag skapas |
Vid skapande av nytt dosunderlag:
|
N/A |
R007 | Omregistrera dosunderlag |
Vid omregistrering av dosunderlag:
|
N/A |
R008 |
Kontroll av dossamtycke vid skapande av dosunderlag | När ett dosunderlag skapas måste det finnas ett aktivt dossamtycke för patienten (dossamtycke finns registrerat, samtycket får inte ha ett avslutsdatum som har infallit eller passerats). |
2-25-204 Dossamtycke saknas. 2-25-207 Dosunderlag går inte att skapa eftersom personen saknar ett aktivt dossamtycke. 2-25-205 Aktivt dossamtycke saknas. |
R009 |
Validering vid registrering av dossamtycke |
Vid skapade av nytt dossamtycke:
Vid omregistrering av dossamtycke:
|
2-25-211 Dosunderlag finns redan på personen. |
R010 |
Vid behov sätts automatiskt på förskrivning av läkemedel om värde saknas |
När dosunderlag registreras för en patient sätts attributet Vid behov automatiskt till true för de av patientens läkemedelsförskrivningar som saknar ett angivet värde. Detta omfattar förskrivningar som har förskrivningsstatus Aktiv eller Parkerad. Samt förskrivningar som har slutexpedierats inom de senaste 3 månaderna eller som har avslutats inom de 3 senaste dagarna. Kommentar: |
N/A |
3.4. AFF-kontroller och kontrollsamlingar
Ingen kontrollsamling körs för denna tillämpningsanvisning.
4. Presentationskrav
Inga specifika presentationskrav finns för denna tillämpningsanvisning.
Versionshistorik
Version |
Datum |
Kommentar |
---|---|---|
1.0 | 2021-11-27 | Ny handbok vård- och apotekstjänster |
1.1 | 2022-03-30 |
Lagt till attributen Samtyckesstatus och Tillämpningsområde för dossamtycke Lagt till attributet "Resurstyp Dosunderlag" för dosunderlag Språkliga justeringar |
1.2 | 2022-11-10 |
Förbättringar dokumentation:
|
1.3 | 2024-02-22 |
Förbättringar dokumentation:
|
1.4 | 2024-08-26 |
|
1.5 | 2024-11-05 |
|