Hae asiakirjoja henkilötunnuksen perusteella

Yleiskuvaus

Käyttötapaus kuvaa tilannetta, jossa asiakas tekee pyynnön tietojensa hakemiseen sosiaali-ja terveydenhuollon ulkopuolisen, tietoja vastaanottavan organisaation, asiointipalvelussa.

Asiakkaalle on tehty asiakirja, joka on tallennettu Potilastietovarantoon. Myöhemmin asiakas käy viranomaisen tai jonkin muun asiakirjoja käyttävän sosiaali- ja terveydenhuollon ulkopuolisen organisaation sähköisessä asiointipalvelussa ja laittaa vireille prosessin, johon tarvitaan asiakirja. Asiointipalvelu tekee hakuehtojen mukaisen haun Kysely- ja välityspalvelulle, joka palauttaa vastaussanomassa hakuehtoja vastaavat asiakirjat.

Käyttäjäroolit

  • Asiakirjoja hakeva sähköinen asiointipalvelu, myöhemmin asiointipalvelu
  • Kysely- ja välityspalvelu, myöhemmin KVP

Esiehdot

  • Asiakirjoja hakeva asiointipalvelu on ottanut käyttöön Kansallisen palveluväylän.
  • Asiakirjoja hakeva asiointipalvelu on liittynyt vastaanottajarekisteriin. [LT1]

Normaali tapahtumakulku

  1. Asiointipalvelu muodostaa kuvauksen Asiakirjojen haku henkilötunnuksen perusteella mukaisen pyyntösanoman.
  2. Asiointipalvelu lähettää pyyntösanoman Kansallisen palveluväylän kautta KVP:lle. [LT1] [LT2] [V1]
  3. KVP tarkistaa, ettei asiakirjaa ole aiemmin haettu tai pyydetty välitettäväksi toiselle vastaanottajalle. [V1]
  4. KVP hakee hakuehtojen mukaiset asiakkaan asiakirjat Potilastietovarannosta.
  5. KVP suodattaa tarvittaessa kunkin palautettavan asiakirjan tietosisällön. [LT3]
  6. KVP palauttaa kuvauksen Asiakirjahakujen vastaus mukaisen vastaussanoman, joka sisältää haulla löydetyt, mahdollisesti suodatetut asiakirjat. [V1]
  7. Asiointipalvelu vastaanottaa vastaussanoman Kansallisen palveluväylän kautta. Käyttötapaus päättyy. [LT4]

Virheet

V1. Hakusanoma on virheellinen tai hakusanoman mukaisten asiakirjojen käsittely aiheuttaa virheen. KVP palauttaa asiointipalvelulle kuvauksen Vastaussanoma virhetilanteessa mukaisen virhevastauksen. Käyttötapaus päättyy.

Lisätiedot

LT1. Viestinvälitys - Sanoman vastaanottaja -koodistossa kuvataan mitä asiakirjoja organisaation on mahdollista vastaanottaa. Lue lisää koodistosta kansalliselta koodistopalvelimelta. KVP tarkistaa, että asiakirjoja hakevalla organisaatiolla on oikeus hakea hakuehtoja vastaavat asiakirjat.

LT2. Viestinvälitys - Välitysperuste -koodistossa kuvataan sallitut välitysperusteet. KVP tarkistaa, että hakupyynnössä annettu välitysperuste on sallittu.

LT3. Asiakirjan tietosisältö suodatetaan, jos THL on määritellyt kyseessä olevalle asiakirjatyypille (i.e. tietty näkymätunnus) asiakirjan vastaanottajaa koskevat suodatussäännöt.

LT4. Asiointipalvelun tulee kuitata haetut asiakirjat vastaanotetuiksi yksitellen. Asiointipalvelu tarvitsee kuittauspyynnön muodostamista varten tietoja vastaussanomassa palautuvista Välitys -resurssi-instansseista. Voit lukea tästä lisää käyttötapauksesta Kuittaa välitys.