Hae potilasasiakirjat

Käyttötapaus kuvaa Kanta-palvelujen Potilastietovarantoon arkistoitujen potilasasiakirjojen hakutilanteet HRP-palvelusta.

Haku kohdistuu palvelutapahtuma- ja hoitoasiakirjoihin ja sitä voidaan rajata kyselyparametrien avulla. Haku rajautuu kerrallaan yhden potilaan tietoihin. Potilas yksilöidään virallisella henkilötunnuksella, eikä tilapäisen yksilöintitunnuksen käyttö ei ole sallittu. Myös puolesta asioiva yksilöidään puolesta asioinnin tilanteissa virallisella henkilötunnuksella. Haku kohdistuu aina kaikkien rekisterinpitäjien rekistereihin, pois lukien vanhat asiakirjat, jotka ovat syntyneet ennen Potilastietovarantoon liittymistä. Haussa palautuu asiakirjojen uusimmat versiot. Mitätöityjä asiakirjoja ei palauteta. Asiakirjat palautuvat arkistointiajan mukaan järjestettynä uusimmasta vanhimpaan.

Potilasasiakirjojen haussa palautuu myös terveys- ja hoitosuunnitelma [LT1].

HRP-palvelu päättelee hakutilanteen kyselysanomassa annettujen tietojen perusteella:

1. Henkilön oma asiointi: Hakuparametreissa on annettu omia tietojaan hakevan henkilön henkilötunnus.
2. Puolesta asiointi: Hakuparametreissa on annettu potilaan eli päämiehen henkilötunnuksen lisäksi puolesta asioivan henkilötunnus [LT2]

Potilastietovarannosta ei missään hakutilanteessa palauteta:

• asiakirjoja, jotka sisältävät toista henkilöä koskevia tietoja,
• asiakirjoja, joita koskee voimassa oleva viivästys,
• asiakirjoja, jotka sisältävät käyttäytymiseen liittyvän riskitiedon,
• alaikäisen henkilön asiakirjoja, jotka ovat syntyneet ennen 1.8.2016, ja
• asiakirjoihin liittyviä henkilöiden tunnistetietoja.

Lisäksi alaikäisen puolesta asioinnissa ei palauteta seuraavia tietoja puolesta asioivalle:

• asiakirjoja, jotka sisältävät tietoja henkilön kokonaislääkityksestä (VLÄÄ-näkymä),
• palvelutapahtuma-asiakirjoja, joihin ei liity yhtään hoitoasiakirjaa, joita voidaan luovuttaa huoltajalle,
• asiakirjoja, joiden luovuttamisen päätöskykyiseksi arvioitu alaikäinen on kieltänyt tai joissa on merkintä "alaikäisen päätöskyky ei tiedossa", ja
• yli 10-vuotiaan lapsen tietoja, joihin ei ole kirjattu tietoa alaikäisen päätöskyvystä ja tahtoa tietojen luovuttamisesta.

Täysi-ikäisen puolesta asioinnissa palautetaan samat potilastiedot kuin henkilölle itselleenkin.

Käyttötapauksen lopputuloksena hakeva järjestelmä on vastaanottanut HRP-palvelun palauttaman hakuparametrien mukaisesti rajatun haun tuloksen Kanta-palveluista haulla saatavista potilasasiakirjoista.

Käyttäjäroolit

1. Hakeva järjestelmä, esimerkiksi Hyvinvointisovellus, jatkossa Järjestelmä
2. Kanta-palvelujen HRP-palvelu, jatkossa Palvelu

Esiehdot

1. Hakevalla järjestelmällä on auktorisointiprosessin seurauksena saatu access token, mikä oikeuttaa pääsyn potilaan tietoihin
2. Potilas on yksilöity henkilötunnuksella
3. Hakevassa järjestelmässä on tiedossa joko käyttäjän antamana tai järjestelmän päättelemänä tarvittavat hakuparametrit
4. Jos kyseessä on sivutetun hakutuloksen jatkohaku, järjestelmällä on tiedossa Palvelun palauttamat tiedot jatkohakua varten
5. Hakutilanteessa B. Puolesta asiointi: Puolesta asioivalla on oikeus asioida päämiehen puolesta ja puolesta asioiva on yksilöity henkilötunnuksella [LT2]

Normaali tapahtumankulku

1. Järjestelmä tuottaa hakusanoman REST-rajapinnan Haku -kuvauksen mukaisesti [V1].
   • Hakuparametrit: voidaan käyttää potilasasiakirjojen haussa käytettävissä olevia hakuparametreja (ks. REST-rajapinta Haku)
   • Pakolliset parametrit:
     • potilaan henkilötunnus
     • haettavan sisällön tyyppi
     • Hakutilanteessa B. Puolesta asiointi: puolesta asioivan henkilötunnus
2. Järjestelmä lähettää hakusanoman Palvelulle [V2].
3. Järjestelmä vastaanottaa hakutuloksen [V3].
4. Järjestelmä käsittelee haettuja tietoja oman säännöstönsä mukaisesti. Käyttötapaus päättyy.

Virhetilanteet

V1 Hakusanoman tarvitsemien tietojen tuottaminen ei onnistu. Järjestelmä toimii oman logiikkansa mukaisesti. Käyttötapaus päättyy.

V2 Hakusanoman muodostaminen ei onnistu. Järjestelmä toimii oman logiikkansa mukaisesti. Käyttötapaus päättyy.

V3 Haun tuloksen vastaanottaminen ei onnistu. Järjestelmä toimii oman logiikkansa mukaisesti. Käyttötapaus päättyy.

Lisätiedot

LT1 Jos haun tuloksessa palautuu terveys- ja hoitosuunnitelman lisäksi muita hoitoasiakirjoja, terveys- ja hoitosuunnitelma palautuu vastauksen ensimmäisenä asiakirjana. Haku voidaan kohdistaa suoraan terveys- ja hoitosuunnitelmaan näkymärajausta käyttäen.
Terveys- ja hoitosuunnitelma palautuu aina Kanta-palvelun Tiedonhallintapalvelun säännöin, eli hakevalle järjestelmälle palautuu uusin terveys- ja hoitosuunnitelma, jota ei koske viivästys. Aikarajaus ja organisaatiorajaus eivät vaikuta haun tulokseen.

LT2 Puolesta asioinnissa palautuvat tiedot ovat päämiehen tietoja. Päämiehellä viitataan siihen henkilöön, jonka puolesta ollaan asioimassa. Puolesta asioivan oikeus asioida päämiehen puolesta tarkistetaan Suomi.fi-valtuudet palvelusta.