Hämta beställningar (SOL:07)
Med denna tjänst kan vården hämta en eller flera beställningar som tidigare lagts av vården på en produkt i originalförpackning. Det kan vara ett läkemedel som inte kan dispenseras, till exempel flytande hostmedicin, eller ett läkemedel som är ordinerat att intas vid behov. Beställningen ska hämtas, expedieras och levereras av det dosapotek som den aktuella dospatienten är kopplad till.
Innehållsförteckning
1. Tjänstespecifikation Hämta beställningar (SOL:07)
HamtaOriginalforpackning 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 |
|
I023 |
maxantal |
Maximalt antal beställningar som tjänsten ska returnera |
0..1 |
Integer |
|
I011 |
Bestallningsurval |
Se I2 nedan |
1..1 |
Klass |
|
I013 |
bestallningsid |
ID för beställningen |
0..1 |
0 - 40 pos |
3.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 |
|
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.2. I2. Beställningsurval
|
ID |
<XML-tag> / fältnamn |
Kort beskrivning |
Mult |
Validering/ Anmärkning |
|---|---|---|---|---|
|
I014 |
personnummer |
De personnummer för dospatienter som hämtningen avser enligt format: YYYYMMDDXXXX |
0..* |
0 - 12 pos |
|
I001 |
dosapotekid |
GLN-kod för dosapotek som beställningen är kopplad till |
0..1 |
Exakt 13 pos Valideras mot EXPO |
|
I018 |
vardgivarid |
HSA-id, vårdens identitetsbegrepp |
0..1 |
1 - 64 pos |
|
I019 |
dosmottagareid |
ID för dosmottagare |
0..* |
0 - 31 pos |
|
I020 |
bestallningsstatusurval |
Tillåtna värden: 1 = Mottagen 2 = Avvisad 3 = Expedierad 4 = Avbeställd 5 = Samtliga statusar 6 = Mottagen av apotek 7 = Under bearbetning 8 = Skickad av apotek |
1..1 |
Enum |
|
I021 |
frandatum |
Datum och klockslag |
1..1 |
Datum Se R004 |
|
I022 |
tilldatum |
Datum och klockslag |
1..1 |
Datum Se R004 |
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 |
Bestallningsrader |
Se U1 nedan |
0..* |
Klass |
4.1. U1. Beställningsrader
|
ID |
<XML-tag> / fältnamn |
Kort beskrivning |
Mult |
Validering/ Anmärkning |
|---|---|---|---|---|
|
U005 |
bestallningsid |
Beställningens ID, UUID |
1..1 |
1 - 40 pos |
|
U012 |
personnummer |
Personnummer för dospatient som beställningen avser enligt format: YYYYMMDDXXXX |
1..1 |
Exakt 12 pos |
|
U015 |
nplpackid |
|
0..1 |
0 - 16 pos |
|
U016 |
varunummer |
|
0..1 |
0 - 8 pos |
|
U018 |
ordinationsid |
Ordination som avropas |
1..1 |
1 - 20 pos |
|
U019 |
dosunderlagsversion |
Version på dosunderlaget |
0..1 |
0 - 10 pos |
|
U020 |
bestallningsresultat |
Möjliga värden: 0 = beställningen mottagen |
0..1 |
Integer |
|
U021 |
bestallningsresultattext |
|
0..1 |
0 - 80 pos |
|
U022 |
bestallningsstatusurval |
Möjliga värden:
5 = Mottagen av apotek 6 = Under bearbetning 7 = Skickad av apotek |
1..1 |
Enum |
|
U023 |
statustidpunkt |
Datum och klockslag |
1..1 |
Datum |
|
U025 |
meddelandefranapotek |
Meddelande från dosapotek |
0..1 |
0 - 255 pos |
|
U026 |
onskadleveranstid |
Datum och klockslag |
0..1 |
Datum |
|
U027 |
planeradleveranstid |
Datum och klockslag |
0..1 |
Datum |
|
U028 |
dosmottagareid |
ID för dosmottagare |
0..1 |
1 – 31 pos |
|
U029 |
dosmottagarenamn |
Namn på dosmottagare |
0..1 |
1 – 64 pos |
|
U030 |
bestallningstid |
Datum och klockslag |
0..1 |
Datum |
|
U031 |
bestallarefornamn |
|
1..1 |
Sträng |
|
U032 |
bestallareefternamn |
|
1..1 |
Sträng |
|
U033 |
bestallarearbetsplats |
Beställarens arbetsplatskod |
1..1 |
Sträng |
|
U034 |
antalforpackningar |
|
0..1 |
Integer |
|
U035 |
akutbestallning |
Möjliga värden: 0 = EJ_AKUT |
0..1 |
Enum |
|
U036 |
dospotekid |
GLN-kod för dosapotek |
1..1 |
Exakt 13 pos |
|
U037 |
forskrivningsid |
Ett UUID |
1..1 |
Exakt 36 pos |
5. Verksamhetsregler/logik
|
ID |
Verksamhetsregler/logik |
|---|---|
|
R001 |
Urval på vårdgivare utförs genom att ange I018 vardgivarid. |
|
R002 |
Urval på dospatient utförs genom att ange I009 personnummer. |
|
R003 |
Urval på dosmottagareid utförs genom att ange ett eller flera av parametern I019 dosmottagareid. |
|
R004 |
Vid sökning ska I020 bestallningsstatusurval, I021 frandatum och I022 tilldatum anges, annars returneras felmeddelande. |
|
R005 |
Det är möjligt att begränsa antalet sökträffar genom att ange ett värde i parametern I023 maxantal. Detta värde skall vara mellan 1 och 500 (maxantal sökträffar bestämt av eHälsomyndigheten). |
|
R006 |
Det är möjligt att hämta en specifik beställning genom att söka på I013 bestallningsid. Notera att när man anger bestallningsid så är det inte möjligt att även ange en parameter ur beställningsurval. |
Versionshistorik
|
Version |
Datum |
Kommentar |
|---|---|---|
| 1.0 | 2021-11-27 | Ny handbok vård- och apotekstjänster |
| 1.1 | 2022-05-25 |
Ändrat: U037 forskrivningsID I014 personnummer, går att ange flera |