Connecting an application to the wellbeing applications interface

Tutustu Terveyden ja hyvinvoinnin laitoksen määräyksiin (thl.fi) kehittäessäsi hyvinvointisovellusta:

• THL:n määräys 4/2025
• THL:n määräys 5/2024
• Asiakastietoja käyttävä hyvinvointisovellus -profiili.

Tutustu myös

• HL7 FHIR-standardiin (hl7.org, englanniksi)
• OAuth 2.0 auktorisointiprotokollaan (oauth.net, englanniksi)
• Kanta-auktorisointioppaaseen (englanniksi)
• määrittelyihin.

Rajapinnan käytölle löydät tukea seuraavista paikoista:

• Ajankohtaista tietoa rajapintapalvelusta jaetaan HL7 Finland Personal Health SIG -kehittämisyhteisössä (hl7.fi).
• Lisätietoja voit kysyä myös Kanta-palveluilta lähettämällä sähköpostia osoitteeseen kanta@kanta.fi.

Ilmoittaudu asiakastestiympäristöön toimittamalla Kanta-palveluihin seuraavat lomakkeet: 

• Hakemuslomake Hyvinvointisovellusten rajapinta potilastietoihin -palvelun asiakastestipalveluun (xlsx)
• THL:n Järjestelmälomake (Määräyksen 5/2024 Liite 4) (xlsx, thl.fi)

Lähetä lomakkeet sähköpostilla osoitteeseen kanta@kanta.fi.

Kun Kela on hyväksynyt hakemuksesi, hae testipalvelinvarmenne Digi- ja väestötietovirastosta (DVV). Palvelinpohjaiset sovellukset tarvitsevat testipalvelinvarmenteen sekä asiakastestiympäristöön että yhteistestaukseen.

• Voit hakea hyvinvointisovelluspalveluvarmenteen vasta, kun sovellus on hyväksytty asiakastestiin ja Kela on antanut sovellustoimittajalle organisaation OID-koodin.
• Lähetämme Kelasta erikseen tarkemmat ohjeet varmenteen hakemiseksi.

Hyvinvointisovelluksen sertifiointi sisältää Kanta-palvelujen yhteistestauksen, Traficomin hyväksymän arviointilaitoksen suorittaman tietoturvallisuuden arvioinnin ja sovelluksen rekisteröimisen Valviran rekisteriin.

Vaaditut toiminnallisuudet on kuvattu THL:n määräyksen 5/2024 liitteessä 3h (thl.fi).

Yhteistestauksella tarkoitetaan sovelluksen sisäisen testauksen todentamista ja toimivuuden varmentamista Kanta-palvelujen asiakastestiympäristöä vasten. Yhteistestaus on tarkoitettu kehitystyön loppuvaiheen testaukseen.

Sovellustoimittaja vastaa siitä, että sovellukseen liittyvä muu testaus tehdään riittävällä laajuudella sekä laadullisesti hyvällä tasolla. 

Ilmoittaudu yhteistestaukseen toimittamalla Kelaan hakemuslomake Hyvinvointisovellusten rajapinta potilastietoihin –palvelun ilmoittautumislomake. Lähetä lomake sähköpostilla osoitteeseen kanta@kanta.fi.

Hyvinvointisovellusten on läpäistävä Traficomin hyväksymän tietoturvallisuuden arviointilaitoksen suorittama tietoturvallisuuden arviointi. 

1. Ilmoita hyvinvointisovellus Valviran Tietojärjestelmien rekisteriin (valvira.fi).
2. Hyväksy hyvinvointisovellusten rajapinnan toimitusehdot (pdf) ja palvelukuvaus (pdf).
3. Hanki DVV:n tuotantopalvelinvarmenne (dvv.fi).
4. Toimita julkaistavan sovelluksen tiedot Kanta-palveluille sähköpostilla, jonka jälkeen

• Sovellus rekisteröidään teknisesti Kanta-palveluissa rajapintapalveluun. Edellytyksenä tekniselle rekisteröinnille on, että hyvinvointisovellus on julkaistu Valviran rekisterissä.
• Sovellus lisätään kanta.fi-sivustolla olevaan sovellusluetteloon kaksi viikkoa teknisen rekisteröinnin jälkeen.

Kun olet varmista tuotannon toimivuuden, voidaan tuotantokäyttö aloittaa.

Sovelluksen käyttäjät saavat potilastietonsa hyvinvointisovellukseen antamalla sovellukselle käyttöoikeudet potilastietoihinsa ja hyväksymällä informoinnin potilastietojen saamisesta hyvinvointisovellukseen (pdf).