Sök dosmottagare, dosaktör (SOL:45)

Med denna tjänst kan dosaktören söka dosmottagare för att kunna utläsa leveransinformation för dospatienters dosrullar.

Innehållsförteckning

1. Tjänstespecifikation Sök dosmottagare, dosaktör (SOL:45)

SokDosmottagareDosaktör V2.0

2. Indata

ID	<XML-tag> / fältnamn	Kort beskrivning	Mult	Validering/ Anmärkning
I001	behorighetsinformation	Se I1 nedan	1..1	Klass
I002	dosapotekid	GLN-kod för dosapotek	0..1	Exakt 13 pos
I003	dosmottagareid	Dosapotekets id för dosmottagaren	0..1	1 – 31 pos Se R002
I004	dosmottagarenamn	Dosapotekets namn på dosmottagaren	0..1	1 – 64 pos
I005	ort	Dosmottagarens postort	0..1
I006	kommunkod	Dosmottagarens kommunkod	0..1	Exakt 2 pos
I007	lanskod	Dosmottagarens länskod	0..1	Exakt 2 pos
I008	adress	Adress till dosmottagare	0..1	1 – 50 pos
I009	arbetsplatskod	Arbetsplatskod till dosmottagare. Är aktuellt om dosmottagare t ex är en distriktsläkarmottagning.	0..1	1 – 13 pos
I010	postnummer	Dosmottagarens postnummer	0..1	Exakt 5 pos
I011	visadolda	Anger om dolda dosmottagare ska returneras eller ej	0..1	Boolean

2.1. I1. Behörighetsinformation

ID	<XML-tag> / fältnamn	Kort beskrivning	Mult	Validering/ Anmärkning
I012	fornamn	Användarens förnamn	1..1	1 - 25 pos
I013	efternamn	Användarens efternamn	1..1	1 - 25 pos
I014	legitimationskod	Farmaceuts legitimationskod	0..1	Exakt 6 pos
I015	yrkesroll	Användarens yrkesroll FA = Farmaceut (apotekare och receptarie) eller AP = apotekspersonal	1..1	Enum
I016	dosapotekid	GLN-kod för dosapotek	1..1	Exakt 13 pos Valideras mot EXPO

3. Utdata

ID	<XML-tag> / fältnamn	Kort beskrivning	Mult	Validering/ Anmärkning
U001	resultatkod	Möjliga värden: 1 = INFO 2 = WARN 3 = ERROR	1..1	Enum
U002	meddelandetext		1..1	1 - 300 pos
U003	meddelandeid	ID för responsmeddelande	1..1	Integer
U004	Dosmottagare	Se U1 nedan	1..1	Klass

3.1. U1. Dosmottagare

ID	<XML-tag> / fältnamn	Kort beskrivning	Mult	Validering/ Anmärkning
U005	adress	Adress till dosmottagare	0..1	1 – 50 pos
U006	arbetsplatskod	Arbetsplatskod till dosmottagare. Är aktuellt om dosmottagare t ex är en distriktsläkarmottagning.	0..1	1 – 13 pos
U007	avdelning	Avdelning inom dosmottagare	0..1	1 – 35 pos
U008	kommunkod	Dosmottagarens kommunkod	0..1	Exakt 2 pos
U009	lanskod	Dosmottagarens länskod	0..1	Exakt 2 pos
U010	dosmottagarenamn	Dosapotekets namn på dosmottagare	1..1
U011	postnummer	Dosmottagarens postnummer	0..1	Exakt 5 pos
U012	ort	Dosmottagarens postort	0..1	1 – 50 pos
U013	dosapotekid	GLN-kod för dosapotek	1..1	Exakt 13 pos
U014	dold	Indikerar om dosmottagaren är dold eller synlig	0..1	Boolean
U015	boende	Indikerar om dosmottagaren är ett boende. True = Dosmottagaren är ett boende False = Dosmottagaren är inte ett boende	1..1	Boolean
U016	sampack	Indikerar om läkemedel till patienter tillhörande dosmottagaren kan paketeras ihop. True = patienters läkemedel kan paketeras ihop med andra patienters läkemedel False = patienters läkemedel kan inte paketeras ihop med andra patienters läkemedel	0..1	Boolean
U017	Leveransadress	Se U2 nedan	0..1	Klass
U029	Produktionsinformation	Se U3 nedan	0..1	Klass
U037	dosmottagareid	ID för dosmottagare	1..1	1 - 31 pos

3.2. U2. Leveransadress

ID	<XML-tag> / fältnamn	Kort beskrivning	Mult	Anmärkning
U018	adress	Adress för dosmottagare/leveransadress	0..1	1 – 50 pos
U019	postnummer	Postnummer till dosmottagare/leveransadress	0..1	1 - 40 pos
U020	ort	Dosmottagarens/leveransadressens postort	0..1	1 - 64 pos
U021	arbetsplatskod	Arbetsplatskod för dosmottagare/leveransadress	0..1	1 - 13 pos
U022	id	ID för dosmottagare/leveransadress	0..1	1 - 31 pos
U023	namn	Namn på dosmottagare/leveransadress	0..1	1 – 64 pos
U024	dosaktor	Den dosaktör som dosmottagaren/leveransadressen tillhör.	0..1	1 - 50 pos
U025	dosapotek	Det dosapotek som dosmottagaren/leveransadressen tillhör.	0..1	1 - 50 pos
U026	avdelning	Namnet på dospatientens avdelning om dosmottagaren/leveransadressen är ett boende	0..1	1 - 50 pos
U027	kommunkod	Dosmottagarens/leveransadressens kommunkod	0..1	1-2 pos
U028	lanskod	Dosmottagarens/leveransadressens länskod	0..1	1-2 pos

3.3. U3. Produktionsinformation

ID	<XML-tag> / fältnamn	Kort beskrivning	Mult	Anmärkning
U030	dosapotekid	GLN-kod för dosapotek	1..1	Exakt 13 pos Valideras mot EXPO
U031	stopptidbestallning	Datum och klockslag	0..1	Datum
U032	stopptidordination	Datum och klockslag	0..1	Datum
U033	akutstopptid	Akut stopptid för beställning	0..1	Tid
U034	forstadosdag	Första dosdag för leveransomgång	1..1	Datum
U035	dosvecka	Vilken vecka dosleveransen kommer till dosmottagaren Möjliga värden: U = Udda J = Jämn V = Varje	1..1	1 pos
U036	Standardschema	Se U4 nedan	1..1	Klass

3.4. U4. Standardschema

ID

<XML-tag> / fältnamn

Kort beskrivning

Mult

Validering/ Anmärkning

U038

periodlangd

Längd på produktionsperiod i dagar tex 7, 14 eller 21

1..1

Integer

U039

Intagstillfalle

Se U5 nedan

1..*

Klass

3.5. U5. Intagstillfälle

ID

<XML-tag> / fältnamn

Kort beskrivning

Mult

Validering/ Anmärkning

U041

intagstillfalleKl

Klockslag enligt standardschema för intagstillfällen t ex 08, 12, 16, 20

1..1

Integer

4. Verksamhetsregler/logik

ID	Verksamhetsregler/logik
R001	Information returneras endast för dosmottagare tillhörande godkända dosapotek.
R002	När dosmottagareid är angivet så får endast dosapotekid och visadolda anges.
R006	I007 fornamn, I008 efternamn, I011 dosapotekid samt anropstidpunkten sparas i SOL, som information om vem som senast ändrat informationen och när.

Versionshistorik

Version

Datum

Release

Kommentar

1.0

2021-11-27

Ny handbok vård- och apotekstjänster

1.1

2022-05-25

U1.Dosmottagare, lagt till:

Lagt till U016 boende
Lagt till U017 sampack

Lag till ny tabell U2. Leveransadress

1.2

2025-02-13

21.12

U3-U5 Produktionsinformation tillagt, DosmottagareID borttaget som indata, justering U035, rättning av information