Beställ originalförpackning (SOL:06)

Med denna tjänst kan 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 (SOL:06)

BestallOriginalforpackning 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

I011

Bestallningsinfo

Se I2 nedan

1..*

Klass

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

Se R007

I004

efternamn

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

1..1

1 - 25 pos

Se R007

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

Se R007

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

ID

<XML-tag> / fältnamn

Kort beskrivning

Mult

Validering/ Anmärkning

I017

personnummer

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

YYYYMMDDXXXX

1..1

Exakt 12 pos

Se R004 och R009

I020

bestallningsid

Beställningens ID, UUID

1..1

1 - 40 pos

Se R001 och R011

I022

nplpackid


0..1

Max 16 pos

I023

varunummer


0..1

Max 8 pos

I026

dosunderlagsversion

Version på dosunderlaget

0..1

1 - 10 pos

I027

antalforpackningar

Antal förpackningar av den aktuella artikeln

0..1

Integer

I028

akutbestallning

Indikator om beställningen är akut:

True = Akut

False = Ej akut

0..1

Boolean

I032

versionsid

Versionsnummer för aktuell version av vårdtagarinformationen

1..1

Long

Se R008

I033

meddelandetillapotek

Meddelande till apotek

0..1

0 - 255 pos

I034

onskadleveranstid

Datum och klockslag

1..1

Datum

Se R010

I035

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:
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 enligt format:

YYYYMMDDXXXX

1..1

Exakt 12 pos

U015

nplpackid


0..1

Max 16 pos

U016

varunummer


0..1

Max 8 pos

U018

ordinationsid

Ordination som avropas

1..1

1 - 20 pos

U019

dosunderlagsversion

Version på dosunderlaget

0..1

Max 10 pos

U020

bestallningsresultat

Möjliga värden:

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

1..1

Integer


U021

bestallningsresultattext

Möjliga värden:

1. Beställningen sparades

2. Patient med personnummer YYYYMMDDXXXX finns ej

3. Angivet versionsid överensstämmer inte med eHälsomyndighetens versionsid. Hämta senaste versionen och gör om uppdateringen

4. Vårdtagaren med personnummer YYYYMMDDNNNN saknar giltig produktionsinformation

1..1

1 -  80 pos


U022

bestallningsstatus

Möjliga värden:

1 = Mottagen

2 = Avvisad

1..1

 Enum

 

U023

statustidpunkt

Datum och klockslag

1..1

Datum

U025

onskadleveranstid

Datum och klockslag

0..1

Datum

U026

dosmottagareid

ID för dosmottagare

0..1

1 - 31 pos

U027

dosmottagarenamn

Namn på dosmottagare

0..1

1 – 64 pos

U028

bestallningstid

Datum och klockslag

1..1

Datum

U029

bestallarefornamn


1..1

Sträng

U030

bestallareefternamn


1..1

Sträng

U031

bestallarearbetsplats

Arbetsplatskod

1..1

Sträng

U032

antalforpackningar


0..1

Integer

U033

akutbestallning

Möjliga värden:
1 = AKUT

0 = EJ_AKUT

0..1

Enum

U034

dospotekid

GLN-kod för dosapotek

1..1

Exakt 13 pos

U035

forskrivningsid

Ett UUID

1..1

Exakt 36 pos

5. Verksamhetsregler/logik

ID

Verksamhetsregler/logik

R001

Inskickat I020 bestallningsid måste vara unikt.

R003

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 kommer returneras kod U022 och felmeddelande U021.

R004

Person med angivet personnummer ska vara registrerad som dospatient i SOL.

R005

När en beställning skapats i SOL får den status 1 = Mottagen.

R006

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

R007

I003 fornamn, I004 efternamn, I007 arbetsplatskod samt anropstidpunkten sparas i SOL, som information om vem som senast ändrat beställningen och när.

R008

I032 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.

R010 När en beställning skapas kopplas beställningen till den dosmottagare som är giltig för vårdtagaren vid onskadleveranstid (I034). Om vårdtagaren har en tillfällig adress som är aktiv vid onskadleveranstid kopplas dosmottagaren som tillhör den tillfällige adressen till beställningen. Annars kopplas vårdtagarens ordinarie dosmottagare till beställningen.
R011 I011 Bestallningsinfo får inte innehålla dubbletter av I020 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 förskrivningsid I035 och U035
1.2 2022-11-10 Lagt till regel R010.
1.3 2023-11-09 Lagt till regel R011 och hänvisning till denna för I020.
1.4 2024-02-22 Uppdaterat R009