Toiminnallisiin määrittelyihin on koostettu hyvinvointisovelluksia koskevat vaatimukset ja määrittelyt, joita hyvinvointisovellusten valmistajien tulee noudattaa rajapintaa toteutettaessa ja sen ollessa tuotantokäytössä.
Teknisiin määrittelyihin kuuluvat FHIR-standardilla toteutetun rajapinnan kuvaukset ja määrittelyt, sekä Kanta-auktorisointipalvelun käyttöön liittyvät määrittelyt. Kanta-auktorisointipalvelussa ylläpidetään hyvinvointisovellusten informointeja ja kansalaisen antamia käyttöoikeuksia.
Tulevaisuudessa hyvinvointisovellusten rajapinnan avulla sovellukset voivat hakea myös reseptitietoja ja sosiaalihuollon asiakastietoja Kannasta. Määrittelyt täydentyvät ja niitä julkaistaan lisää, kun palvelu laajenee.
Hyvinvointisovellusten rajapinnan toiminnalliset määrittelyt
| Määrittelyn nimi ja versio | Kuvaus | Muutokset edelliseen versioon | Voimassa sertifioinnissa | Voimassa tuotantokäytössä |
|---|---|---|---|---|
| Hyvinvointisovellusten rajapinnan vaatimukset ja toiminnalliset määrittelyt 2.0 (yhteistyotilat.fi)(avautuu uuteen ikkunaan) | Dokumentti toimii Hyvinvointisovellusten rajapinta potilastietoihin -palveluun liittyvien toiminnallisten vaatimusten kokoavana ja ensisijaisena määrityksenä hyvinvointisovellusten valmistajille. | Tuotu mukaan puolesta asiointiin liittyvät määrittelyt ja vaatimukset, lisätty uusia käsitemäärittelyjä ja tarkennettu hyvinvointisovellukselta vaadittavan tunnistautumisen vaatimuksia. | Toistaiseksi 11.6.2026 alkaen | Toistaiseksi 11.6.2026 alkaen |
| Hyvinvointisovellusten rajapinnan vaatimukset ja toiminnalliset määrittelyt 1.0 | Dokumentti toimii Hyvinvointisovellusten rajapinta potilastietoihin -palveluun liittyvien toiminnallisten vaatimusten kokoavana ja ensisijaisena määrityksenä hyvinvointisovellusten valmistajille. | - | 20.11.2024-10.6.2026 | 20.11.2024-31.12.2028 |
Hyvinvointisovellusten tekniset määrittelyt
| Määrittelyn nimi ja versio | Kuvaus | Muutokset edelliseen versioon | Voimassa sertifioinnissa | Voimassa tuotantokäytössä |
|---|---|---|---|---|
| Auktorisointiopas hyvinvointisovelluksille 2.3 (pdf, englanniksi)(avautuu uuteen ikkunaan) | Muutoshistoria näkyvillä Auktorisointioppaassa | Toistaiseksi 11.6.2026 alkaen | Toistaiseksi 11.6.2026 alkaen | |
| Auktorisointiopas hyvinvointisovelluksille 2.2 (pdf, englanniksi)(avautuu uuteen ikkunaan) | - | - | 20.11.2024-10.6.2026 | 20.11.2024-31.12.2028 |
| Määrittelyn nimi ja versio | Kuvaus | Muutokset edelliseen versioon | Voimassa sertifioinnissa | Voimassa tuotantokäytössä |
|---|---|---|---|---|
| Hyvinvointisovellusten rajapinnan FHIR R4 -implementointiopas 2.2.0 (simplifier.net)(avautuu uuteen ikkunaan) | Versio 2.2.0 | Näkyvillä implementointioppaan versiohistoriassa. | Toistaiseksi 11.6.2026 alkaen. | Toistaiseksi 11.6.2026 alkaen. |
| Hyvinvointisovellusten rajapinnan FHIR R4 -implementointiopas 2.1.0 (simplifier.net) | Versio 2.1.0 | Näkyvillä implementointioppaan versiohistoriassa. | 28.8.2025-10.6.2026 | 22.9.2025-31.12.2028 |
| Hyvinvointisovellusten rajapinnan FHIR R4 -implementointiopas 2.0.0 (simplifier.net) | Versio 2.0.0 | Näkyvillä implementointioppaan versiohistoriassa. | 15.5.2025-27.8.2025 | 15.5.2025-21.9.2025 |
| Hyvinvointisovellusten rajapinnan FHIR R4 -implementointiopas 1.1.0 | Versio 1.1.0. | Näkyvillä implementointioppaan versiohistoriassa. | 3.2.2025-14.5.2025 | 3.2.2025-14.5.2025 |
| Hyvinvointisovellusten rajapinnan FHIR R4 –implementointiopas 1.0.0 | Versio 1.0.0. | Ensimmäinen versio. | 20.11.2024-2.2.2025. | 20.11.2024-2.2.2025. |
Määrittelyjen voimassaolo
- ”Voimassa sertifioinnissa” kertoo, millä aikavälillä järjestelmän yhteistestaus, tietoturvallisuuden arviointi tai vaatimustenmukaisuuden uusiminen tehdään kyseisen version mukaisesti.
- ”Voimassa tuotantokäytössä” kertoo, millä aikavälillä tuotannossa olevat järjestelmät saavat toimia kyseisen version mukaisesti.
- Lisätietoja voimassaoloajoista (thl.fi)(avautuu uuteen ikkunaan)