Hae potilasasiakirjat

Käyttötapaus kuvaa Kanta-palvelujen Potilastiedon tietovarantoon 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, tilapäisen yksilöintitunnuksen käyttö ei ole sallittu. Haku kohdistuu aina kaikkien rekisterinpitäjien rekistereihin, pois lukien vanhat asiakirjat, jotka 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].

Potilastiedon tietovarannosta ei palauteta seuraavia asiakirjoja:

• asiakirjat, jotka sisältävät toista henkilöä koskevia tietoja
• asiakirjat, joita koskee voimassa oleva viivästys
• asiakirjat, jotka sisältävät käyttäytymiseen liittyvän riskitiedon
• alaikäisen henkilön asiakirjat, jotka ovat syntyneet ennen 1.8.2016 ja
• palautettavista asiakirjoista poistetaan henkilöiden tunnistetiedot.

Käyttötapauksen lopputuloksena hakeva järjestelmä on vastaanottanut HRP-palvelun palauttaman hakuparametrien mukaisesti rajatun haun tuloksen Kannasta 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

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:
     • henkilötunnus
     • haettavan sisällön tyyppi
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.