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

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:
1 = AKUT

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