Kanta Liittymisohje Kanta-asiakastestipalveluun

Kanta-asiakastestipalvelu 1 (20) Kanta Liittymisohje Kanta-asiakastestipalveluun

Kanta-asiakastestipalvelu 2 (20) Dokumentin muutoshistoria Versio Pvm Tekijä / hyväksyjä Kuvaus 1.0 3.9.2009 KanTa-palveluryhmä, Kela 1.1 25.2.2010 KanTa-palveluryhmä, Kela 1.2 17.6.2010 KanTa-palveluryhmä, Kela 1.3 24.6.2010 KanTa-palveluryhmä, Kela 1.4 3.2.2011 KanTa-palveluryhmä, Kela 1.5 16.2.2011 VRK Tarkennuksia 1.6 19.3.2012 KanTa-palveluryhmä, Kela 1.7 18.12.2014 Kanta-palvelut-yksikkö, Kela 1.8 17.4.2015 Kanta-palvelut-yksikkö, Kela 1.9 Kanta-palvelut-yksikkkö,Kela Liittymishakemuksen tietoja tarkennettu. Lisätty earkiston palvelupyyntökoodiston tunniste sekä viittaus THL:n OID-oppaaseen. Lisätty uusimispyyntöjen vastaanottopalvelun portti 443. Terveydenhuollon varmentajan tehtävät siirtyivät Valviralta VRK:lle. Liitynpisteen määritelmää on tarkennettu. Päivitetty earkiston osuuksia ja vanhentuneet kohdat Päivitetty ulkoasu ja termit. Muokattu Potilastiedon arkisto -palvelun liittymisen edellytyksiä, luku 3.2. Lisätty yksityisen terveydenhuollon testiorganisaatioihin liittyviä täsmennyksiä, luvut 6 ja 9. Lisätty sosiaalihuollon asiakastiedon arkiston osuuksia ja päivitetty muita tietoja

Kanta-asiakastestipalvelu 3 (20) Sisällys 1 Yleistä... 4 2 Palvelun yleiskuvaus... 4 3 Liittymisen edellytykset... 5 4 Tietoliikenneyhteys... 6 5 Liittymishakemus Kelaan... 7 6 Testiaineistot... 11 7 OID-tunnusten muodostaminen... 12 7.1 Organisaation OID-tunnus (THL-SOTE-organisaatiorekisteri)... 12 7.2 Itsenäinen ammatinharjoittaja... 12 7.3 Kanta-liityntäpisteen OID-tunnus... 12 7.4 Arkistonmuodostajan ja rekisterinpitäjän OID-tunnus (vain julkinen terveydenhuolto)... 13 8 Testikortit... 14 9 Testipalvelinvarmenteet... 15 10 Testijärjestelmäallekirjoitusvarmenteet Potilastiedon arkisto- ja Sosiaalihuollon asiakastiedon arkisto -palveluissa... 16 11 Varmenteiden käyttö... 17 11.1 TLS-yhteyden muodostaminen... 17 11.2 VRK:n varmennemääritykset... 17 12 Kanta-palvelujen WSDL-kuvaukset järjestelmätoimittajille... 18 13 Kanta-palvelujen osoitteet ja sanomaliikenteen osapuolitunnisteet... 18 14 Tukipalvelut... 19 15 Teknisten palvelulokien katselu Resepti-palvelussa... 20

Kanta-asiakastestipalvelu 4 (20) 1 Yleistä Tämä ohje on tarkoitettu järjestelmätoimittajille, jotka ovat toteuttamassa järjestelmiinsä liityntää valtakunnalliseen Reseptikeskukseen, Potilastiedon arkistoon tai Sosiaalihuollon asiakastiedon arkistoon. Lisäksi ohje on suunnattu näiden järjestelmätoimittajien asiakasorganisaatioille, jotka liittyvät palveluun omista testiympäristöistään. Kela voi tarvittaessa rajoittaa asiakastestipalvelun käyttäjien määrää. Asiakas tarkoittaa tässä ohjeessa asiakastestipalveluun liittyvää organisaatioita. 2 Palvelun yleiskuvaus Kanta-asiakastestipalvelu sisältää Resepti-, Potilastiedon arkisto- ja Sosiaalihuollon asiakastiedon arkisto -palvelut. Palveluihin liitytään erillisillä hakemuksilla tämän ohjeen mukaisesti. Resepti-palvelussa asiakas voi testata potilastieto- tai apteekkijärjestelmänsä sähköisen reseptin toteutusta Kelan ylläpitämää Reseptikeskusta vasten. Potilastiedon arkisto -palvelussa asiakas voi testata potilastietojärjestelmänsä sähköisten potilastietojen arkistoinnin toteutusta Kelan Potilastiedon arkistoa ja tiedonhallintapalvelua vasten. Potilastiedon arkisto -palveluun liittymisen yhteydessä asiakkaalle tarjotaan mahdollisuutta liittyä Kelan ylläpitämään Omakanta-palvelun asiakastestiversioon, sekä mahdollisuutta hyödyntää testauksessa arkistonhoitajan käyttöliittymää. Sosiaalihuollon asiakastiedon arkisto -palvelussa asiakas voi testata sosiaalihuollon sähköisten asiakastietojen arkistoinnin toteutusta Kelan Sosiaalihuollon asiakastiedon arkistoa vasten. Tuotantokäytön käynnistyttyä Resepti-, Potilastiedon arkisto- ja Sosiaalihuollon asiakastiedon arkisto -palveluissa ylläpidetään tuotantoversiota seuraavaa kehitysversiota.

Kanta-asiakastestipalvelu 5 (20) 3 Liittymisen edellytykset Resepti-, Potilastiedon arkisto- ja Sosiaalihuollon asiakastiedon arkisto palveluihin liittyminen edellyttää, että asiakas on toteuttamassa Kantaan integroitavaa järjestelmää palvelukohtaiset voimassa olevat määritykset huomioiden. Vaatimusten määrittelemä toiminnallisuus pitää testata järjestelmätoimittajan omissa testeissä, ennen kuin järjestelmä voidaan hyväksyä Kelan koordinoimaan yhteistestaukseen.

Kanta-asiakastestipalvelu 6 (20) 4 Tietoliikenneyhteys Kanta-asiakastestipalveluun liitytään joko internetin tai suljetun asiakasverkon, esim. MPLS, kautta. Liittymän hankkiminen on asiakkaan vastuulla. Suljetun asiakasverkon yhteyden käyttämisestä on sovittava yhdessä asiakkaan tietoliikenneoperaattorin ja Kelan kanssa. Kanta-palvelujen tuotantoympäristöön liitytään yleensä suljetun asiakasverkon kautta. Testipalveluihin voi liittyä myös tavallisen internetliittymän kautta. Liittymän IP-osoitteen tulee olla kiinteä ja julkinen.

Kanta-asiakastestipalvelu 7 (20) 5 Liittymishakemus Kelaan Hakemuslomake Kanta-asiakastestipalveluun on ladattavissa osoitteesta http://www.kanta.fi/fi/web/ammattilaisille/testaus. Hakemuslomake on palvelukohtainen. Täytetty hakemuslomake lähetetään Kelaan osoitteeseen liittyminen@kanta.fi. Sähköpostin aiheeksi kirjoitetaan Kanta-asiakastestipalveluun/Sähköiseen reseptiin liittyminen" tai "Kanta-asiakastestipalveluun/Potilastiedon arkistoon liittyminen" tai Kanta-asiakastestipalveluun/Sosiaalihuollon asiakastiedon arkistoon liittyminen. Kela ilmoittaa hakemuksen hyväksymisestä sähköpostitse ja avaa yhteydet Kantaasiakastestipalveluun kolmen viikon kuluessa hakemuksen saapumisesta. Hakemuslomakkeella ilmoitetaan seuraavat palvelukohtaiset tiedot: Sähköinen resepti organisaation OID (ks. kappale 7) organisaation nimi organisaation tyyppi (apteekkijärjestelmätoimittaja, potilastietojärjestelmätoimittaja, apteekki, terveydenhuollon toimintayksikkö) postiosoite katuosoite postitoimipaikka postinumero sähköpostiosoite (organisaation asiointiosoite, johon tieto hakemuksen käsittelystä lähetetään) hallinnollinen yhteyshenkilö, esim. projektipäällikkö (rooli, nimi, puhelinnumero ja sähköpostiosoite) tekniset yhteyshenkilöt, esim. tekninen projektipäällikkö tai tietoliikenneasiantuntija (rooli, nimi, puhelinnumero ja sähköpostiosoite) apteekki- tai potilastietojärjestelmän nimi tieto siitä, vastaanottaako organisaatio sähköisen lääkemääräyksen uusimispyyntöjä (K/E) liityntäpiste (ks. kappale 7), josta organisaatio käyttää Resepti-palvelua o liityntäpisteen OID o liityntäpisteen DNS-nimi tai IP-osoite o tietoliikenneliittymän tyyppi (internet tai suljettu asiakasverkko) o uusimispyynnön vastaanottopalvelun URL-osoite * (jos uusimispyynnöt vastaanotetaan tämän liityntäpisteen kautta) liityntäpiste, johon organisaatio vastaanottaa uusimispyynnöt, jos uusimispyyntöjen vastaanottoa varten on erillinen liityntäpiste o liityntäpisteen OID o liityntäpisteen DNS-nimi tai IP-osoite o tietoliikenneliittymän tyyppi (internet tai suljettu asiakasverkko) o uusimispyynnön vastaanottopalvelun URL-osoite *

Kanta-asiakastestipalvelu 8 (20) liityntäpiste, josta organisaatio käyttää Valviran rajoitus- ja attribuuttikyselypalvelua o liityntäpisteen OID o liityntäpisteen DNS-nimi tai IP-osoite o tietoliikenneliittymän tyyppi (internet tai suljettu asiakasverkko) liityntäpiste, josta organisaatio tutkii teknisiä palvelulokeja (lokipalvelu on sallittu ainoastaan järjestelmätoimittajille) o liityntäpisteen OID o liityntäpisteen DNS-nimi tai IP-osoite o tietoliikenneliittymän tyyppi (internet tai suljettu asiakasverkko) *) Huomaa, että uusimispyyntöjen vastaanottopalvelun pitää sijaita https-portissa 443. Potilastiedon arkisto, julkisen ja yksityisen terveydenhuollon testiorganisaatioiden yhteiset tiedot: organisaation OID (THL-SOTE-organisaatiorekisterin toimintayksikkötason OID tai itsenäisen ammatinharjoittajan OID, ks. kappale 7) organisaation nimi organisaation tyyppi (potilastietojärjestelmän toimittaja tai terveydenhuollon toimintayksikkö) postiosoite katuosoite postinumero postitoimipaikka sähköpostiosoite (organisaation asiointiosoite, johon tieto hakemuksen käsittelystä lähetetään) hallinnollinen yhteyshenkilö, esim. projektipäällikkö (rooli, nimi, puhelinnumero, sähköpostiosoite) tekniset yhteyshenkilöt, esim. tekninen projektipäällikkö tai tietoliikenneasiantuntija (rooli, nimi, puhelinnumero, sähköpostiosoite) potilastietojärjestelmän nimi liityntäpiste (ks. kappale 7), josta organisaatio käyttää arkistopalvelua o liityntäpisteen OID o liityntäpisteen DNS-nimi tai IP-osoite o tietoliikenneliittymän tyyppi (internet tai suljettu asiakasverkko) liityntäpiste (ks. kappale 7), josta organisaatio käyttää Valviran rajoitus- ja attribuuttikyselypalvelua o liityntäpisteen OID o liityntäpisteen DNS-nimi tai IP-osoite o tietoliikenneliittymän tyyppi (internet tai suljettu asiakasverkko) IP-osoite, josta organisaatio käyttää Omakanta-palvelua

Kanta-asiakastestipalvelu 9 (20) Potilastiedon arkisto, vain julkisen terveydenhuollon testiorganisaatioista ilmoitettavat tiedot: arkistonmuodostajan OID (ks. kappale 7) arkistonmuodostajan nimi rekisterinpitäjän OID (ks. kappale 7) rekisterinpitäjän nimi sairaanhoitopiiri, johon testiorganisaatio liitetään (tunnus ja nimi) liityntäpiste (ks. kappale 9), josta organisaatio käyttää alueellista yhteisrekisteriä o liityntäpisteen OID o liityntäpisteen DNS-nimi tai IP-osoite o tietoliikenneliittymän tyyppi (internet tai suljettu asiakasverkko) Potilastiedon arkisto, vain yksityisen terveydenhuollon testiorganisaatioista ilmoitettavat tiedot: liittyykö organisaatio suoraan tai toimiiko yhteisliittymismallin isäntäroolissa (organisaatioon kytketään liityntäpiste) toimiiko vain yhteisliittymismallin vuokralaisroolissa (organisaatio käyttää isännän liityntäpistettä) Liityttäessä Potilastiedon arkisto -palveluun, organisaatio voi hakea liittymistä seuraaviin palveluihin: Potilastiedon arkisto -palvelu, sisältää tiedonhallintapalvelun alueellinen yhteisrekisteri (julkinen terveydenhuolto) Omakanta-palvelu Sosiaalihuollon asiakastiedon arkisto organisaation OID (ks. kappale 7) organisaation nimi organisaation tyyppi (sosiaalihuollon asiakastietojärjestelmätoimittaja tai sosiaalihuollon palvelunjärjestäjä) postiosoite katuosoite postitoimipaikka postinumero sähköpostiosoite (organisaation asiointiosoite, johon tieto hakemuksen käsittelystä lähetetään) hallinnollinen yhteyshenkilö, esim. projektipäällikkö (nimi, puhelinnumero ja sähköpostiosoite) tekniset yhteyshenkilöt, esim. tekninen projektipäällikkö tai tietoliikenneasiantuntija (nimi, puhelinnumero ja sähköpostiosoite) asiakastietojärjestelmän nimi liityntäpiste (ks. kappale 7), josta organisaatio käyttää arkistopalvelua o liityntäpisteen OID

Kanta-asiakastestipalvelu 10 (20) o o liityntäpisteen DNS-nimi tai IP-osoite tietoliikenneliittymän tyyppi (internet tai suljettu asiakasverkko) Kela hallinnoi asiakastestiympäristöön liittyneen organisaation käyttöoikeuksia myöntämällä palvelukohtaisia käyttöoikeuksia. Esimerkiksi alueellinen yhteisrekisteri mahdollistaa informointi- ja kieltoasiakirjojen arkistoinnin vain Kelan ylläpitämään rekisteriin.

Kanta-asiakastestipalvelu 11 (20) 6 Testiaineistot Kela lähettää asiakkaalle liittymishakemuksen hyväksymisilmoituksen yhteydessä sähköpostitse tietyn määrän testihenkilötunnuksia. Osa näistä tunnuksista on yhteiskäytössä muiden asiakastestipalveluun liittyneiden kanssa. Asiakkaalla on lupa käyttää Kanta-asiakastestipalvelussa ainoastaan Kelasta saamiaan henkilötunnuksia.

Kanta-asiakastestipalvelu 12 (20) 7 OID-tunnusten muodostaminen Organisaation ja sen liityntäpisteen OID-tunnusten muodostamisessa noudatetaan suositusta "JHS 159 ISO OID -yksilöintitunnuksen soveltaminen julkishallinnossa" sekä Terveyden ja hyvinvoinnin laitoksen (THL) opasta "ISO OID -yksilöintitunnuksen käytön kansalliset periaatteet sosiaali- ja terveysalalla". 7.1 Organisaation OID-tunnus (THL-SOTE-organisaatiorekisteri) Organisaatio voi käyttää testauksessa kuvitteellista Y-tunnuksesta muodostettua OID-tunnusta, jos sillä ei ole terveydenhuollon palvelunantajan OID-tunnusta. Tunnus lisätään hakemuksessa annetuilla tiedoilla Kanta-asiakastestiympäristön koodistoon. Y-tunnukseen pohjautuva OID on muotoa 1.2.246.10.<y-tunnus>.10.0. Y-tunnuksesta jätetään alkunollat ja väliviiva pois, esim. jos organisaation y-tunnus on 0411270-8, sen OID on 1.2.246.10.4112708.10.0. Organisaation toimipaikat yksilöidään y- tunnuksen alle solmuluokkaan 10. Koko yritys tai organisaatio saa tunnuksen 0. 7.2 Itsenäinen ammatinharjoittaja Organisaatio voi käyttää testauksessa kuvitteellista itsenäisen ammatinharjoittajan OID-tunnusta, joka perustuu esimerkiksi Terhikki-tunnusta vastaavaan testikortin yksilöintitunnukseen. Terhikki-tunnukseen perustuva OID on muotoa 1.2.246.537.28.<yksilöintitunnus>. 7.3 Kanta-liityntäpisteen OID-tunnus Kanta-liityntäpisteellä tarkoitetaan pistettä, josta organisaation tietojärjestelmä liittyy Kanta-palveluihin sosiaali- ja terveydenhuollon varmentajan palvelinvarmenteella salattua ja tunnistettua tietoliikenneyhteyttä pitkin. Kanta-liityntäpisteeseen on asennettu VRK:n myöntämä palvelinvarmenne. Kanta-liityntäpisteelle annetaan yksilöivä OID-tunnus. Sitä käytetään myös liityntäpisteeseen asennettavan palvelinvarmenteen yksilöivänä tunnuksena (palvelinvarmenteen Subject-osion serialnumber-kenttä). Tunnus muodostetaan liityntäpisteen toteuttamisesta vastaavan organisaation tai organisaatioyksikön OID-tunnuksen alle solmuun 13. Jos organisaatiolla tai organisaatioyksiköllä on useita liityntäpisteitä, ne numeroidaan juoksevasti 0:sta alkaen. Liityntäpiste voi olla asiakkaan omassa hallinnassa tai se voi olla ulkoistettu toisen organisaation hallintaan. Liityntäpiste on ulkoistettu, jos asiakas on ulkoistanut konesalinsa tai liittyy Kanta-palveluihin viestinvälityspalvelua tarjoavan organisaation kautta. Ulkoistetun liityntäpisteen OID-tunnus muodostetaan liityntäpistettä hallinnoivan organisaation tai sen toimipaikan juuren alle solmuun 13.

Kanta-asiakastestipalvelu 13 (20) Organisaation liityntäpisteen OID-tunnus noudattaa todennäköisesti jotakin seuraavista muodoista: 1.2.246.10.[organisaation y-tunnus].13.[0] 1.2.246.10.[organisaation y-tunnus].10.[organisaatioyksikön tunnus].13.[0] 1.2.246.10.[kunnan y-tunnus].10.[terveyskeskuksen tunnus].13.[0] 1.2.246.553.1.[apteekin numero].13.[0] 7.4 Arkistonmuodostajan ja rekisterinpitäjän OID-tunnus (vain julkinen terveydenhuolto) Arkistonmuodostajalle annetaan OID-tunnus solmuluokkaan 19 seuraavalle vapaalle numerolle juoksevasti siten, että se ei koskaan kuitenkaan ole 0 (1.2.246.10.[Ytunnuksesta johdettu].19.x). '0' on varattu ainoastaan rekisterinpitäjille jäljempänä esitetyn mukaisesti. Rekisterinpitäjän/toimintayksikön solmuluokka on 19. Kun rekisterinpitäjänä on koko yritys tai yhteisö, rekisterinpitäjä saa tunnuksen 0. Muut rekisterinpitäjät yksilöidään juoksevasti 1:stä alkaen. Rekisterinpito perustuu lakiin ja mahdollisesti sen lisäksi hallinnollisiin päätöksiin, joiden mukaisesti yksilöintitunnukset on annettava. Kerran annettua tunnusta ei voida ottaa uudelleen käyttöön.

Kanta-asiakastestipalvelu 14 (20) 8 Testikortit Testivarmennekortit tilataan Väestörekisterikeskukselta (VRK). Tarkempi ohjeistus ja testikorttien tilauslomakkeet ovat saatavilla VRK:n varmennepalvelut -sivustolta osoitteesta https://eevertti.vrk.fi/varmenteen-hankinta. Terveydenhuollon testikortteja on saatavissa kolmea tyyppiä: 1. terveydenhuollon ammattikortti (esim. lääkärille, sairaanhoitajalle ja farmaseutille) 2. terveydenhuollon henkilöstökortti (terveydenhuollon organisaatiossa työskentelevälle henkilölle, jolla ei ole terveydenhuollon ammattioikeutta, esim. sihteerille) 3. terveydenhuollon toimijakortti (henkilölle, joka ei työskentele terveydenhuollon organisaatiossa mutta jonka pitää työnsä takia kirjautua järjestelmään, esim. IT-palvelutoimittajalle). Kaikki testikortit sisältävät kuvitteelliset tiedot. Tilaaja merkitsee tilauslomakkeelle, montako kappaletta kutakin ennalta määriteltyä korttia hän haluaa tilata.

Kanta-asiakastestipalvelu 15 (20) 9 Testipalvelinvarmenteet Testivarmennekorttien lisäksi asiakkaan pitää hankkia VRK:sta palvelinvarmenne. Tätä varmennetta tarvitaan, jotta voidaan muodostaa TLS-yhteys asiakkaan palvelimen ja Kanta-palvelimien välille. Sosiaali- ja terveydenhuollon testipalvelinvarmenteen hankintaohje ja hakemuslomake ovat saatavilla VRK:n varmennepalvelut -sivustolta osoitteesta https://eevertti.vrk.fi/varmenteen-hankinta. PKCS#10-muotoinen varmennepyyntö muodostetaan palvelinvalmistajan ohjeistuksen mukaisesti sillä palvelimella, johon varmenne asennetaan. Varmennepyynnössä tulee olla seuraavat tiedot: Subject o cn = palvelimen julkinen IP-osoite tai DNS-nimi o serialnumber = organisaation liityntäpisteen OID (solmu 13, ks. kappale 9) o ou = organisaatioyksikkö (ei pakollinen) o o = organisaation nimi o c = FI o subjectaltname = sähköpostiosoite (ei pakollinen) Huom. Varmennepyynnössä annettujen organisaatiotietojen ja tietoliikenneosoitteen (IP-osoite tai DNS-nimi) tulee olla samoja kuin Kanta-palvelujen liittymishakemuksessa annettujen vastaavien tietojen.

Kanta-asiakastestipalvelu 16 (20) 10 Testijärjestelmäallekirjoitusvarmenteet Potilastiedon arkisto- ja Sosiaalihuollon asiakastiedon arkisto -palveluissa Potilastiedon- ja Sosiaalihuollon asiakastiedon arkistoon liityttäessä tarvitaan myös testijärjestelmäallekirjoitusvarmenne. Tällä varmenteella järjestelmä allekirjoittaa asiakirjoja sähköisesti. Sosiaali- ja terveydenhuollon järjestelmäallekirjoitusvarmenteen hakemuslomake ja hankintaohje ovat saatavilla VRK:n varmennepalvelut -sivustolta osoitteesta https://eevertti.vrk.fi/varmenteen-hankinta. PKCS#10-muotoinen varmennepyyntö muodostetaan palvelinvalmistajan ohjeistuksen mukaisesti sillä palvelimella, johon varmenne asennetaan. Varmennepyynnössä tulee olla seuraavat tiedot: Subject o cn = järjestelmän tyyppi o serialnumber = organisaation OID (solmu 10) o ou = organisaatioyksikkö (ei pakollinen) o o = organisaation nimi o c = FI o subjectaltname = sähköpostiosoite (ei pakollinen)

Kanta-asiakastestipalvelu 17 (20) 11 Varmenteiden käyttö Kanta-palvelujen varmentajan tehtävät siirtyivät 1.12.2010 Valviralta Väestörekisterikeskukselle (VRK). Kanta-palvelut luottaa ainoastaan VRK:n terveydenhuollon CAvarmenteisiin. Jos asiakassovellus hakee Kanta-palveluista vanhoja asiakirjoja, joihin on tehty järjestelmäallekirjoitus Valviran varmenteella, asiakassovelluksen tulee edelleen luottaa myös Valviran varmenteisiin, mikäli sovellus tarkistaa haettavien asiakirjojen allekirjoituksia. Allekirjoituksen tarkistaminen asiakirjahakujen yhteydessä ei ole yleensä suositeltavaa, koska Kanta-palvelut tarkistavat tallennettavien asiakirjojen allekirjoitukset arkistointivaiheessa. 11.1 TLS-yhteyden muodostaminen TLS-yhteyden muodostamista varten asiakkaan pitää 1. asentaa omalle palvelimelleen VRK:n (VRK TEST CA for Social Welfare and Health Care Service Providers) myöntämä testipalvelinvarmenne. 2. määritellä luotto (trusted CA) VRK:n (VRK TEST CA for Social Welfare and Health Care Service Providers) myöntämiin palvelinvarmenteisiin. Huom. luottamusta ei tule määritellä pelkästään Root CA:n tasolle, koska Root CA:n alla on muitakin kuin pelkästään terveydenhuollon Intermediate CA:ita. 3. TLS-kättelyssä asiakkaan pitää lähettää Kanta-palveluille sekä oma testipalvelinvarmenteensa että sen varmentajan varmentajavarmenne (CAvarmenne). 11.2 VRK:n varmennemääritykset VRK:n varmennepolitiikka ja tekniset määritykset löytyvät osoitteesta https://eevertti.vrk.fi/cps.

Kanta-asiakastestipalvelu 18 (20) 12 Kanta-palvelujen WSDL-kuvaukset järjestelmätoimittajille Palvelujen WSDL-rajapintakuvaukset järjestelmätoimittaja saa Kelalta sähköpostitse, sen jälkeen kun Kela on käsitellyt ja hyväksynyt järjestelmätoimittajan liittymishakemuksen. Paketissa on seuraavat palvelukohtaiset WSDL-tiedostot: Sähköinen resepti RCMR_AR000003_Yhteiset.wsdl RCMR_AR000003_Potilaskertomus.wsdl RCMR_AR000003_Apteekki.wsdl RCMR_AR000001_Reseptikeskus.wsdl. Reseptikeskus.wsdl sisältää palvelut, jotka sähköisen lääkemääräyksen uusimispyyntöjä vastaanottavan järjestelmän pitää toteuttaa. Potilastiedon arkisto RCMR_AR000003_Arkisto.wsdl Sosiaalihuollon asiakastiedon arkisto RCMR_AR00003_Sosiaalihuolto.wsdl 13 Kanta-palvelujen osoitteet ja sanomaliikenteen osapuolitunnisteet Kanta-asiakastestipalvelun URL-osoitteet ja sanomaliikenteen osapuolitunnisteet asiakas saa Kelalta sähköpostitse liittymishakemuksen hyväksymisilmoituksen yhteydessä.

Kanta-asiakastestipalvelu 19 (20) 14 Tukipalvelut Määrittelykysymykset ja asiakastestiympäristön käyttöön liittyvät ongelmat ilmoitetaan kantakehitys@kanta.fi sähköpostilaatikkoon. Asiakastestiympäristöön liittymiseen liittyvät asiat puolestaan lähetetään osoitteella liittyminen@kanta.fi ja Kanta-palveluihin liittyvät muut asiat osoitteeseen kanta@kanta.fi. Yhteistestausta koskevat tiedustelut ja kysymykset lähetetään osoitteella yhteistestaus@kanta.fi. Potilastiedon arkiston toiminnallisia määrittelyitä koskevat kysymykset lähetetään osoitteeseen kantapalvelut@thl.fi. Sosiaalihuollon asiakastiedon arkiston toiminnallisia määrittelyitä koskevat kysymykset lähetetään osoitteeseen sostiedonhallinta@thl.fi. Viestit tulee otsikoida seuraavasti: Sähköisen reseptin, Potilastiedon arkiston tai Sosiaalihuollon asiakastiedon arkiston vaatimusmäärittelykysymykset otsikolla Sähköisen reseptin/potilastiedon arkiston/sosiaalihuollon asiakastiedon arkisto määrittely + kysyttävän asian aihe esim. Potilastiedon arkiston määrittely, asiakirjan korvaus Sähköisen reseptin, Potilastiedon arkisto tai Sosiaalihuollon asiakastiedon arkiston testausasiat otsikolla Sähköisen reseptin/potilastiedon arkiston/sosiaalihuollon asiakastiedon arkisto + ohjelmiston nimi + asia esim. Sähköisen reseptin yhteistestaus, Mediatri, testiketjut aloitettu Kerro virheilmoituksessa seuraavat tiedot: virheen havaitsemisajankohta käyttötapaus tai palvelupyyntö, johon virhe liittyy virheen kuvaus Kanta-palvelujen mahdollisesti palauttama virheilmoitus organisaatio ja järjestelmä, jossa virhe on havaittu liitetiedostona lähetetty SOAP-sanoma ja mikäli mahdollista myös HTTPheader Väestörekisterikeskuksen myöntämiä asiakastestipalvelun testivarmenteita koskevat virheilmoitukset lähetetään sähköpostitse osoitteeseen vptuotanto@vrk.fi.

Kanta-asiakastestipalvelu 20 (20) 15 Teknisten palvelulokien katselu Resepti-palvelussa Potilastieto- ja apteekkijärjestelmätoimittajat voivat itse tutkia Kanta-asiakastestipalvelun sähköisen reseptin teknisiä palvelulokeja. Lokien katselusovelluksen osoitteen asiakas saa sähköpostitse liittymishakemuksen hyväksymisilmoituksen yhteydessä. Lokirivien hakuehdoksi on kirjoitettava sanoman täydellinen OID eli sanoman idelementin root- ja extension-attribuuttien yhdistetty arvo. Jokaisessa lokirivissä on mukana sanoman tunniste, jonka avulla kyseiseen sanomaan liittyviä muita rivejä voi hakea. Tekniset palvelulokit poistuvat automaattisesti lokitiedoston koon ylittäessä säädetyn raja-arvon. Myöhempää tarkastelua tai ongelmanselvitystä varten tarpeelliset lokirivit kannattaa ottaa talteen.