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.
Rajapintaan toteutetaan alaikäisten ja täysi-ikäisten puolesta asiointi syksyn 2025 aikana. Näitä varten julkaistaan erilliset 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 (yhteistyotilat.fi)(avautuu uuteen ikkunaan) | Dokumentti toimii Hyvinvointisovellusten rajapinta potilastietoihin -palveluun liittyvien toiminnallisten vaatimusten kokoavana ja ensisijaisena määrityksenä hyvinvointisovellusten valmistajille. | - | Toistaiseksi 20.11.2024 alkaen. | Toistaiseksi 20.11.2024 alkaen. |
| 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 | Päivitetään myöhemmin | Päivitetään myöhemmin | |
| Auktorisointiopas hyvinvointisovelluksille 2.2 (pdf, englanniksi)(avautuu uuteen ikkunaan) | - | - | Toistaiseksi 20.11.2024 alkaen. | Toistaiseksi 20.11.2024 alkaen. |
| Määrittelyn nimi ja versio | Kuvaus | Muutokset edelliseen versioon | Voimassa sertifioinnissa | Voimassa tuotantokäytössä |
|---|---|---|---|---|
| Hyvinvointisovellusten rajapinnan FHIR R4 -implementointiopas 2.0.0 (simplifier.net)(avautuu uuteen ikkunaan) | Versio 2.0.0 | Näkyvillä implementointioppaan versiohistoriassa. | Toistaiseksi 15.5.2025 alkaen. | Toistaiseksi 15.5.2025 alkaen. |
| Hyvinvointisovellusten rajapinnan FHIR R4 -implementointiopas 1.1.0 (simplifier.net)(avautuu uuteen ikkunaan) | 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 (simplifier.net)(avautuu uuteen ikkunaan) | Versio 1.0.0. | Ensimmäinen versio. | 20.11.2024-2.2.2025. | 20.11.2024-2.2.2025. |
- ”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)