Hämta meddelanden, dosaktör (SOL:30)

Med denna tjänst kan dosaktör hämta meddelanden i fritextformat. Ett meddelande i SOL är alltid kopplat till ett personnummer. Meddelandet kan även vara kopplat till tidigare meddelanden. Meddelandeidentitet genereras automatiskt i SOL.


Innehållsförteckning

1. Tjänstespecifikation Hämta meddelanden, dosaktör (SOL:30)

HamtaMeddelandeDosaktor 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

I008

meddelandeurval

Se I2 nedan

1..1

Klass

3.1. I1. Behörighetsinformation

ID

<XML-tag> / fältnamn

Kort beskrivning

Mult

Validering/ Anmärkning

I003

fornamn

Farmaceuts eller annan apotekspersonals förnamn

1..1

1 - 25 pos

I004

efternamn

Farmaceuts eller annan apotekspersonals efternamn

1..1

1 - 25 pos

I005

legitimationskod

Farmaceuts legitimationskod

0..1

Exakt 6 pos

I006

yrkesroll

Användarens yrkesroll

FA = Farmaceut (apotekare och receptarie)

eller

AP = Apotekspersonal

1..1

Enum


I007

dosapotekid

GLN-kod för dosapotek

1..1

Exakt 13 pos

Valideras mot EXPO

3.2. I2. Meddelandenurval

ID

<XML-tag> / fältnamn

Kort beskrivning

Mult

Validering/ Anmärkning

I015

personnummer

Personnummer för dospatient som meddelandet avser enligt format:

YYYYMMDDXXXX

0..1

Exakt 12 pos


I018

meddelandeid


0..1

String

0-36 pos

I019

status

Tillåtna värden:

O = Oläst

L = Läst

LO = Läst eller oläst

B = Borttaget

0..1

Enum

Se R001



I023

frantidpunkt

Datum och klockslag

0..1

Datum

I024

tilltidpunkt

Datum och klockslag

0..1

Datum

I025 maxantal Anges för att begränsa antalet meddelanden som anropet ska returnera. 0..1

Integer

Se R003

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

meddelanden

Se U1 nedan

0..*

Klass

4.1. U1. Meddelanden

ID

<XML-tag> / fältnamn

Kort beskrivning

Mult

Validering/ Anmärkning

U005

meddelandeid

ID för meddelandet

1..1

UUID

36 pos

U011

personnummer

Personnummer för dospatient som meddelandet avser enligt format:

YYYYMMDDXXXX

1..1

Exakt 12 pos

U014

kommunikationsriktning

Möjliga värden:

1 = Från vården

2 = Från dosapotek

0..1

Enum

U015

tidigaremeddelandeid

Anges om meddelandet är kopplat till ett tidigare meddelande

0..1

UUID

36 pos

U017

dosapotekid

GLN-kod för mottagande dosapotek

0..1

Exakt 13 pos

U018

dosapoteknamn

Namn på dosapotek

0..1

0 - 40 pos

U019

sandningstidpunkt

Tidpunkt då meddelandet skickades

1..1

Datum

U020

ursprungligsandarefornamn

Avsändares förnamn

1..1

1 - 25 pos

U021

ursprungligsandareefternamn

Avsändares efternamn

1..1

1 - 40 pos

U022

ursprungligsandareid

Avsändares HSA-id

0..1

0 - 64 pos

U023

ursprungligsandareyrkeskod

Avsändares yrkeskod:

LK = Läkare

BM = Barnmorska

SJ = Sjuksköterska

TL = Tandläkare

RS = Röntgensjuksköterska

TH = Tandhygienist

0..1

Enum

U024

ursprungligsandarearbplats

Avsändares arbetsplats

0..1

0 - 40 pos

U025

rubrik

Rubrik för meddelandet

0..1

0 - 40 pos

U026

prioritet

Möjliga värden:

H = Hög

N = Normal

L = Låg

0..1

Enum

U027

meddelandestatus

Möjliga värden:

O = Oläst

L = Läst

1..1

Enum

U028

meddelandestatusfornamn

Förnamn på den som senast uppdaterat status

1..1

1 - 25 pos

U029

meddelandestatusefternamn

Efternamn på den som senast uppdaterat status

1..1

1 - 25 pos

U030

meddelandestatusarbetsplats

Arbetsplats för den som senast uppdaterat status

1..1

1 - 40 pos

U031

meddelandestatustidpunkt

Datum och klockslag för senaste statusuppdatering

1..1

Datum

U032

meddelande


1..1

1 - 1024 pos

5. Verksamhetsregler/logik

ID

Verksamhetsregler/logik

R001

Meddelanden som är markerade som Borttagna returneras ej.

R003

De meddelanden som returneras är de äldsta bland de som uppfyller sökkriterierna, baserat på meddelandets sändningstidpunkt.

Maxantalet anges i I028. Om inget värde anges i I028 blir defaultvärdet 500 st.

R004

Endast meddelanden kopplade till det anropande dosapoteket kommer att returneras.

R008

Utöver personnummer eller meddelandeid kan sökning göras på
1. Datumintervall, d v s I024 tilltidpunkt och I023 frantidpunkt för sändning
och/eller
2. I019 status, där L=Läst, O=Oläst eller LO=antingen Läst eller Oläst kan anges.

R010

Sökresultat som inte ger någon träff genererar meddelandetext: ”Ingen träff”

R011

Om varken I015 personnummer eller I018 meddelandeid anges så ska tjänsten bara returnera de meddelanden som skickats från vården till det aktuella dosapoteket.

Versionshistorik

Version

Datum

Kommentar

1.0 2021-11-27 Ny handbok vård- och apotekstjänster
1.1 2022-05-25

Ändrat: datatyp för I018, U005 och U015, justerat R003

Tillagt: I025

1.2 2024-02-22

Tagit bort R002