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, 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].

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 asioijan henkilötunnus [LT2].

Potilastietovarannosta ei palauteta missään hakutilanteessa 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 tietoja haettaessa asiakirjat, jotka ovat syntyneet ennen 1.8.2016, ja
  • palautettavista asiakirjoista poistetaan henkilöiden tunnistetiedot.

Lisäksi käyttötilanteessa B. Puolesta asiointi ei palauteta seuraavia asiakirjoja, mikäli henkilö, jonka tietoja haetaan, on ala-ikäinen:

  • asiakirjat, jotka sisältävät tietoja henkilön kokonaislääkityksestä,
  • asiakirjat, joiden luovuttamisen huoltajalle alaikäinen on kieltänyt, ja
  • palvelutapahtuma-asiakirjat, joihin ei liity yhtään hoitoasiakirjaa, joita voidaan luovuttaa huoltajalle.

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 asioijalla on oikeus asioida päämiehen puolesta [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 asioijan henkilötunnus on pakollinen hakuparametri. Puolesta asioija yksilöidään virallisella henkilötunnuksella, tilapäisen henkilötunnuksen käyttö ei ole sallittu.
  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 asioijan oikeus asioida päämiehen puolesta tarkistetaan Suomi.fi-valtuudet palvelusta.