En EES-analys startar när en användare anropar tjänsten. Kundens elektroniskt lagrade recept hämtas och analyseras via tjänsten Hämta Signal per recept eller Hämta signal per grupp.

---

1. Hämta och presentera kundens EES-analys

En kunds EES-analys kan köras via två olika tjänster:

• Hämta signal per recept (HamtaSignalPerRecept).
• Hämta signal per grupp (HamtaSignalPerGrupp).

 Aktören ska göra ett aktivt val om vilken av tjänsterna man ska integrera mot.

1.1. Gemensam logik

Båda tjänsterna returnerar signaler för aktuella (status = Expedierbar) och inaktuella (status = Slutexpedierat eller Avslutad) förskrivningar. 

En signal kan skapas på tre olika sätt:

• från en aktuellt förskrivning.
• mellan två aktuella förskrivningar.
• mellan en aktuell och en inaktuellt förskrivning.

En signal kan aldrig skapas enbart via en inaktuell förskrivning. Har en förskrivning blivit inaktuell kommer denna förskrivning bara generera en signal om det påverkar en aktuell förskrivning. Detta gäller för regelkategorierna

• Interaktion
• Dubbelmedicinering
• Påverkar sjukdom
• Övrig info

Detta innebär att följande signaler inte kommer att visas för inaktuella förskrivningar:

• Hög dos
• Könsspecifikt
• Barn
• Barn - Info
• Äldre

Observera att alla förskrivningar inte genererar EES signal. 

Om inte alla signaler presenteras för användaren ska det tydligt framgå vilka typer av signaler som inte visas så att användaren själv kan göra en bedömning om manuell kontroll behöver göras.

En EES-analys ger en ögonblicksbild av en kunds potentiella läkemedelsrelaterade problem och ska vara ett stöd i den obligatoriska farmakologiska kontrollen.  Viss information om stängda signaler sparas hos E-hälsomyndigheten, men det går inte att ta del av gamla analysresultat.

1.2. Tjänsteanrop HamtaSignalPerRecept

HamtaSignalPerRecept kan användas i expedieringsflödet för att visa signaler knutna till en specifik förskrivning för användaren. 

Denna tjänst returnerar kundens alla signaler utifrån de förskrivningar som de har skapats ifrån. Tjänstesvaret är uppbyggd på ett sådant sätt att för varje förskrivning finns det noll till flera signal-id som hör till den aktuella förskrivningen. Utifrån signal-id kan man sedan ta fram information om signalen. Eftersom det för vissa signaler finns flera inblandade förskrivningar kan ett signal-id förekomma på flera förskrivningar.

1.3. Tjänsteanrop HamtaSignalPerGrupp

HamtaSignalPerGrupp bör användas när en användare vill få en helhetsbild av kundens alla signaler samtidigt.

Denna tjänst returnerar, precis som HamtaSignalPerRecept, kundens alla signaler utifrån de förskrivningar som de har skapats ifrån. Tjänstesvaret är uppbyggd på ett sådant sätt att för varje förskrivning finns det noll till flera signal-id som hör till den aktuella förskrivningen.

Det som tillkommer i HamtaSignalPerGrupp är att de signaler som anses farmakologiskt lika och som genererades utifrån samma regel (regel-id) bildar en grupp (grupp-id) som tjänsten returnerar. Via detta grupp-id kan man sedan ta fram information om vilken typ av signal det är (signalkategori beskrivning), samt den beskrivande texten (signalbeskrivning). Till varje grupp finns också alla enskilda signaler kopplade för att det ska vara möjligt att visa dem var för sig.

Grupp-id ska användas i tjänsten StangSignalPerGrupp, se mer information under Stänga signal.

1.4. Gemensamma detaljer för HamtaSignalPerRecept och HamtaSignalPerGrupp 

Nedan beskrivs gemensam information för HamtaSignalPerRecept och HamtaSignalPerGrupp. All information i tjänsten beskrivs inte, fokus ligger på EES-specifik information (signaler).

1.4.1. Förskrivningsinformation

Den förskrivningsinformation som skickas med i HamtaSignalPerRecept och HamtaSignalPerGrupp är inte fullständig förskrivningsinformation, men det är den information som krävs för att kunna identifiera rätt förskrivning och sedan koppla förskrivningen till rätt signal. Förskrivningsinformation kan även hämtas via andra tjänster från E-hälsomyndigheten via recept-id/ForskrivningsId.

1.4.2. Hantering av spärrade recept

De förskrivningar som är spärrade för vårdnadshavare, och ingår i analyssvaret, har två frivilliga extensions-attribut:

• Spärrad uppgift kod (sparradUppgiftKod)
• Spärrad uppgift klartext (sparradUppgiftKlartext).

Via Recept-id/ForskrivningsId kan den spärrade informationen kopplas till rätt signal (signal-id). Detta gäller även om signalen är stängd och för Ej granskade läkemedel. Det ska i ett tidigt skede framgå tydlig om det finns någon signal  som genererats från en spärrad förskrivning, till exempel genom en pop-up innan analysresultatet visas.

1.4.3. Ej granskade läkemedel

Ej granskade läkemedel är ett samlingsnamn för de läkemedel som inte har granskats i samtliga EES regelkategorier.

Varje läkemedel som inte är analyserat i alla regelkategorier beskrivs med en orsakskod och en klartext till hur läkemedlet är granskat.

En användare ska ha tillgång till information om vilka läkemedel som inte har granskats och orsaken till varför de inte granskats. Parametern Orsak klartext ska användas för att meddela användaren hur läkemedlet inte har granskats. Ej granskade läkemedel visar om receptet är spärrat.​

1.4.4. Stängda signaler

När farmaceuten stänger en signal sätts en flagga av systemet. Dessa stängda signaler ska finnas tillgängliga för nästa användare. Det ska visas vilken signal det gäller samt de specifika parametrarna för stängd signal, se tabellen nedan.

Informationsmängder specifika för stängd signal:

För stängd signal framgår det om signalen genererats från ett spärrat recept.

Versionshistorik