SOPIMUS ASIAKAS- JA POTILASTIETOJÄRJESTELMÄSTÄ

SOPIMUS ASIAKAS- JA POTILASTIETOJÄRJESTELMÄSTÄ

Liite B13

Apotti Avoin Palvelurajapinta (AAP)

VERSIOHISTORIA

Päivä	Versio	Kuvaus	Tekijä
12.03.2015	3.0	Tarjouspyynnön liitteeksi	Hanketoimisto

Sisällysluettelo

1. Apotti Avoin Palvelurajapinta (AAP) 4

1. Apotti Avoin Palvelurajapinta (AAP)‌

Tarvittavat rajapinnat Järjestelmästä muihin ulkopuolisiin tietojärjestelmiin ovat tiedossa ja esimerkiksi nykyisestä lainsäädännöstä ja viranomaismääräyksistä aiheutuvat rajapintavaati- mukset ovat tarkasti määriteltävissä. Järjestelmässä on varauduttava joustavasti palvelemaan myös tulevia tarpeita, ja sen tulee mahdollistaa uusien kolmansien osapuolien toteuttamien ohjelmistojen joustava liittäminen. Tämän vuoksi järjestelmän tulee sisältää tarvittavat rajapinta- toiminnallisuudet, joista käytetään nimitystä ”Apotti Avoin Palvelurajapinta”, AAP.

Avoimen palvelurajapinnan kautta kolmannen osapuolen toteuttamille sovelluksille mahdolliste- taan tietoturvallinen ja tapauskohtaisesti konfiguroitavissa oleva yhteys Järjestelmän tietoihin. ”Avoimella” tarkoitetaan tässä sitä, että Apotti-organisaatio voi vapaasti (Järjestelmän toimitta- jasta riippumatta) hyödyntää rajapintaa siirtämään tietoja Järjestelmän ja muiden sovellusten ja sovelluskomponenttien kanssa. AAP-rajapinnan tulee toteuttaa seuraavissa kappaleissa kuvatut vaatimukset.

Avoimen rajapinnan kutsut voidaan varmentaa tarkoituksenmukaisesti tunnistamalla rajapintoja käyttävät sovellukset ja sovelluksia käyttävät henkilöt.

Vaatimukset ja vaatimusten arviointi

Apotti Avoin Palvelurajapinta (AAP):aan liittyvät vaatimukset on esitetty liitteessä B14 Apotti Avoin Palvelurajapinta (AAP) vaatimukset.

Näiden vaatimuksenmukaisuutta osoittava arviointi ja sen käytännön toteutustapa on kuvattu Tarjouspyynnön liitedokumentissa ”Apotin Avointen Palvelurajapintojen arvioinnin kuvaus ja toteutussuunnitelma”.

Käyttötapaukset

Käyttötapaus AAP-KT-1 (Riskitesti) kuvaa tilannetta, jossa Jjärjestelmän ulkopuolella (esim. 3- sektorin toimijan palvelimella) on lomakkeeseen perustuva riskitesti, jolla asiakas/potilas voi arvioida esimerkiksi sokeritauti-riskiään. Hyödyntämällä AAP:tä testilomakkeen sisältö ja testin tulos voidaan viedä Järjestelmään, jolloin se on hyödynnettävissä hoito-ja palveluprosessissa. Lisäksi AAP:n kautta voidaan tarvittaessa hakea tietoja lomakkeen esitäyttöä varten. Erilaisten riskitestien ja muiden omahoitoa tukevien, lomakepohjaisten ratkaisujen hyödyntäminen asia- kasohjauksessa ja hoito- ja palveluprosesseissa on nopeasti yleistymässä. Näitä ratkaisuja todennäköisesti tullaan toteuttamaan myös suoraan Apotin asiakas- ja potilasportaaliin, mutta mahdollisuus hyödyntää ulkopuolisia palveluja laajentaa testivalikoimaa huomattavasti.

Käyttötapaus AAP-KT-2 (Omahoitosovellus) kuvaa tilannetta, jossa asiakkaalla/potilaalla on käytössään terveyden monitorointiin (esim. verenpaineseurantaan) tarkoitettu omahoitosovellus. AAP:n avulla omahoitosovellus voi siirtää seurantatietoja Järjestelmään, jossa ne ovat hoito- henkilökunnan käytettävissä. Toisaalta omahoitosovellus voi myös saada AAP:n kautta käyt- töönsä omahoitoa tukevia tietoja sovelluksen käyttöliittymässä esitettäväksi. AAP:n kautta haet- tavia tietoja voidaan hyödyntää myös päätöksenteon tukitoiminnallisuudessa, jossa mittaustu- losten pohjalta tuotetaan personoituja palauteviestejä asiakkaalle/potilaalle.

Käyttötapaus AAP-KT-3 (Omien tietojen siirto) kuvaa tilannetta, jossa asiakas/potilas haluaa kopioida tietojaan Järjestelmän ja omassa käytössään olevan tietovaraston (esim. terveystalti- on) välillä. Omien tietojen vienti terveystaltioon (esim. Taltioni-palvelu) voi olla tarpeen, kun

asiakas/potilas haluaa hyödyntää tietojaan muissa sovelluksissa. Terveystaltio on toimiva rat- kaisu myös tilanteessa, jossa asiakas haluaa varmistaa aikaisempien tietojensa käytettävissä olon esim. ulkomaille muuton yhteydessä. Vastaavasti, ulkomailta Suomeen tulevalla henkilöllä voi olla sähköisiä tietoja omassa hallussaan, ja ne tulisi voida tuoda hoitohenkilökunnan käyt- töön AAP:n avulla.

Käyttötapaus AAP-KT-4 (Tutkimuskäyttö) kuvaa tilannetta, jossa Järjestelmään tallennettuja tietoja luovutetaan tutkimuskäyttöön. AAP:n avulla voidaan hakea kulloinkin tutkimuksen koh- teena olevien asiakas- tai potilasryhmien tarvittavat tiedot tutkimusta varten. Tyypillisessä tilan- teessa tutkimuskäyttöön otettavat tiedot ovat anonymisoituja siten, että tutkijat eivät näe asiak- kaiden/potilaiden tunnistetietoja. Tietojen anonymisointi voi tällöin tapahtua Järjestelmän toi- mesta tai se voidaan tehdä myös ulkoisessa sovelluksessa, joka hakee tiedot Järjestelmästä ja tallentaa ne tutkimustietokantaan. Käyttötapauksessa 4 tarvittava toiminnallisuus tukee myös potilasryhmiin kohdistettua virtuaalista terveystarkastusta, jossa tutkijan sijasta tietoja analysoi- daan automaattisesti esimerkiksi riskiryhmien identifioimiseksi.

Käyttötapaus AAP-KT-5 (Päätöstukisovellus) kuvaa tilannetta, jossa Jjärjestelmä hyödyntää kolmannen osapuolen toimittamaa päätöstukiratkaisua. Järjestelmän yhteydessä toimii tällöin sovelluskomponentti, joka tuo ohjelmiston käyttöliittymään ammattilaisen työtä ohjaavia viestejä ja varoituksia (esim. varoitus lääkkeiden yhteisvaikutuksesta). Tämä päätöksenteon tukikompo- nentti saa tarvitsemansa asiakas- ja potilastiedot käyttöön AAP:n kautta. Käyttötapaus 5 poik- keaa edellisistä käyttötapauksista siinä, että AAP:tä kutsuva sovellus sijoittuu Järjestelmän sisälle. Siten, edellytyksenä käyttötapaukselle on, että Järjestelmä mahdollistaa tällaisen sovel- luskomponentin toteuttamisen.

AAP:n toiminnallisuuden täyttäminen ei edellytä erikseen määrittelyjen mukaan toteutettua rajapintaa vaan Järjestelmä voi toteuttaa toiminnallisuuden yhdellä tai useammalla järjestelmä- rajapintakomponentilla.

Taulukko 1: Käyttötapaukset

Käyttötapaus	Tietojen haku Apotista	Tietojen vienti Apottiin	Kommentit
AAP-KT-1 Riskitesti	Demografisten tietojen ja muiden muuttumattomien tai harvoin muuttuvien tietojen haku lomakkeen esitäyttöä varten.	Riskitesti-lomakkeelle täytetyt tiedot ja testin antama tulos/palaute. Tiedonsiirto mahdollista myös rakenteisessa muo- dossa.	Esim. sokeritautiriski, sydäninfarktiriski, aivohal- vausriski, masennus-testi (BDI), sähköinen terveys- tarkastus, audit
AAP-KT-2 Omahoitosovellus	Omahoitoa tukevien potilastietojen haku, mm.: diagnoosit lääkitys, vara- tut ajat, laboratoriotulok- set, fysiologiset mittauk- set, rokotukset, terveys- ja hoitosuunnitelma.	Omat mittaus- ja havainto- tiedot, mm. verenpaine, verensokeri, paino, antikoagulaatio (INR), hengitys (PEF/FEV), kipu, oireet, kaatumiset, lääkkeiden otto, uni, ener- gian kulutus, liikunta, päihteiden käyttö, muistut- teet ja hälytykset.	Esim. Järjestelmä vaihtaa tietoja terveyden monito- rointiin tarkoitetun mobiili- sovelluksen palvelinkom- ponentin kanssa
AAP-KT-3 Omien tietojen siirto	Kertaluonteinen potilas- ja asiakastietojen haku.	Kertaluonteinen omien terveys- ja hyvinvointitieto- jen vienti.	Esim. tietojen siirto Apotin ja avoimen terveystaltion välillä.
AAP-KT-4 Tutkimuskäyttö	Potilas- ja asiakastietojen haku (usean asiakkaan tiedot).	Ulkopuolisesta tietoläh- teestä tuonti (esim. tutki- musrekisteri, geenirekiste- ri).	Sisältää myös virtuaalisen potilasryhmän terveystar- kastuksen.

AAP-KT-5 Päätöksenteon tuen tukisovellus Potilas- ja asiakastietojen haku päätöstukitoimintoa varten, mm. demografiset tiedot, diagnoosit, riskit, lääkitys, rokotukset, laboratoriotu- lokset, fysiologiset mitta- ukset, toimenpiteet, Päätöstukitoiminnon tuot- tamat tiedot (mm. muistut- teet) käyttöliittymään ja tietokantaan. Käyttötapaus koskee Apottiin sisällytettyä 3. osapuolen toteuttamaa päätöstukikomponenttia.

Käyttötapausten tarkemmat kuvaukset

Käyttötapaus 1 (AAP-KT-1): Riskitesti
Xxxxxxxx (roolit)	Asiakas/potilas, sosiaalihuollon tai terveydenhuollon ammattilainen
Kuvaus	Asiakas/potilas voi täyttää riskitestin tai sähköisen terveystarkastuksen ja saada sen pohjalta palautteen terveydentilastaan ja ohjeita terveytensä ylläpitoon. Asiak- kaan/potilaan suostumuksella riskitestin tai sähköisen terveystarkastuksen vasta- ukset ja palaute (esim. vastausten perusteella automaattisesti generoitu tilannear- vio tai toimintaohje) voidaan viedä myös ammattilaisen käyttöön.
Esiehdot	•Asiakkaalla/potilaalla on pääsy riskitestiin tai sähköiseen terveystarkastuk- seen, joko kolmannen osapuolen palvelimella tai Apotin asiointiympäris- tössä •Riskitesti tai sähköinen terveystarkastus on hyväksytty Apotin Avoimen Pal- velurajapinnan (AAP) käyttäjäksi •Asiakas on hyväksynyt riskitestiin tai sähköiseen terveystarkastukseen kir- jaamiensa tietojen ja niihin saadun palautteen siirron Apottiin (vaihtoehtoi- sesti asiakas antaa hyväksynnän vasta siirron yhteydessä)
Tyypillinen työnkulku	•Asiakas/potilas kirjautuu riskitestiin tai sähköiseen terveystarkastukseen (tai Apotti-palveluportaaliin) ja täyttää ao. lomakkeen •Asiakas/potilas saa palautteen sekä ohjeita hyvinvointinsa ja terveytensä yl- läpitoon •Asiakasta/potilasta pyydetään antamaan suostumus lomaketietojen ja palaut- teen siirtoon Apottiin (jos suostumusta ei ole annettu etukäteen) •Riskitesti- tai sähköinen terveystarkastus –palvelu siirtää lomaketiedot ja pa- lautteen Apottiin AAP:n ao. palvelua hyödyntämällä •Asiakas/potilas saapuu ammattilaisen vastaanotolle •Testin/tarkastuksen vastaukset käydään asiakkaan kanssa yhdessä läpi ja niitä hyödynnetään hoitosuunnitelman laatimisessa

	•Asiakas/potilas ohjeistetaan täyttämään testi/tarkastus uudestaan ennen seu- raavaa käyntiä, jolloin voidaan seurata asiakkaan/potilaan kokemia muu- toksia hyvinvoinnissaan. •Riskitestin tai sähköisen terveystarkastuksen tiedot ovat hyödynnettävissä Apotissa myös muissa käyttötarkoituksissa tiedon käyttötarpeen mukaan
Vaihtoehtoinen työnkulku / huomio	•Vastaavalla mekanismilla voidaan toteuttaa myös muita lomakkeeseen pe- rustuvia kyselyitä. Näin voidaan täydentää Apotin asiakasportaaliin sisältyviä kyselyitä.

Käyttötapaus 2 (AAP-KT-2): Omahoitosovellus
Xxxxxxxx (roolit)	Asiakas/potilas, Terveydenhuollon ammattilainen
Kuvaus	Verenpaineen omaseurannan tavoitteena on saada asiakas/potilas parempaan hoitotasapainoon esimerkiksi seuraamalla verenpainelääkityksen tai elämäntapa- muutoksen tehoa. Asiakas/potilas näkee omat mittauksensa mittaussovelluksen kautta. Tiedot siirtyvät myös Apottiin, jossa ammattilainen voi seurata niitä käyn- tien ja puhelinyhteydenottojen yhteydessä tai niiden ulkopuolella määritellyn pro- sessin mukaisesti. Omahoitosovellus voi pohjautua tai olla pohjautumatta terveys- taltioon.
Esiehdot	•Asiakkaan/potilaan kanssa on sovittu verenpainemittausten tekemisestä ko- tona ja hän on saanut tarvittavan opastuksen. •Asiakkaalla/potilaalla on käytössään mittaussovellus, joka on hyväksytty Apotin Avoimen Rajapinnan (AAP) käyttäjäksi •Asiakas/potilas on antanut hyväksynnän verenpainemittaustietojen siirrolle Apottiin
Tyypillinen työnkulku	•Asiakas/potilas tekee verenpainemittauksen kotona •Mittaustulos siirtyy mittaussovelluksen tietokantaan palvelimelle •Mittaussovellus siirtää verenpainemittauksen Apottiin käyttämällä AAP:n ao. rajapintapalvelua •Asiakas/potilas saapuu kontrollikäynnille tai on puhelimitse/sähköisesti yh- teydessä terveyskeskukseen tai lääkäri/sairaanhoitaja seuraa omahoidos- sa olevan asiakkaan/potilaan tilannetta •Lääkäri/sairaanhoitaja näkee asiakkaan/potilaan tekemät mittaukset Apotin käyttöliittymässä •Sovellus tukee toiminnallisuutta jossa ammattilainen arvioi ja kuittaa mittaus- tulokset ennen potilaskertomuksen osaksi siirtämistä. Tällöin lääkä- ri/sairaanhoitaja voi kirjata niihin liittyviä huomioita. Sovellus tukee myös

automaattista tietojen kirjautumista osaksi potilaskertomusta. •Asiakas/potilas hyödyntää omahoitosovelluksen toimintoja mittaustietojen katseluun kotona ja voi saada automaattista palautetta omahoitosovelluk- sen kautta

Vaihtoehtoinen työnkulku / huomio

•Mittaussovellus toteaa, että mittaustuloksen johdosta asiakkaan/potilaan tulisi olla yhteydessä terveydenhuollon ammattilaiseen välittömästi •Mittaussovellus kehottaa asiakasta olemaan yhteydessä terveyskeskukseen •Mittaussovellus lähettää ilmoituksen yhteydenottotarpeesta sairaanhoitajan työlistalle Apottiin käyttämällä AAP:n ao. rajapintapalvelua •Ilmoitus ohjautuu asiakkaan/potilaan seurannasta vastaavan sairaanhoitaja- tiimin työlistalle •Sairaanhoitaja on puhelinyhteydessä asiakkaaseen/potilaaseen ja käynnistää tarvittavat toimenpiteet (esim. kutsuu asiakkaan/potilaan kontrollikäynnille terveyskeskukseen)

Käyttötapaus 3 (AAP-KT-3): Omien tietojen siirto
Xxxxxxxx (roolit)	Asiakas/potilas, Terveydenhuollon ammattilainen
Kuvaus	Asiakas/potilas voi halutessaan siirtää potilaskertomustietojaan ulkoiseen terveys- taltiosovellukseen (ns. avoin terveystaltio). Tästä on hyötyä, kun asiakas/potilas haluaa yhdistää eri lähteistä peräisin olevat tietonsa yhteen tietovarastoon, jossa tiedot ovat helposti käytettävissä ja välitettävissä muiden hyvinvointisovellusten käyttöön. Mahdollisuus tietojen siirtoon on hyödyllinen myös tilanteessa, jossa asiakas muuttaa uudelle paikkakunnalle tai toiseen maahan.
Esiehdot	•Asiakkaalla/potilaalla on käytössään terveystaltiosovellus •Terveystaltiosovellus on hyväksytty AAP:n käyttäjäksi •Asiakas/potilas on hyväksynyt tietojensa siirron terveystaltiosovellukseen ja määritellyt siirrettävät tiedot
Tyypillinen työnkulku	•Asiakas/potilas käy lääkärin vastaanotolla. •Käynnin tuloksena syntyy/päivitetään joukko tietoja, mm. lääkelista, laborato- riotulokset, diagnoosit. •Asiakas/potilas kirjautuu kotona terveystaltiosovellukseen •Terveystaltiosovellus pyytää asiakkaalta/potilaalta luvan tietojen hakuun Apo- tista. •Jos asiakas/potilas antaa luvan tietojen hakuun, terveystaltiosovellus hakee päivittyneet tiedot AAP:n kautta (Jos asiakas/potilas on Terveystaltiosovel- luksessa antanut jatkuvan luvan tietojensa päivittämiseen, asiak-

	kaan/potilaan ei tarvitse enää erikseen antaa lupaa). •Asiakas/potilas näkee terveystaltiosovelluksessa vastaanottokäynnin yhtey- dessä syntyneet tietonsa yhdessä aikaisempien tietojensa kanssa.
Vaihtoehtoinen työnkulku / huomio	Vastaavasti on tarve siirtää terveystaltion sisältöä Apottiin joko osittain tai koko- naisuudessaan.

Käyttötapaus 4 (AAP-KT-4): Tutkimuskäyttö
Xxxxxxxx (roolit)	Tutkija
Kuvaus	Potilaskertomustietoja käytetään laajasti erilaisten tutkimusten aineistoina. Apotin Avoin Palvelurajapinta mahdollistaa tutkimuksessa tarvittavien tietojen siirron tutkijoiden käyttöön tehokkaasti ja tietoturvallisesti.
Esiehdot	•Tutkija on hankkinut tarvittavat luvat (mm. Eettisen toimikunnan luvan) tietty- jen potilaiden tiettyjen potilaskertomustietojen käyttöön. •Tutkija on saanut käyttönsä tarvittavat tunnisteet Hakusovelluksen käyttöön ja tietojen hakuun sekä ohjeistuksen tietojen hakemiseksi.
Tyypillinen työnkulku	•Tutkija kirjautuu Hakusovellukseen •Tutkija käynnistää tietojen haun ja syöttää pyydettäessä saamansa hakutun- nisteen. •Hakusovellus hakee tiedot AAP:lta ja tarjoaa Tutkijalle mahdollisuuden tallen- taa tiedot paikalliseen tietokantaan tai kannettavalle tallennusmedialle (Tutkijan tulee noudattaa saamissaan luvissa asetettuja ehtoja tietojen kä- sittelystä)
Vaihtoehtoinen työnkulku / huomio	Xxx Xxxxxx ei sisällä tietojen anonymisointia, tulee tämän toiminnallisuuden sisältyä hakusovellukseen, mikäli tarkoituksena on anonymisoidun tiedon käsittely. Tutkimustietokannasta voi olla myös tarpeen siirtää tietoja Apottiin

Käyttötapaus 5 (AAP-KT-5): Päätöstukisovellus
Xxxxxxxx (roolit)	Sosiaalihuollon tai terveydenhuollon ammattilainen, asiakas/potilas
Kuvaus	Päätöstukiratkaisut tuottavat muistutteita (varoituksia, ohjeita, linkkejä taustamate- riaaleihin) ammattilaiselle ja asiakkaalle/potilaalle perustuen sähköisessä asiakas- ja potilaskertomuksessa oleviin ja muihin asiakkaasta/potilaasta käytettävissä oleviin tietoihin sekä näyttöön perustuvaan tietämykseen. Päätöstukitoiminnallisuuksia sisältyy suoraan Järjestelmään, mutta myös ulkoisten päätöstuki-komponenttien hyödyntämisen tulee olla mahdollista.
Esiehdot	• Järjestelmään on integroitu päätöstuen mahdollistava toiminnallisuus (huom: edellyttää myös muita integraatioita kuin avoimen palvelurajapinnan)
Tyypillinen työnkulku	•Ammattilainen kirjaa lääkityslistalle uuden lääkkeen •Päätöstukitoiminto tarkastaa potilaan diagnoosien, muun lääkityksen sekä tutkimukseen perustuvan tiedon pohjalta, voiko uudella lääkkeellä olla hai- tallisia sivuvaikutuksia. •Tarvittaessa annetaan päätöstukimuistute, jossa varoitetaan mahdollisesta lääkkeen sivuvaikutuksesta •Lisäksi voidaan antaa ohjeita paremmin soveltuvasta lääkityksestä sekä link- kejä taustatietoihin
Vaihtoehtoinen työnkulku / huomio	•Ammattilainen kirjaa asiakkaalle/potilaalle uuden diagnoosin •Päätöstukitoiminto selvittää löytyykö diagnoosiin liittyvää hoitokaaviota ja tuo sen saataville käyttöliittymään •Päätöstukitoiminto osoittaa potilaskertomustietojen perusteella asiak- kaan/potilaan sen hetkisen tilanteen hoitopolulla •Päätöstukitoiminto voi myös tuottaa asiakkaalle/potilaalle itselleen tarkoitettu- ja muistutteita (esim. hoito-ohjeita). •Asiakkaalle/potilaalle tarkoitetut muistutteet viedään asiakkaan/potilaan omaan kansioon (jos tällainen on olemassa) Apotin palveluportaalissa