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:
INFO
WARN
ERROR

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