Hämta beställningar (SOL:07)

Med denna tjänst kan vården 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 (SOL:07)

HamtaOriginalforpackning 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

I023

maxantal

Maximalt antal beställningar som tjänsten ska returnera

0..1

Integer

I011

Bestallningsurval

Se I2 nedan

1..1

Klass

I013

bestallningsid

ID för beställningen

0..1

0 - 40 pos

3.1. I1. Behörighetsinformation

ID

<XML-tag> / fältnamn

Kort beskrivning

Mult

Validering/ Anmärkning

I003

fornamn

Förnamn på behörig användare som använder tjänsten

1..1

1 - 25 pos

I004

efternamn

Efternamn på behörig användare som använder tjänsten

1..1

1 - 25 pos

I005

forskrivarkod


0..1

Exakt 7 pos

I006

yrkeskod

Typ av förskrivare

LK = Läkare

BM = Barnmorska

SJ = Sjuksköterska

TL=Tandläkare

RS = Röntgensjuksköterska

TH = Tandhygienist

0..1

Enum

I007

arbetsplatskod


1..1

1 - 13 pos

I008

hsaid

Vårdens identitetsbegrepp

0..1

1 - 64 pos

I009

personnummer

Användarens personnummer

0..1

Exakt 12 pos

I010

organisationsnummer

Användarens organisations organisationsnummer

0..1

1 - 20 pos

3.2. I2. Beställningsurval

ID

<XML-tag> / fältnamn

Kort beskrivning

Mult

Validering/ Anmärkning

I014

personnummer

De personnummer för dospatienter som hämtningen avser enligt format:

YYYYMMDDXXXX

0..*

0 - 12 pos

I001

dosapotekid

GLN-kod för dosapotek som beställningen är kopplad till

0..1

Exakt 13 pos

Valideras mot EXPO

I018

vardgivarid

HSA-id, vårdens identitetsbegrepp

0..1

1 - 64 pos

I019

dosmottagareid

ID för dosmottagare

0..*

0 - 31 pos

I020

bestallningsstatusurval

Tillåtna värden:

1 = Mottagen

2 = Avvisad

3 = Expedierad

4 = Avbeställd

5 = Samtliga statusar

6 = Mottagen av apotek

7 = Under bearbetning

8 = Skickad av apotek

1..1

Enum


I021

frandatum

Datum och klockslag

1..1

Datum

Se R004

I022

tilldatum

Datum och klockslag

1..1

Datum

Se R004

4. Utdata

ID

<XML-tag> / fältnamn

Kort beskrivning

Mult

Validering/ Anmärkning

U001

resultatkod

Möjliga värden:
1 = Info
2 = Varning
3 = Fel

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

U005

bestallningsid

Beställningens ID, UUID

1..1

1 - 40 pos

U012

personnummer

Personnummer för dospatient som beställningen avser enligt format:

YYYYMMDDXXXX

1..1

Exakt 12 pos

U015

nplpackid


0..1

0 - 16 pos

U016

varunummer


0..1

0 - 8 pos

U018

ordinationsid

Ordination som avropas

1..1

1 - 20 pos

U019

dosunderlagsversion

Version på dosunderlaget

0..1

0 - 10 pos

U020

bestallningsresultat

Möjliga värden:

0 = beställningen mottagen
1= beställningen avvisad

0..1

Integer

U021

bestallningsresultattext


0..1

0 - 80 pos

U022

bestallningsstatusurval

Möjliga värden:


1 = Mottagen
2 = Avvisad
3 = Expedierad
4 = Avbeställd

5 = Mottagen av apotek

6 = Under bearbetning

7 = Skickad av apotek

1..1

Enum

U023

statustidpunkt

Datum och klockslag

1..1

Datum

U025

meddelandefranapotek

Meddelande från dosapotek

0..1

0 - 255 pos

U026

onskadleveranstid

Datum och klockslag

0..1

Datum

U027

planeradleveranstid

Datum och klockslag

0..1

Datum

U028

dosmottagareid

ID för dosmottagare

0..1

1 – 31 pos

U029

dosmottagarenamn

Namn på dosmottagare

0..1

1 – 64 pos

U030

bestallningstid

Datum och klockslag

0..1

Datum

U031

bestallarefornamn


1..1

Sträng

U032

bestallareefternamn


1..1

Sträng

U033

bestallarearbetsplats

Beställarens arbetsplatskod

1..1

Sträng

U034

antalforpackningar


0..1

Integer

U035

akutbestallning

Möjliga värden:
1 = AKUT

0 = EJ_AKUT

0..1

Enum

U036

dospotekid

GLN-kod för dosapotek

1..1

Exakt 13 pos

U037

forskrivningsid

Ett UUID

1..1

Exakt 36 pos

5. Verksamhetsregler/logik

ID

Verksamhetsregler/logik

R001

Urval på vårdgivare utförs genom att ange I018 vardgivarid.

R002

Urval på dospatient utförs genom att ange I009 personnummer.

R003

Urval på dosmottagareid utförs genom att ange ett eller flera av parametern I019 dosapotekid.

R004

Vid sökning ska I020 bestallningsstatusurval, I021 frandatum och I022 tilldatum anges, annars returneras felmeddelande.

R005

Det är möjligt att begränsa antalet sökträffar genom att ange ett värde i parametern I023 maxantal. Detta värde skall vara mellan 1 och 500 (maxantal sökträffar bestämt av eHälsomyndigheten).

R006

Det är möjligt att hämta en specifik beställning genom att söka på I013 bestallningsid. Notera att när man anger bestallningsid så är det inte möjligt att även ange en parameter ur beställningsurval.

Versionshistorik

Version

Datum

Kommentar

1.02021-11-27Ny handbok vård- och apotekstjänster 
1.12022-05-25

Ändrat: U037 forskrivningsID

I014 personnummer, går att ange flera