Yhteistestauksen prosessi

Yhteistestausprosessi jakautuu tietojärjestelmätoimittajan omatoimisen testauksen vaiheeseen ja yhteistestausvaiheeseen.

Ennen yhteistestausta

Varmista, että tietojärjestelmä vastaa kansallisia vaatimuksia. Tietojärjestelmän tulee perustua kansallisten säädösten ja THL:n määräysten mukaisiin olennaisiin vaatimuksiin ja tietojärjestelmäprofiileihin.

Tietojärjestelmien kehittämistä ohjaavat kansallisesti

Kanta-palvelujen julkaisuaikataulu sisältää toiminnallisuuksien kehittämisen aikataulut sekä sosiaali- ja terveydenhuollon käyttöönottojen takarajat. Julkaisuaikataulussa näkyy myös yhteistestauksen valmiuden aikataulut.

Tutustu myös palvelukohtaisiin yhteistestausten sisältöihin.

Liity asiakastestipalveluun tekemällä liittymishakemus kyseiseen Kanta-palveluun. Liittyminen edellyttää tietojärjestelmää, joka vastaa haettavan palvelun käyttötapauksia ja vaatimuksia.

Kannan asiakastestipalveluun liitytään aina järjestelmätoimittajan omasta testiympäristöstä. Hakemukset käsitellään kolmen viikon kuluessa.

Asiakastestipalvelun käyttämiseen tarvitaan sosiaali- ja terveydenhuollon testiammattikortteja (dvv.fi)  ja varmenteita (dvv.fi) (palvelin- ja järjestelmäallekirjoitusvarmenteet). Ne tilataan Digi- ja väestötietovirastosta.

Omatietovarannon asiakastestiympäristöön liittyminen ja yhteistestaukseen ilmoittautuminen tehdään samanaikaisesti liittymishakemuksella. Sitä ennen sovelluskehittäjät suorittavat omatoimista testausta sandbox-ympäristössä. Lisätietoa sandbox-ympäristöstä.

Tarkempia ohjeita löydät liittymishakemusten Ohje-välilehdeltä:

Kanta-asiakastestiympäristöistä löydät tietoa Testiympäristöt-sivulta.

Testaa kattavasti Kanta-asiakastestipalvelun asiakastestiympäristössä kaikki määritellyt toiminnallisuudet ja varmista, että tietojärjestelmä vastaa määrittelyiden mukaisia vaatimuksia.

Validoi Kantaan tallennettavia asiakirjoja validointipalvelussa.

Tarvittavat käyttöoikeudet kannattaa hakea hyvissä ajoin. Kanta-yhteistestauksen asiantuntijat kertovat, tarvitsetko käyttöoikeudet Testain-palveluun, Kumppanit-työtilaan vai molempiin. Yhteistestauksen uusi Testain-palvelu otetaan käyttöön vaiheittain keväästä 2025 alkaen, ja rinnalla säilyy toistaiseksi yhteistestauksen Kumppanit-työtila.

Yhteistestauksen Testain-palvelu

Testain on yhteistestauksen läpivientiä helpottava palvelu. Testain otetaan käyttöön vaiheittain keväästä 2025 alkaen.

Kanta-yhteistestauksen Testain-palvelu sujuvoittaa yhteistestausten läpiviemistä sekä helpottaa tietojärjestelmätoimittajan tilannekuvan seurantaa ja käynnissä olevan yhteistestauksen aikaista viestintää. Testaimeen siirretään yhteistestauksia vaiheittain. Tarkempaa tietoa löytyy Testain -sivulta.

Testaimeen kirjaudutaan suomi.fi-tunnisteilla. Tietojärjestelmätoimittajan pitää itse valtuuttaa palvelun käyttäjät. Suomi.fi-tunnisteista saa lisätietoa Digi- ja väestötietovirastosta. 

Yhteistestauksen Kumppanit-työtila

Jokaisella järjestelmätoimittajalla on oma Kanta-palvelukohtainen Kumppanit-työtila (SharePoint), jonne pääsevät vain kyseisen järjestelmätoimittajan edustajat ja heidän asiakasorganisaatioidensa edustajat. Käyttöoikeudet varmistetaan yhteistestauksen alkaessa.

Siirtymävaiheessa Kumppanit-työtila toimii Testaimen rinnalla järjestelmätoimittajan, sen asiakasorganisaation ja Kanta-palveluiden viestintäkanavana. Myös testitapaukset raportoidaan Kumppanit-työtilaan niin kauan kunnes kyseinen testauskokonaisuus on siirretty Testaimeen.

Kanta-palvelut tallentaa järjestelmäkohtaiseen Kumppanit-työtilaan yhteistestaukseen liittyviä dokumentteja, kuten:

  • ilmoittautumislomakkeet
  • yhteistestauksessa käytettävät testihenkilötunnukset
  • yhteistestauksen testitapaukset
  • tarkastushavainnot
  • Potilastietovarantoon tallennettavien lausuntojen ja todistusten tyylitiedostoja. 

Kumppanit-työtilat:

Testaa tietojärjestelmääsi Kanta-palveluja vasten ensin tekemällä esitestit. Esitestitapauksilla varmistetaan, että tietojärjestelmä on valmis yhteistestaukseen.

Esitestitapaukset tehdään Kanta-määrittelyjen mukaisella toteutuksella. 

Jos merkittäviä virheitä ei löydy, siirrytään järjestelmätoimittajan ja Kelan väliseen testaukseen. Esitestitapaukset on kerrottu kunkin yhteistestauksen ilmoittautumislomakkeessa.

Yhteistestauksen esitestit siirtyvät vaiheittain Testain-palveluun eikä erillistä ilmoittautumislomaketta enää täytetä niiden testien osalta, jotka ovat Testaimessa.

Raportoi kyseiselle testaussisällölle ennalta määritellyt esitestitapaukset, jotka löytyvät ilmoittautumislomakkeelta tai lähetetään pyydettäessä Kelasta. Mikäli järjestelmän käyttötarkoitus niin vaatii, Kela voi tarvittaessa räätälöidä ilmoittautumislomakkeen esitestitapausten sisältöä ja laajuutta. Esitestitapausten määrä vaihtelee yhteistestattavan sisällön mukaan.

Yhteistestauksen aikana

Ilmoittaudu kyseisen Kanta-palvelun sisällön yhteistestaukseen. Mikäli esitestitapaukset on raportoitu Testain-palvelussa, yhteistestaukseen ilmoittautuminenkin tapahtuu Testaimessa.

Tarkempaa tietoa löydät Ilmoittaudu yhteistestaukseen-sivulta. 

Ilmoittautumisen yhteydessä Kelaan pitää toimittaa THL:n järjestelmälomake (THL:n Määräys 5/2024, liite 4). Muista merkitä huolellisesti järjestelmän käyttötarkoituksen mukaiset tietojärjestelmäprofiilit (THL:n määräys 5/2024) ja järjestelmän käyttötarkoitus. Lisäksi Kela voi tarvittaessa pyytää arkkitehtuurikuvausta. 

Järjestelmälomake on keskeinen dokumentti Kanta-palveluiden yhteistestaukselle, sillä sen (ja järjestelmälomakkeella ilmoitettujen tietojärjestelmäprofiilien) avulla määritellään tietojärjestelmältä edellytettävien yhteistestausten sisältö ja laajuus.

Kela voi tarvittaessa räätälöidä yhteistestauksen sisältöä ja laajuutta esimerkiksi tietojärjestelmän käyttötarkoituksen perusteella. Testitapausten määrä vaihtelee yhteistestattavan sisällön mukaan.

Kela tarkastaa esitestitapaukset ja mikäli niissä havaitaan korjattavaa, tietojärjestelmätoimittaja korjaa puutteet ja raportoi kyseiset esitestit uudelleen.

Kun esitestitapauksissa ei ole enää korjattavaa, yhteistestauksen asiantuntija antaa varsinaiset testitapaukset suoritettavaksi. Tarvittaessa Kela järjestää erillisen yhteistestauksen aloituspalaverin.

Suorita varsinaiset testitapaukset yhteistestauksen asiantuntijalta saamasi ohjeistuksen mukaan.

Tietojärjestelmätoimittajan ja Kelan välisessä testauksessa tarkastellaan Kanta-palveluihin liitettävän tietojärjestelmän tai hyvinvointisovelluksen ja Kanta-palvelujen välistä toimintaa. Testauksen kohteena ovat erityisesti tallennettavat sanomat ja niiden rakenne.

Tyypillisesti tämä testausvaihe suoritetaan järjestelmä- tai sovellustoimittajan omasta testiympäristöstä, joka on yhteydessä Kanta-palvelujen asiakastestiympäristöön. Joissain tilanteissa voi kuitenkin asiakasorganisaation testiympäristö olla ainoa testiympäristö, jossa yhteistestaus voidaan suorittaa. Tällainen tilanne voi muodostua, kun testataan esimerkiksi moduuleista koostuvia tietojärjestelmäkokonaisuuksia tai Kuva-aineistojen tietovarantoa.

Yhteistestauksen asiantuntija kertoo, raportoiko järjestelmätoimittaja testitapaukset siirtymävaiheessa Kumppanit-työtilaan vai Testain-palveluun. Jos Kanta-palvelut havaitsee testitapauksissa virheitä, järjestelmätoimittaja korjaa ne ja osoittaa korjauksien toimivuuden uudelleentestauksella.

Yhteistestauksen aloituskokouksessa käydään läpi yhteistestauksen aikaiset testausvaiheet ja se, sisältyykö yhteistestaukseen asiakasorganisaation ja Kelan välinen testaus. 

Yleensä sitä tarvitaan vain laajimmissa kokonaisuuksissa. 

Tällöin testaus tehdään järjestelmätoimittajan asiakkaan, kuten esimerkiksi hyvinvointialueen, testiympäristössä, joka on yhteydessä Kannan asiakastestiympäristöön.

Asiakasorganisaation ja Kelan välisessä testauksessa testitapaukset sisältävät tyypillisesti testattavan sisällön tallentamiseen ja hakemiseen liittyviä tapahtumaketjuja.

Ristiintestauksen tarkoituksena on varmistaa Kanta-palveluihin tallennettujen asiakirjojen yhteentoimivuus tietojärjestelmien välillä. Ristiintestausta ei edellytetä kaikissa testaussisällöissä.

Kun ristiintestausta edellytetään, Kanta-palvelut etsii kumppanit ristiintestausta varten ja antaa siihen testitapaukset. Järjestelmätoimittajat vastaavat itse testauksen niille aiheuttamista kustannuksista.

Järjestelmätoimittajien asiakasorganisaatiot ristiintestaavat testitapaukset asiakasorganisaation testiympäristössä, joka on yhteydessä Kanta-palvelujen asiakastestiympäristöön. Kummankin osapuolen tietojärjestelmätoimittajat osallistuvat ja tukevat asiakasorganisaatiota testauksessa. Ristiintestauksen molemmilla osapuolilla ei tarvitse olla meneillään olevaa yhteistestausta.

Jos järjestelmä toimii tuotannossa, sen tulee lain mukaan osallistua yhteistestauksiin, jotta tietojärjestelmien keskinäinen yhteentoimivuus voidaan varmistaa (asiakastietolaki, 86 § (finlex.fi)).

Yhteistestauksen jälkeen

Kun yhteistestaus on hyväksytysti suoritettu, Kela antaa tietojärjestelmälle yhteistestauslausunnon. Lausunnon liitteenä on tarkempi yhteistestausraportti. 

Kela lähettää yhteistestauslausunnon ja -raportin tiedoksi myös Terveyden ja hyvinvoinnin laitokselle (THL), Valviralle ja tietoturvallisuuden arviointilaitokselle.

Tietojärjestelmätoimittajan pitää ilmoittaa Valviralle, kun järjestelmä on saanut uuden yhteistestauslausunnon.

Tietojärjestelmän rekisteröinti (valvira.fi).

Varmista, pitääkö ennen tuotantokäytön aloitusta tehdä käyttöönottokoe.

Käyttöönottokokeeseen liittyvät käytännöt vaihtelevat eri Kanta-palveluissa. Löydät tarkempaa tietoa sivultamme Testauksesta tuotantoon. 

Ilmoita Kantaan liitetyn järjestelmän muutoksista.

Jos Kantaan liitetyn järjestelmän Resepti-palvelun, Potilastietovarannon, Sosiaalihuollon asiakastietovarannon tai toiminnallisuuksiin tai rajapintaan tulee muutoksia, niistä kuuluu aina ilmoittaa Kelaan. Myös Kantaan liittyneiden Hyvinvointisovellusten muutoksista pitää ilmoittaa Kelaan.

Muutosilmoituksen perusteella Kela arvioi yhteistestauksen tarpeen. Aina yhteistestausta ei edellytetä tai se voi olla hyvin suppeakin.

Ilmoitusvelvollisuus muutostilanteissa