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.
R010	Vid U020 bestallnuíngsstatus UNDER_BEARBETNING ska apoteket kunna uppdatera den till status AVVISAD.
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