Beställ originalförpackning, dosaktör (SOL:26)
Med denna tjänst kan dosaktör på uppdrag av vården lägga en beställning 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 Beställ originalförpackning, dosaktör (SOL:26)
BestallOriginalforpackningDosaktor 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 |
|
I003 |
bestallningsinfo |
Se I2 nedan |
1..* |
Klass |
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 Se R007 |
|
I005 |
efternamn |
Farmaceuts eller annan apotekspersonals efternamn |
1..1 |
1 - 25 pos Se R007 |
|
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ällningsinfo
|
ID |
<XML-tag> / fältnamn |
Kort beskrivning |
Mult |
Validering/ Anmärkning |
|---|---|---|---|---|
|
I030 |
personnummer |
Personnummer för dospatient som beställningen gäller enligt format: YYYYMMDDXXXX |
1..1 |
Exakt 12 pos Se R009 |
|
I010 |
bestallningsid |
Beställningens ID, UUID |
1..1 |
1 - 40 pos Se R002 och R012 |
|
I012 |
nplpackid |
|
0..1 |
0 - 16 pos |
|
I013 |
varunummer |
|
0..1 |
0 - 8 pos |
|
I016 |
dosunderlagsversion |
Version på dosunderlaget |
0..1 |
0 - 10 pos |
|
I017 |
meddelande |
Meddelande från dosapotek |
0..1 |
0 - 255 pos |
|
I026 |
versionsid |
ID för aktuell version av vårdtagarinformationen |
1..1 |
Long Se R008 |
|
I020 |
onskatleveransdatum |
Datum |
1..1 |
Datum Se R011 |
|
I021 |
planeradleveranstid |
Datum och klockslag |
0..1 |
Datum Se R011 |
|
I022 |
antalforpackningar |
Antal förpackningar av den aktuella artikeln |
0..1 |
Integer |
|
I023 |
akutbestallning |
Tillåtna värden: True = Akut False = Ej akut |
0..1 |
Boolean |
|
I031 |
forskrivningsid |
Ett UUID |
1..1 |
Exakt 36 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 |
bestallningsrader |
Se U1 nedan |
1..* |
Klass |
4.1. U1. Beställningsrader
|
ID |
<XML-tag> / fältnamn |
Kort beskrivning |
Mult |
Validering/ Anmärkning |
|---|---|---|---|---|
|
U032 |
personnummer |
Personnummer för dospatient 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 |
Ordination som avropas |
1..1 |
1 - 20 pos |
|
U012 |
dosunderlagsversion |
Version på dosunderlaget |
0..1 |
0 - 10 pos |
|
U014 |
dosmottagareid |
ID för dosmottagare |
0..1 |
1 - 31 pos Se R011 |
|
U037 |
dosmottagarenamn |
Namn på dosmottagare |
0..1 |
1 – 64 pos |
|
U016 |
onskatleveransdatum |
Datum |
1..1 |
Datum |
|
U018 |
statustidpunkt |
Datum och klockslag |
0..1 |
Datum |
|
U020 |
bestallningsstatus |
Möjliga värden: 1 = Mottagen 2 = Avvisad |
0..1 |
Enum |
|
U021 |
planeradleveranstid |
Datum och klockslag |
0..1 |
Datum |
|
U022 |
bestallningstid |
Datum och klockslag |
0..1 |
Datum |
|
U023 |
bestallarefornamn |
|
0..1 |
1 - 25 pos |
|
U024 |
bestallareefternamn |
|
0..1 |
1 - 40 pos |
|
U025 |
bestallarearbetsplatskod |
Arbetsplatskod/Dosapotekid |
0..1 |
1 - 256 pos |
|
U026 |
bestallningsresultat |
Möjliga värden: 0 = beställning mottagen |
0..1 |
Integer |
|
U027 |
bestallningsresultattext |
Text som returneras: 1. Beställningen sparades 2. Patient med personnummer YYYYMMDDXXXX finns ej |
0..1 |
1 - 80 pos |
|
U035 |
antalforpackningar |
|
0..1 |
Integer |
|
U036 |
akutbestallning |
Möjliga värden: 0 = EJ_AKUT |
0..1 |
Enum |
|
U037 |
forskrivningsid |
Ett UUID |
1..1 |
Exakt 36 pos |
5. Verksamhetsregler/logik
|
ID |
Verksamhetsregler/logik |
|---|---|
|
R001 |
En dosapotekanvändare kan endast skapa en beställning till dospatient som tillhör det egna dosapoteket. |
|
R002 |
Inskickat I010 beställningsid måste vara unikt. |
|
R004 |
Vid beställningar som gäller en lista med flera dospatienter kommer resultatet innehålla en lista med alla svar, både på de som har sparats samt de resultat som misslyckades och genererade fel. För misslyckande resultat returneras U026 bestallningsresultat och U027 bestallningsresultattext |
|
R005 |
En ny beställning i SOL får U020 bestallningsstatus MOTTAGEN_AV_APOTEK om den är skapad av dosapotek. |
|
R006 |
För att en beställning ska skapas ska dospatienten ha en aktuell dosmottagare registrerad i SOL. |
|
R007 |
I004 fornamn, I005 efternamn, I008 dosapotekid samt anropstidpunkten sparas i SOL, som information om vem som senast ändrat beställningen och när. |
|
R008 |
I026 versionsid måste överensstämma med dospatientens versionsid i SOL för att beställningen ska kunna skickas. |
|
R009 |
Dospatient måste finnas, ej ha status Tekniskt avregistrerad, Personnummerändring, Personen finns ej i folkbokföringen eller Avliden i FOLK och ha ett dossamtycke registrerat hos E-hälsomyndigheten. |
| R011 | När en beställning skapas kopplas beställningen till den dosmottagare som är giltig för vårdtagaren vid planeradleveranstid (I021) om den är angiven, annars vid onskatleveransdatum (I020). Om vårdtagaren har en tillfällig adress som är aktiv vid onskatleveransdatum/planeradleveranstid kopplas den dosmottagare som tillhör den tillfällige adressen till beställningen. Annars är det vårdtagarens ordinarie dosmottagare som kopplas till beställningen. |
| R012 | I003 Bestallningsinfo får inte innehålla dubbletter av I010 bestallningsid i ett och samma anrop. |
Versionshistorik
|
Version |
Datum |
Kommentar |
|---|---|---|
| 1.0 | 2021-11-27 | Ny handbok vård- och apotekstjänster |
| 1.1 | 2022-05-25 |
Ändrat: forskrivningsid I031 och U037 |
| 1.2 | 2022-11-10 | Ny regel R011 tillagd. |
| 1.3 | 2023-11-09 | R012 tillagd och hänvisning till denna för I010. |
| 1.4 | 2024-02-22 |
Tagit bort R003 Uppdaterat R009 |
| 1.5 | 2024-08-26 |
Tagit bort R010 |