Hämta vårdtagareinformation, dosaktör (SOL:22)
Med denna tjänst kan dosaktören hämta information om en dospatient. Dospatienten är kopplad till ett specifikt dosapotek som producerar dospåsarna. Dospåsarna levereras av dosapoteket till en dosmottagare, som är leveransstället.
Innehållsförteckning
1. Tjänstespecifikation Hämta vårdtagareinformation, dosaktör (SOL:22)
HamtaVardtagareinformationDosaktor 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 |
|
I012 |
personnummer |
Dospatients personnummer i format: YYYYMMDDXXXX |
1..1 |
Exakt 12 pos |
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 |
|
I004 |
efternamn |
Farmaceuts eller annan apotekspersonals efternamn |
1..1 |
1 - 25 pos |
|
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 |
4. Utdata
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U001 |
resultatkod |
Möjliga värden: |
1..1 |
Enum |
|
U002 |
meddelandetext |
|
1..1 |
1 - 300 pos |
|
U003 |
meddelandeid |
ID för responsmeddelande |
1..1 |
Integer |
|
U004 |
vardtagarinformation |
Se U1 nedan |
0..1 |
Klass |
|
U005 |
samtyckeforskrivare |
Se U12 nedan |
0..1 |
Klass |
4.1. U1. Vårdtagarinformation
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U006 |
hemmaboende |
Indikator om ny dospatient är hemmaboende eller inte 1=Ja 2=Nej |
1..1 |
Enum |
|
U007 |
dosapotekid |
GLN-kod för dosapotek |
1..1 |
Exakt 13 pos |
|
U008 |
dosapoteknamn |
Namn på dosapotek |
1..1 |
1 - 50 pos Hämtas från EXPO |
|
U009 |
forstadosdag |
Första dosdag för leveransomgång för dosmottagare |
0..1 |
Datum |
|
U010 |
avvikandedosschema |
Visar om avvikande dosschema används Möjliga värden: 1=Ja 2=Nej |
1..1 |
Enum |
|
U011 |
patientinformation |
Se U2 nedan |
1..1 |
Klass Hämtas från FOLK |
|
U012 |
adressInfoFolk |
Se U3 nedan |
0..1 |
Klass Hämtas från FOLK |
|
U030 |
telefon |
Telefonnummer |
0..1 |
1 - 15 pos |
|
U013 |
tillfalligadress |
Se U4 nedan |
0..1 |
Klass |
|
U014 |
dosmottagare |
Se U6 nedan |
0..1 |
Klass |
|
U015 |
kontaktinformation |
Se U8 nedan |
0..1 |
Klass |
|
U017 |
adressInfoSPost |
Se U8 nedan |
0..1 |
Klass Hämtas från FOLK |
|
U089 |
statuskod |
Vårdtagarstatuskod
AKTIV VILANDE AVFORD AVLIDEN |
1..1 |
Enum |
| U097 | senastUppdaterad | Se U13 nedan | 1..1 | Klass |
|
U019 |
vilandestatusorsak |
Orsak till att dospatienten har, har haft eller ska ha status Vilande |
0..1 |
1 - 100 pos |
|
U102 |
vilandefranochmed |
Från och med vilket datum dospatienten har, har haft eller ska ha status Vilande |
0..1 |
Datum |
|
U103 |
vilandetillochmed |
Till och med vilket datum dospatienten har, har haft eller ska ha status Vilande |
0..1 |
Datum |
| U104 | versionsid | Versionsnummer för aktuell version av vårdtagarinformationen | 1..1 | Long |
| U105 | 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 |
| U106 | 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 |
4.2. U2. Patientinformation
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U020 |
fornamn |
Dospatientens förnamn |
1..1 |
1 - 80 pos |
|
U021 |
mellannamn |
Dospatientens mellannamn |
0..1 |
1 - 40 pos |
|
U022 |
efternamn |
Dospatientens efternamn |
1..1 |
1 - 60 pos |
|
U024 |
personnummer |
Personnummer för dospatient enligt format: YYYYMMDDXXXX |
1..1 |
Exakt 12 pos |
|
U025 |
lanskod |
Dospatientens län |
0..1 |
1 - 2 pos |
|
U026 |
kommunkod |
Dospatientens kommun |
0..1 |
1 - 2 pos |
4.3. U3. AdressInfoFolk
Patientens folkbokföringsadress
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U027 |
gatuadress |
Patientens folkbokföringsadress |
0..1 |
1 - 50 pos |
| U107 | foadress | Fortsättningsadress på gatuadress | 0..1 | 1 - 35 pos |
| U108 | coAdress | Patientens c/o adress om sådan finns | 0..1 | 1 - 50 pos |
|
U028 |
postnummer |
Hempostnummer |
0..1 |
1 - 10 pos |
|
U029 |
ort |
Hempostort |
0..1 |
1 - 50 pos |
|
U031 |
land |
Patientens land i klartext |
0..1 |
1 - 31 pos |
|
U032 |
skapadDat |
Datum när adressen skapades i FOLK |
0..1 |
Datum |
| U109 | andradDat | Datum när adressen senast ändrades i FOLK | 0..1 | Datum |
4.4. U4. AdressInfoSPost
Patientens särskilda postadress om sådan finns
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U110 |
gatuadress |
Patientens särskilda postadress |
0..1 |
1 - 50 pos |
| U111 | foadress | Fortsättningsadress på patientens särskilda postadress | 0..1 | 1 - 35 pos |
| U112 | postnummer | Postnummer för patientens särskilda postadress | 0..1 | Exakt 5 pos |
| U113 | ort | Ort för patientens särskilda postadress | 0..1 | 1 - 50 pos |
| U114 | coAdress | Patientens c/o adress om sådan finns | 0..1 | 1 - 50 pos |
| U115 | land | Land för patientens särskilda postadress i klartext | 0..1 | 1 - 35 pos |
| U116 | skapadDat | Datum när adressen skapades i FOLK | 0..1 | Datum |
| U117 | andradDat | Datum när adressen senast ändrades i FOLK | 0..1 | Datum |
4.5. U5. Tillfällig adress
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U033 |
adress |
Adress till tillfälligt boende |
0..1 |
1 - 50 pos |
|
U034 |
postnummer |
Postnummer till tillfälligt boende |
0..1 |
5 - 6 pos |
|
U035 |
ort |
Postort för tillfälligt boende |
0..1 |
1 - 50 pos |
|
U036 |
telefon |
Telefonnummer för tillfälligt boende |
0..1 |
1 - 15 pos |
|
U037 |
id |
ID för dosmottagare/leveransadress kopplad till den tillfälliga adressen |
1..1 |
1 - 31 pos |
|
U038 |
namn |
Namn på dosmottagare/leveransadress kopplad till den tillfälliga adressen |
0..1 |
1 – 64 pos Se R007 |
|
U039 |
frandatum |
Tillfällig adress giltig fr o m datum |
0..1 |
Datum |
|
U040 |
tilldatum |
Tillfällig adress giltig t o m datum |
0..1 |
Datum |
4.6. U6. Dosmottagare
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
| U041 | adress | Adress för dosmottagare | 0..1 | 1 - 50 pos |
| U042 | postnummer | Postnummer till dosmottagaren | 0..1 | 5 - 6 pos |
| U043 | ort | Dosmottagarens postort | 0..1 | 1 - 64 pos |
| U044 | arbetsplatskod | Arbetsplatskod för dosmottagare | 0..1 | 1 - 13 pos |
| U045 | id | ID för dospatientens aktuella dosmottagare | 0..1 | 1 - 31 pos |
|
U046 |
namn |
Namn på dosmottagare |
0..1 |
1 - 64 pos Se R007 |
| U047 | dosaktor | Den dosaktör som dosmottagaren tillhör. | 0..1 | 1 - 50 pos |
| U048 | dosapotek | Namn för det dosapotek som dosmottagaren tillhör. | 0..1 | 1 - 50 pos |
|
U135 |
dosapotekid |
GLN-kod för det dosapotek som dosmottagaren tillhör. |
0..1 |
Exakt 13 pos |
|
U049 |
avdelning |
Namnet på dospatientens avdelning om dosmottagaren är ett boende |
0..1 |
1 - 50 pos |
| U118 | kommunkod | Dosmottagarens kommunkod | 0..1 | 1 - 2 pos |
| U119 | lanskod | Dosmottagarens länskod | 0..1 | 1 - 2 pos |
| U120 | boende |
Indikerar om dosmottagaren är ett boende. True = Dosmottagaren är ett boende False = Dosmottagaren är inte ett boende |
0..1 | Boolean |
| U121 | sampack |
Indikerar om läkemedel till patienter tillhörande dosmottagaren kan paketeras ihop. True = patienters läkemedel kan paketeras ihop med andra patienters läkemedel False = patienters läkemedel kan inte paketeras ihop med andra patienters läkemedel |
0..1 | Boolean |
| U122 | Produktionsinformation | Se U9 | 0..1 | Klass |
| U123 | Leveransadress | Se U7 | 0..1 | Klass |
| U136 | Dold | Indikerar om dosmottagaren är dold eller synlig för vården | 0..1 | Boolean |
4.7. U7. Leveransadress
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U124 |
adress |
Adress för dosmottagare/leveransadress |
0..1 |
1 - 50 pos |
| U125 | postnummer | Postnummer till dosmottagare/leveransadress | 0..1 | 1 - 40 pos |
| U126 | ort | Dosmottagarens/leveransadressens postort | 0..1 | 1 - 64 pos |
| U127 | arbetsplatskod | Arbetsplatskod för dosmottagare/leveransadress | 0..1 | 1 - 13 pos |
| U128 | id | ID för dosmottagare/leveransadress | 0..1 | 1 - 31 pos |
| U129 | namn | Namn på dosmottagare/leveransadress | 0..1 | 1 - 64 pos |
| U130 | dosaktor | Den dosaktör som dosmottagaren/leveransadressen tillhör. | 0..1 | 1 - 50 pos |
| U131 | dosapotek | Det dosapotek som dosmottagaren/leveransadressen tillhör. | 0..1 | 1 - 50 pos |
| U132 | avdelning | Namnet på dospatientens avdelning om dosmottagaren/leveransadressen är ett boende | 0..1 | 1 - 50 pos |
| U133 | kommunkod | Dosmottagarens/leveransadressens kommunkod | 0..1 | 1 - 2 pos |
| U134 | lanskod | Dosmottagarens/leveransadressens länskod | 0..1 | 1 - 2 pos |
4.8. U8. Kontaktinformation
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U050 |
PALforskrivarkod |
Förskrivarkod för patientansvarig läkare (=PAL) |
0..1 |
Exakt 7 pos |
|
U051 |
PALfornamn |
Förnamn PAL |
0..1 |
1 - 25 pos |
|
U052 |
PALefternamn |
Efternamn PAL |
0..1 |
1 - 50 pos |
|
U053 |
anhorigkontaktnamn |
|
0..1 |
1 - 50 pos |
|
U054 |
anhorigkontaktemail |
E-postadress till anhörig |
0..1 |
1 - 40 pos |
|
U055 |
ansvarigkontaktnamn |
|
0..1 |
1 - 50 pos |
|
U056 |
ansvarigkontaktemail |
|
0..1 |
1 - 40 pos |
|
U057 |
ansvarigkontaktadress |
|
0..1 |
1 - 50 pos |
|
U058 |
ansvarigkontaktpostnummer |
|
0..1 |
Exakt 5 pos |
|
U059 |
ansvarigkontaktpostort |
|
0..1 |
1 - 50 pos |
|
U060 |
ansvarigkontakttelefon1 |
|
0..1 |
1 - 15 pos |
|
U061 |
ansvarigkontakttelefon2 |
|
0..1 |
1 - 15 pos |
|
U062 |
vardandeenhetid |
ID för ordinationsansvarig enhet |
0..1 |
1 - 64 pos |
|
U063 |
vardandeenhetnamn |
|
0..1 |
1 - 64 pos |
|
U064 |
vardandeenhetpostort |
|
0..1 |
1 - 50 pos |
|
U065 |
vardandeenhetpostnummer |
|
0..1 |
5 - 6 pos |
4.9. U9. Produktionsinformation
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U076 |
dosapotekid |
GLN-kod för dosapotek |
1..1 |
Exakt 13 pos |
|
U077 |
stopptidbestallning |
Datum och klockslag |
0..1 |
Datum |
|
U078 |
stopptidordination |
Datum och klockslag |
0..1 |
Datum |
|
U079 |
forstadosdag |
Första dosdag för leveransomgång för dosmottagare |
1..1 |
Datum |
|
U073 |
akutstopptid |
Klockslag |
0..1 |
Datum |
|
U080 |
dosvecka |
Vilken vecka dosleveransen kommer till dosmottagaren Möjliga värden: |
0..1 |
10 pos |
|
U081 |
standardschema |
Se U9 nedan |
1..1 |
Klass |
4.10. U10. Standardschema
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U084 |
periodlangd |
Längd på produktionsperiod i dagar tex 7, 14 eller 21 |
1..1 |
Integer |
|
U085 |
intagstillfalle |
Se U10 nedan |
1..*
|
Klass
|
4.11. U11. Intagstillfälle
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U086 |
intagstillfalleKl |
Klockslag enligt standardschema för intagstillfällen t ex 08, 12, 16, 20 |
1..1 |
Integer |
4.12. U12. Samtyckeförskrivare
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U092 |
fornamn |
Förnamn på användare som inhämtat dossamtycke |
1..1 |
1 - 25 pos |
|
U093 |
efternamn |
Efternamn på användare som inhämtat dossamtycke |
1..1 |
1 - 50 pos |
|
U094 |
forskrivarKod |
Förskrivarkod för förskrivare som inhämtat dossamtycke |
0..1 |
Exakt 7 pos |
|
U095 |
arbetsplatsKod |
Arbetsplatskod för användare som inhämtat dossamtycke |
1..1 |
1 - 13 pos |
|
U096 |
yrkesKod
|
LK = Läkare SJ = Sjuksköterska |
1..1
|
Enum |
4.13. U13. SenastUppdaterad
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U098 |
senastUppdaterad |
Tidsstämpel för när vårdtagarinformationen senast uppdaterades |
0..1 |
Datum |
|
U099 |
senastUppdateradAvFornamn |
Förnamn på den som senast uppdaterat vårdtagarinformationen |
0..1 |
1 - 25 pos |
|
U100 |
senastUppdateradAvEfternamn |
Efternamn på den som senast uppdaterat vårdtagarinformationen |
0..1 |
1 - 25 pos |
|
U101 |
senastUppdateradAvArbetsplats |
Arbetsplatskod alternativt apoteksid för den som senast uppdaterat vårdtagarinformationen |
0..1 |
1 - 13 pos |
|
U102 |
versionsid |
Versionsnummer för aktuell version av vårdtagarinformationen |
1..1 |
Long |
5. Verksamhetsregler/logik
| ID | Verksamhetsregler/logik |
|---|---|
|
R003 |
En dospatients tillfälliga 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 eller c) dagens datum har inte passerat tilldatum och frandatum är tomt |
|
R004 |
Om dospatientens personnummer inte hittas i SOL returneras ett fel (ERROR) i U001 resultatkod. |
|
R007 |
Om I007 dosapotekid och U007 dosapotekid inte tillhör samma dosaktör:
|
| R008 |
Om I012 personnummer ej finns i FOLK returneras ett felmeddelande. |
|
R009 |
Om dospatienten saknar dossamtycke sätts statusen i SOL till AVFÖRD. Om dospatienten har status avliden i FOLK sätts statusen i SOL till AVLIDEN. Dospatient som tilldelas status AVFÖRD eller AVLIDEN historiseras efter ett givet antal dagar som bestäms av E-hälsomyndigheten. |
| R011 | Om U096 yrkesKod = SJ kan U094 förskrivarKod vara tomt. |
Versionshistorik
|
Version |
Datum |
Kommentar |
|---|---|---|
| 1.0 | 2021-11-27 | Ny handbok vård- och apotekstjänster |
| 1.1 | 2022-05-25 |
Tagit bort U3 Ordinärtboendeinformation och U5 Särskilt boende och hemsjukvårdinformation Lagt till U3 adressInfoFolk, U4 Spostdressinfo, U6 dosmottagare, U7 Leveransadress Uppdaterat om R003 och R007. Tagit bort R010 U105 hemleverans, U106 aktorsbunden och U121 sampack tillagda. |
| 1.2 | 2022-11-10 | Ändrat maxlängd för U019 vilandestatusorsak till 100 tecken. |
| 1.3 | 2023-08-24 | Lagt till U136 Dold och justerat R007, R008 och R009. |
| 1.4 | 2024-02-22 | Tagit bort R002 |
| 1.5 | 2024-08-26 | Ändrat läkare till förskrivare samt ändrat förskrivarkod till frivillig i U12 |