Sil SOAP API 4.2 Prerelease 2 (22 juni 2016) Nyheter och förändringar gentemot 4.1
Innehåll * 1. Inledning... 5 1.1 Allmänt... 5 1.2 Om dokumentationen... 5 1.3 Sammanfattning av förändringar... 5 2. Bakåtkompatibilitet... 6 3. Driftmiljö... 6 4. Ansökan om tillgång till demoservrar... 6 5. Nyheter... 7 5.1 Ordinationsorsaker... 7 5.1.1 Avsedd användning... 8 5.2 Länkar till produktresuméer för APL-produkter... 9 5.2.1 Avsedd användning... 9 5.3 Söktjänster... 10 5.3.1 Avsedd användning... 10 5.3.2 Om implementationen... 10 5.4 Anpassningar till VARA 3... 12 5.5 Kompletterande substansinformation... 13 5.5.1 Avsedd användning... 13 5.6 Kompletterande info om läkemedelsinstruktioner... 14 5.6.1 Avsedd användning... 14 5.7 Komplettering av interaktionsinformation... 15 5.7.1 Avsedd användning... 15 6. Nya API tjänster och typer... 16 6.1 Inledning... 16 6.1.1 Termerna typ och objekt... 16 6.1.2 Utgångna attribut... 16 6.1.3 Exempel på användning av API:et... 16 6.2 Parallellimporterade läkemedel (4.5)... 17 6.2.1 Förändrad typ: Drug... 17 6.3 Läkemedelsprodukter (4.6)... 18 Sid 2/46
6.3.1 Ny tjänst: searchdistributeddrugs... 18 6.3.2 Ny tjänst: searchunauthoriseddistributeddrugs... 20 6.3.3 Förändrad typ: DistributedDrug... 21 6.3.4 Ny typ: Link... 23 6.3.5 Ny typ: DistributedDrugMatch... 23 6.4 Läkemedelsartiklar (4.7)... 24 6.4.1 Ny tjänst: searchdrugarticles... 24 6.4.2 Ny tjänst: searchunauthoriseddrugarticles... 25 6.4.3 Förändrad typ: DrugArticle... 26 6.4.4 Ny typ: DrugArticleMatch... 26 6.5 Läkemedelsinstruktioner (4.11)... 27 6.5.1 Förändrad typ: DrugInstruction... 27 6.6 Interaktioner (4.14)... 29 6.6.1 Förändrad typ: DrugInteraction... 29 6.7 Ingredienser och substanser (4.19)... 30 6.7.1 Förändrad typ: Substance... 30 6.7.2 Ny typ: SubstanceCode... 32 6.7.3 Ny typ: SubstanceNamn... 32 6.8 Handelsvaror (4.23)... 32 6.8.1 Förändrad typ: NonDrugArticle... 32 6.10 Referensdatatjänster (4.26)... 33 6.10.1 Ny tjänst: getrxrepeatables... 33 6.10.2 Ny tjänst: getdispenserestrictions... 34 6.10.3 Ny tjänst: getrxrepeatablebycode... 36 6.10.4 Ny tjänst: getdispenserestrictionbycode... 36 6.10.5 Ny typ: RxRepeatable... 37 6.10.6 Ny typ: DispenseRestriction... 37 6.11 Ordinationsorsaker (Nytt!)... 38 6.11.1 Ny tjänst: getreasonforprescriptionbycode... 38 6.11.2 Ny tjänst: getreasonsforprescriptionbytext... 40 6.11.3 Ny tjänst: getreasonsforprescriptionbycategory... 41 6.11.4 Ny tjänst: getreasonforprescriptioncategoriesbycode... 42 6.11.5 Ny tjänst: getreasonforprescriptioncategoriesbytext... 44 6.11.6 Ny tjänst: getreasonsforprescriptionbynplid... 45 6.11.7 Ny typ: ReasonForPrescription... 46 Sid 3/46
6.11.8 Ny typ: ReasonForPrescriptionCategory... 46 6.11.9 Ny typ: TreatmentIntent... 46 Sid 4/46
1. Inledning 1.1 Allmänt Detta dokument beskriver nyheter och förändringar i Sil SOAP API 4.2 gentemot Sil SOAP API 4.1 som det ser ut vid denna prerelease. Det förutsätts att läsaren är bekant med hur Sil SOAP API fungerar och har läst dokumentationen för Sil SOAP API 4.1; "Tjänstegränssnittsbeskrivning - Sil SOAP API 4.1". Detta dokument beskriver Sil SOAP API 4.2 som det ser ut vid detta dokuments upprättande och är inte en slutgiltig beskrivning av Sil SOAP API 4.2. Det beskriver nyheter och förändringar i den kommande releasen av API:et, som det ser ut just nu, så att systemutvecklare och andra intresserade ska få en så konkret och tydlig bild som möjligt om vad de kan förvänta sig i den slutliga releasen av Sil SOAP API 4.2 den 28 september 2016. 1.2 Om dokumentationen Sil SOAP API är ett omfattande API och det är en utmaning dels att dokumentera det på ett sådant sätt att det är lätt att förstå och hitta i dokumentationen och dels att dokumentera ändringar i en ny release så att man snabbt kan få en överblick av vad som är nytt. Dokumentet Tjänstegränssnittsbeskrivning - Sil SOAP API 4.1 är indelat i kapitel baserat på en gruppering av API-tjänster och typer (populärt kallat objekt) utifrån den information de berör. I detta dokument har vi, för de nya API-tjänsterna och typerna, valt att följa den strukturen, i förhoppningen att det ska vara lättare för läsaren att få en överblick och orientera sig i förändringarna. Den övergripande beskrivningen av förändringarna från ett verksamhetsperspektiv beskrivs i separata underavsnitt i kapitlet Nyheter. Vi tar gärna emot kommentarer och synpunkter på hur vi kan förbättra dokumentationen för systemutvecklare och andra som läser denna dokumentation. 1.3 Sammanfattning av förändringar De förändringar som skett och som finns med i prerelease 2 av Sil SOAP API 4.2 (22 juni 2016) omfattar följande: a) Ordinationsorsaker (från den nya källan NKOO från Socialstyrelsen). b) Stöd för länkar till APL-produktresuméer (en ny källa från APL). c) Söktjänster för läkemedel. d) Anpassningar till förändringar i källan VARA. e) Kompletterande substansinformation (från källan NSL). f) Kompletterande information om läkemedelsinstruktioner (från källan eped). g) Komplettering av interaktionsinformation med läkemedelsform (från källan Sfinx). Sil SOAP API 4.2 innehåller 190 SOAP-tjänster och 94 SOAP-typer. Sil SOAP API 4.1 innehåller 176 SOAP-tjänster och 84 SOAP-typer. Dessutom har ytterligare 6 SOAP-typer ändrats genom att attribut har tillkommit i dem. Sid 5/46
2. Bakåtkompatibilitet Sil SOAP API 4.2 är tekniskt bakåtkompatibelt med SIL SOAP API 4.1. Med detta menas att ingenting som fanns i den tidigare versionen har tagits bort, utan skillnaderna handlar uteslutande om saker som lagts till och i några fall ett par attribut som är utgångna och inte bör användas längre. De senare attributen kommer att fortsätta ha giltiga värden men det finns nu andra bättre sätt att komma åt den information som de attributen förmedlar. Det kan i vissa bakåtkompatibla releaser även finnas förändringar i installations- och driftmiljön för Sil Server även om API:et är tekniskt bakåtkompatibelt. För Sil SOAP API 4.2 finns inte några sådana förändringar gentemot Sil SOAP API 4.1. Även om förändringarna är tekniskt bakåtkompatibla kan det behövas en mindre översyn av de system som använder API:et, speciellt om man använder teknik som inte hanterar wsdl:er dynamiskt. Detta gäller alltså även om man inte tänkt använda de nya tjänsterna, objekten eller attributen. Som del av översynen av system som anropar Sil SOAP API, rekommenderas man alltså att göra system- och/eller regressionstest i samband med uppgradering från att använda Sil SOAP API 4.1 till 4.2, även om man inte ändrat i sitt system för att använda de nya tjänsterna. 3. Driftmiljö Driftmiljön för Sil SOAP API 4.2 är densamma som för 4.1, alltså: Windows Server 2012 Microsoft SQL Server 2012 Java 8 och Tomcat 8. 4. Ansökan om tillgång till demoservrar I samband med prerelease 2 av Sil SOAP API 4.2 tillgängliggjordes en demoserver med Sil SOAP API 4.2 som är åtkomlig via Internet. För åtkomst till Sil:s demoservrar krävs att man har avtal och har fyllt i formell en ansökan om åtkomst till demoservrarna. För de som redan har avtal och godkända ansökningar om åtkomst till demoservrar med Sil SOAP API, krävs ingen ytterligare ansökan. För information om avtalen och hur man ansöker om åtkomst till demoservrar se: http:///tjanster--projekt/sil/inforandestod-sil/ OBS! I den demoserver som tillgängliggörs i prereleasen finns enbart kopplingar till ordinationsorsaker för läkemedelsprodukter som ligger i ATC-kodsgruppen C. Vidare saknas också data i vissa av de nya attribut som har att göra med nyheter i VARA eftersom det inte ännu finns komplett testdata från VARA. Sid 6/46
5. Nyheter 5.1 Ordinationsorsaker Nationell källa för ordinationsorsak (NKOO) har tagits fram av och kommer att underhållas av Socialstyrelsen 1. Den innehåller ordinationsorsaker och behandlingsändamål för alla godkända humanläkemedel i Sverige. En ordinationsorsak är en journalhandling som är avsedd att läsas av vårdpersonal medan ett angivet behandlingsändamål vänder sig till patient och farmaceut. Syftet med NKOO är i första hand att bidra till ökad patientsäkerhet genom att vårdpersonal på ett tydligt sätt ska veta varför en ordinatör satt in en viss läkemedelsbehandling och för att patienter ska få tydlig information om varför de tar ett visst läkemedel. I andra hand ska användning av en genomarbetad och konsistent terminologi även förbättra möjligheten till databaserad uppföljning av läkemedelsanvändning. Varje ordinationsorsak och varje behandlingsändamål i NKOO har en unik kod. Ordinationsorsaker tilldelas också unika Snomed CT koder. Ordinationsorsaker kan tilldelas en temporär kod i väntan på att registrering och publicering av en ny utgåva av Snomed CT görs. Ordinationsorsaker och behandlingsändamål utgår från de godkända läkemedelsprodukternas indikationstexter, och är kopplade till läkemedelsprodukter via deras NPL-id och baseras på respektive produkts indikationstext i dess produktresumé. Ordinationsorsakerna är organiserade i terminologisk hierarki med tre nivåer av ordinationsorsakskategorier. Varje ordinationsorsakskategori har en unik kod. En ordinationsorsak kan strukturellt ligga under en kategori på nivå 1, 2 eller 3 men i praktiken kommer alla ordinationsorsaker att ligga under en kategori på nivå 2 eller 3. Nedan visas en delmängd av hierarkin av ordinationsorsaker. Ordinationsorsakskategorier står i blått, ordinationsorsaker står i grönt och behandlingsändamål står i svart under den ordinationsorsak till vilken den hör. 01 Infektions- och parasitsjukdomar 01.01 Förebyggande av infektion 01.02 Hudinfektioner 01.03 Infektioner i andningsorganen 01.03.01 Bakteriella luftvägsinfektioner pulmonell antrax (code: 11389007) Mot mjältbrand (code: 0000000930) 1 Se: http://www.socialstyrelsen.se/nationellehalsa/snomed-ct/ordinationsorsak. I slutrapporten för 2015 finns en bilaga som beskriver riktlinjer för användning hur källan bör implementeras i vårdens system. Sid 7/46
akut bakteriell faryngit (code: 195658003) Mot halsinfektion (code: 0000000700) akut bakteriell bronkit (code: 233598009) Mot akut bronkit orsakad av bakterier (code: 0000000056) neonatal klamydiapneumoni (code: 233610007) Mot lunginflammation under nyföddhetsperioden (code: 0000000595) 01.03.02 Svampinfektioner i luftvägarna 01.03.03 Virusinfektioner i luftvägarna 01.03.04 Övriga infektioner 5.1.1 Avsedd användning Tjänsterna för ordinationsorsaker ska stödja en arbetsprocess i journalsystem och förskrivarstöd där ordinatören först väljer produkt att ordinera och sedan anger en ordinationsorsak och sedan ett behandlingsändamål. Den angivna ordinationsorsaken och behandlingsändamålet ska sparas i journalsystemet. Det angivna behandlingsändamålet ska skickas med i e-receptet. Systemen ska alltid erbjuda ordinatören möjlighet att ange ordinationsorsak som fritext. I de fallen bör fritexten även användas som behandlingsändamål. Se avsnitt X för en beskrivning av SOAP-tjänsterna och typerna som finns för att hämta information om ordinationsorsaker. Med tjänsterna kan man hämta ordinationsorsaker via deras kod eller via NPL-id för en läkemedelsprodukt. Man kan också göra fritextsökning baserat på innehållet i ordinationsorsakstexterna. Genom att använda tjänsten getreasonsforprescriptionbytext för fritextsökning så kan man t.ex. erbjuda stöd för automatisk komplettering av förslag till ordinationsorsak i ett inmatningsfält. Sid 8/46
5.2 Länkar till produktresuméer för APL-produkter APL är ett företag som producerar extemporeläkemedel. För extemporeläkemedel som tillverkas i större satser lagerberedningar beviljar Läkemedelsverket en rikslicens. APL skriver och publicerar produktresuméer för sina rikslicenser. Dessa granskas och godkänns av läkemedelsverket och tillgängliggörs av APL på en webbsajt. Varje produktresumé har en stabil URL som är unik för den berörda APL-produkten. 5.2.1 Avsedd användning I Sil kan man via ett nytt attribut i typen DistributedDrug få tag på URL:en till produktresumén för APL-produkter. Med hjälp av den kan journalsystem och förskrivarstöd dels presentera en länk, knapp eller menyval som användaren kan klicka på. Då kan systemet hämta och presentera produktresumén. Sid 9/46
5.3 Söktjänster Sil SOAP API har utökats med söktjänster för både godkända och icke-godkända läkemedelsprodukter och förpackningar. 5.3.1 Avsedd användning Söktjänsterna kan användas för att erbjuda fritextsökning i användargränssnitt, på olika attribut som hör till produkter, artiklar och substanser. Söktjänsterna är uppdelade i olika söktjänster för godkända respektive icke-godkända läkemedel. 5.3.2 Om implementationen Sil SOAP API använder Lucene 2 för att implementera informationssökningen i Sil-databasen som dessa tjänster erbjuder. Sökningen baseras på att alla DistributedDrug- och DrugArticleobjekt förindexeras på ett antal attributvärden. Man kan, med hjälp av dessa söktjänster, erbjuda enkla sökfält där man kan ange söksträngar som Alvedon 500mg eller Paracetamol tablett och snabbt kan visa användaren samtliga läkemedelsprodukter som matchar de söksträngarna. Indexerade attribut DistributedDrug-objekt indexeras på följande attributvärden: a) Handelsnamn b) NPL-id c) Beredningsform (tablett, etc.) d) Styrketext e) Substansnamn för alla ingredienser f) NPL-substansid för alla ingredienser g) ATC-kod h) ATC-text samt ATC-texter för alla ovanliggande ATC-nivåer till läkemedelsproduktens ATC-kod i) Produkttypkod (MEP, LIC etc.) DrugArticle-objekt indexeras på sammas attribut som ovan och dessutom även på följande attributvärden: j) NPL-packid k) Förpackningstext l) Förpackningsstorlek 2 Apache Lucene är ett open-source licenserat mjukvarubibliotek för informationssökning (information retrieval) som är skrivet i Java. Det har stöd för en mängd informationsökningstekniker för fulltextindexering och används ofta i, och tillsammans med, olika dokumentbaserade system och databassystem. URL: http://lucene.apache.org Sid 10/46
m) Varunummer Indexeringsteknik och sökstöd Förutom att indexeringen görs med hjälp av ovan nämnda attribut har en mängd andra beslut tagits avseende implementation av indexeringen och sökning. De sammanfattas kort här. Det förutsätts att läsaren har en grundläggande förståelse för informationssökning och etablerad terminologi inom det området. En del av de implementationsbeslut som tagits kommer att påverka slutanvändaren och det är lämpligt att man tydligt indikerar eller förklarar för slutanvändaren i enklare språk hur sökning fungerar. För tokenisering och stemming gäller: a) Lucenes standard tokeniserare samt filter används. Den splittar bl.a. termer och fixar unicode-tecken som copyrightsymbolen. Denna tokeniserare har vissa mindre begränsningar som gör att den kan komma att bytas ut i slutreleasen. b) En svensk snowball stemmer används. Den normaliserar böjningar på ord (tabletter == tablet), men bara om ursprungsordet är >= 5 tecken. Detta gör att "para" inte blir "par". c) Ett filter för att göra alla tecken till gemener används, så att ingen skillnad på gemener och versaler görs. För sökning gäller: a) Om en sökterm är >= 3 tecken tillämpas en implicit prefixsökning på de termerna. Det innebär t.ex. att para tolkas som para* och tab tolkas som tab*. b) Om en sökterm är >= 5 tecken och söktermen inte innehåller några siffror i sig tillämpas en implicit fuzzy-sökning med en edit distance på 1. Det sker ingen fuzzy-sökning på identitetsattribut och koder som t.ex. varunummer, ATC-koder etc. c) Om en söksträng innehåller två eller fler termer tillämpas implicit sökoperatorn AND. d) Om en söksträng är tom så matchas inget. e) Sökresultat sorteras alfabetiskt på objektets name -attribut. Sid 11/46
5.4 Anpassningar till VARA 3 Under 2016 kommer det ske förändringar i VARA och man byter datastruktur från VARA 2 till VARA 3. Det innebär förändringar och att nya attribut och SOAP-typer tillkommer för läkemedelsprodukter och artiklar. Förändringarna är: a) Läkemedelsprodukter har nu ett attribut som anger om läkemedel är under utökad övervakning. Detta ersätter den tidigare källan i Sil Nationell lista läkemedel under utökad övervakning som tillgängliggjordes i Sil SOAP API via en rekommendationslista för läkemedel under utökad övervakning. Nu ska man använda det nya attributet i stället och källan Nationell lista läkemedel under utökad övervakning kommer att tas bort i nästa version av Sil SOAP API (2017). I Sil 4.2 underhålls källan Nationell lista läkemedel under utökad övervakning men utan kommentarer för varje läkemedel. b) VARA 3 hanterar information om särskilda läkemedel och iterering i två separata attribut istället för som tidigare gemensamt i ett attribut. Det gemensamma attributet kommer att fortsätta uppdateras men man ska anpassa sina system att istället använda de två nya attributen då det gemensamma attributet kommer att tas bort i nästa release av Sil SOAP API (2017). Nyheterna är: a) Europeiskt godkännandenummer (eumano) finns nu angivet för både läkemedelsprodukter och artiklar. b) Läkemedelsprodukter har nu ett attribut som anger om de är klassificerade som antidot enligt GIC (Giftinformationscentralen). c) Läkemedelsprodukter har nu ett attribut som anger om de har restriktioner för utlämnande. d) Läkemedelsprodukter har nu ett attribut som anger om de är en godkänd rikslicens. e) Läkemedelsartiklar har nu två nya attribut som anger om artikeln endast får användas för dosdispensering och endast för sjukhusbruk. f) Läkemedelsartiklar och handelsvaror inom förmånen har nu information om apotekens inköpspris (aip) samt från- och tilldatum för när artiklar och handelsvaror ingår i förmånen (enligt TLV). Sid 12/46
5.5 Kompletterande substansinformation I Sil SOAP API 4.2 tillgängliggörs mer information från NSL (Nationellt Substansregister för Läkemedel) än tidigare. Detta innebär att man nu får tillgång till alternativa namn på svenska men också på engelska samt tillgång till diverse olika koder som finns associerade med varje substans som bl.a. ATC-koder. Läkemedelsverket har också kompletterat NSL med information om narkotikaklass för varje substans. Denna information finns nu också tillgänglig för varje substans i Sil SOAP API. I samband med översyn av substanstjänsterna har också ett nytt attribut links införts på Substance-typen. På sikt kan det användas för att tillhandahålla länkar till webbresurser som rör substanser. Samma attribut finns nu också på DistributedDrug- och DrugArticle-typerna vilket innebär att Sil också kan tillhandahålla länkar till webbresurser för läkemedelsprodukter och artiklar. I dagsläget finns dock inga planer att tillgängliggöra sådana webbresurser för substanser. 5.5.1 Avsedd användning Substanstjänsterna kan användas på flera olika sätt i journal- och beslutsstödsystem. Generellt erbjuder de möjlighet att implementera stöd för ett generiskt förhållningssätt vid ordination av läkemedel. Konkret innebär det att man bl.a. kan erbjuda stöd för sökning efter läkemedelsprodukter utifrån aktiv substans, men man kan också vid val av en läkemedelsprodukt kan visa namn på ingående aktiva substanser på ett bra sätt. Då Sil SOAP API också används som grundsystem i olika redaktionssystem för evidensbaserade kunskapskällor inom läkemedelsområdet, möjliggör substanstjänsterna att dessa redaktionssystem kan arbeta med substanser som utgångspunkt. I sådana system är det värdefullt att ha tillgång till ATC-koder och CAS-nummer för substanser. Sid 13/46
5.6 Kompletterande info om läkemedelsinstruktioner Sil SOAP API innehåller sedan 4.1 information om läkemedelsinstruktioner från eped. På sikt kan läkemedelsinstruktioner från andra källor tillkomma. Dataobjekten med information om läkemedelsinstruktioner har i 4.2 kompletterats med två attribut som beskriver de läkemedel som ska administreras enligt läkemedelsinstruktionen. Dessa attribut har att göra med om läkemedel har annan styrka och läkemedelsform än det som finns i de läkemedelsprodukter som läkemedel baseras på, eller om det tillkommer några nya substanser som inte finns i de läkemedelsprodukterna. 5.6.1 Avsedd användning Det är viktigt att uppmärksamma ordinatören eller personen som iordningsställer eller administrerar läkemedel på om det läkemedel man väljer i varusortimentet för ordination, iordningställandet eller administrering skiljer sig från det läkemedel man utgår ifrån i läkemedelsinstruktionen. Skillnaderna kan vara att läkemedel från varusortimentet har en annan styrka eller form än den man baserar sin ordination på eller att det innehåller flera substanser än utgångsläkemedel. I Sil SOAP API 4.2 får man nu följande information: a) Läkemedel i läkemedelsinstruktionen har annan styrka eller läkemedelsform än de läkemedelsprodukter det baseras på. b) Läkemedel innehåller andra substanser än de läkemedelsprodukter det baseras på. Denna information är viktig att presentera till ordinatören vid ordination samt till personer som iordningsställar eller administrerar läkemedel. Sid 14/46
5.7 Komplettering av interaktionsinformation Sil SOAP API har länge haft information om läkemedelsinteraktioner från interaktionsdatabasen Sfinx. Läkemedelsinteraktioner är beroende av sättet hur läkemedel administreras. Till exempel är det oftast ingen interaktion mellan två substanser när ett läkemedel tillförs topikalt (via huden). I interaktionskällan Sfinx har man alltid tagit hänsyn till administrering av läkemedel men den informationen har inte tillgängliggjorts i Sil SOAP API. Man har bara tagit hänsyn till administrering och läkemedelsform när informationen om interaktioner lagts in i Sfinx, men själva informationen visades aldrig. I Sil SOAP API 4.2 finns nu för varje interaktion mellan två substanser också information om vilken administrering som avses för varje substans. Vidare finns information om vilka ingående substanser som interagerar. 5.7.1 Avsedd användning Den nya informationen kan användas för att tydliggöra vilka substanser som kan ge upphov till en viss interaktion och att den interaktionen uppstår när produkterna administreras på ett visst sätt. Sid 15/46
6. Nya API tjänster och typer Alla siffror inom parentes i följande underkapitel hänvisar till motsvarande kapitel i Tjänstegränssnittsbeskrivningen för Sil SOAP API 4.1. 6.1 Inledning 6.1.1 Termerna typ och objekt I tjänstegränssnittsbeskrivningen av Sil SOAP API har under många år termen SOAP-objekt använts, lite slarvigt, både för att referera till de databärande typerna i WSDL-filen för SOAP API:et och till konkreta instanser av dessa typer. I detta dokument har vi valt att göra en distinktion och förtydliga användningen av dessa termer. Termen typ avser nu en namngiven databärande datatyp i WSDL-filen för SOAP API:et. Termen objekt används för att referera till en konkret instans av en sådan typ. 6.1.2 Utgångna attribut I vissa fall har attribut i några typer ersatts av andra attribut eller andra sätt att komma åt viss information. De ersatta attributen sägs då vara utgångna 3. Det innebär att de inte längre ska användas och att man snarast möjligt bör planera in för att anpassa sina system att inte använda de attributen mer, utan istället använda de nya attributen. Utgångna attribut markeras med röd text. 6.1.3 Exempel på användning av API:et I dokumentationen finns exempel på anrop av tjänster. Exemplen baseras på anrop av API:et med Python som beskrivs i avsnittet 3.3 Exempel i dokumentet "Tjänstegränssnittsbeskrivning - Sil SOAP API 4.1". 3 I tidigare tjänstegränssnittsbeskrivningar för Sil har den svengelska termen deprikerad använts för tjänster, typer och attribut som är utgångna. I fortsättningen kommer termen utgången att användas. Sid 16/46
6.2 Parallellimporterade läkemedel (4.5) På grund av förändringar i VARA har ett attribut i typen DistributedDrug markerats som utgånget och man ska istället använda nya attribut i typen DistributedDrug. 6.2.1 Förändrad typ: Drug Denna typ representerar den generella läkemedelsinformationen som är gemensam för alla parallellimporter för en läkemedelsprodukt. Denna typ finns redan med i Sil SOAP API 4.1. Ett attribut har markerats som utgångna enligt följande. OBS! Attributet nedan omfattar bara det berörda attributet i denna typ! Förändrade attribut drugclassificationcode: string Utgånget attribut som enbart finns kvar för att bibehålla bakåtkompabilitet. Kommer att tas bort i framtida version av Sil SOAP API och ska inte användas. Istället för detta attribut ska nu de nya attributen controlleddrugflag och rxrepeatablecode i typen DistributedDrug användas. Värdet på detta attribut kommer, fram till dess att det tas bort, att sättas baserat på värdena på de två ovan nämnda attributen. Här följer exempel på hur ett DistributedDrug-objekt kan se ut med de nya attributen. Exempel Anropet: getdistributeddrugbynplid ("20140926000136", False, -1) returnerar läkemedelsprodukten med NPL-id 20100709000050 (OBS! Bara en delmängd av attributen visas): (DistributedDrug){ } nplid = 20140926000136 strengthtext = 20 mg tradename = Methylphenidate Alternova controlleddrugflag = Y rxrepeatablecode = 004 Sid 17/46
6.3 Läkemedelsprodukter (4.6) Det har tillkommit två nya tjänster, searchdistributeddrugs och searchunauthoriseddistributeddrugs, och två nya typer, DistributedDrugMatch och Link. Dessutom har en typ ändrats; DistributedDrug. 6.3.1 Ny tjänst: searchdistributeddrugs Returnerar sökträffar på alla godkända läkemedelsprodukter som matchar den angivna söksträngen. Vid sökning kan man, med hjälp av parametern flgcurrent, avgränsa sig till enbart läkemedelsprodukter som har minst en läkemedelsartikel som är tillgänglig. Man kan också ange om man vill att sökningen ska generaliseras till en generisk sökning som ska returnera sökträffar för alla läkemedelsprodukter med samma ATC-kod som de läkemedelsprodukter som matchar söksträngen. Inparametrar query: string flgcurrent: boolean flggeneric: boolean Returtyp DistributedDrugMatch [] Exempel Anropet: Söksträngen. Anger att information om enbart läkemedelsprodukter som har minst en läkemedelsartikel som är tillgänglig (True), eller om alla (False), läkemedelsprodukter ska returneras. Anger att sökningen ska generaliseras till en generisk sökning som ska returnera sökträffar för alla läkemedelsprodukter med samma ATC-kod som de läkemedelsprodukter som matchar söksträngen. Lista med alla sökträffar. searchdistributeddrugs ("Alvedon 500mg", False, False) returnerar alla sökträffar som matchar söktexten Alvedon 500mg (7 stycken): [(DistributedDrugMatch){ nplid = "20100709000050" name = "Alvedon Novum, 500 mg, Filmdragerad tablett" }, (DistributedDrugMatch){ nplid = "20010323000094" name = "Alvedon Dos, 500 mg, Tablett" }, (DistributedDrugMatch){ }] Sid 18/46
Om man istället väljer att göra samma sökning men generaliserad till en generisk sökning (baserad på samma ATC-kod): searchdistributeddrugs ("Alvedon 500mg", False, True) returneras alla sökträffar som matchar söktexten Alvedon 500mg (31 stycken): [(DistributedDrugMatch){ nplid = "20100709000050" name = "Alvedon Novum, 500 mg, Filmdragerad tablett" }, (DistributedDrugMatch){ nplid = "20010323000094" name = "Alvedon Dos, 500 mg, Tablett" }, (DistributedDrugMatch){ }, (DistributedDrugMatch){ nplid = "20110818000063" name = "Therimin Honung & Citron, 500 mg, Pulver till oral lösning" }, (DistributedDrugMatch){ }] nplid = "20110818000056" name = "Therimin Skogsbär, 500 mg, Pulver till oral lösning" Notera att man då även får sökträffar på läkemedelsprodukter med andra handelsnamn men som har samma ATC-kod som de läkemedelsprodukter som matchar söksträngen Alvedon 500mg. Sid 19/46
6.3.2 Ny tjänst: searchunauthoriseddistributeddrugs Returnerar sökträffar på alla icke-godkända läkemedelsprodukter som matchar den angivna söksträngen. Vid sökning kan man, med hjälp av parametern flgcurrent, avgränsa sig till enbart läkemedelsprodukter som har minst en läkemedelsartikel som är tillgänglig. Man kan också ange om man vill att sökningen ska generaliseras till en generisk sökning som ska returnera sökträffar för alla läkemedelsprodukter med samma ATC-kod som de läkemedelsprodukter som matchar söksträngen. Inparametrar query: string flgcurrent: boolean silproducttypegroup: string flggeneric: boolean Returtyp DistributedDrugMatch [] Exempel Anropet: False) Söksträngen. Anger att information om enbart läkemedelsprodukter som har minst en läkemedelsartikel som är tillgänglig (True), eller om alla (False), läkemedelsprodukter ska returneras. Sil produkttypsgrupp. Giltiga värden är NON_APPROVED och TRADITIONAL. Anger att sökningen ska generaliseras till en generisk sökning som ska returnera sökträffar för alla läkemedelsprodukter med samma ATC-kod som de läkemedelsprodukter som matchar söksträngen. Lista med alla sökträffar. searchunauthoriseddistributeddrugs ("Vitamin A", False, "NON_APPROVED", returneras alla sökträffar som matchar söktexten Vitamin A (25 stycken): [(DistributedDrugMatch){ nplid = "20130603011036" name = "A 313, 50000 IE, Kapsel, hård" }, (DistributedDrugMatch){ nplid = "20130603020045" name = "A-Vitamin, 50000 IE, Tablett" }, (DistributedDrugMatch){ Sid 20/46
6.3.3 Förändrad typ: DistributedDrug Denna typ representerar en läkemedelsprodukt och finns redan med i Sil SOAP API 4.1. Den har kompletterats med attribut enligt följande. OBS! Attributen nedan omfattar bara de nya attributen i denna typ! Nya attribut eumano: string antidoteflag: string rxrepeatablecode: string controlleddrugflag: string nationallicenseflag: string Europeiskt godkännandenummer. Från EMA (Europeiska läkemedelsmyndigheten). Det är ett nummer om 11 eller 12 tecken med formatet: EU/1/YY/NNN alternativt EU/1/YY/NNNN där inledande EU/1/ betyder humanläkemedel och EU/2/ betyder veterinärläkemedel. I Sil finns dock bara information om humanläkemedel. Värde saknas om det inte är en godkänd produkt. Anger om produkten är klassad som en antidot av GIC (Giftinformationscentralen). Möjliga värden är Y (ja) och N (nej). Anger om produkten får förskrivas med upprepade uttag (iterering). Använd tjänsten getrxrepeatables för att se möjliga värden. Denna information finns redan angiven i attributet drugclassificationcode i typen Drug, men är där kombinerad med information om produkten är ett särskilt läkemedel. Denna information är nu separerad i två separata attribut som finns i DistributedDrug. Attributet drugclassificationcode i Drug ska inte längre användas. Anger om produkten är ett särskilt läkemedel enligt receptkungörelsens klassifikation av särskilda läkemedel. Möjliga värden är Y (ja) och N (nej). Denna information finns redan angiven i attributet drugclassificationcode i typen Drug, men är där kombinerad med information om produkten är ett särskilt läkemedel. Denna information är nu separerad i två separata attribut som finns i DistributedDrug och attributet drugclassificationcode i Drug ska inte längre användas. Anger om produkten är en godkänd rikslicens. Möjliga värden är Y (ja) och N (nej). Sid 21/46
additionalmonitoringflag: string dispenserestrictioncode: string atccode: string links: Link [] Anger om produkten är föremål för utökad övervakning enligt beslut av EMA (Europeiska läkemedelsmyndigheten) och Läkemedelsverket. Möjliga värden är Y (ja) och N (nej). Anger eventuella utlämnandebegränsningar som Läkemedelsverket bestämt. T.ex. ett läkemedel som innehåller isotretinoin får utlämnas från apotek endast om det har förordnats av en läkare med specialistkompetens i dermatologi. Använd tjänsten getdispenserestrictions för att se möjliga värden. Produktens ATC-kod. En lista med länkar till webbresurser som hör till denna läkemedelsprodukt. Idag stöds enbart länkar till produktblad för APL-produkter. Nedan följer ett exempel på anrop av tjänsten getdistributeddrugbynplid och hur svaret med attributet links kan se ut. Exempel Anropet: getdistributeddrugbynplid ("20030804000665", False, -1) returnerar ett DistributedDrug-objekt för läkemedelsprodukten med NPL-id = 20030804000665 som är en APL-produkt: (DistributedDrug){ } tradename = "Cyklopentolat-fenylefrin APL" links[] = (Link){ }, type = "spc_national_license" name = "APL Produktresumé rikslicens" url = "https://api.apl.se/produktdokument/20030804000665/spc" Sid 22/46
6.3.4 Ny typ: Link Denna typ representerar en länk till en webbresurs. Denna typ används för att ha information om länkar till webbresurser som berör läkemedelsprodukter, artiklar och substanser. Initialt är det enbart länkar till produktresuméer för APL-produkter som stöds. I framtiden kan det bli aktuellt med länkar till FASS-texter på www.fass.se och andra webbresurser. Attribut type: string name: string url: string 6.3.5 Ny typ: DistributedDrugMatch Anger vilken typ av resurs länken pekar på. För produktresuméer för APL-produkter är type = spc_national_license. Det är den enda typ som finns idag. I framtiden kan nya typer tillkomma. Namn på länken. För type = spc_national_license är name = APL Produktresumé rikslicens. URL till produktresumén. Denna typ representerar en sökträff på ett DistributedDrug-objekt. Attribut name: string nplid: string Ett namn som representerar en sökträff på ett DistributedDrug-objekt. Namnet består av handelsnamn följt av styrka och beredningsform. Det kan användas vid presentation av sökträffar. Läkemedelsproduktens NPL-id. Sid 23/46
6.4 Läkemedelsartiklar (4.7) Två nya tjänster har tillkommit; searchdrugarticles och searchunauthoriseddrugarticles, och en ny typ, DrugArticleMatch, för att erbjuda stöd för fritextsökning av läkemedelsartiklar. Det har också skett förändringar i en typ, DrugArticle. 6.4.1 Ny tjänst: searchdrugarticles Returnerar sökträffar på alla godkända läkemedelsartiklar som matchar den angivna söksträngen. Vid sökning kan man, med hjälp av parametern flgcurrent, avgränsa sig till enbart läkemedelsartiklar som är tillgängliga. Man kan också ange om man vill att sökningen ska generaliseras till en generisk sökning som ska returnera sökträffar för alla läkemedelsartiklar med samma ATC-kod som de läkemedelsartiklar som matchar söksträngen. Inparametrar query: string flgcurrent: boolean flggeneric: boolean Returtyp DrugArticleMatch [] Exempel Anropet: Söksträngen. Anger att information om enbart läkemedelsartiklar som är tillgängliga (True), eller inte (False), ska returneras. Anger att sökningen ska generaliseras till en generisk sökning som ska returnera sökträffar för alla läkemedelsartiklar med samma ATC-kod som de läkemedelsartiklar som matchar söksträngen. Lista med alla sökträffar. searchdrugarticles ("Alvedon 500mg", False, False) returnerar alla sökträffar som matchar söktexten Alvedon 500mg (23 stycken): [(DrugArticleMatch){ nplpackid = "20130116100050" name = "Alvedon Novum, 500 mg, Filmdragerad tablett, Blister, 20 tabletter (PP)" }, (DrugArticleMatch){ nplpackid = "20010323100367" name = "Alvedon Dos, 500 mg, Tablett, Plastburk, 300 tabletter (dosdispensering och sjukhusförpackning)" }, }] Sid 24/46
6.4.2 Ny tjänst: searchunauthoriseddrugarticles Returnerar sökträffar på alla icke-godkända läkemedelsartiklar som matchar den angivna söksträngen. Vid sökning kan man, med hjälp av parametern flgcurrent, avgränsa sig till enbart läkemedelsartiklar som är tillgängliga. Man kan också ange om man vill att sökningen ska generaliseras till en generisk sökning som ska returnera sökträffar för alla läkemedelsartiklar med samma ATC-kod som de läkemedelsartiklar som matchar söksträngen. Inparametrar query: string flgcurrent: boolean silproducttypegroup: string flggeneric: boolean Returtyp DrugArticleMatch [] Exempel Anropet: False) Söksträngen. Anger att information om enbart läkemedelsartiklar som är tillgängliga (True), eller inte (False), ska returneras. Sil produkttypsgrupp. Giltiga värden är NON_APPROVED och TRADITIONAL. Anger att sökningen ska generaliseras till en generisk sökning som ska returnera sökträffar för alla läkemedelsartiklar med samma ATC-kod som de läkemedels-artiklar som matchar söksträngen. Lista med alla sökträffar. searchunauthoriseddrugarticles ("Vitamin A", False, "NON_APPROVED", returnerar alla sökträffar som matchar söktexten Vitamin A (11 stycken): [(DrugArticleMatch){ nplpackid = "20130603103359" name = "A 313, 50000 IE, Kapsel, hård, Licensförpackning" }, (DrugArticleMatch){ }, }] nplpackid = "20130603112016" name = "A-Vitamin, 50000 IE, Tablett, Licensförpackning" Sid 25/46
6.4.3 Förändrad typ: DrugArticle Denna typ representerar en läkemedelsartikel och finns redan med i Sil SOAP API 4.1. Den har kompletterats med attribut enligt följande. OBS! Attributen nedan omfattar bara de nya attributen i denna typ samt ett attribut som kommer att få en ändrad typ i kommande release av Sil SOAP API (2017). Nya attribut aip: decimal aupfromdate: string auptodate: string aup: float eumano: string dosdisponlyflag: string hospitaluseonlyflag: string links: Link [] Apotekens inköpspris som satts av TLV. Datum från när aup och aip gäller. Sätts av TLV. Datum till när aup och aip gäller. Sätts av TLV. Förmånspris (apotekens utförsäljningspris) som satts av TLV. Detta attribut kommer att få en ändrad typ till decimal i nästa major release av Sil SOAP API. Europeiskt godkännandenummer. Från EMA (Europeiska läkemedelsmyndigheten). Det är ett nummer om 15 eller 16 tecken med formatet: EU/1/YY/NNN/NNN alternativt EU/1/YY/NNNN/NNN där inledande EU/1/ betyder humanläkemedel och EU/2/ betyder veterinärläkemedel. I Sil finns dock bara information om humanläkemedel. Anger om artikeln endast får användas för dosdispensering. Möjliga värden är Y (ja) och N (nej). Anger om artikeln endast får användas för sjukhusbruk. Möjliga värden är Y (ja) och N (nej). En lista med länkar till webbresurser som hör till denna läkemedelsartikel. Attributet aup har idag typen float. Det är olämpligt för attribut som har att göra med exakta decimaltal att göra, i detta fall ett pris. De ska ha en typ som kan representera decimaltal exakt, som decimal. 6.4.4 Ny typ: DrugArticleMatch Denna typ representerar en sökträff på ett DrugArticle-objekt. Attribut name: string nplpackid: string Ett namn som representerar en sökträff på ett DrugArticle-objekt. Namnet består av handelsnamn följt av styrka och beredningsform samt förpackningsform. Det kan användas vid presentation av sökträffar. Läkemedelsartikelns NPL-packid. Sid 26/46
6.5 Läkemedelsinstruktioner (4.11) 6.5.1 Förändrad typ: DrugInstruction Denna typ representerar en läkemedelsinstruktion och finns redan med i Sil SOAP API 4.1. Den har kompletterats med attribut enligt följande. OBS! Attributen nedan omfattar bara de nya attributen i denna typ! Nya attribut hasreformulated: string hasadditions: string strengthnumeric: decimal strengthnumericunit: string strengthtext: string drugformcode: string drugformtextsv: string Läkemedlet, som ska administreras enligt läkemedelsinstruktionen, skiljer sig från minst en av ursprungsprodukterna vad gäller styrka eller läkemedelsform. Möjliga värden är Y (ja), N (nej) och - (ospecificerad). Läkemedlet, som ska administreras enligt läkemedelsinstruktionen, har minst en tillsats av någon substans som inte finns i någon av ursprungsprodukterna. Möjliga värden är Y (ja), N (nej) och - (ospecificerad) Numerisk styrka på det läkemedel som ska administreras enligt läkemedelsinstruktionen. Detta värde saknas om det är ett kombinationspreparat eller om tillsatser finns. Om uppgift saknas står 0.0. Styrkeenhet på det läkemedel som ska administreras enligt läkemedelsinstruktionen. Detta värde är Ospecificerat om det är ett kombinationspreparat eller om tillsatser finns eller om uppgift saknas. Styrka och enhet i klartext på det läkemedel som ska administreras enligt läkemedelsinstruktionen. Detta värde saknas om det är ett kombinationspreparat eller om tillsatser finns eller om uppgift saknas. Läkemedelsform för läkemedlet som ska administreras enligt läkemedelsinstruktionen. Detta värde är - om uppgift saknas. Läkemedelsform på svenska för läkemedlet som ska administreras enligt läkemedelsinstruktionen. Detta värde är Ospecificerat om uppgift saknas. Sid 27/46
Här följer exempel på hur ett DrugInstruction-objekt kan se ut med de nya attributen. Exempel Anropet: getdruginstructionsbydruginstructionid ("eped", "3163", "1.1") returnerar ett DrugInstruction-objekt för läkemedelsinstruktionen med id:t 3163 och version 1.1 : (DrugInstruction){ } druginstructionid = 3163 version = 1.1 source = eped url = http://eped.sll.sjunet.org/eped/3163_1.1.pdf title = Amfotericin B intravenös inf 1 mg/ml (AmBisome) created = 2015-10-27T15:09:46 modified = 2016-05-26T17:29:28 nplids[] = [ 19920110000012, 20110408000084, 20120111000066, SB050901000001 ] hasreformulated = Y hasadditions = N strengthnumeric = 1 strengthnumericunit = mg/ml strengthtext = 1 mg/ml drugformcode = EMUINF drugformtextsv = Infusionsvätska, emulsion I exemplet ovan kan man se att det läkemedel som ska iordningställas enligt den angivna läkemedelsinstruktionen skiljer sig från minst en av ursprungsprodukterna i läkemedelsform och/eller styrka (hasreformulated = Y ) men att det inte har några tillsatser ( hasadditions = N ). Det är viktigt att den som ska skapa eller redigera en ordinationsmall, eller den som ska ordinera, baserat på denna läkemedelsinstruktion (via en ordinationsmall) uppmärksammas på detta. Sid 28/46
6.6 Interaktioner (4.14) 6.6.1 Förändrad typ: DrugInteraction Denna typ representerar en läkemedelsinteraktion och finns redan med i Sil SOAP API 4.1. Den har kompletterats med attribut enligt följande. OBS! Attributen nedan omfattar bara de nya attributen i denna typ! Nya attribut administration1: string administration2: string name1: string name2: string Det administreringssätt som den ena interagerande substansen, name1, ska administreras på för att denna interaktion ska ske. Det administreringssätt som den andra interagerande substansen, name2, ska administreras på för att denna interaktion ska ske. Namn på den ena interagerande substansen eller livsmedlet. Namn på den andra interagerande substansen eller livsmedlet. Här följer exempel på hur ett DrugInteraction-objekt kan se ut med de nya attributen. Exempel Anropet: getdruginteractionsbydrugidagainstall ("20070512000014", "-") returnerar en lista med DrugInteraction-objekt för alla interaktioner som finns med läkemedlet med drugid 20070512000014 : [(DrugInteraction){ }, docclassification = 4 drugids[] = "20070512000014", "20141008000020", interactionid = 178 sevclassification = "D" administration1 = "Enteral or Parenteral" administration2 = "Enteral or Parenteral" name1 = "epirubicin" name2 = "cimetidin" Sid 29/46
6.7 Ingredienser och substanser (4.19) Det har tillkommit kompletterande information om koder och namn på substanser. 6.7.1 Förändrad typ: Substance Denna typ representerar en läkemedelssubstans och finns redan med i Sil SOAP API 4.1. Den har kompletterats med attribut enligt följande. OBS! Attributen nedan omfattar bara de nya attributen i denna typ! Nya attribut substancenameen: string narcoticclasscode: string codes: substancecode [] names: substancename [] links: Link [] casno: string Rekommenderat engelskt namn enligt NSL. Narkotikaklass enligt Läkemedelsverkets klassificering. Substanskoder för denna substans i olika kodsystem. Alternativa substansnamn. En lista med länkar till webbresurser som hör till denna läkemedelssubstans. Utgånget attribut som enbart finns kvar för att bibehålla bakåtkompabilitet. Kommer att tas bort i framtida version av Sil SOAP API och ska inte användas. CAS-no för substansen kan nu hämtas som en av koderna i listan codes. Värdet på detta attribut kommer, fram till dess att det tas bort, att sättas baserat värdet på CAS-no i den listan. Nedan följer ett exempel på anrop av tjänsten getsubstance och hur svaret med ovan nämnda attribut kan se ut. Exempel Anropet: getsubstancesbysubstancename ("ivermektin") returnerar ett Substance-objekt för substansen med namnet ivermektin : (Substance){ nplsubstanceid = IDE4POFCUAWB7VERT1 substancename = "ivermektin" substancenameen = ivermectin narcoticclasscode = 0 codes[] = [ (SubstanceCode){ code = D11AX22 Sid 30/46
system = ATC status = Current }, (SubstanceCode){ code = P02CF01 system = ATC status = Current }, (SubstanceCode){ code = 70288-86-7 system = CAS status = Current }, ] names[] = [ (SubstanceName){ name = ivermectin type = Official Name lang = eng }, (SubstanceName){ name = ivermektin type = Official Name lang = swe } ] links[] = None } Sid 31/46
6.7.2 Ny typ: SubstanceCode Denna typ representerar en substanskod. Attribut code: string system: string status: string En kod som identifierar en substans. Det kodsystem som koden tillhör. Den status koden. Giltiga värden på status beror på kodsystemet. Olika kodsystem har olika sätt och termer för att uttrycka status. 6.7.3 Ny typ: SubstanceNamn Denna typ representerar ett substansnamn. Attribut name: string type: string lang: string Ett substansnamn. Typ av namn. Språk för namnet. 6.8 Handelsvaror (4.23) 6.8.1 Förändrad typ: NonDrugArticle Denna typ representerar en handelsvara inom förmånen och finns redan med i Sil SOAP API 4.1. Den har kompletterats med attribut enligt följande. OBS! Attributen nedan omfattar bara de nya attributen i denna typ samt ett attribut som kommer att få en ändrad typ i kommande release av Sil SOAP API (2017). Nya attribut aip: decimal aupfromdate: string auptodate: string aup: float Apotekens inköpspris som satts av TLV. Datum från när aup och aip gäller. Sätts av TLV. Datum till när aup och aip gäller. Sätts av TLV. Förmånspris (apotekens utförsäljningspris) som satts av TLV. Detta attribut kommer att få en ändrad typ till decimal i nästa major release av Sil SOAP API. Attributet aup har idag typen float. Det är olämpligt för attribut som har att göra med exakta decimaltal att göra, i detta fall ett pris. De ska ha en typ som kan representera decimaltal exakt, som decimal. Sid 32/46
6.10 Referensdatatjänster (4.26) Det har tillkommit fyra nya tjänster och två nya typer för att erbjuda information om upprepade uttag och utlämnandebegränsningar för läkemedelsprodukter. 6.10.1 Ny tjänst: getrxrepeatables Inparametrar [Inga] Returtyp RxRepeatableCode [] Exempel Anropet: getrxrepeatables () returnerar alla koder som finns. De är: [(RxRepeatable){ code = "001" texten = None textsv = "Recept får itereras" }, (RxRepeatable){ code = "002" texten = None textsv = "Recept får inte itereras" }, (RxRepeatable){ code = "003" texten = None textsv = "Recept för humant bruk får itereras" }, (RxRepeatable){ code = "004" texten = None Lista med alla koder för upprepade uttag (iterering). textsv = "Recept får itereras endast om receptet är elektroniskt eller i pappersformat som förvaras på öppenvårdsapotek" }, (RxRepeatable){ }] code = "-" texten = "Unspecified" textsv = "Ospecificerad" Sid 33/46
6.10.2 Ny tjänst: getdispenserestrictions Inparametrar [Inga] Returtyp DispenseRestriction [] Exempel Anropet: getdispenserestrictions () returnerar alla utlämnandebegränsningar som finns. De är: [(DispenseRestriction){ code = "D01" texten = None Lista med alla koder för utlämnandebegränsningar. textsv = "Får endast utlämnas för behandling av ADHD hos barn och ungdomar om förskriven av läkare med specialistkompetens i barn/ungdomspsykiatri, psykiatri, rättspsykiatri, barn/ungdomsneurologi med habilitering eller läkare med dispens från LV. LVFS 2002:7" }, (DispenseRestriction){ code = "D02" texten = None textsv = "Får utlämnas för behandling av opiatberoende endast om förordnad av läkare med spec.komp. i psykiatri verksam vid sjukvårdsinr. inom beroendevård där läkemedelsass. underhållsbeh. ges eller läkare med delegation vid samma inrättning enligt LVFS 2004:15" }, (DispenseRestriction){ code = "D03" texten = None textsv = "Får utlämnas endast om det har förordnats av läkare med specialistkompetens i dermatologi eller av läkare med dispens från Läkemedelsverket. LVFS 2013:9" }, (DispenseRestriction){ code = "D04" texten = None textsv = "Får utlämnas endast om det förordnats av läkare som är behörig att utföra abort samt endast till klinik där läkaren är verksam. Läkemedlet får inte utlämnas till enskild patient efter ordination på recept. LVFS 1992:4" }, (DispenseRestriction){ code = "-" Sid 34/46
texten = "Unspecified" textsv = "Ospecificerad" }] Sid 35/46
6.10.3 Ny tjänst: getrxrepeatablebycode Inparametrar code: string Returtyp RxRepeatableCode Exempel Anropet: getrxrepeatablebycode ("004") returnerar koden 004 : (RxRepeatable){ code = 004 texten = Kod. Kod för upprepade uttag (iterering). textsv = Recept får itereras endast om receptet är elektroniskt eller i pappersformat som förvaras på öppenvårdsapotek } 6.10.4 Ny tjänst: getdispenserestrictionbycode Inparametrar code: string Returtyp DispenseRestriction Exempel Anropet: Kod. getdispenserestrictionbycode ( D02 ) returnerar koden D02 : (DispenseRestriction){ code = D02 texten = Kod för utlämnandebegränsning. textsv = Får utlämnas för behandling av opiatberoende endast om förordnad av läkare med spec.komp. i psykiatri verksam vid sjukvårdsinr. inom beroendevård där läkemedelsass. underhållsbeh. ges eller läkare med delegation vid samma inrättning enligt LVFS 2004:15 } Sid 36/46
6.10.5 Ny typ: RxRepeatable Denna typ representerar en kod för att ange om en läkemedelsprodukt får förskrivas med upprepade uttag (iterering). Attribut code: string textsv: string texten: string 6.10.6 Ny typ: DispenseRestriction Kod. Använd tjänsten getrxrepeatables för att få reda på giltiga koder. Textsträng på svenska. Textsträng på engelska. Denna typ representerar en kod för att ange om det finns utlämnandebegränsningar för en läkemedelsprodukt. Attribut code: string textsv: string texten: string Kod. Använd tjänsten getdispenserestrictions för att få reda på giltiga koder. Textsträng på svenska. Textsträng på engelska. Sid 37/46
6.11 Ordinationsorsaker (Nytt!) Det har tillkommit X nya tjänster och Y nya typer för att stödja åtkomst till information om ordinationsorsaker och behandlingsändamål. 6.11.1 Ny tjänst: getreasonforprescriptionbycode Returnerar ordinationsorsaken med angiven ordinationsorsakskod. Om inget NPL-id anges returneras ett ReasonForPrescription-objekt med samtliga treamentintent-objekt som finns kopplade till den ordinationsorsaken. Om ett giltigt NPL-id anges, returneras endast de treatmentintent-objekt som är kopplade till just den ordinationsorsaken och den angivna läkemedelsprodukten. Om ett ogiltigt NPL-id anges eller om ett giltigt NPL-id anges för en läkemedelsprodukt som saknar ordinationsorsaker, returneras inget ReasonForPrescriptionobjekt (null). Inparametrar code: string nplid: string Returtyp ReasonForPrescription Exempel Anropet: Snomed-kod eller temporär kod från Socialstyrelsen för en ordinationsorsak. NPL-id för den läkemedelsprodukt för vilken ordinationsorsaken hör. Ordinationsorsak. getreasonforprescriptionbycode ("39579001, None) returnerar ordinationsorsaken med Snomed CT kod 39579001 tillsammans med alla behandlingsändamål för alla läkemedelsprodukter som är kopplade till den ordinationsorsaken: (ReasonForPrescription){ } code = "39579001" text = "anafylaktisk reaktion" treatmentintents[] = (TreatmentIntent){ }, code = "0000000421" text = "Adrenalin för injektion vid allvarlig akut allergisk reaktion" (TreatmentIntent){ }, code = "0000001309" text = "Kortisonbehandling mot allvarlig akut allergisk reaktion" Sid 38/46