Skapa ny vårdtagare för dos, dosaktör (SOL:21)

Med denna tjänst kan dosaktören på uppdrag av region eller kommun med vilken man har avtal, skapa en vårdtagare för dos, d v s dospatient. Dosapoteket ska, efter att dosunderlag skapats, uppdatera dostillhörighet via E-hälsomyndighetens tjänster. Dostillhörigheten visar vilket dosapotek dospatienten tillhör. När denna uppdatering är klar finns kopplingen mellan dospatient, dosunderlag och dosapotek.


Innehållsförteckning

1. Tjänstespecifikation Skapa ny vårdtagare för dos, dosaktör (SOL:21)

SkapaVardtagareDosaktor V4.0

2. Formatregler

2.1. Datum och tid

Datatypen ”Datum” sätts i SOLs tjänstespecifikationer till formatet YYYY-MM-DDTHH:mm:ss om inte annat anges. Om inte tid skickas med vid anrop sätts tiden till 00:00:00. Vissa tjänster tar bara hänsyn till YYYY-MM-DD-delen.

3. Indata

ID <XML-tag> / fältnamn Kort beskrivning Mult Validering/ Anmärkning

I002

behorighetsInformation

Se I1 nedan

1..1

Klass

I008

samtyckeforskrivare

Se I2 nedan

1..1

Klass

I014

vardtagarinformation

Se I2 nedan

1..1

Klass

I102

meddelandetilldosapotek


1..1

1 - 1024 pos, Se R017

3.1. I1. Behörighetsinformation

ID <XML-tag> / fältnamn Kort beskrivning Mult Validering/ Anmärkning

I003

fornamn

Farmaceuts eller annan apotekspersonals förnamn

1..1

1 - 25 pos

Se R012

I004

efternamn

Farmaceuts eller annan apotekspersonals efternamn

1..1

1 - 25 pos

Se R012

I005

legitimationskod

Farmaceuts legitimationskod

0..1

Exakt 6 pos

I006

yrkesroll

Användarens yrkesroll

FA = Farmaceut (apotekare och receptarie)

eller

AP = apotekspersonal.

1..1

Enum



I007

dosapotekid

GLN-kod för dosapotek

1..1

Exakt 13 pos

Valideras mot EXPO

Se R012

3.2. I2. Samtyckesförskrivare

ID <XML-tag> / fältnamn Kort beskrivning Mult Validering/ Anmärkning

I009

fornamn

Förnamn på användare som inhämtat dossamtycke

1..1

1 - 25 pos

I010

efternamn

Efternamn på användare som inhämtat dossamtycke

1..1

1 - 50 pos

I011

forskrivarKod

Förskrivarkod för förskrivare som inhämtat dossamtycke

0..1

Exakt 7 pos

I012

arbetsplatsKod

Arbetsplatskod för användare som inhämtat dossamtycke

1..1

1-13 pos

I013

yrkesKod

Tillåtna värden:

LK = Läkare

SJ = Sjuksköterska

1..1

Enum

Se R006

3.3. I3. Vårdtagarinformation

ID <XML-tag> / fältnamn Kort beskrivning Mult Validering/ Anmärkning

I015

hemmaboende

Indikator om ny dospatient är hemmaboende eller inte.

Tillåtna värden:
JA

NEJ 

1..1

Enum

Se R003


I016

dosapotekid

GLN-kod för dosapotek

0..1

Exakt 13 pos

Valideras mot EXPO


I018

forstadosdag

Dag då dospatient ska påbörja behandling med dosdispenserade läkemedel. Anges om annan än den som finns i dospatientens produktionsinformation.

0..1

Datum

I019

avvikandedosschema

Indikator om avvikande dosschema eller inte.

Tillåtna värden:
JA

NEJ 

1..1

Enum


I025

personnummer

Personnummer för ny dospatient enligt format:

YYYYMMDDXXXX

1..1

Exakt 12 pos

Se R015 och R018

I032

telefon

Dospatientens telefonnummer

0..1

1-15 pos

I033

dosmottagareid

ID för dosmottagare för ordinärt boende (dospatientens folkbokföringsadress)

1..1

1-31 pos

Valideras mot dosmottagare i SOL

I035

tillfalligadress

Se I5 nedan

0..1

Klass

I054

kontaktinformation

Se I7 nedan

0..1

Klass

I100

vilandestatusorsak

Orsak till att dospatienten ska ha status Vilande

0..1

1-100 pos

Se R011

I104

vilandefranochmed

Från och med vilket datum dospatienten ska ha status Vilande

0..1

Datum

Se R011

I105

vilandetillochmed

Till och med vilket datum dospatienten ska ha status Vilande

0..1

Datum

Se R011

I106 hemleverans

Indikerar att läkemedlen skickas till dospatientens hemadress.

True = läkemedlen ska skickas till dospatientens hemadress

False = läkemedlen ska inte skickas till dospatientens hemadress
0..1 Boolean
I107 aktörsbunden

Indikerar om dostjänsten är bunden till dosaktören eller upphandlad av en region

True = dostjänsten är bunden till dosaktören

False = dostjänsten är upphandlad av en region
0..1 Boolean

3.4. I5. Tillfällig adress

ID <XML-tag> / fältnamn Kort beskrivning Mult Validering/ Anmärkning

I036

adress

Adress till tillfälligt boende

0..1

1-50 pos

I037

postnummer

Postnummer till tillfälligt boende

0..1

5-6 pos

I038

ort

Postort för tillfälligt boende

0..1

1-50 pos

I039

telefon

Telefonnummer för tillfälligt boende

0..1

1-15 pos

I040

id

ID för dosmottagare/leveransadress kopplad till tillfällig adress

0..1

1-31 pos


I042

frandatum

Tillfälligt boende giltig fr o m datum

0..1

Datum

Se R003, R008

I043

tilldatum

Tillfälligt boende giltig  t o m datum

0..1

Datum

Se R003, R008


3.5. I7. Kontaktinformation

ID <XML-tag> / fältnamn Kort beskrivning Mult Validering/ Anmärkning

I055

PALforskrivarkod

Förskrivarkod för patientansvarig läkare (=PAL)

0..1

Exakt 7 pos

I056

PALfornamn

Förnamn PAL

0..1

1 - 25 pos

I057

PALefternamn

Efternamn PAL

0..1

1 - 50 pos

I058

anhorigkontaktnamn


0..1

1 - 50 pos

I059

anhorigkontaktemail

E-postadress till anhörig


0..1

1 - 40 pos

I060

ansvarigkontaktnamn


0..1

1 - 50 pos

I061

ansvarigkontaktemail


0..1

1 - 40 pos

I062

ansvarigkontaktadress


0..1

1 - 50 pos

I063

ansvarigkontaktpostnummer


0..1

Exakt 5 pos

I064

ansvarigkontaktpostort


0..1

1 - 50 pos

I065

ansvarigkontakttelefon1


0..1

1 - 15 pos

I066

ansvarigkontakttelefon2


0..1

1 - 15 pos

I067

vardandeenhetid

ID för ordinationsansvarig enhet

0..1

1 - 64 pos

Valideras mot enheter i SOL

4. Utdata

Utdata returneras enligt Utdata i Hämta vårdtagareinformation, dosaktör (SOL:22)

5. Verksamhetsregler/logik

ID Verksamhetsregler/logik

R001

Användare hos dosaktör får endast skapa dospatient kopplad till ett av de egna dosapoteken. Om I016 dosapotekid ej är angiven kopplas dospatienten till dosapotekid angivet i I007. Om I016 dosapotekid är angiven kontrolleras att I007 dosapotekid och I016 dosapotekid tillhör samma dosaktör.  

R003

Tillfällig adress gäller om den finns och

a)  både frandatum och tilldatum har angivits och dagens datum ligger inom datumintervallet frandatum – tilldatum

eller

b) dagens datum har passerat frandatum och tilldatum är tomt

R006

Giltig I013 yrkeskod för dossamtyckesförskrivare är LK och SJ. Om I013 = LK är I011 ett obligatoriskt fält, annars valfritt.

R011

I105 vilandetillochmed får inte ligga före I104 vilandefranochmed

I100 vilandestatusorsak måste anges om I104 vilandefranochmed har angivits.

I100 vilandestatusorsak kan inte anges och om I104 vilandefranochmed inte har angivits.

R012

I003 fornamn, I004 efternamn, I007 dosapotekid samt anropstidpunkten sparas i SOL, som information om när och av vem vårdtagarinformationen senast ändrades. 

R013

När ny dospatient har skapats, skapar SOL ett nytt meddelande adresserat till vården (se SOL 29_Tjänstespecifikation_Skicka meddelanden till vården).

R014

Vårdande enhet och dosmottagare/produktionsinformation för dospatientens boenden måste tillhöra samma dosaktör som dospatienten.

R015

I025 personnummer måste finnas och ej ha status Tekniskt avregistrerad eller Avliden i FOLK.

R017 Om I102 meddelandefråndosapotek är skilt från null skickas ett meddelande till vården.
R018 I025 personnummer får inte redan finnas sparad som vårdtagare i SOL.

Versionshistorik

Version

Datum

Kommentar

1.0 2021-11-27 Ny handbok vård- och apotekstjänster
1.1 2022-05-25

Tagit bort I046 boendeenhetid och I097 statuskod

Tagit bort R004, R005, R010 och R016.

Uppdaterat R003 och R011.

Lagt till I106 hemleverans och I107 aktörsbunden

Uppdaterat Utdata med referens till SOL 22

1.2 2022-11-10 Ändrat maxlängd för I100 vilandestatusorsak till 100 tecken.
1.3 2023-08-24 Lagt till R018
1.4 2024-02-22 Tagit bort R002
Uppdaterat R015
1.5 2024-08- Uppdaterat formulering i I2, samt rättat I011 till valfri