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 |