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 läkare 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: 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: 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 |