Sök dosmottagare (SOL:12)
Med denna tjänst kan vården söka dosmottagare för att kunna utläsa leveransinformation för dospatienters dosrullar.
Innehållsförteckning
1. Tjänstespecifikation Sök dosmottagare (SOL:12)
SokDosmottagare V3.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 |
---|---|---|---|---|
I001 |
behorighetsinformation |
Se I1 nedan |
1..1 |
Klass |
I002 |
dosapotekid |
GLN-kod för dosapotek |
0..1 |
Exakt 13 pos |
I003 |
dosmottagareid |
Dosapotekets id för dosmottagaren |
0..1 |
1 – 31 pos |
I004 |
dosmottagarenamn |
Dosapotekets namn på dosmottagaren |
0..1 |
1 – 64 pos |
I005 |
ort |
Dosmottagarens postort |
0..1 |
|
I006 |
dosaktor |
Namn på dosaktör |
0..1 |
Minst 3 pos |
3.1. I1. Behörighetsinformation
ID |
<XML-tag> / fältnamn |
Kort beskrivning |
Mult |
Validering/ Anmärkning |
---|---|---|---|---|
I007 |
fornamn |
Användarens förnamn |
1..1 |
1 - 25 pos |
I008 |
efternamn |
Användarens efternamn |
1..1 |
1 - 25 pos |
I009 |
forskrivarkod |
Förskrivarkod |
0..1 |
Exakt 7 pos |
I010 |
yrkeskod |
Tillåtna värden: LK = Läkare BM = Barnmorska SJ = Sjuksköterska TL = Tandläkare RS = Röntgensjuksköterska TH = Tandhygienist |
0..1 |
Enum |
I011 |
arbetsplatskod |
Arbetsplatskod |
1..1 |
1 - 13 pos |
I012 |
hsaid |
Vårdens identitetsbegrepp |
0..1 |
1 - 64 pos |
I013 |
personnummer |
Användarens personnummer |
0..1 |
Exakt 12 pos |
I014 |
organisationsnummer |
Användarens organisations organisationsnummer |
0..1 |
1 - 20 pos |
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 |
Dosmottagare |
Se U1 nedan |
1..1 |
Klass |
4.1. U1. Dosmottagare
ID |
<XML-tag> / fältnamn |
Kort beskrivning |
Mult |
Validering/ Anmärkning |
---|---|---|---|---|
U005 |
adress |
Adress till dosmottagare |
0..1 |
1 – 50 pos |
U006 |
arbetsplatskod |
Arbetsplatskod till dosmottagare. Är aktuellt om dosmottagare t ex är en distriktsläkarmottagning. |
0..1 |
1 – 13 pos |
U007 |
avdelning |
Avdelning inom dosmottagare |
0..1 |
1 – 35 pos |
U008 |
dosmottagareid |
Dosapotekets id för dosmottagaren |
1..1 |
1 – 31 pos |
U009 |
kommunkod |
Dosmottagarens kommunkod |
0..1 |
Exakt 2 pos |
U010 |
lanskod |
Dosmottagarens länskod |
0..1 |
Exakt 2 pos |
U011 |
dosmottagarenamn |
Dosapotekets namn på dosmottagare |
1..1 |
|
U012 |
postnummer |
Dosmottagarens postnummer |
0..1 |
Exakt 5 pos |
U013 |
ort |
Dosmottagarens postort |
0..1 |
1 – 50 pos |
U014 |
dosaktor |
Namn på dosaktör |
1..1 |
1 – 50 pos |
U015 |
dosapotek |
Namn på dosapotek |
1..1 |
1 – 50 pos |
U016 |
dosapotekid |
GLN-kod för dosapotek |
1..1 |
Exakt 13 pos |
U017 | boende |
Indikerar om dosmottagaren är ett boende. True = Dosmottagaren är ett boende False = Dosmottagaren är inte ett boende |
1..1 | Boolean |
U018 | 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 |
U019 | Leverans | Se U2 nedan | 0..1 | Klass |
4.2. U2. Leveransadress
ID |
<XML-tag> / fältnamn |
Kort beskrivning |
Mult |
Anmärkning |
U020 |
adress |
Adress för dosmottagare/leveransadress |
0..1 |
1 – 50 pos |
U021 |
postnummer |
Postnummer till dosmottagare/leveransadress |
0..1 |
1 - 40 pos |
U022 |
ort |
Dosmottagarens/leveransadressens postort |
0..1 |
1 - 64 pos |
U023 |
arbetsplatskod |
Arbetsplatskod för dosmottagare/leveransadress |
0..1 |
1 - 13 pos |
U024 |
id |
ID för dosmottagare/leveransadress |
0..1 |
1 - 31 pos |
U025 |
namn |
Namn på dosmottagare/leveransadress |
0..1 |
1 – 64 pos |
U026 |
dosaktor |
Den dosaktör som dosmottagaren/leveransadressen tillhör. |
0..1 |
1 - 50 pos |
U027 |
dosapotek |
Det dosapotek som dosmottagaren/leveransadressen tillhör. |
0..1 |
1 - 50 pos |
U028 |
avdelning |
Namnet på dospatientens avdelning om dosmottagaren/leveransadressen är ett boende |
0..1 |
1 - 50 pos |
U029 |
kommunkod |
Dosmottagarens/leveransadressens kommunkod |
0..1 |
1-2 pos |
U030 | lanskod | Dosmottagarens/leveransadressens länskod | 0..1 | 1-2 pos |
5. Verksamhetsregler/logik
ID |
Verksamhetsregler/logik |
---|---|
R001 |
Information returneras endast för dosmottagare tillhörande godkända dosapotek. |
R002 |
Vid fler än 100 träffar avbryts anropet och felmeddelandet ”Användare måste specificera sitt urval ytterligare” returneras. |
R003 |
Det ska vara möjligt att söka på flera parametrar, dock måste minst en av parametrarna I005 ort eller I004 dosmottagarenamn anges. |
R004 |
Antingen I006 dosaktor eller I002 dosapotekid måste anges. |
R005 |
Om I003 dosmottagareid anges måste även I002 dosapotekid anges och då ignoreras övriga parametrar vid sökningen. |
R006 |
I007 fornamn, I008 efternamn, I011 arbetsplatskod samt anropstidpunkten sparas i SOL, som information om vem som senast ändrat informationen och när. |
Versionshistorik
Version |
Datum |
Kommentar |
---|---|---|
1.0 | 2021-11-27 | Ny handbok vård- och apotekstjänster |
1.1 | 2022-05-25 |
Utdata: Lagt till U017 boende Lagt till U018 sampack Lagt till U2. Leveransadress |