Hae organisaatiolle osoitetut asiakirjat

Yleiskuvaus

Käyttötapaus kuvaa tilannetta, jossa viranomainen tai jonkin muu sosiaali- ja terveydenhuollon ulkopuolinen organisaatio hakee sille kuuluvia asiakirjoja Kysely- ja välityspalvelusta.

Käyttäjäroolit

  • Asiakirjoja hakeva järjestelmä
  • Kysely- ja välityspalvelu, myöhemmin KVP

Esiehdot

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

Normaali tapahtumakulku

  1. Asiakirjoja hakeva järjestelmä muodostaa kuvauksen Organisaatiolle osoitettujen asiakirjojen haku mukaisen pyyntösanoman.
  2. Asiakirjoja hakeva järjestelmä lähettää pyyntösanoman Kansallisen palveluväylän kautta KVP:lle. [LT1]
  3. KVP hakee hakuehtojen mukaiset asiakirjat Potilastietovarannosta. [V1] [LT2]
  4. KVP suodattaa tarvittaessa kunkin palautettavan asiakirjan tietosisällön. [LT5]
  5. KVP palauttaa kuvauksen Asiakirjahakujen vastaus mukaisen vastaussanoman, joka sisältää haulla löydetyt, mahdollisesti suodatetut asiakirjat. [V1]
  6. Asiakirjoja hakeva järjestelmä vastaanottaa vastaussanoman Kansallisen palveluväylän kautta. Käyttötapaus päättyy. [LT3] [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. KVP hakee Potilastietovarannosta ainoastaan ne asiakirjat, joista on tehty potilastietojärjestelmästä KVP:lle välityspyyntö. Asiakirja haetaan, jos välityspyynnössä asiakirjan vastaanottajaksi on asetettu asiakirjahaun tehnyt organisaatio eikä asiakirjaa ole vielä haettu. Jos asiakirja on jo haettu, mutta on tarpeen hakea se uudelleen, asiakirjoja hakeva järjestelmä voi asettaa pyyntösanomassa reload=true. Pyyntösanoma on kuvattu sivulla Organisaatiolle osoitettujen asiakirjojen haku.

LT3. Jos asiakirjan vastaanottaminen epäonnistuu, asiakirjoja hakeva järjestelmä voi tehdä haun uudestaan asettamalla pyyntösanomassa reload=true.

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

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