Hae ajanvaraukset

Käyttötapaus kuvaa potilaan ajanvarausten haun Potilastietovarannosta terveydenhuollon palvelunantajien rekistereistä hakuparametrien mukaisesti huomioiden luovutustenhallinnan tiedot ja potilaan asettamat luovutuskiellot.

Potilastietovaranto päättelee hakutilanteen kyselysanomassa annettujen tietojen perusteella ja palauttaa laajimman mahdollisen yhdistelmän tietoja. Haku kattaa luovutushaun, hätähaun, haun ostopalvelutilanteessa, ennakkohaun sekä haun hakijan omasta rekisteristä.

Potilastietovaranto päättelee hakutilanteen:

1. Luovutushaku: Kyselysanomassa on annettu hoitosuhteen todentava, voimassa oleva palvelutapahtuma, joka on hakevan organisaation omassa rekisterissä. Haussa palautuu kaikkien rekisterinpitäjien tiedot luovutussäännöt huomioiden sekä oman rekisterin tiedot.
2. Haku ostopalvelutilanteessa: Kyselysanomassa on annettu hoitosuhteen todentava, voimassa oleva palvelutapahtuma, joka on ostopalvelun järjestäjän rekisterissä. Haussa palautuu järjestäjän rekisterin asiakirjat ostopalvelun valtuutuksen mukaisesti sekä kaikkien rekisterinpitäjien tiedot luovutussäännöt huomioiden.
3. Haku omasta potilasrekisteristä: Kyselysanomassa ei ole annettu hoitosuhteen todentavaa palvelutapahtumaa. Haussa palautuu hakevan organisaation oman rekisterin tiedot.

Hakutilanteen lisäksi pääteltävät tiedot:

4. Luovutuksenhallinnan tarkastukset ohittava haku (LT3): Kyselysanomassa on annettu kyselyn erityinen syy, ’Hätähaku’. Tiedot palautuvat, vaikka informointi ja luovutuslupa puuttuisivat. Palautukseen laajuus määräytyy hakutilanteen (A, B tai C) mukaisesti.
5. Ennakkohaku: Kyselysanomassa ei ole annettu pyynnön tehneen kansalaisen eikä ammattihenkilön tunnistetta, joten kyseessä on ennakkohaku. Palautukseen laajuus määräytyy hakutilanteen (A, B tai C) mukaisesti.

Haku rajautuu tässä käyttötapauksessa potilaan ja hakijan mukaan:

• Haetaan aina yhden potilaan tiedot. Asiakirjoja voidaan hakea henkilötunnuksella tai tilapäisellä yksilöintitunnuksella
• Haku kohdistuu lähtökohtaisesti kaikkien terveydenhuollon palvelunantajien rekistereihin
• Potilastietovaranto rajaa haun kyselyn lähettäjän omaan rekisteriin, jos potilaalla on tilapäinen henkilötunnus.
• Potilastietovaranto rajaa haun kyselyn lähettäjän omaan rekisteriin, jos kyselysanomassa ei välitetä hoitosuhteen todentavaa palvelutapahtumaa (tilanne C).
• Jos potilas ei ole antanut luovutuslupaa eikä kyseessä ole luovutuksenhallinnan tarkastukset ohittava haku, Potilastietovaranto rajaa haun seuraavasti:
  • tilanteessa A (luovutushaku)
    • Jos kyselyn lähettäjä kuuluu Uudenmaan maakunnan hyvinvointialueeseen, Helsingin kaupunkiin tai HUS-yhtymään, Potilastietovaranto rajaa haun edellä mainittujen palvelunantajien rekistereihin, mikäli potilasta on informoitu Uudenmaan väliaikaisesta tiedonsaantioikeudesta [LT2].
    • Muuten Potilastietovaranto rajaa haun kyselyn lähettäjän omaan rekisteriin
  • tilanteessa B (ostopalvelu) Potilastietovaranto rajaa haun palvelunjärjestäjän rekisteriin
• Potilastietovaranto rajaa hakutuloksen potilaan mahdollisesti asettamien luovutuskieltojen mukaisesti.

Käyttötapauksen lopputuloksena hakeva järjestelmä on vastaanottanut Potilastietovarannon palauttaman hakuparametrien mukaisesti rajatun haun tuloksen.

Käyttäjäroolit

1. Kantaan liittynyt järjestelmä. Ajanvarauksen muodostajan -roolissa toimiva järjestelmä: resurssienhallinta, palveluntuottajan toiminnanohjaus, asiointipalvelut kuten ajanvarauspalvelu, palveluohjain, peruutusaikapalvelu tai ilmoitus- ja vahvistuspalvelu. Jatkossa Järjestelmä
2. Potilastietovaranto

Esiehdot

1. Potilas on yksilöity henkilötunnuksella tai tilapäisellä yksilöintitunnuksella

• tilanteessa B (ostopalvelu) potilas tulee yksilöidä henkilötunnuksella; tilapäinen yksilöintitunnus ei ole sallittu

2. Potilastietojärjestelmässä on tiedossa joko käyttäjän antamana tai järjestelmän päättelemänä tarvittavat hakuparametrit
3. Tilanteessa A hoitosuhteen todentava palvelutapahtuma on arkistoitu hakevan organisaation omaan rekisteriin.
4. Tilanteessa B (haku ostopalvelutilanteessa) hoitosuhteen todentava palvelutapahtuma on arkistoitu ostopalvelun järjestäjän rekisteriin, ja siinä on yksilöity ostopalvelun valtuutus. [LT1]
   • Yksilöidyssä ostopalvelun valtuutuksessa on valtuutettu se rekisteri, johon palvelutapahtuma on arkistoitu, sille tuottajalle joka hakua on tekemässä
5. Tilanteessa C (haku omasta rekisteristä) hoitosuhteen todentavaa palvelutapahtumaa ei välitetä.

Normaali tapahtumankulku

1. Järjestelmä tuottaa hakusanoman "REST-rajapinta Haku -kuvauksen mukaisesti" [V1]
   • Viittaus palvelutapahtumaan on annettava, jos halutaan hakea tietoja muiden rekisterinpitäjien rekistereistä:
     • Tilanteessa A (luovutushaku): viitattava palvelutapahtuma, on kyselyn lähettäjän rekisterissä
     • Tilanteessa B (haku ostopalvelutilanteessa): viitattava palvelutapahtuma on ostopalvelun järjestäjän rekisterissä
     • Tilanteessa D (luovutuksenhallinnan tarkastukset ohittava haku) kyselysanomaan tulee tuottaa tieto kyselyn perusteena olevasta erityisestä syystä. Erityiseksi syyksi laitetaan ’Hätähaku’.
     • Tilanne E (ennakkohaku): Kaikki hakutilanteet on mahdollista käynnistää järjestelmän tekemänä ennakkohakuna. Ennakkohaussa ei välitetä kyselyn käynnistäneen kansalaisen eikä ammattihenkilön tietoja.
   • Hakuparametrit: voidaan käyttää ajanvarausten haussa käytettävissä olevia hakuparametreja (ks. "REST-rajapinta Haku")
     • Pakollinen parametri henkilötunnus tai tilapäinen yksilöintitunnus
   • Kaikkien versioiden haku (_history)
     • Tilanne A (luovutushaku): Kaikkien versioiden haku on mahdollista vain omasta rekisteristä. Potilastietovaranto rajaa haun lähettäjän omaan rekisteriin.
     • Tilanne B (haku ostopalvelutilanteessa): Kaikkien versioiden haku on mahdollista vain ostopalvelun järjestäjän rekisteristä ostopalvelun valtuutuksen puitteissa. Potilastietovaranto rajaa haun ostopalvelun järjestäjän rekisteriin.
     • Tilanne C (haku omasta rekisteristä): Kaikkien versioiden haku on mahdollista omasta rekisteristä.
2. Järjestelmä lähettää hakusanoman Potilastietovarantoon [V2]
3. Järjestelmä vastaanottaa hakutuloksen [V3]
   • Mikäli informointi puuttuu ja sen puuttumisella on vaikutusta palautettavaan haun tulokseen, palautetaan Järjestelmälle paluusanomassa tieto informoinnin puuttumisesta. Tietoa ei palauteta luovutuksenhallinnan tarkastukset ohittavassa haussa, sillä informoinnin puuttuminen ei vaikuta tulokseen.
   • Mikäli informointi annettu mutta luovutuslupa puuttuu, palautetaan Järjestelmälle paluusanomassa tieto luovutusluvan puuttumisesta. Luovutusluvan puuttuminen voi vaikuttaa palautettavaan haun tulokseen. Tietoa ei palauteta luovutuksenhallinnan tarkastukset ohittavassa haussa, sillä luovutusluvan puuttuminen ei vaikuta tulokseen.
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ä antaa ilmoituksen käyttäjälle tai tallentaa tiedon jatkokäsittelyä varten. Käyttötapaus päättyy.

V2 Hakusanoman muodostaminen ei onnistu Järjestelmä antaa ilmoituksen käyttäjälle tai tallentaa tiedon jatkokäsittelyä varten. Käyttötapaus päättyy.

V3 Haun tuloksen vastaanottaminen ei onnistu. Järjestelmä antaa ilmoituksen käyttäjälle tai tallentaa tiedon jatkokäsittelyä varten. Käyttötapaus päättyy.

Lisätiedot

LT1 Ostopalveluratkaisun siirtymäaikana palvelutapahtuma on voitu arkistoida myös ilman ostopalvelun valtuutuksen tunnistetta. Ostopalvelun järjestäjän arkistoasiakirjat-rekisterissä on oltava kuitenkin ostopalvelun valtuutus, jossa on valtuutettu hakua tekevä palveluntuottaja käyttämään rekisteriä, johon palvelutapahtuma on arkistoitu.

LT2 1.1.2023 alkaen Uudenmaan maakunnassa hyvinvointialueen, Helsingin kaupungin ja HUS-yhtymän välillä tietoja voidaan luovuttaa ilman erillistä luovutuslupaa kiellot huomioiden, mikäli potilasta on tästä informoitu (Kanta-informointi versio 1.1 tai uudempi). Tämän mahdollistaa Uudenmaan väliaikainen tiedonsaantioikeus (HE 18/2022 vp, 64 a §), joka pohjautuu terveydenhuoltolain 1326/2010 9 §:n mukaista sairaanhoitopiirin alueen yhteisrekisteriä koskevaan potilastietojen käsittelyä koskevaan sääntelyyn. Uudenmaan hyvinvointialueiden, Helsingin kaupungin ja HUS-yhtymän omalle henkilöstölleen tuottama työterveyshuolto ei kuulu väliaikaisen tiedonsaantioikeuden piiriin.

LT3 Luovutuksenhallinnan tarkastukset ohittavaa hakua voidaan tarvita tilanteissa, joissa potilas ei ole kykenevä päättämään tietojen luovuttamisesta Potilastiedon arkiston toiminnalliset vaatimukset sosiaali- ja terveydenhuollon tietojärjestelmille v2.1. Joissain tilanteissa voidaan tarvita ajanvaraustietoja siinä kuin muitakin potilastietoja. Ajanvarausten haun yhteydessä ei palauteta potilaan mahdollisia tahdonilmaisuja (hoitotahto ja elinluovutustahto).