Uppdatera beställningsstatus, dosaktör (SOL:36)
Med denna tjänst kan dosaktör uppdatera status på en beställning på en produkt i originalförpackning. Även beställningsstatus, meddelande och planerad leveranstid kan uppdateras med denna tjänst. Tidpunkt för statusuppdateringen sätts automatiskt av SOL.
Innehållsförteckning
1. Tjänstespecifikation Uppdatera beställningsstatus, dosaktör (SOL:36)
UppdateraBestallningsstatus V3.0
1.1. Formatregler
1.2. 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.
1.3. Uppdatering av valfria värden i SOL
Alla valfria värden som kan uppdateras vid anrop av SOL:s uppdateringstjänster, ersätts av null om inget värde anges.
2. Indata
ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
I001 | behorighetsinformation | Se I1 nedan | 1..1 | Klass |
I003 | bestallningsrader | Se I2 nedan | 1..* | Klass |
2.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 R009 |
I005 | efternamn | Farmaceuts eller annan apotekspersonals efternamn | 1..1 | 1 - 25 pos Se R009 |
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 Se R001 och R009 |
2.2. I2. Beställningsrader
ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
I010 | bestallningsid | Beställningens ID, UUID | 1..1 | 1 - 40 pos Se R012 |
I017 | meddelande | Meddelande från dosaktör | 0..1 | 0 - 255 pos |
I021 | planeradleveranstid | Datum och klockslag | 0..1 | Datum Se R011 |
I026 | bestallningsstatus | Status för beställningen: MOTTAGEN MOTTAGEN_AV_APOTEK UNDER_BEARBETNING EXPEDIERAD SKICKAD_AV_APOTEK AVBESTALLD AVVISAD | 1..1 | Enum Se R002, R005, R011 |
3. 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 Se R007 | |
U003 | meddelandeid | ID för responsmeddelande | 1..1 | Integer |
4. Verksamhetsregler/logik
ID | Verksamhetsregler/logik |
|---|---|
R001 | Användare på dosapotek får endast uppdatera beställningar till det egna dosapoteket, dvs I008 dosapotekid måste vara samma som beställningens dosapotekid. Med undantaget att beställningar kan uppdateras av det dosapotek som satte befintlig status på beställningen även om patienten som beställningen avser, har bytt dosapotek. |
R002 | En beställning som har bestallningsstatus = UNDER BEARBETNING, EXPEDIERAD eller SKICKAD AV APOTEK kan inte ändras till I026 bestallningsstatus = AVBESTALLD. En sådan avbeställning kommer att avvisas. |
R005 | En beställning som har bestallningsstatus AVBESTALLD eller AVVISAD kan inte ändras till någon annan I026 bestallningsstatus. |
R006 | Statustidpunkt sätts automatiskt till tidpunkten då status ändras. |
R007 | Vid fler än en felaktig I003 beställningsrad kommer felmeddelandet i U002 meddelandetext att trunkeras när längden överskrider 300 tecken. |
R009 | I004 fornamn, I005 efternamn, I008 dosapotekid samt anropstidpunkten sparas i SOL, som information om vem som senast ändrat beställningen och när. |
| R011 | När bestallningsstatus (I026) ändras till UNDER BEARBETNING, EXPEDIERAD eller SKICKAD AV APOTEK uppdateras dosmottagaren kopplad till beställningen om den skiljer sig från den dosmottagare som är giltig för vårdtagaren vid beställningens planeradleveranstid (I021), om sådant datum finns, annars vid beställningens önskade leveransdatum. Vårdtagarens giltiga dosmottagare är den dosmottagare som är kopplad till vårdtagarens tillfälliga adress om den är aktiv vid planeradleveranstid/onskatleveransdatum annars är det vårdtagarens ordinarie dosmottagare. |
| R012 | I003 bestallningsrader 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-11-10 | Ny regel R011 tillagd. |
| 1.2 | 2023-05-04 | Uppdaterat R001. |
| 1.3 | 2023-08-24 | Tagit bort R010. |
| 1.4 | 2023-11-09 | Lagt till R012 och hänvisning till denna för I010 |
| 1.5 | 2024-02-22 | Tagit bort R003 |