Hämta vårdtagareinformation (SOL:02)
Med denna tjänst kan vården hämta information om en dospatient. Dospatienten är kopplad till ett specifikt dosapotek som producerar dospåsarna åt dospatienten. Dospåsarna levereras av dosapoteket till en dosmottagare, som är leveransstället.
Innehållsförteckning
1. Tjänstespecifikation Hämta vårdtagareinformation (SOL:02)
HamtaVardtagareinformation V4.0
1.1. Formatregler
1.1.1. Datum / 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.
2. Indata
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
I002 |
Behorighetsinformation |
Se I1 nedan |
1..1 |
Klass |
|
I012 |
personnummer |
Personnummer enligt format: YYYYMMDDXXXX |
1..1 |
Exakt 12 pos |
2.1. I1. Behörighetsinformation
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
I003 |
fornamn |
Förnamn på behörig användare som använder tjänsten |
1..1 |
1 - 25 pos |
|
I004 |
efternamn |
Efternamn på behörig användare som använder tjänsten |
1..1 |
1 - 25 pos |
|
I005 |
forskrivarkod |
|
0..1 |
Exakt 7 pos |
|
I006 |
yrkeskod |
Typ av förskrivare LK = Läkare BM = Barnmorska SJ = Sjuksköterska TL = Tandläkare RS = Röntgensjuksköterska TH = Tandhygienist |
0..1 |
Enum |
|
I007 |
arbetsplatskod |
Arbetsplatskod |
1..1 |
1 - 13 pos |
|
I008 |
hsaid |
Vårdens identitetsbegrepp |
0..1 |
1 - 64 pos |
|
I009 |
personnummer |
Användarens personnummer |
0..1 |
Exakt 12 pos |
|
I010 |
organisationsnummer |
Användarens organisations organisationsnummer |
0..1 |
1 - 20 pos |
3. 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 |
3.1. U1. Vårdtagarinformation
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U005 |
hemmaboende |
Indikator om dospatient är hemmaboende eller inte True = Hemmaboende False = Ej hemmaboende |
1..1 |
Boolean |
|
U006 |
dosapotekid |
GLN-kod för dosapotek |
1..1 |
Exakt 13 pos |
|
U007 |
dosapoteknamn |
Namn på dosapotek |
1..1 |
1 - 50 pos Hämtas från EXPO |
|
U008 |
forstadosdag |
Första dosdag för leveransomgång |
0..1 |
Datum |
|
U009 |
avvikandedosschema |
Anger om avvikande dosschema används True = Avvikande dosschema False = Ej avvikande dosschema |
1..1 |
Boolean |
|
U010 |
Patientinformation |
Se U2 nedan |
1..1 |
Klass Hämtas från FOLK |
|
U018 |
AdressInfoFolk |
Se U3 nedan |
0..1 |
Klass Hämtas från FOLK |
| U123 | AdressInfoSPost | Se U4 nedan | 0..1 |
Klass Hämtas från FOLK |
|
U022 |
telefon |
Telefonnummer |
0..1 |
1 - 15 pos |
|
U025 |
Tillfalligadress |
Se U5 nedan |
0..1 |
Klass |
|
U032 |
Dosmottagare |
Se U6 nedan |
0..1 |
Klass |
|
U042 |
Kontaktinformation |
Se U8 nedan |
0..1 |
Klass |
|
U085 |
statuskod |
Vårdtagarstatuskod 1 = Aktiv 2 = Vilande 4 = Avförd 5 = Avliden |
1..1 |
Enum |
|
U088 |
vilandestatusorsak |
Orsak till att dospatienten har haft eller ska ha status Vilande |
0..1 |
1 - 100 pos |
| U089 | senastUppdaterad | Se U12 nedan | 0..1 | Klass |
|
U095 |
vilandefranochmed |
Från och med vilket datum dospatienten har haft eller ska ha status Vilande |
0..1 |
Datum |
|
U096 |
vilandetillochmed |
Till och med vilket datum dospatienten har haft eller ska ha status Vilande |
0..1 |
Datum |
| U100 | 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 |
1..1 | Boolean |
| U101 | 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 |
1..1 | Boolean |
3.2. U2. Patientinformation
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U011 |
fornamn |
Dospatientens förnamn |
1..1 |
1 - 80 pos |
|
U012 |
mellannamn |
Dospatientens mellannamn |
0..1 |
1 - 40 pos |
|
U013 |
efternamn |
Dospatientens efternamn |
1..1 |
1 - 60 pos |
|
U015 |
personnummer |
Personnummer för dospatient enligt format: YYYYMMDDXXXX |
1..1 |
Exakt 12 pos |
|
U016 |
lanskod |
Dospatientens län |
0..1 |
1 - 2 pos |
|
U017 |
kommunkod |
Dospatientens kommun |
0..1 |
1 - 2 pos |
3.3. U3. AdressInfoFolk
Patientens folkbokföringsadress
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U019 |
gatuadress |
Patientens folkbokföringsadress |
0..1 |
1 - 50 pos |
| U111 | foadress | Fortsättningsadress på gatuadress | 0..1 | 1 - 35 pos |
|
U020 |
postnummer |
Patientens postnummer |
0..1 |
Exakt 5 pos |
|
U021 |
ort |
Patientens folkbokföringsort |
0..1 |
1 - 50 pos |
| U110 | coAdress | Patientens c/o adress om sådan finns | 0..1 | 1 - 50 pos |
| U112 | land | Patientens land i klartext | 0..1 | Datum |
| U113 | skapadDat | Datum när adressen skapades i FOLK | 0..1 | Datum |
| U114 | andradDat | Datum när adressen senast ändrades i FOLK | 0..1 | Datum |
3.4. U4. AdressInfoSPost
Patientens särskilda postadress om sådan finns
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U115 |
gatuadress |
Patientens särskilda postadress |
0..1 |
1 - 50 pos |
| U116 | foadress | Fortsättningsadress på patientens särskilda postadress | 0..1 | 1 - 35 pos |
|
U117 |
postnummer |
Postnummer för patientens särskilda postadress |
0..1 |
Exakt 5 pos |
|
U118 |
ort |
Ort för patientens särskilda postadress |
0..1 |
1 - 50 pos |
| U119 | coAdress | Patientens c/o adress om sådan finns | 0..1 | 1 - 50 pos |
| U120 | land | Land för patientens särskilda postadress i klartext | 0..1 | Datum |
| U121 | skapadDat | Datum när adressen skapades i FOLK | 0..1 | Datum |
| U122 | andradDat | Datum när adressen senast ändrades i FOLK | 0..1 | Datum |
3.5. U5. Tillfällig adress
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U026 |
adress |
Adress till tillfälligt boende |
0..1 |
1 - 50 pos |
|
U027 |
postnummer |
Postnummer till tillfälligt boende |
0..1 |
Exakt 5 pos |
|
U028 |
ort |
Tillfälliga boendets postort |
0..1 |
1 - 50 pos |
|
U029 |
telefon |
Tillfälliga boendets telefonnummer |
0..1 |
1 - 15 pos |
|
U030 |
id |
ID för dosmottagare/leveransadress kopplad till tillfällig adress |
0..1 |
1 - 31 pos |
|
U099 |
namn |
Namn på dosmottagare kopplad till tillfällig adress |
0..1 |
1 – 64 pos |
|
U096 |
frandatum |
Tillfällig adress giltig fr o m datum |
0..1 |
Datum |
|
U097 |
tilldatum |
Tillfällig adress giltig t o m datum |
0..1 |
Datum |
3.6. U6. Dosmottagare
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U035 |
adress |
Adress för dosmottagare |
0..1 |
1 - 50 pos |
|
U036 |
postnummer |
Postnummer till dosmottagare |
0..1 |
1 - 40 pos |
|
U037 |
ort |
Dosmottagarens postort |
0..1 |
1 - 64 pos |
|
U039 |
arbetsplatskod |
Arbetsplatskod för dosmottagare |
0..1 |
1 - 13 pos |
|
U040 |
id |
ID för dospatientens aktuella dosmottagare |
0..1 |
1 - 31 pos |
|
U041 |
namn |
Namn på dosmottagare |
0..1 |
1 – 64 pos |
| U069 | dosaktor | Den dosaktör som dosmottagaren tillhör | 0..1 | 1 - 50 pos |
| U070 | dosapotek | Namn på det dosapotek som dosmottagaren tillhör | 0..1 | 1 - 50 pos |
| U109 | dosapotekid | GLN-kod till det dosapotek som dosmottagaren tillhör | 0..1 | Exakt 13 pos |
| U102 | avdelning | Namnet på dospatientens avdelning om dosmottagaren är ett boende | 0..1 | 1 - 50 pos |
| U103 | kommunkod | Dosmottagarens kommunkod | 0..1 | 1 - 2 pos |
| U104 | lanskod | Dosmottagarens länskod | 0..1 | 1 - 2 pos |
| U105 | boende |
Indikerar om dosmottagaren är ett boende. True = Dosmottagaren är ett boende False = Dosmottagaren är inte ett boende |
0..1 | Boolean |
| U106 | 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 |
| U107 | Produktionsinformation | Se U9 nedan | 0..1 | Klass |
| U108 | Leveransadress | Se U7 nedan | 0..1 | Klass |
3.7. U7. Leveransadress
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U035 |
adress |
Adress för dosmottagare/leveransadress |
0..1 |
1 - 50 pos |
| U036 | postnummer | Postnummer till dosmottagare/leveransadress | 0..1 | 1 - 40 pos |
| U037 | ort | Dosmottagarens/leveransadressens postort | 0..1 | 1 - 64 pos |
| U039 | arbetsplatskod | Arbetsplatskod för dosmottagare/leveransadress | 0..1 | 1 - 13 pos |
| U040 | id | ID för dosmottagare/leveransadress | 0..1 | 1 - 31 pos |
| U041 | namn | Namn på dosmottagare/leveransadress | 0..1 | 1 – 64 pos |
| U124 | dosaktor | Den dosaktör som dosmottagaren/leveransadressen tillhör. | 0..1 | 1 - 50 pos |
| U125 | dosapotek | Det dosapotek som dosmottagaren/leveransadressen tillhör. | 0..1 | 1 - 50 pos |
| U102 | avdelning | Namnet på dospatientens avdelning om dosmottagaren/leveransadressen är ett boende | 0..1 | 1 - 50 pos |
| U103 | kommunkod | Dosmottagarens/leveransadressens kommunkod | 0..1 | 1 - 2 pos |
| U104 | lanskod | Dosmottagarens/leveransadressens länskod | 0..1 | 1 - 2 pos |
3.8. U8. Kontaktinformation
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U043 |
PALforskrivarkod |
Förskrivarkod till patientansvarig läkare (=PAL) |
0..1 |
Exakt 7 pos |
|
U044 |
PALfornamn |
Förnamn PAL |
0..1 |
1 - 25 pos |
|
U045 |
PALefternamn |
Efternamn PAL |
0..1 |
1 - 50 pos |
|
U046 |
anhorigkontaktnamn |
|
0..1 |
1 - 50 pos |
|
U047 |
anhorigkontaktemail |
E-postadress till anhörig |
0..1 |
1 - 40 pos |
|
U048 |
ansvarigkontaktnamn |
|
0..1 |
1 - 50 pos |
|
U049 |
ansvarigkontaktemail |
|
0..1 |
1 - 40 pos |
|
U050 |
ansvarigkontaktadress |
|
0..1 |
1 - 50 pos |
|
U051 |
ansvarigkontaktpostnummer |
|
0..1 |
Exakt 5 pos |
|
U052 |
ansvarigkontaktpostort |
|
0..1 |
1 - 50 pos |
|
U053 |
ansvarigkontakttelefon1 |
|
0..1 |
1 - 15 pos |
|
U054 |
ansvarigkontakttelefon2 |
|
0..1 |
1 - 15 pos |
|
U055 |
vardandeenhetid |
ID för ordinationsansvarig enhet |
0..1 |
1 - 31 pos |
|
U056 |
vardandeenhetnamn |
Namn på ordinationsansvarig enhet |
0..1 |
1 - 64 pos |
|
U057 |
vardandeenhetpostort |
Postort för ordinationssansvarig enhet |
0..1 |
1 - 50 pos |
|
U058 |
vardandeenhetpostnummer |
|
0..1 |
|
3.9. U8. Produktionsinformation
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U071 |
dosapotekid |
GLN-kod för dosapotek |
1..1 |
Exakt 13 pos |
|
U072 |
stopptidbestallning |
Datum och klockslag |
0..1 |
Datum |
|
U073 |
stopptidordination |
Datum och klockslag |
0..1 |
Datum |
|
U074 |
forstadosdag |
Första dosdag för leveransomgång |
1..1 |
Datum |
|
U075 |
dosvecka |
Vilken vecka dosleveransen kommer till dosmottagaren Möjliga värden: U = udda vecka |
0..1 |
Sträng |
|
U076 |
doseringsschema |
Standardschema |
1..1 |
Klass |
|
U095 |
akutstopptid |
Akut stopptid för beställning |
0..1 |
Datum |
3.10. U9. Standardschema
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U077 |
periodlangd |
Längd på produktionsperiod i dagar tex 7, 14 eller 21 |
1..1 |
Integer |
|
U078 |
intagstillfalle |
Intagstillfälle |
1..* |
Klass |
3.11. U10. Intagstillfälle
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U079 |
intagstillfalleKl |
Klockslag enligt standardschema för intagstillfällen t ex 08, 12, 16, 20 |
1..1 |
Integer |
3.12. U12. SenastUppdaterad
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
|
U090 |
senastUppdaterad |
Tidsstämpel för när vårdtagarinformationen senast uppdaterades |
0..1 |
Datum |
|
U091 |
senastUppdateradAvFornamn |
Förnamn på den som senast uppdaterat vårdtagarinformationen |
0..1 |
1 - 25 pos |
|
U092 |
senastUppdateradAvEfternamn |
Efternamn på den som senast uppdaterat vårdtagarinformationen |
0..1 |
1 - 25 pos |
|
U093 |
senastUppdateradAvArbetsplats |
Arbetsplatskod alternativt apoteksid för den som senast uppdaterat vårdtagarinformationen |
0..1 |
1 - 13 pos |
|
U094 |
versionsid |
Versionsnummer för aktuell version av vårdtagarinformationen |
1..1 |
Long |
4. Verksamhetsregler/logik
| ID | Verksamhetsregler/logik |
|---|---|
|
R001 |
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 |
|
R002 |
Om dospatientens personnummer inte hittas i SOL returneras ett fel (ERROR) i U001 resultatkod. |
|
R005 |
Om I012 personnummer ej finns i FOLK eller dospatienten saknar dossamtycke hos eHälsomyndigheten så returneras ett felmeddelande. |
|
R006 |
Om I012 personnummer ej finns i FOLK eller dospatienten saknar dossamtycke så 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 eHälsomyndigheten. |
Versionshistorik
|
Version |
Datum |
Kommentar |
|---|---|---|
| 1.0 | 2021-11-27 | Ny handbok vård- och apotekstjänster |
| 1.1 | 2022-05-25 |
U5. Särskilt boende och hemsjukvårdinformation ersatt av U6. Dosmottagare U102-U108 tillagda i U6. Dosmottagare Referens till U6. Dosmottagare flyttad till U1. Vårdtagarinformation U100 hemleverans tillagd U089 Senast uppdaterad flyttad till U1. Vårdtagarinformation U8. Leveransadress tillagd R007 borttagen då produktionsinformation alltid finns i U6. Dosmottagare U101 aktörsbunden tillagd U3. Hemmaboendeinformation ersatt av U3. AdressinfoFolk och U4. SPostadress |
| 1.2 | 2022-11-10 | Ändrat maxlängd för vilandestatusorsak till 100 tecken |