Beställ originalförpackning, dosaktör (SOL:26)

Med denna tjänst kan dosaktör på uppdrag av vården lägga en beställning 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 Beställ originalförpackning, dosaktör (SOL:26)

BestallOriginalforpackningDosaktor 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

I003

bestallningsinfo

Se I2 nedan

1..*

Klass

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

Se R007

I005

efternamn

Farmaceuts eller annan apotekspersonals efternamn

1..1

1 - 25 pos

Se R007

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ällningsinfo

ID

<XML-tag> / fältnamn

Kort beskrivning

Mult

Validering/ Anmärkning

I030

personnummer

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

YYYYMMDDXXXX

1..1

Exakt 12 pos

Se R009

I010

bestallningsid

Beställningens ID, UUID

1..1

1 - 40 pos

Se R002 och R012

I012

nplpackid


0..1

0 - 16 pos

I013

varunummer


0..1

0 - 8 pos

I016

dosunderlagsversion

Version på dosunderlaget

0..1

0 - 10 pos

I017

meddelande

Meddelande från dosapotek

0..1

0 - 255 pos

I026

versionsid

ID för aktuell version av vårdtagarinformationen

1..1

Long

Se R008

I020

onskatleveransdatum

Datum

1..1

Datum

Se R011

I021

planeradleveranstid

Datum och klockslag

0..1

Datum

Se R011

I022

antalforpackningar

Antal förpackningar av den aktuella artikeln

0..1

Integer

I023

akutbestallning

Tillåtna värden:

True = Akut

False = Ej akut

0..1

Boolean


I031

forskrivningsid

Ett UUID

1..1

Exakt 36 pos

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

1..*

Klass

4.1. U1. Beställningsrader

ID

<XML-tag> / fältnamn

Kort beskrivning

Mult

Validering/ Anmärkning

U032

personnummer

Personnummer för dospatient 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

Ordination som avropas

1..1

1 - 20 pos

U012

dosunderlagsversion

Version på dosunderlaget

0..1

 0 - 10 pos

U014

dosmottagareid

ID för dosmottagare

0..1

1 - 31 pos

Se R011

U037

dosmottagarenamn

Namn på dosmottagare

0..1

1 – 64 pos

U016

onskatleveransdatum

Datum

1..1

Datum

U018

statustidpunkt

Datum och klockslag

0..1

Datum

U020

bestallningsstatus

Möjliga värden:

1 = Mottagen

2 = Avvisad

0..1

Enum


U021

planeradleveranstid

Datum och klockslag

0..1

Datum

U022

bestallningstid

Datum och klockslag

0..1

Datum

U023

bestallarefornamn


0..1

1 - 25 pos

U024

bestallareefternamn


0..1

1 - 40 pos

U025

bestallarearbetsplatskod

Arbetsplatskod/Dosapotekid

0..1

1 - 256 pos

U026

bestallningsresultat

Möjliga värden:

0 = beställning mottagen
1= beställning avvisad

0..1

Integer


U027

bestallningsresultattext

Text som returneras:

1. Beställningen sparades

2. Patient med personnummer YYYYMMDDXXXX finns ej 

0..1

1 - 80 pos


U035

antalforpackningar


0..1

Integer

U036

akutbestallning

Möjliga värden:
1 = AKUT

0 = EJ_AKUT

0..1

Enum

U037

forskrivningsid

Ett UUID

1..1

Exakt 36 pos

5. Verksamhetsregler/logik

ID

Verksamhetsregler/logik

R001

En dosapotekanvändare kan endast skapa en beställning till dospatient som tillhör det egna dosapoteket.

R002

Inskickat I010 beställningsid måste vara unikt.

R004

Vid beställningar som gäller en lista med flera dospatienter kommer resultatet innehålla en lista med alla svar, både på de som har sparats samt de resultat som misslyckades och genererade fel. För misslyckande resultat returneras U026 bestallningsresultat och U027 bestallningsresultattext

R005

En ny beställning i SOL får U020 bestallningsstatus MOTTAGEN_AV_APOTEK om den är skapad av dosapotek.

R006

För att en beställning ska skapas ska dospatienten ha en aktuell dosmottagare registrerad i SOL.

R007

I004 fornamn, I005 efternamn, I008 dosapotekid samt anropstidpunkten sparas i SOL, som information om vem som senast ändrat beställningen och när.

R008

I026 versionsid måste överensstämma med dospatientens versionsid i SOL för att beställningen ska kunna skickas.

R009

Dospatient måste finnas, ej ha status Tekniskt avregistrerad, Personnummerändring, Personen finns ej i folkbokföringen eller Avliden i FOLK och ha ett dossamtycke registrerat hos E-hälsomyndigheten.

R011 När en beställning skapas kopplas beställningen till den dosmottagare som är giltig för vårdtagaren vid planeradleveranstid (I021) om den är angiven, annars vid onskatleveransdatum (I020). Om vårdtagaren har en tillfällig adress som är aktiv vid onskatleveransdatum/planeradleveranstid kopplas den dosmottagare som tillhör den tillfällige adressen till beställningen. Annars är det vårdtagarens ordinarie dosmottagare som kopplas till beställningen.
R012 I003 Bestallningsinfo 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-05-25

Ändrat:  forskrivningsid I031 och U037  

1.2 2022-11-10 Ny regel R011 tillagd.
1.3 2023-11-09 R012 tillagd och hänvisning till denna för I010.
1.4 2024-02-22

Tagit bort R003

Uppdaterat R009

1.5 2024-08-26

Tagit bort R010