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