Expeditionsställeregister (EXPO)
1. Inledning
1.1 Syfte
Syftet med denna sida i handboken är att beskriva Expeditionsställeregistret, så som dess innehåll och tjänster.
1.2 Målgrupp
Målgrupp för denna sida är apoteksaktör (tillståndsinnehavare för ett eller flera öppenvårdsapotek) med IT-system som nyttjar E-hälsomyndighetens tjänster samt systemleverantör som utvecklar eller förvaltar dessa IT-system.
1.3 Informationsnivå
Allmän information
1.4 Bakgrund
Expeditionsställeregistret (EXPO) innehåller information om försäljningsställen som säljer läkemedel och förmånsberättigade varor.
EXPO innehåller alla apotek som enligt lag ska tillhandahålla statistikunderlag till E-hälsomyndigheten. Registret innehåller i första hand information om apoteksaktörer och dess apotek, men även information om apoteksaktörers administrativa enheter och kundtjänst.
Syftet med EXPO är att förse andra delsystem inom E-hälsomyndigheten, andra myndigheter, externa webbplatser, vårdaktörer och apoteksaktörer med apoteksinformation. EXPO används bland annat för komplettering och valideringar av transaktioner mot E-hälsomyndigheten.
Det är väldigt viktigt att informationen i EXPO har hög kvalitet då den används i olika tjänster hos E-hälsomyndigheten, men även av andra myndigheter, olika aktörer och externa webbplatser.
I Behörighetsstyrning från och med release17.1 finns en behörighetsmatris som detaljerat beskriver vilka tjänster som respektive roll får använda.
2. Specifika definitioner för EXPO
Ett apotek är ett expeditionsställe. Ett apotek tillåts endast ha en identifierare i EXPO. Identifieraren ska vara en unik GLN-kod (GLN - Global Localisation Number, se www.gs1.se) som inte får ändras, bytas ut eller återanvändas. GLN-koden är oftast sammankopplad med ett specifikt tillstånd för att bedriva öppenvårdsapotek utfärdat av Läkemedelsverket, med undantag för administrativa enheter och kundtjänst. Dessa behöver inget specifikt tillstånd för att bedriva öppenvårdsapotek, men fortfarande en unik GLN-kod.
En aktör har expeditionsställen under sig och är ett överordnat begrepp. En aktör identifieras med organisationsnummer och namn. En aktör tillåts endast administrera sina egna expeditionsställen. Ett antal aktörer kan grupperas till en aktörsgrupp.
En aktörsgrupp är en gruppering av aktörer för administrativa syften. En aktör som ingår i en aktörsgrupp får behörighet att administrera alla expeditionsställen för alla aktörer i aktörsgruppen. En aktörsgrupp identifieras med gruppnamn och specifik sammankoppling. Anmälan om att tillhöra en grupp ska göras skriftligen till E-hälsomyndigheten.
Ett expeditionsställe är aktivt ett visst datum om detta datum ligger inom start- och slutdatum, samt om expeditionsstället innehar tillstånd för att bedriva öppenvårdsapotek av Läkemedelsverket. Ett expeditionsställe måste ha ett startdatum men behöver inte ha ett slutdatum om det är öppet tillsvidare.
3. Informationsinnehåll i EXPO
3.1 Aktörsgruppen
EXPO innehåller följande information om aktörsgruppen: gruppnamn, grupp-id och grupptyp.
3.2 Aktören
EXPO innehåller följande information om aktören: aktörsnamn, organisationsnummer och aktörs-id.
3.3 Expeditionsställen - Apotek
EXPO innehåller följande information om ett apotek: apoteks-id (unik identifierare=GLN-kod), apoteksnamn, kortnamn, besöksadress, besöksort samt annan geografisk information, telefonnummer, eventuell tidigare GLN-kod, verksamhetstyper, e-receptinformation (både för human och djur), tillståndsstatus samt information om öppethållande.
3.3.1 Definition av verksamhetstyper
För apotek finns det två parallella kodsystem för att ange typ av verksamhet.
3.3.1.1 Huvudorganisationskod
I det ena kodsystemet som benämns huvudorgtypkod, anges huvudverksamhet. Endast en verksamhetstyp kan väljas i detta kodsystem. Parametern används för att exportera ut huvudverksamhet till vårdsystemen i apotekslistan_js, samt apotekslista_js_djur. För mer information om apotekslistan_js se
5.1 Förskrivning. Huvudorgtypkod exporteras även till apotekslista_apotek_oppettider, mer information finns under
5.5 Apoteksinformation till webbplats, apotekslista_apotek_oppettider. För definition av vilka huvudorgtypkoder som finns se
EXPO - Funktionsspecifikation (17.1).
3.3.1.2 Organisationstyp
I det andra kodsystemet, orgtyp, kan ett apotek ha flera koder satta, men det är obligatoriskt att ange minst en orgtyp till TRUE. Detta kodsystem innehåller alla verksamhetstyper ett expeditionsställe har. De koder som finns tillgängliga definieras i
EXPO - Funktionsspecifikation (17.1). Till exempel kan ett apotek som både bedriver distanshandel och är öppet för allmänheten i butik ha två flaggor, DIST och EA. Om man inte har öppet för allmänheten utan enbart bedriver distanshandel använder man enbart DIST. Det kan även innebära att huvudorgtypkoden och orgtyp är av samma typ, t.ex: huvudorgtyp=SA (Sjukhusapotek) och orgtyp=SA (Sjukhusapotek).
4. Informationsansvar för EXPO
4.1 Aktörens ansvar
Ansvaret för att hålla information om försäljningsställena i EXPO uppdaterad ligger på den aktör som är ansvarig för respektive försäljningsställe. E-hälsomyndigheten ansvarar inte att uppdatera någon annan information än det som specificeras under 4.2 E-hälsomyndighetens ansvar. Om fel uppkommer i sådan information som aktören är ansvarig för att skicka in, är det respektive aktör som är ansvarig för att rätta informationen i EXPO. Om E-hälsomyndigheten upptäcker felaktig information i EXPO meddelas aktörens kundtjänst. Informationen i EXPO måste hållas uppdaterad då till exempel receptexpeditioner kan bli felaktiga, allmänhet och vård kan få felaktig information om expeditionsstället och försäljningstransaktioner kan avvisas. Läkemedelsstatistiken kan bli inkorrekt, vilket får konsekvenser för bland annat myndigheternas uppföljning.
Anrop med uppdateringar till EXPO ska övervakas från aktörens expedierande system för att undvika att allvarliga fel uppkommer i processerna.
Aktören ansvarar för att förse E-hälsomyndigheten med en kopia av beslutet om beviljat tillstånd för att bedriva öppenvårdsapotek från Läkemedelsverket, samt att förse E-hälsomyndigheten med information om aktören på aktörsnivå. Detta skickas in via aktörens kundtjänst till E-hälsomyndighetens Servicedesk
servicedesk@ehalsomyndigheten.se. Observera att om apoteket avslutar sin verksamhet ska den apoteksaktör som ansvarar för apoteket uppdatera EXPO med apotekets slutdatum.
4.2 E-hälsomyndighetens ansvar
E-hälsomyndighetens ansvarar för att uppdatera tillståndsstatus för apoteken samt information om aktörer och aktörsgrupper i EXPO. Tillståndsstatus avser Läkemedelsverkets beslut om tillstånd för att bedriva apoteksverksamhet.
För att E-hälsomyndigheten ska markera i EXPO att ett apotek har fått tillstånd av Läkemedelsverket att bedriva apoteksverksamhet krävs att aktören/apoteket uppdaterat EXPO med apoteksinformation och skickat/mejlat en kopia av Läkemedelsverkets beslut på erhållet tillstånd till E-hälsomyndighetens servicedesk.
E-hälsomyndigheten rekommenderar att aktören skickar in intyget så snart det erhållits av Läkemedelsverket. Startdatum för verksamheten styr när apoteket aktiveras mot vårdsystemen.
5. Användningsområde för EXPO
Samtliga transaktioner mot E-hälsomyndighetens tjänster, till exempel mot Receptdepå human, Högkostnadsdatabasen, Läkemedelsförteckningen, försäljningstransaktioner, måste innehålla identitet på anropande apotek som är registrerat i EXPO. Med hjälp av EXPO avgörs om det är ett apotek som har tillstånd för apoteksverksamhet som använder E-hälsomyndighetens tjänster.
Apoteksaktören ansvarar för att korrekta identiteter för apoteken används i transaktioner med E-hälsomyndighetens tjänster. Transaktioner där apoteket inte kan verifieras mot EXPO avvisas. Detta innebär att det är mycket viktigt att kvaliteten på informationen i EXPO är korrekt och aktuell, i annat fall påverkas hela processen från förskrivning, expedition till rapportering och efterföljande ekonomiska transaktioner och statistikinrapportering.
Nedan beskrivs några processer som kräver korrekt information från EXPO mer ingående.
5.1 Förskrivning Human och Förskrivning Djur
Vid förskrivning behöver förskrivare i vissa sammanhang kunna adressera ett e-recept till ett angivet apotek,exempelvis då en patient inte har ett fullständigt personnummer. Vid mottagning av e-recept sker en validering mot EXPO att en korrekt adressering till apoteket skett. För att kunna adressera e-receptet direkt till ett apotek krävs att förskrivaren i sitt vårdsystem har tillgång till en lista med de apotek som har tillstånd av Läkemedelsverket att bedriva apoteksverksamhet och är aktiva. Listan som benämns apotekslista human (apotekslista_js), exporteras från EXPO och tillhandahålls till vårdsystem human. Apotekslista djur, (apotekslista_js_djur), exporteras också från EXPO och tillhandhålls till vårdsystem djur. Båda listorna tillhandahålls via en sftp-plats.
Försäljningsställen med följande villkor satta exporteras till apotekslista human:
- eRecept satt till TRUE
- Startdatum är aktuellt datum eller tidigare, eventuellt slutdatum är aktuellt datum eller senare
- Försäljningsstället har tillstånd från Läkemedelsverket att bedriva apoteksverksamhet
Försäljningsställen med följande villkor satta exporteras till apotekslista djur:
• Expeditionsställen med Huvudorgtypkod =AP, DJUR eller DIAP
• Startdatum är aktuellt datum eller tidigare, eventuellt slutdatum är aktuellt datum eller senare
• Försäljningsstället har tillstånd från Läkemedelsverket att bedriva apoteksverksamhet
Apotekslistorna kan även användas av vården bland annat för att hitta öppna öppenvårdsapotek nära patienten/djurägaren, kontrollera apotekens öppettider, hitta telefonnummer eller adresser till apoteken. För att få tillgång till apotekslistan ansöker regionerna/veterinära system om ett sftp-abonnemang hos E-hälsomyndigheten. Dokumentation om exportfilen finns beskriven i handboken för vårdaktörer human och djur. Följande termer (se funktionsspecifikationen för mer information om termerna) exporteras till apotekslistorna:
- glnKod
- namn
- kortnamn
- postAdress
- besöksAdress
- postNr
- postort
- lan (landstingskod)
- kommun (kommunkod)
- allmTelefon
- recepturtelefon
- huvudOrgTypKod
- eRecept markering
- oppetHallandeLista (normala öppettider, samt tillfälligt stäng/orsak i närtid.)
5.2 Receptexpedition
Vid expedition av e-recept ska det vara möjligt att kunna söka i Receptdepå human, Receptdepå djur eller efter e-recept som adresserats till det egna apoteket exempelvis för personer som saknar fullständigt personnummer.
Vid expedition kan det även finnas behov av att söka kontaktinformation i EXPO för apotek som tidigare utfört transaktioner för en kund i Receptdepå human eller Receptdepå djur. Expedierande system kan stödja detta genom att läsa kontaktinformation i EXPO för dessa apotek. Tjänsten HamtaApoteksInfo används.
5.3 Distribution av läkemedelsförmån
Vid distribuering av läkemedelsförmånen till regionerna, valideras att försäljningstransaktionerna skett av ett apotek som finns i EXPO, har tillstånd att bedriva apotek av Läkemedelsverket och är aktivt. Om inte detta uppfylls avvisas transaktionerna. Valideringen sker mot GLN-kod.
5.4 Statistik
Expeditionsställen som säljer läkemedel eller förmånsberättigade varor är förpliktigade enligt lag att tillhandahålla statistikunderlag till E-hälsomyndigheten för den nationella läkemedelsstatistiken. Vid inrapportering av statistik valideras inskickad GLN-kod mot EXPO.
5.5 Apoteksinformation till webbplats, apotekslista_apotek_oppettider
Apotekslista_apotek_oppettider exporteras från EXPO dagligen och tillhandahålls till Sveriges Apoteksförening och fass.se via en sftp-plats. Apotekslistan innehåller bland annat öppettider, adresser och kontaktuppgifter till apotek som finns i EXPO. Apoteksinformationen exponeras ut på Sveriges Apoteksförenings hemsida, samt fass.se.
6. Arbetsflöden för EXPO
Nedan illustreras ett antal arbetsflöden för att administrera information i EXPO.
6.1 Administrera apotek
6.1.1 Skapa apotek
Nedan illustreras arbetsflödet för att skapa ett apotek.
Figur 1. Arbetsflöde Skapa apotek
6.1.2 Uppdatera apotek
Nedan illustreras arbetsflödet för att uppdatera ett apotek.
Figur 2. Arbetsflöde Uppdatera apotek
6.2 Hämta apoteksinformation
Nedan illustreras arbetsflödet för att hämta apoteksinformation.
Figur 3. Arbetsflöde Hämta apoteksinformation
7. Tjänsteanrop EXPO
Nedan beskrivs vilka tjänsteanrop som finns för att anropa EXPO direkt och som ska användas i olika situationer. För detaljerad information om tjänsteanropen hänvisas till den beskrivning av tjänsterna som finns i
EXPO - Funktionsspecifikation (17.1). I tjänsteanropet måste en redan befintlig GLN-kod anges, anropet måste komma från ett expeditionsställe som redan finns upplagt i EXPO för att det ska godkännas. Se vidare i
Behörighetsstyrning från och med release17.1.
7.1 Tjänsteanrop HamtaApoteksInfo
En apoteksaktör kan läsa information om ett apotek i EXPO genom att använda tjänsten HamtaApoteksInfo. Datum och tid kan skickas med i tjänsteanropet. Om parametrarna anges, returneras apoteksinformationen som gällde vid angiven tidpunkt. I tjänsteanropet måste en redan befintlig GLN-kod anges, anropet måste komma från ett expeditionsställe som redan finns upplagt i EXPO för att det ska godkännas.
7.2 Tjänsteanrop SkapaApotek
För att skapa ett apotek i EXPO ska tjänsten SkapaApotek användas.
För att ett apotek ska kunna läggas in i EXPO av aktören, måste dess aktör vara upplagd i EXPO. Endast den egna aktören eller gruppen tillåts skapa apotek. I anropet måste en redan befintlig GLN-kod anges, anropet måste komma från ett expeditionsställe som redan finns upplagt i EXPO för att det ska godkännas. Apoteksnamnet bör återspegla verksamheten och gärna innefatta eventuell kedja som apoteket tillhör.
7.3 Tjänsteanrop UppdateraExpoMedApotek
För att uppdatera information om ett apotek ska tjänsten UppdateraExpoMedApotek användas.
Endast den egna aktören eller gruppen tillåts uppdatera information om apotek. I tjänsteanropet måste en redan befintlig
GLN-kod anges, anropet måste komma från ett expeditionsställe som redan finns upplagt i EXPO för att det ska godkännas.
7.4 Tjänsteanrop HamtaApoteksinfoEget
Genom att anropa tjänsten HamtaApoteksinfoEget med GLN-kod returneras all gällande information om ett eget apotek som finns inlagd i EXPO. Om organisationsnummer skickas in returneras gällande information om alla apotek inom en viss aktör. Endast den egna aktören eller gruppen tillåts hämta information om apotek. I tjänsteanropet måste en redan befintlig GLN-kod anges, anropet måste komma från ett expeditionsställe som redan finns upplagt i EXPO för att det ska godkännas. Tjänsten är en lästjänst som kan användas för att verifiera vad som finns inlagt i EXPO för den egna aktörens apotek.
7.5 Tjänsteanrop SkapaDosmottagare.
Med tjänsteanropet skapas dosmottagare i EXPO. Dosmottagaren kan antingen vara av typen öppenvårdsapotek eller direktleverans. I tjänsteanropet måste en redan befintlig
GLN-kod anges, dvs. anropet måste komma från ett expeditionsställe som redan finns upplagt i EXPO för att det ska godkännas.
- Registrerande apotek måste tillhöra samma aktörsgrupp som dosproducenten. Är en aktör sammankopplad med en annan aktör via en aktörsgrupp kan båda aktörerna skapa dosmottagare åt varandra. Saknas aktörsgrupp ska registrerande apotek tillhöra samma aktör som dosproducenten.
- Samtliga dosproducenter ska kunna skapa dosmottagare i sina respektive system.
- Apoteks-id (GLN-kod) för dosproducenten måste ha aktiv Organisationskod (orgtyp)= DOS eller Huvudorganisationskod (huvudorgtypkod) = DX i EXPO, dvs. dosmottagare kan endast kopplas till dosproducenten.
- Dosutlämnande apotek måste ha Apoteks-id som finns upplagt i EXPO och ha godkänt tillstånd från Läkemedelsverket (LV).
7.6 Tjänsteanrop UppdateraDosmottagare
Tjänsteanropet uppdaterar information om dosmottagare i EXPO. Dosmottagaren kan antingen vara av typen öppenvårdsapotek eller direktleverans. I tjänsteanropet måste en redan befintlig GLN-kod anges, dvs. anropet måste komma från ett expeditionsställe som redan finns upplagt i EXPO för att det ska godkännas.
Apoteks-id (GLN-kod) för dosproducenten och mottagar-id för dosmottagaren skickas in för att identifiera vilken information som kan uppdateras.
- Alla parametrar måste skickas med vid ändring, även de uppgifter som inte har ändrats. Anropande system kan välja att korrigera en eller flera parametrar vid anrop. Samtliga korrigerbara parametrar skickas med i anrop. Anges inget värde för en parameter raderas innehållet i parametern. Obligatoriska parametrar måste inneha ett värde.
- Samtliga dosproducenter ska kunna uppdatera dosmottagare i sina respektive system.
- Registrerande apotek måste tillhöra samma aktörsgrupp som dosproducent. Är en aktör sammankopplad med en annan aktör via en aktörsgrupp kan båda aktörerna uppdatera dosmottagare åt varandra. Saknas aktörsgrupp ska registrerande apotek tillhöra samma aktör som dosproducenten.
- Apoteks-id (GLN-kod) för dosproducenten måste ha aktiv Organisationskod (orgtyp)= DOS eller Huvudorganisationskod(huvudorgtypkod) = DX i EXPO, d v s dosmottagare kan endast kopplas till dosproducenten.
7.7 Tjänsteanrop TaBortDosmottagare
Tjänsteanropet används för användare ska kunna ta bort dosmottagare från dosproducent i EXPO. Dosmottagaren kan antingen vara av typen öppenvårdsapotek eller direktleverans. Apoteks-id (GLN-kod) för dosproducent och mottagar-id för dosmottagaren skickas in för att identifiera vilken information som ska tas bort. I tjänsteanropet måste en redan befintlig GLN-kod anges, dvs. anropet måste komma från ett expeditionsställe som redan finns upplagt i EXPO för att det ska godkännas.
- Borttagande apotek måste tillhöra samma aktörsgrupp som dosproducent. Är en aktör sammankopplad med en annan aktör via en aktörsgrupp kan båda aktörerna uppdatera dosmottagare åt varandra. Saknas aktörsgrupp ska borttagande apotek tillhöra samma aktör som dosproducenten.
- Samtliga dosproducenter ska kunna ta bort dosmottagare i sina respektive system.
Versionshistorik
2.0 |
2013-09-09 |
Kapitel 1, lagt till hänvisning till Extern kravspecifikation E002 Behörighetsstyrning.
Kapitel 6, arbetsflöden tillagda.
Kapitel 7, förtydligande av tjänsternas namn i respektive underrubrik. |
3.0 |
2014-04-28 |
Inlagt i ny mall.
Apotekens Service har ersatts av eHälsomyndigheten i den löpande texten och i arbetsflödena.
5.1, förtydligat att apotekslistan även används av vårdaktörer djur. |
4.0 |
2014-09-26 |
5.1 Rättning av kriterier för apotekslistor. |
| |
|
Ny mall |
4.2 |
2016-04-15 |
Rättat felstavningar och felaktig information under förskrivning human och djur och 5.5 Apoteksinformation till webbplats, apotekslista_apotek_oppettider. Inga funktionella korrigeringar inför release 16.1 har gjorts. |
| 5.2 |
2017-10-27 |
Lagt till förtydliganden om behörighetsstyrning från 17.1 |
| 6.0 |
2019-07-16 |
Tagit bort tjänster samt referenser till Kontaktuppgifter, samt huvudorgtyp OAP.
7.5-7.7 Information kring att dostjänster är flyttade från EXPO till SOL (17.1.5)
Uppdaterat länkar till teknisk information
Bytt namn på försäljningsställe till korrekta expedionsställe. Redaktionella ändringar |
