Avbeställ originalförpackning (SOL:08)

Med denna tjänst kan vården avbeställa 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, exempelvis flytande hostmedicin, eller ett läkemedel som är ordinerat att intas vid behov. 


Innehållsförteckning

1. Tjänstespecifikation Avbeställ originalförpackning (SOL:08)

AvbestallOriginalforpackning V3.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.

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

3. Indata

ID

<XML-tag> / fältnamn

Kort beskrivning

Mult

Validering/ Anmärkning

I002

Behorighetsinformation

Se I1 nedan

1..1

Klass

I011

Avbestallningsinfo

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 R005

I004

efternamn

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

1..1

1 - 25 pos

Se R005

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 R005

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

ID

<XML-tag> / fältnamn

Kort beskrivning

Mult

Validering/ Anmärkning

I020

bestallningsid

Beställningens ID, UUID

1..1

1 - 40 pos

Se R006

I027

meddelandetillapotek

Meddelande till apotek

0..1

0 - 255 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 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öjligt värde:
0 = Avbeställningen mottagen

0..1

Integer

U021

bestallningsresultattext

Sätts alltid till ”Beställningen avbeställdes”

0..1

0 - 80 pos

U022

bestallningsstatus

Möjligt värde:

4 = Avbeställd

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

0 - 31 pos

U029

dosmottagarenamn

Namn på dosmottagare

0..1

1 – 64 pos

U030

bestallningstid

Datum och klockslag

0..1

Datum

U031

bestallarefornamn


1..1

1 - 25 pos

U032

bestallareefternamn


1..1

1 - 50 pos

U033

bestallarearbetsplats

Arbetsplatskod

1..1

1 - 256 pos

U034

dospotekid

GLN-kod för dosapotek

1..1

Exakt 13 pos

5. Verksamhetsregler/logik

ID

Verksamhetsregler/logik

R001

En beställning som har status 6 = Under bearbetning, 3 = Expedierad, 4 = Avvisad eller 7 = Skickad av apotek går inte att avbeställa. En sådan avbeställning kommer att avvisas.

R002

Bestallningsstatus U022, bestallningsresultat U020, bestallningsresultattext U021 och statustidpunkt U023 sätts automatiskt av tjänsten. Statustidpunkten sättas endast då status ändras.

R003

En varning samt en lista på samtliga beställningar och deras status returneras om en eller flera av beställningarna som ingår i anropet saknas eller inte gick att avbeställa.

R005

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

R006

I011 Avbestallningsinfo 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 2023-11-09 Lagt till regel R006 och hänvisning till denna för I020.
1.2 2024-02-22 Uppdaterat R003