Rajapintakäyttötapaukset potilastietovarannon ja liittyvän järjestelmän välillä

Potilastietovarannon rajapintakäyttötapaukset -dokumentissa kuvataan potilastietoa käsittelevän järjestelmän ja Potilastietovarannon väliset rajapintakäyttötapaukset tietojen arkistointiin Potilastietovarantoon sekä tietojen hakemiseen Potilastietovarannosta.

Alla olevasta taulukosta löytyy dokumentin eri versiot.

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)

Taulukko: Potilastietovarannon rajapintakäyttötapaukset -dokumentin eri versiot. Päivitetty 5.3.2025.
Määrittelyn nimi ja versio	Kuvaus	Muutokset edelliseen versioon	Voimassa sertifioinnissa	Voimassa tuotantokäytössä
Potilastietovaranto: rajapintakäyttötapaukset tietovarannon ja liittyvän järjestelmän välillä (zip) Versio 2.4 Julkaistu 5.3.2025	Vastuutaho Kela, Kanta-palvelut	Lisätty lääkemääräyskohtaisen kiellon (RKIE) kahden eri lomakeversion käsittely ja tarkennettu ostopalvelun valtuutuksen yksilöivän tunnisteen käyttöä.	Ilmoitetaan myöhemmin	Ilmoitetaan myöhemmin
Potilastietovaranto: rajapintakäyttötapaukset tietovarannon ja liittyvän järjestelmän välillä (zip) Versio 2.3 Julkaistu 11.6.2024 Päivitetty 4.9.2024	Vastuutaho Kela, Kanta-palvelut	Lisätty toimintansa päättäneen rekisterinpitäjän tietojen haku ja arkistointi. Lisätty toimintansa päättäneen rekisterinpitäjän vanhojen tietojen haku ja arkistointi.	Toistaiseksi 11.6.2024 alkaen	Toistaiseksi 11.6.2024 alkaen
Potilastiedon arkisto: rajapintakäyttötapaukset arkiston ja liittyvän järjestelmän välillä (zip). Versio 2.2 Julkaistu 11.12.2023 Päivitetty 30.1.2024, 7.2.2024	Vastuutaho Kela, Kanta-palvelut	Sisältää RC-versioissa julkaistut muutokset mm. YKIE ja PSSUO, PP24 huoltajan kieltoyhteenveto luovutusluvan käytön laajennus uusi kieltolomake 30.1.2024: Vahvistettu YKIE ja PSSUO rivinvaihtoratkaisu. 7.2.2024: Virheen korjaus.	Toistaiseksi 11.12.2023 alkaen	Toistaiseksi 11.12.2023 alkaen
Potilastiedon arkisto: rajapintakäyttötapaukset arkiston ja liittyvän järjestelmän välillä (zip) Versio 2.1 Julkaistu 29.6.2022 Päivitetty 16.12.2022	Vastuutaho Kela, Kanta-palvelut	Sisältää muutoksia mm. Luovutus sairaanhoitopiirin yhteisrekisteriin perustuen Väestötasoisen ostopalvelun termimuutos Laaja luovutuskielto poistettu Tarkennettu PPB-hakua	Ei voimassa	Ei voimassa
Potilastiedon arkisto: rajapintakäyttötapaukset arkiston ja liittyvän järjestelmän välillä (zip) Versio 2.0 Julkaistu 25.3.2022	Vastuutaho Kela, Kanta-palvelut	Sisältää RC-versioissa julkaistut muutokset asiakastietolain muutokset uudet palvelupyynnöt ostopalvelu 2 muutokset	Ei voimassa	Ei voimassa
Potilastiedon arkisto: rajapintakäyttötapaukset arkiston ja liittyvän järjestelmän välillä (pdf) Versio 1.0.2 Julkaistu 27.2.2019 Dokumenttiin liittyvä errata, sisältää koronatodistukseen liittyvät muutokset Errata (docx), lisätty 10.5.2021, päivitetty 7.6.2021	Vastuutaho Kela, Kanta-palvelut		Ei voimassa	Ei voimassa

Potilastietovarannon palvelupyynnöt palvelutapahtumien ja hoitoasiakirjojen käsittelyyn, voimassaoloajat. Päivitetty 29.4.2024.
Palvelupyynnöt	Kuvaus	Voimassa sertifioinnissa	Voimassa tuotantokäytössä
Uudet palvelupyynnöt	PPA (Potilasasiakirjojen arkistointi), PPB (Potilasasiakirjojen haku) ja PPC (Keskeisten tietojen haku)	Toistaiseksi 01/2022 alkaen.	Toistaiseksi 03/2022 alkaen.
Vanhat palvelupyynnöt	Oman rekisterin käsittelyn palvelupyynnöt PP1, PP2 Luovutushaun palvelupyynnöt PP21, PP22, PP30 Ostopalvelutilanteen palvelupyynnöt PP12, PP13, PP15, PP16, PP40, PP42, PP44, PP46 Keskeisten tietojen haun palvelupyynnöt PP27, PP28 Ostopalvelutilanteen keskeisten tietojen haun palvelupyynnöt PP41, PP43, PP45, PP47	1.1.2011 - 31.12.2024	1.1.2011 - 31.12.2028