Tallenna, korvaa, mitätöi ajanvaraus

Käyttötapaus kuvaa seuraavat tilanteet:

1. Palveluntuottaja tallentaa ajanvarauksen omaan rekisteriinsä.
2. Palveluntuottaja tallentaa ajanvarauksen ostopalvelutilanteessa ostopalvelun järjestäjän rekisteriin.
3. Organisaation omassa rekisterissä olevan ajanvarauksen korvaaminen.
4. Ajanvarauksen korvaaminen ostopalvelutilanteessa. Ostopalvelutilanteessa ostopalvelun tuottaja tallentaa korvaavan ajanvarauksen ostopalvelun järjestäjän rekisteriin. Ostopalvelun tuottaja voi korvata oman organisaationsa ja ostopalvelun järjestäjän tuottamia ja versioimia ajanvarauksia.
5. Virheellisen ajanvarauksen mitätöinti. Virheellinen ajanvaraus omassa rekisterissä.
6. Virheellisen ajanvarauksen mitätöinti ostopalvelutilanteessa. Ostopalvelutilanteessa ostopalvelun tuottajan mitätöi ostopalvelun järjestäjän rekisterissä olevan ajanvarauksen. Ostopalvelun tuottaja voi mitätöidä oman organisaationsa ja ostopalvelun järjestäjän tuottamia ja versioimia ajanvarauksia.

• Tilanteissa A ja B: Ajanvarausasiakirjan muodostaja tuottaa ajanvarauksen ja toimittaa sen Potilastietovarantoon tallennettavaksi.

• Tilanteissa C ja D: Ajanvarausasiakirjan muodostaja tuottaa ajanvarauksesta uuden version ja toimittaa sen Potilastietovarantoon tallennettavaksi.

• Tilanteissa E ja F: Ajanvarausasiakirjan muodostaja tuottaa virheellisen ajanvarauksen mitätöinnin ja toimittaa sen Potilastietovarantoon tallennettavaksi.

• Tilanteissa A ja B: Käyttötapauksen lopputuloksena ajanvaraus on tallennettu Potilastietovarantoon ja lähettäneessä järjestelmässä on tieto tallennuksesta.

• Tilanteissa C ja D: Uusi versio ajanvarauksesta on tallennettu Potilastietovarantoon ja se on korvannut edellisen version.

• Tilanteissa E ja F: Virheellinen ajanvaraus on mitätöity Potilastietovarannosta.

Kaikissa tilanteissa on mahdollista toimittaa kerralla yhden ajanvarauksen tiedot. Tämä koskee myös sarja- ja moniajanvarauksia:

• Sarja-ajanvarauksessa toimitetaan kerralla yksi sarja-ajanvarauksen tapahtuma.
• Moniajanvarauksessa toimitetaan kerralla yksi moniajanvarauksen tapahtuma.

Käyttäjäroolit

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

Esiehdot

1. Tilanteessa A, B: Järjestelmässä on tehty uusi ajanvaraus. Ajanvarauksen tila on jokin ajanvarauksen Potilastietovarantoon tallennuksessa sallituista tiloista.

2. Tilanteissa C, D: Potilastietovarannossa olevaa ajanvarausta on muutettu Järjestelmässä. Ennen ajanvarauksen muuttamista Järjestelmä on hakenut muutettavan ajanvarauksen Potilastietovarannosta sen varmistamiseksi, että muutos tehdään ajanvarauksen viimeiseen versioon.

3. Tilanteissa E, F: Terveydenhuollon ammattihenkilö on mitätöinyt Järjestelmässä Potilastietovarannossa olevan ajanvarauksen.

4. Potilas on yksilöity järjestelmässä

• Tilanteissa A, C, E: henkilötunnuksella tai tilapäisellä yksilöintitunnuksella

• Tilanteissa B, D, F: henkilötunnuksella

  Kansalaisen tekemissä ajanvaraustoimenpiteissä potilas on yksilöity henkilötunnuksella.

2. Ajanvaraus on liitetty palvelutapahtumaan. Palvelutapahtuma on tallennettu samaan rekisteriin, johon ajanvaraus tallennetaan.
3. Tilanteissa B, D, F (ostopalvelu):

• Palvelutapahtumassa on yksilöity ostopalvelun valtuutus. [LT1]
• Ostopalvelun järjestäjän arkistoasiakirjat-rekisterissä on palvelutapahtumassa yksilöity ostopalvelun valtuutus, joka oikeuttaa ostopalvelun tuottajan tallentamaan ostopalvelun järjestäjän rekisteriin. [LT1]
• Ostopalvelun tuottajalla on tiedossa ostopalvelujen järjestäjän rekisteri, jota ostopalvelun valtuutus koskee ja johon ajanvaraus tallennetaan.

Ajanvarauksen tallentamisen profiilit ja operaatiot

• Tilanteissa A, B, C, D: Ajanvarauksen tallennuksessa ja korvauksessa käytetään AppointmentAppointment- ja AppointmentProvenance-profiileja.
• Tilanteissa E, F: Ajanvarauksen mitätöinnissä käytetään AppointmentMitatointiProvenance-profiilia.

Profiilien sisältö on kuvattu Profiilit ja laajennokset -sivulla.

Ajanvarauksen tallentavan järjestelmän ja Potilastietovarannon käyttämät operaatiot on kuvattu seuraavassa kuvassa:

Normaali tapahtumankulku

1. Tilanteissa A, B, C, D: Järjestelmä muodostaa AppointmentAppointment-profiilin mukaisen Appointment-resurssin. (V1)

   • Tilanteissa C, D (Ajanvarauksen korvaus):
     • Ajanvarauksen globaalisti yksilöivänä tunnuksena tulee käyttää Potilastietovarannon ajanvaraukselle tuottamaa yksilöintitunnusta, jonka Potilastietovaranto on palauttanut vastaussanomassa (Appointment.id).
     • Ajanvarauksen tunnisteen tulee olla sama kuin korvattavalla ajanvarauksella. Ajanvarauksen tunniste on tietosisältömäärittelyssä kuvattu ajanvarauksen yksilöivä tunniste (Appointment.identifier).
     • Potilaan henkilötietoja voidaan korjata. Esim. henkilötunnuksen vaihtuessa ajanvarauksen asiakkaan tiedoissa välitetään sekä vanha että uusi henkilötunnus. Ajanvarausta ei saa vaihtaa toiselle henkilölle.

2. 1. Tilanteissa A, B, C, D: Järjestelmä muodostaa AppointmentProvenance-profiilin mukaisen Provenance-resurssin. (V2)

      • Tilanteissa A (Omaan rekisteriin tallennus), C: (Omassa rekisterissä olevan ajanvarauksen korvaaminen): Järjestelmä tuottaa Provenance-resurssille seuraavat tiedot:
        • Resurssin rekisterinpitäjä on varattavasta palvelusta vastaavan palveluntuottajan rekisterinpitäjä
        • Resurssin tuottanut palveluntuottaja on tässä tilanteessa varattavasta palvelusta vastaava palveluntuottaja
      • Tilanteissa B (Ostopalvelun palveluntuottaja tallentaa ajanvarauksen ostopalvelun järjestäjän rekisteriin), D (Ostopalvelun tuottaja tallentaa korvaavan ajanvarauksen ostopalvelun järjestäjän rekisteriin): Järjestelmä tuottaa Provenance-resurssille seuraavat tiedot:
        • Resurssin rekisterinpitäjä on ostopalvelun järjestäjän rekisterinpitäjä
        • Resurssin tuottanut palveluntuottaja on tässä tilanteessa varattavasta palvelusta vastaava palveluntuottaja
      • Tilanteissa C (Omassa rekisterissä olevan ajanvarauksen korvaaminen), D (Ostopalvelun tuottaja tallentaa korvaavan ajanvarauksen ostopalvelun järjestäjän rekisteriin):
        • Uudessa versiossa voidaan muuttaa mitä tahansa muita kuvailutietoja lukuun ottamatta ajanvarauksen rekisterinpitäjää, rekisteriä ja rekisterin tarkennetta.
        • Ajanvarauksen korvauksen syy -tieto ratkaisee, ovatko ajanvarauksen aiemmat versiot Järjestelmän haettavissa Potilastietovarannosta. Ajanvarauksen korvauksen syy voi olla:
          • Asiakirjan korjaaminen tai päivittäminen: 1, korjaus
          • Asiakirjan korjaus: 3, korjaus siten, että vanhat versiot merkitään käytöstä poistetuiksi

   2. Tilanteissa E, F: Järjestelmä muodostaa MitatointiProvenance-profiilin mukaisen Provenance-resurssin. (V2)

      • Valmistumisen tilan tulee olla ’Poistettu’.
      • Ajanvarauksen korvauksen syy -tieto ratkaisee, ovatko ajanvarauksen aiemmat versiot Järjestelmän haettavissa Potilastietovarannosta. Ajanvarauksen korvauksen syy voi olla:
        • Asiakirjan mitätöiminen: 2, mitätöinti
        • Asiakirjan mitätöiminen: 4, mitätöinti siten, että vanhat versiot merkitään käytöstä poistetuiksi
3. 1. Tilanteissa A, B, C, D: Järjestelmä muodostaa Bundle-resurssin ja liittää siihen Appointment- ja Provenance -resurssit. (V3)
   2. Tilanteissa E, F: Järjestelmä muodostaa Bundle-resurssin ja liittää siihen Provenance-resurssin. (V3)

4. Järjestelmä allekirjoittaa Bundle-resurssin.(V4)

5. Järjestelmä muodostaa Kanta JSON Web Tokenin. (V5)

6. Järjestelmä allekirjoittaa Kanta JSON Web Tokenin. (V6)

7. Järjestelmä lähettää transaction-tyyppisen Bundle-resurssin ja Kanta JSON Web Tokenin Potilastietovarantoon. (V7)

8. Potilastietovaranto tallentaa Appointment- ja Provenance -resurssit sekä Bundle-resurssin.

9. Potilastietovaranto lähettää järjestelmälle kuittauksen transaction-response.

• Jos ajanvarauksen tallennus ei onnistu, Potilastietovaranto palauttaa HTTP virhestatuskoodin sekä HTTP bodyssa OperationOutcome resurssi-instanssin, jolla ilmoitetaan tarkempi virhe. OperationOutcome-sivulla on kuvattu tarkemmin, miten Potilastietovaranto palauttaa virheilmoitukset OperationOutcome-resussilla.

10. Käyttötapaus jatkuu järjestelmän oman logiikan mukaan.

Virhetilanteet

1. Appointment-resurssin muodostaminen epäonnistuu.
2. Provenance-resurssin muodostaminen epäonnistuu.
3. Bundle-resurssin muodostaminen epäonnistuu.
4. Bundle-resurssin allekirjoittaminen epäonnistuu.
5. Kanta JSON Web Token -operaation muodostaminen epäonnistuu.
6. Kanta JSON Web Token -operaation allekirjoittaminen epäonnistuu.
7. Operaation lähettäminen epäonnistuu.

Lisätiedot

LT1 Ostopalveluratkaisun siirtymäaikana palvelutapahtuma on voitu tallentaa myös ilman ostopalvelun valtuutuksen tunnistetta. Ostopalvelun järjestäjän arkistoasiakirjat-rekisterissä on oltava kuitenkin ostopalvelun valtuutus, joka oikeuttaa ostopalvelun tuottajan tallentamaan ostopalvelun järjestäjän rekisteriin.