Inledning

Planerat releasedatum för SIL 3.0 är 29 Mars 2012.

Här nedan beskrivs de viktigare förändringarna i SIL-API 3.0 gentemot SIL-API 2.9.

Nyheter i SIL-API 3.0 är:

1. Stöd för att komma åt information om licensläkemedel och naturläkemedel. Denna information är åtskild från information om godkända läkemedel. Det är viktigt att systemintegratörer tar hänsyn till regler och riktlinjer för förskrivning av olika typer av läkemedel i sina system.
2. Utökad doseringsinformation som nu omfattar administrationssätt, administrationsväg och patientinformation.
3. Stöd för sökning av läkemedelsinformation baserat på substanser.
4. Utökat stöd för förmånsinformation inklusive periodens vara.
5. Ett mindre register med utsättningsorsaker. Utsättningsorsaker kan användas i journalsystem för att erbjuda läkare möjlighet att välja bland fördefinierade utsättningsorsaker.

SIL-API 3.0 är inte tekniskt bakåtkompatibelt med SIL-API 2.9. De tekniska förändringarna omfattar:

1. En del tjänster (SOAP messages) och en del objekt (SOAP complex types) har tagits bort. Många av dessa tjänster var tidigare utpekade som utgående tjänster och objekt i SIL-API 2.9.
2. En del tjänster har fått lite ändrad semantik (dvs. de beter sig lite annorlunda än i SIL 2.9). Detta är för att kunna särskilja godkända läkemedel från licensläkemedel och naturläkemedel på ett bra sätt.
3. En del nya tjänster och objekt har tillkommit.

Då SIL-API 3.0 erbjuder tjänster för att komma åt information om nya läkemedelsprodukttyper har en gruppering av läkemedelsprodukttyper införts. Denna gruppering styr vilken information som returneras av en del tjänster i SIL-API. Produkttypsgrupperna är:

• APPROVED. Omfattar produkttyperna MEP, ALL, VBL, RAP, NLM, VUM och NIN.
• NON_APPROVED. Omfattar produktyperna APL och LIC.
• TRADITIONAL. Omfattar produkttypen TVB.

Tjänsterna för läkemedel som ingår i gruppen APPROVED fungerar som tidigare i SIL 2.9. Nya tjänster har tillkommit för läkemedel i grupperna NON_APPROVED och TRADITIONAL.

OBS! Då diskussioner fortfarande pågår med Läkemedelsverket och Apotekens Service AB om hur olika läkemedelsprodukttyper bör hanteras kan det ske förändringar i grupperingarna tom. releasen av SIL 3.0.

Tjänster med förändrad semantik

Följande tjänster returnerar nu enbart information om läkemedel i gruppen APPROVED.

• getAtcCodeDrugsByAtcCodeList
• getDrugsByAtcCode
• getDrugsByDistributedDrugTradeName
• getDistributedDrugsByDistributedDrugTradeName
• getDrugArticlesByDistributedDrugTradeName
• getSuperDrugsByDistributedDrugTradeName
• getSuperDrugsByAtcCodeList
• getSuperDrugsByAtcTextSv

Nya tjänster

Följande tjänst ger information om giltiga grupper:

• getSILProductTypeGroups ()

Följande tjänster ger information om läkemedel i grupperna NON_APPROVED och TRADITIONAL.

• getUnauthorisedSuperDrugsByDistributedDrugTradeName (… , silProductTypeGroup ) Kommentar: Giltiga värden på silProductTypeGroup: "NON_APPROVED" och "HERBAL".
• getUnauthorisedSuperDrugsByAtcCodeList (… , silProductTypeGroup ) Kommentar: Giltiga värden på silProductTypeGroup: "NON_APPROVED" och "HERBAL".
• getUnauthorisedSuperDrugsByAtcTextSv (… , silProductTypeGroup ) Kommentar: Giltiga värden på silProductTypeGroup: "NON_APPROVED" och "HERBAL".

Följande nya tjänst ger utökad information om förmåner och periodens vara.

• getTlvExchangesByNplPackIdList (String[] nplPackIds) returnerar en lista med TlvExchange-objekt som var och en i sin tur innehåller en lista med ExchangePeriod-objekt.

TlvExchange-objekt har följande format:

String[14] nplPackId
ExchangePeriod[] exchangePeriods

ExchangePeriod-objekt har följande format:

String[10] startDate
String[10] stopDate
String[1]  periodicArticleFlag
String[10] periodicArticleStartDate
String[1]  orderStoppedFlag
String[10] orderStoppedStartDate

Följande tjänster möjliggör sökning efter läkemedel baserat på aktiv substans.

• getDistributedDrugsByNplSubstanceId (String nplSubstanceId) returnerar en lista med DistributedDrug-objekt.
• getDistributedDrugsBySubstanceName (String substanceName) returnerar en lista med DistributedDrug-objekt.
• getUnauthorisedDistributedDrugsBySubstanceName (…, String silProductTypeGroup) returnerar en en lista med DistributedDrug-objekt.

Följande tjänst returnerar en lista med föreslagna utsättningsorsaker.

• getTreatmentWithdrawalReasons () returnerar en lista med TreatmentWithdrawalReason-objekt.

TreatmentWithdrawalReason-objekt har följande format:

String shortText
String longText

Bortagna tjänster

• getFormIdsByNplIdList Kommentar: formid fanns i NPL och motsvarade specid i JACA. Det finns inte tillgängligt via VARA.
• getArticleIdsByNplPackIdList Kommentar: articleid fanns i JACA och finns inte tillgängliga via någon annan källa.
• getNoneDrugArticleArticleNosBySpecIdList Kommentar: specid fanns i JACA och finns inte tillgängliga via någon annan källa.
• getNoneDrugArticleSpecIdsByArticleNoList Kommentar: specid fanns i JACA och finns inte tillgängliga via någon annan källa.
• getRecommendedListsByRegionId Kommentar: Ersatt av getRecommendListsByRegionId.
• getRecommendedLists Kommentar: Ersatt av getRecommendListsByRegionId.
• getRecommendationsByNplPackIdListRegionId Kommentar: Ersatt av getRecommendsByNplPackIdListRegionIdListTypes.
• getRecommendationsByTherapyGroupIndicationNameRegionId Kommentar: Ersatt av getRecommendsByTherapyGroupIndicationNameRegionIdListTypes.
• getDistDrugContentsByNplIdList Kommentar: Ersatt av modifierad getDistributedDrugContentsByNplIdList.
• getNoneDrugArticleComplementsByArticleNoList Kommentar: Fält i NoneDrugArticleComplements har flyttats till NoneDrugArticle.

Förändrade objekt

• DistributedDrugContent- och Ingredient-objektens decimal typer returnerar float istället.
• NoneDrugArticle-objekt får två nya fält. isPrescriptionRequired och isDiscounted som tidigare fanns i NoneDrugArticleComplement-objektet.
• DrugArticle-objektets fält LfnPriceAupExclMoms, NplPriceAupInclMoms, NplPriceAupPrescription, outOfStock är borttagna.

Bortagna objekt

• NoneDrugArticleSpecId Kommentar: specid fanns i JACA och finns inte tillgängliga via någon annan källa.
• RecommendedList Kommentar: Berörd tjänst är borttagen.
• Recommendation Kommentar: Berörd tjänst är borttagen.
• Indication Kommentar: Berörd tjänst är borttagen.
• DistDrugContent-objekt Kommentar: Berörd tjänst är borttagen.
• Ingred-objekt Kommentar: Berörd tjänst är borttagen.
• NoneDrugArticleComplement-objekt Kommentar: Berörd tjänst är borttagen.

Övrigt

Alla fältlängder för rena textattribut i objekten kommer att tas bort. Ett exempel på detta är ATCCode-objekt:

Den tidigare längdbegränsningen för attributet ‘textSv’ på 300 tecken har tagits bort, då det inte finns någon specificerad längd på den beskrivande svenska texten för ATC-koder. Däremot har fältet ‘atcCode’ behållt längdbegränsningen på 8 tecken då ATC-koder enligt specifikationen maximalt kan vara 8 tecken.