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