SOL - Sortiment och Leveransinformation för dos

1 Inledning

Denna sida riktar sig till apoteksaktörer, vårdaktörer och systemleverantörer av expeditions- och ordinationssystem som hanterar information som krävs för att leverera dostjänsten. Sidan ingår i Handbok för vårdaktörer samt Handbok för apoteksaktörer.

På sidan likställs begreppet kund med patient. I den löpande texten används begreppet patient.

På sidan likställs begreppet vårdaktörer med vårdaktörer human.

1.1 Syfte

Syftet med denna sida är att beskriva de tjänster som används i vårdens och dosaktörernas stödprocess vid hantering av information runt dospatienter.

Processer finns beskrivna enligt följande:

• delprocesser i ordinations- och receptexpeditions­processen med koppling till SOL-tjänster
• detaljerade processteg​
• SOL-specifika stödtjänster

1.2 Avgränsningar och förutsättningar

Tjänsterna är delvis beskrivna i ett sammanhang kopplat till ordinations- och receptexpeditions­processen. För fullständig beskrivning av dessa processer hänvisas till sidorna Ordinationsprocessen respektive Receptexpeditionsprocessen.

I de fall anropande system, vårdens eller dosaktörens, skickar med parametrar som är nyckelbegrepp i andra register, till exempel förskrivarkod eller arbetsplatskod, förutsätts dessa vara kvalitetssäkrade innan anrop sker mot SOL-tjänsterna. Viss validering av inskickade parametrar görs av SOL mot andra register, men ansvaret för att inskickade parametrar är korrekta ligger på anropande system.

Anropande system ska kontrollera och styra behörighet och åtkomst för att säkerställa att rätt person får tillgång till den information som den är behörig att ta del av och/eller uppdatera i SOL.

Anropande system ska kunna använda tjänsterna i sin helhet för att säkerställa att kvalitet och tillförlitlighet upprätthålls i SOL-informationen.

Anropande system ska säkerställa att information från tjänsterna visas i sin helhet för användaren, vilket innebär att systemet måste ta hänsyn till angivna fältlängder.

1.3 Referenser

I detta dokument finns hänvisningar till sidor i Handbok för vårdaktörer samt Handbok för apoteksaktörer. I handböckerna finns en komplett förteckning av samtliga sidor som hör till respektive handbok.

Tjänstespecifikationer SOL (17.1)

SOL - Flytt av dospatient

Begreppskatalog

Receptexpeditionsprocessen

Ordinationsprocessen

1.4 Läsanvisning processer

För detaljerad beskrivning av in- och utparametrar för tjänsterna hänvisas till respektive tjänstespecifikation.

Den grafiska processmodellen består av följande objekt:

	Processteg Processteg som tillhandahålls av eHälsomyndigheten innehåller ett nummer, t.ex. P004.
	Processteg enligt ovan. Processteget har verksamhetsmässiga kopplingar till SOL-tjänster.
	SOL-tjänster
	Tillstånd i delprocesser inom Ordinations- och Receptexpeditionsprocessen
	Sekventiellt flöde

1.5 Definition av begrepp och tekniska termer

Centrala begrepp finns definierade på sidan Begreppskatalog.

2 Generell funktionalitet SOL-tjänster

Genom SOL-tjänsterna får vård- och dosaktör möjlighet till en effektiv hantering av sortiment- och leveransinformation genom den nationella SOL-databasen. Det finns tjänster för vården för att hantera information och beställningar kring dospatienten samt tjänster för dosaktören för att möjliggöra dosproduktion och helförpackningsbeställningar.

Det är E-hälsomyndigheten som är personuppgiftsansvarig för informationen i SOL och ansvarar för informationen i registret. Informationen i SOL utgör allmän handling hos E-hälsomyndigheten. Det innebär att E-hälsomyndigheten kan komma att lämna ut information ur SOL enligt offentlighetsprincipen i tryckfrihetsförordningen (1949:105) och enligt offentlighets- och sekretesslagen (2009:400). Det är vård- och apoteksaktörer som registrerar och uppdaterar informationen i SOL.

Det finns 38 stycken SOL-tjänster; 12 tjänster avsedda för vården och 26 tjänster avsedda för dosaktörer:, redovisade nedan i respektive tabell

Vårdaktör

3 Delprocesser inom Ordinations- och Receptexpeditionsprocessen med kopplingar till SOL-tjänster

Ordinations- och Receptexpeditionsprocessen beskriver två huvudprocesser; ordinations­processen som sker i vården och receptexpeditionsprocessen som sker hos apoteksaktören. Ordinations­processen beskriver den del av förskrivarens möte med en patient, som resulterar i ett recept. Receptexpeditionsprocessen beskriver apotekets expedition av recept.

Vissa processteg i ordinationsprocessen respektive receptexpeditionsprocessen har verksamhets­mässiga kopplingar till SOL-tjänster. Dessa är gulmarkerade i figur 2 nedan. Utöver dessa finns ett antal SOL-specifika stödtjänster som används utan att ha några verksamhetsmässiga kopplingar till andra tjänster i Receptdepå human. Varje enskild tjänst är riktad mot antingen vård eller apotek, se tabell ovan.

Inledningsvis beskrivs de SOL-tjänster som har verksamhetsmässiga kopplingar till andra tjänster. Därefter beskrivs de SOL-specifika stödtjänsterna.

 

Figur 2 Ordinations- och Receptexpeditionsprocessen samt SOL-tjänster  

3.1 Delprocess Ordinera läkemedel

Delprocess Ordinera läkemedel sker hos en vårdaktör.

De gulmarkerade processtegen i figur 3 innehåller verksamhetsmässiga kopplingar till SOL-tjänsterna.

Processteg P001 är enbart aktuell för dospatienter och SOL-tjänsten Hämta vårdtagarinformation (SOL:02) anropas.

I processteg P005 och processteg P006 anropas tjänsten Hämta lokalt produktsortiment (SOL:05) när förskrivaren ordinerar ett läkemedel som ska dosdispenseras.

Figur 3 Delprocess Ordinera läkemedel

3.1.1 SOL-tjänst Hämta vårdtagarinformation (SOL:02/SOL:22)

Vården eller dosaktören kan hämta information om en dospatient med kopplingar till boende eller hemsjukvårdsområde och ordinationsansvarig enhet inom en region eller kommun.

Dospatienten är via sitt boende eller hemsjukvårdsområde och ordinationsansvariga enhet kopplad till ett specifikt dosapotek som producerar dospåsarna åt patienten. Dospåsarna levereras av dosapoteket till en dosmottagare, som är leveransstället.

Användare hos dosaktör som går mot versionspaket 16.1 kan hämta information endast om patienter kopplade till ett av de egna dosapoteken. 

Användare hos dosaktör som går mot versionspaket 17.1 kan hämta information om alla patienter. 

Informationen som hämtas inkluderar bland annat patientinformation, dostillhörighet, produktionsinformation, information om ordinärt boende/tillfällig adress/särskilt boende och hemsjukvård och vårdtagarstatus.

3.1.2 SOL-tjänst Hämta lokalt produktsortiment (SOL:05)

Tjänsten används av vårdaktör.

I de fall där förskrivaren ordinerar ett läkemedel som ska dosdispenseras behöver denne ha information om vilket sortiment som dosaktören har tillgängligt. Detta sortiment styrs bland annat av dosaktörens produktionsutrustning och av regionens avtal med den dosaktör de upphandlat tjänsten av. Det är dosaktören som har definierat sitt sortiment. Ett dosapotek kan ha olika sortiment för olika regioner. Vården behöver informationen till exempel för att veta vilken produkt som bör förskrivas för att den ska kunna dispenseras av dosaktören som levererar till den aktuella dospatienten. Tjänsten kan leverera dosapotekets dispenserbara sortiment för den region som patienten tillhör eller dosapotekets hela dispenserbara sortiment.

För att vården ska kunna hämta lokalt produktsortiment krävs att dosaktören först har definierat sitt sortiment via SOL-tjänsten Leverera lokalt produktsortiment (SOL:37).

3.2 Delprocess Förbereda Helförpackningsorder

Delprocess Förbereda helförpackningsorder sker hos en vårdaktör eller hos en apoteksaktör.

En helförpackning kan vara ett läkemedel som inte kan dispenseras, till exempel flytande hostmedicin eller ett läkemedel som är ordinerat att intas vid behov. Även livsmedel och hjälpmedel som förskrivs kan beställas på samma sätt som helförpackningar.

En beställning av en helförpackning hämtas, produceras och levereras av det dosapotek som hanterar den aktuella dospatienten.

Helförpackningar kallas i SOL-tjänsterna för originalförpackning (OF).

Det gula processteget i figur 4 innehåller verksamhetsmässiga kopplingar till SOL-tjänsterna Beställ originalförpackning (SOL:06/SOL:26), Hämta beställningsidn (SOL:42), Hämta originalförpackning/Hämta beställning (SOL:07/SOL:27), Uppdatera beställningsstatus (SOL:36) samt Avbeställ originalförpackning (SOL:08).

Figur 4 Delprocess Förbereda Helförpackningsorder på ett apotek

3.2.1 SOL-tjänst Beställ originalförpackning (SOL:06/SOL:26)

Vården eller en dosaktör, på uppdrag av vården, kan lägga en beställning på en originalförpackning som berörd dospatient har recept på. När en beställning skapats i SOL får den status "Mottagen".

3.2.2 SOL-tjänster Hämta beställningsidn (SOL:42) och Hämta originalförpackning/Hämta beställning (SOL:07/SOL:27) 

Vården kan hämta information om tidigare lagda beställningar på produkter i originalförpackning. Detta görs med tjänsten Hämta originalförpackning (SOL:07​).

Beställningarna ska hämtas, produceras och levereras av den dosaktör som hanterar den aktuella dospatienten. 

Dosaktören är skyldig att fånga upp och hämta upp information om samtliga beställningar som lagts till dosaktören. Beställningar kan inkomma till SOL även under ett driftstopp hos en dosaktören, såväl planerade som oplanerade. 

Dosaktören hämtar beställningarna med tjänsterna Hämta beställningsidn (SOL:42)​ ​och Hämta beställningar (SOL:27).

Med tjänsten Hämta beställningsidn (SOL:42) hämtas enbart id:n på beställningarna. Denna tjänst används för att fånga upp id:n på beställningar, men ger ingen information om patienten eller innehållet i beställningen. Denna tjänst kan användas av maskinanvändare.

För att hämta patientinformation och beställningens fullständiga innehåll används tjänsten Hämta beställningar (SOL:27) där beställningsid används som inparameter. Denna tjänst kräver fysisk person för anrop.

3.2.3 SOL-tjänst Uppdatera Beställningsstatus (SOL:36)

Tjänsten används av dosaktör.

Dosaktör kan uppdatera status på en tidigare lagd beställning på en produkt i originalförpackning. En beställning kan ha följande statusar:

• Mottagen​​                        En beställning får status "Mottagen" när den skapas och lagras i SOL.
  
• Mottagen av apotek         Dosaktör kan uppdatera beställningen från vården till denna status. Då beställningen skapas av dosaktören sätts denna                                             status automatiskt.
• Under bearbetning          Dosaktör kan uppdatera beställningen till denna status.
• Skickad av apotek           Dosaktör kan uppdatera beställningen till denna status.
• Expedierad                     Dosaktören har expedierat och levererat beställning.
• Avbeställd                      Vården, eller dosaktören, har avbeställt beställningen.
• Avvisad                          Beställningen kan av olika orsaker, till exempel slutexpedierat recept, ha avvisats.

Beställningar som har status "Avbeställd" kan inte ändras till någon annan status. Beställningar som har status "Expedierad" kan ändras tillbaka till status "Mottagen".

Tidpunkt för statusuppdateringen sätts automatiskt av SOL.

Observera att det endast är statusfältet, meddelandefältet samt planerad leveranstid som kan uppdateras med denna tjänst. För att uppdatera beställningsstatus anges beställnings-ID. 

Användare på dosapotek får endast uppdatera beställningar till det egna dosapoteket.

3.2.4 SOL-tjänst Avbeställ originalförpackning (SOL:08)

Tjänsten används av vårdaktör.

Vården kan avbeställa en lagd beställning på en produkt i originalförpackning.

Beställning kan inte avbeställas om den redan har blivit expedierad, det vill säga levererad, av dosaktören. En sådan avbeställning kommer att avvisas.

3.3 Stödprocess Hantera dospatient

Stödprocess Hantera dospatient sker hos en vård- eller dosaktör.

För fullständig beskrivning av stödprocessen hänvisas till sidorna Ordinationsprocessen respektive Receptexpeditionsprocessen. Förutom de processteg som finns beskrivna där finns det specifika SOL-tjänster som används för att hantera dospatienter. Dessa tjänster kan anropas av användare både hos dosaktör och hos vård.

3.3.1 SOL-tjänst Skapa ny vårdtagare (SOL:01/SOL:21)

Vården kan skapa en vårdtagare för dos (dospatient). Dospatienten blir via sitt boende eller hemsjukvårdsområde och ordinationsansvariga enhet kopplad till ett specifikt dosapotek som kommer att producera dospåsarna åt patienten. För att en dospatient ska kunna knytas till ett boende, krävs det att boendet finns registrerat i SOL.

En dosaktör kan också, på uppdrag av region eller kommun med vilken man har avtal, skapa en vårdtagare för dos. Användare hos dosaktör får endast skapa dospatient kopplad till ett av de egna dosapoteken.

Processen för att skapa en ny dospatient innebär att en vårdtagare skapas i SOL och att ett dosunderlag skapas i Receptdepå human. För att ett dosunderlag ska få skapas, måste ett samtycke inhämtas och lagras hos E-hälsomyndigheten. Samtycket kan endast inhämtas av läkare med individuell förskrivarkod. När detta är klart kan vården börja ordinera läkemedel för dosdispensering. Dosapoteket ska, efter att dosunderlag skapats, uppdatera dostillhörighet på dosunderlaget via E-hälsomyndighetens tjänster. När denna uppdatering är klar finns kopplingen mellan dosunderlag och dosapotek.

Vårdtagaren behöver vara ansluten till högkostnadsdatabasen (HKDB) för att kunna bli dospatient. Undantaget är barn under 18 år som inte behöver anslutas till HKDB för att kunna registreras som dospatient. Anslutning till HKDB hanteras inte av tjänsten Skapa ny vårdtagare. 

3.3.2 SOL-tjänst Uppdatera Vårdtagare (SOL:03/SOL:23)

Vården kan uppdatera information kopplad till dospatient.

Dosaktör kan också, på uppdrag av region eller kommun med vilken man har avtal, uppdatera en vårdtagare för dos. Användare på dosapotek får endast uppdatera information kopplad till patient inom det egna dosapoteket.

3.3.3 SOL-tjänst Flytta Vårdtagare (SOL:41)

4 SOL-specifika stödtjänster

4.1 SOL-tjänst Skapa ordinationsansvarig enhet (SOL:16)

Tjänsten används av dosaktör.

Dosaktör kan skapa en ordinationsansvarig enhet (även kallad vårdande enhet). En ordinationsansvarig enhet kan till exempel vara en vårdcentral. 

När en ordinationsansvarig enhet skapas av ett dosapotek knyts den nya enheten till det dosapotek som skapade den.

Användare på dosapotek får endast skapa ordinationsansvarig enhet kopplad till ett av de egna dosapoteken.

4.2 SOL-tjänster Sök vårdande enhet/ordinationsansvarig enhet (SOL:04/SOL:24)

Vård- eller dosaktör kan söka fram en ordinationsansvarig enhet (även kallad vårdande enhet). I svaret framgår vilket dosapotek som den ordinationsansvariga enheten är kopplad till. Detta behövs till exempel då man inom vården vill lägga upp en ny dospatient.

En ordinationsansvarig enhet kan till exempel vara en vårdcentral.

För att söka ordinationsansvarig enhet anges namn och/eller ort.

4.3 SOL-tjänst Uppdatera ordinationsansvarig enhet (SOL:14)

Tjänsten används av dosaktör.

Dosaktör kan uppdatera information kopplad till en ordinationsansvarig enhet (även kallad vårdande enhet). En ordinationsansvarig enhet kan till exempel vara en vårdcentral. 

Användare på dosapotek får endast uppdatera information för ordinationsansvarig enhet kopplad till ett av de egna dosapoteken.

4.4 SOL-tjänst Skapa särskilt boende & hemsjukvård (SOL:17)

Tjänsten används av dosaktör.

Dosaktör kan skapa ett särskilt boende eller en enhet inom hemsjukvården. Ett särskilt boende kan vara ett vårdhem. Hemsjukvård kan till exempel vara ett hemsjukvårdsdistrikt.

Användare på dosapotek får endast skapa särskilt boende eller hemsjukvård kopplad till ett av de egna dosapoteken.

4.5 SOL-tjänst Sök särskilt boende & hemsjukvård (SOL:35)

Tjänsten används av dosaktör.

Dosaktör kan söka fram ett särskilt boende eller hemsjukvård. I svaret framgår adressuppgifter samt vilket dosapotek som boendet eller hemsjukvården är kopplat till.

Ett särskilt boende kan vara till exempel ett vårdboende. Hemsjukvård kan vara ett hemsjukvårdsdistrikt i kommunen.

Användare på dosapotek får endast läsa särskilda boenden som är kopplade till den egna dosaktören.

4.6 SOL-tjänst Uppdatera särskilt boende & hemsjukvård (SOL:15)

Tjänsten används av dosaktör.

Dosaktör kan uppdatera information kopplad till ett särskilt boende eller en enhet inom hemsjukvården. Ett särskilt boende kan vara ett vårdhem. Hemsjukvård kan till exempel vara ett hemsjukvårdsdistrikt.

Användare på dosapotek får endast uppdatera information för särskilt boende eller hemsjukvård kopplad till ett av de egna dosapoteken.

4.7 SOL-tjänst Skicka meddelanden (SOL:09 / SOL:29)

Vården kan skapa ett meddelande i fritextformat till en dospatients dosaktör. Dosapotek kan skapa ett meddelande i fritextformat till vården.

Meddelanden är patientbundna (kopplat till ett personnummer) alternativt meddelandebundet (kopplat till en tidigare meddelandeidentitet). En meddelandekedja börjar alltid med ett patientbundet meddelande. När ett patientbundet meddelande har skapats kan svar hanteras via meddelandebundna meddelanden, som refererar till föregående meddelande. Meddelandeidentitet tilldelas av E-hälsomyndigheten.

Meddelande kan skapas från vården, via vårdsystem (via tjänst SOL:09), och från dosapotek (via tjänst SOL:29). Innehållet i meddelanden måste vara förenliga med gällande lagstiftning, förordningar och författningar. Notera särskilt att meddelandefunktionen inte är avsedd att ersätta funktion i befintliga tjänster. Tänk också på att personer som inte har yrkesändamål kan se dessa uppgifter, och därmed ta del av känslig information.

4.8 SOL-tjänster Hämta meddelandeidn (SOL:43) och Hämta meddelanden (SOL:10/SOL:30)

Vården kan hämta ett meddelande i fritextformat som skapats av dosapotek (via tjänsten Hämta meddelanden SOL:10). 

Meddelanden från vård till apotek ska hämtas och hanteras av det dosapotek som hanterar den aktuella dospatienten. 

Dosaktören är skyldig att fånga upp och hämta information om samtliga meddelanden som lagts till aktören.  Meddelanden kan inkomma till SOL även under ett driftstopp hos en dosaktör, såväl planerade som oplanerade. ​

Dosaktören hämtar meddelanden med tjänsterna Hämta meddelandeidn (SOL:43)​ ​och Hämta meddelanden (SOL:30).

Med tjänsten Hämta  meddelandeidn (SOL:43) hämtas enbart id:n på meddelandena. Denna tjänst används för att fånga upp id:n på meddelanden, men ger ingen information om patienten eller innehållet i meddelandet. Denna tjänst kan användas av maskinanvändare.

För att hämta patientinformation och meddelandets fullständiga innehåll används tjänsten Hämta meddelanden (SOL:30) där meddelandeid används som inparameter. Denna tjänst kräver fysisk person för anrop.​​

Meddelanden som är markerade som "Borttagna" returneras inte.

4.9 SOL-tjänst Uppdatera meddelandestatus (SOL:11/SOL:31)

Vården eller dosapotek kan uppdatera status på ett tidigare skapat meddelande.

Meddelande kan uppdateras från status "Oläst" till "Läst", "Oläst" till "Borttaget" eller "Läst" till "Borttaget". Ett eller flera meddelande kan ändra status i samma anrop. Meddelandestatus kan även uppdateras från "Läst" tillbaka till "Oläst".

Meddelanden är patientbundna (kopplat till ett personnummer) alternativt meddelandebundet (kopplat till en tidigare meddelandeidentitet).

4.10 SOL-tjänst Leverera lokalt produktsortiment (SOL:37)

Tjänsten används av dosaktör.

Dosaktör kan uppdatera sitt lokala dispenserbara produktsortiment så att detta kan läsas av vården i till exempel en förskrivningssituation och ge förskrivare vägledning om vilket läkemedel som ska förskrivas för att kunna dispenseras.

Flera olika lokala produktsortiment per dosapotek kan definieras för att kunna hantera flera regioner kopplade till samma dosapotek. 

4.11 SOL-tjänst Skapa produktionsinformation (SOL:40)

Tjänsten används av dosaktör.

Dosaktör kan skapa produktionsinformation för sina dosmottagare, till exempel stopptider för beställning. Produktionsinformationen är kopplad till leverans och logistik kring dosmottagaren.

Varje dospatient är kopplad till en dosmottagare via sitt boende. Detta kan vara antingen ett särskilt boende, (exempelvis ett vårdboende), ett ordinärt boende (hemma), eller en tillfällig adress. Dosapoteket levererar varorna till den dosmottagare som är kopplad till patientens boende.

Dosmottagar-id måste definieras som inparameter för att skapa produktionsinformation.

När stopptider för beställning och ordination har passerats måste dessa värden uppdateras med nya stopptider via tjänsten Uppdatera produktionsinformation (SOL:38).

Produktionsinformationen kan läsas av vården via SOL-tjänsten Hämta vårdtagarinformation (SOL:02).

Dosaktör ska endast kunna skapa produktionsinformation för dosmottagare kopplad till ett av de egna dosapoteken.

4.12 SOL-tjänst Uppdatera produktionsinformation (SOL:38)

Tjänsten används av dosaktör.

Dosaktör kan uppdatera produktionsinformation för sina dosmottagare, till exempel stopptider för beställning. Produktionsinformationen är kopplad till leverans och logistik kring dosmottagaren.

4.13 SOL-tjänst Skapa dosmottagare (SOL:44)

Tjänsten används av dosaktör.

Dosaktören kan skapa dosmottagare med tillhörande produktionsinformation.

Varje dospatient är kopplad till en dosmottagare via sitt boende. Detta kan vara antingen ett särskilt boende, (exempelvis ett vårdboende), ett ordinärt boende (hemma), eller en tillfällig adress. Dosapoteket levererar varorna till den dosmottagare som är kopplad till patientens boende.

4.14 SOL-tjänst Sök dosmottagare (SOL:12/SOL:45)

Tjänsten används av vårdaktör eller dosaktör.

Tjänsten kan användas för att söka dosmottagare för att hitta information för att kunna koppla dospatient korrekt.

4.15 SOL-tjänst Ta bort dosmottagare (SOL:46)

Tjänsten används av dosaktör.

Dosaktören kan ta bort dosmottagare med tillhörande produktionsinformation, förutsatt att det inte finns kopplingar till  en aktiv dospatient.

Varje dospatient är kopplad till en dosmottagare via sitt boende. Detta kan vara antingen ett särskilt boende, (exempelvis ett vårdboende), ett ordinärt boende (hemma), eller en tillfällig adress. Dosapoteket levererar varorna till den dosmottagare som är kopplad till patientens boende.

4.16 SOL-tjänst Uppdatera dosmottagare (SOL:47)

Tjänsten används av dosaktör.

Dosaktören kan uppdatera dosmottagare.

Varje dospatient är kopplad till en dosmottagare via sitt boende. Detta kan vara antingen ett särskilt boende (exempelvis ett vårdboende), ett ordinärt boende (hemma), eller en tillfällig adress. Dosapoteket levererar varorna till den dosmottagare som är kopplad till patientens boende.

4.17 SOL-tjänst Ta bort särskilt boende (SOL:48)

Tjänsten används av dosaktör.

Dosaktör kan ta bort ett särskilt boende eller en enhet inom hemsjukvården. Ett särskilt boende kan vara ett vårdhem. 

För information om behörighet och loggning, se Behörighetsstyrning från och med 17.1 

6 Specifikt om datum för vilandestatus

7 Historisering

8 Versionshistorik