Hämta beställningar, dosaktör (SOL:27)
Med denna tjänst kan dosaktören 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, dosaktör (SOL:27)
HamtaBestallningarDosaktor 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 |
I020 | maxantal | Maximalt antal beställningar som tjänsten ska returnera | 0..1 | Maxvärde = 500 |
I003 | bestallningsurval | Se I2 nedan | 1..1 | Klass |
I010 | bestallningsid |
| 0..1 | 0 - 40 pos |
3.1. I1. Behörighetsinformation
ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
I004 | fornamn | Farmaceuts eller annan apotekspersonals förnamn | 1..1 | 1 - 25 pos |
I005 | efternamn | Farmaceuts eller annan apotekspersonals efternamn | 1..1 | 1 - 25 pos |
I006 | legitimationskod | Farmaceuts legitimationskod | 0..1 | Exakt 6 pos |
I007 | yrkesroll | Användarens yrkesroll FA = Farmaceut (apotekare och receptarie) eller AP = Apotekspersonal | 1..1 | Enum |
I008 | dosapotekid | GLN-kod för dosapotek | 1..1 | Exakt 13 pos Valideras mot EXPO |
3.2. I2. Beställningsurval
ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
I011 | personnummer | De personnummer som hämtningen avser enligt format: YYYYMMDDXXXX | 0..* | 0 - 12 pos |
I015 | vardgivarid | HSA-id, vårdens identitetsbegrepp | 0..1 | 1 - 64 pos Se R003 |
I016 | dosmottagareid | ID för dosmottagare | 0..* | 0 - 31 pos |
I017 | bestallningsstatusurval | Tillåtna värden: MOTTAGEN AVVISAD EXPEDIERAD AVBESTALLD SAMTLIGA_STATUS MOTTAGEN_AV_APOTEK UNDER_BEARBETNING SKICKAD_AV_APOTEK | 0..1 | 1 - 40 pos |
I018 | frandatum | Datum och klockslag | 0..1 | Datum Se R006 |
I019 | tilldatum | Datum och klockslag | 0..1 | Datum Se R006 |
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 |
|---|---|---|---|---|
U035 | personnummer | Personnummer för dospatient som beställningen avser enligt format: YYYYMMDDXXXX | 1..1 | Exakt 12 pos |
U006 | bestallningsid | Beställningens ID, UUID | 1..1 | 1 - 40 pos |
U008 | nplpackid | 0..1 | 0 - 16 pos | |
U009 | varunummer | 0..1 | 0 - 8 pos | |
U011 | ordinationsid | 1..1 | 1 - 20 pos | |
U012 | dosunderlagsversion | 0..1 | 0 - 10 pos | |
U013 | meddelande | Meddelande till dosapotek | 0..1 | 0 - 255 pos |
U014 | dosmottagareid | 0..1 | 0 - 31 pos | |
U015 | dosmottagarenamn | 0..1 | 0 – 64 pos | |
U016 | onskatleveransdatum | Önskat leveransdatum | 1..1 | Datum |
U017 | statustidpunkt | Datum och klockslag då beställningen senast uppdaterades | 1..1 | Datum |
U019 | bestallningsstatus | Möjliga värden: 1 = Mottagen 2 = Avvisad 3 = Expedierad 4 = Avbeställd 6 = Mottagen av apotek 7 = Under bearbetning 8 = Skickad av apotek | 1..1 | Enum |
U020 | planeradleveranstid | 0..1 | Datum | |
U021 | bestallningstid | Datum och klockslag | 0..1 | Datum |
U022 | bestallarefornamn | Beställarens förnamn | 0..1 | 0 - 255 pos |
U023 | bestallareefternamn | Beställarens efternamn | 0..1 | 0 - 255 pos |
U024 | bestallarearbetsplatskod | Arbetsplatskoden för beställaren | 0..1 | 0 - 255 pos |
U025 | bestallningsresultat | Möjliga värden: 0 = beställning mottagen 1 = beställning avvisad | 0..1 | Integer |
U026 | bestallningsresultattext | 0..1 | 0 - 255 pos | |
U027 | antalforpackningar | 0..1 | 0 - 10 pos | |
U028 | akutbestallning | Möjliga värden: 0 = EJ_AKUT | 0..1 | Enum |
U036 | forskrivningsid | Ett UUID | 1..1 | Exakt 36 pos |
5. Verksamhetsregler/logik
ID | Verksamhetsregler/logik |
|---|---|
R001 | Användare får endast hämta beställningar för dospatienter inom det egna dosapoteket. |
R003 | Urval på vårdgivare utförs genom att ange I015 vardgivarid. |
R004 | Urval på dospatient utförs genom att ange I011 personnummer. |
R005 | Urval på dosmottagareid utförs genom att ange ett eller flera av parametern I016 dosmottagareid. |
R006 | Vid sökning med I003 bestallningsurval ska I017 bestallningsstatusurval, I018 frandatum och I019 tilldatum anges, annars returneras felmeddelande. |
R008 | Det är möjligt att hämta en specifik beställning genom att söka på I010 bestallningsid. Notera att när man anger bestallningsid så är det inte möjligt att även ange en parameter ur I003 bestallningsurval. |
R009 | Det är möjligt att begränsa antalet sökträffar genom att ange ett värde i parametern I020 maxantal. Detta värde skall vara mellan 1 och 500 (maxantal sökträffar bestämt av E-hälsomyndigheten). |
Versionshistorik
Version | Datum | Kommentar |
|---|---|---|
| 1.0 | 2021-11-27 | Ny handbok vård- och apotekstjänster |
| 1.1 | 2022-05-25 | Ändrat: U036 förskrivningsid I011 personnummer - det går att ange flera |
| 1.2 | 2024-02-22 | Tagit bort R002 |