Tallenna luovutusilmoitus

Tallenna luovutusilmoitus -käyttötapausta käytetään, kun lokirekisterien säilytyspalveluun tallennetaan uusi sosiaalihuollon luovutusilmoitus. Sosiaalihuollon luovutusilmoitus tulee tallentaa seuraavissa tilanteissa:

  • Sosiaalihuollon organisaatio luovuttaa asiakastietoja toiselle sosiaalihuollon organisaatiolle muuten kuin Kanta-palvelujen kautta.
  • Sosiaalihuollon organisaatio luovuttaa asiakastietoja terveydenhuollon organisaatiolle muuten kuin Kanta-palvelujen kautta.
  • Sosiaalihuollon organisaatio luovuttaa asiakastietoja sosiaali- ja terveydenhuollon ulkopuoliselle viranomaiselle.
  • Sosiaalihuollon organisaatio luovuttaa asiakastietoja asiakkaalle tai hänen lailliselle edustajalleen.

Tilanteita, joissa luovutusilmoitus tulee tallentaa on kuvattu tarkemmin Kanta-palvelujen käsikirjan sosiaalihuollon toimijoille luvussa 11.4 Asiakastietojen luovuttaminen.

Jokaisesta asiakastietojen luovutustapahtumasta tehdään oma luovutusilmoituksensa. Samaan luovutusilmoitukseen kootaan kaikkien samassa luovutustapahtumassa luovutettujen asiakastietojen luovutusta koskevat tiedot.

Jos luovutetaan sosiaalihuollon yhteisen asian asiakkaiden tietoja, jokaisen asiakkaan tietojen luovuttamisesta tehdään oma luovutusilmoituksensa, joka tallennetaan lokirekisterien säilytyspalveluun.

Asiakastietojen luovutuksesta, josta tallennetaan luovutusilmoitus lokirekisterien säilytyspalveluun, ei laadita asiakaskertomusmerkintää Merkintä asiakastietojen luovuttamisesta.

Asiakastiedot luovuttaneen rekisterinpitäjän on ilmoitettava aina mihin asiakastietojen luovuttaminen perustuu. Asiakastietojen luovuttaminen perustuu joko säädökseen tai asiakkaan tai hänen laillisen edustajansa antamaan luovutuslupaan. Yhdessä luovutustapahtumassa on aina yksi luovutuksen peruste. Jos asiakastietoja luovutetaan samalle vastaanottajalle useammalla kuin yhdellä perusteella (esimerkiksi asiakkaan antaman luovutusluvan perusteella ja säädöksen perusteella), katsotaan luovutukset omiksi luovutustapahtumikseen, joista tallennetaan omat luovutusilmoituksensa.

Asiakastiedot luovuttaneen rekisterinpitäjän on ilmoitettava aina mihin käyttötarkoitukseen asiakastiedot on luovutettu. Asiakastietojen käyttötarkoitus ilmoitetaan Kansallisen koodistopalvelun koodistolla THL - Asiakastietojen käyttötarkoitus (1.2.246.537.6.3300.202201). Yhdessä tietojen luovutuksessa on aina yksi asiakastietojen käyttötarkoitus. Jos asiakastietoja luovutetaan samalle vastaanottajalle eri käyttötarkoituksiin, katsotaan luovutukset omiksi luovutustapahtumikseen, joista tallennetaan omat luovutusilmoituksensa.

Sosiaalihuollon luovutusilmoituksesta ei voi tallentaa uusia versioita.

Luovutusilmoituksen tallentamisen profiilit ja operaatiot

Luovutusilmoituksen tallentamisessa käytetään SocialWelfareServiceAuditEvent-, SocialWelfareServiceProvenance- ja SocialWelfareServiceBundle -profiileja. SocialWelfareServiceAuditEvent- ja SocialWelfareServiceProvenance -profiilien sisältö kuvataan Profiilit-osiossa. SocialWelfareServiceBundle -profiilin sisältö julkaistaan vuoden 2023 aikana.

Luovutusilmoituksen tallentavan järjestelmän ja lokirekisterien säilytyspalvelun käyttämät operaatiot on kuvattu kuvassa 1.

 

Kuva 1 Luovutusilmoituksen tallentamisen operaatiot

Normaali tapahtumankulku

  1. Järjestelmä muodostaa SocialWelfareServiceAuditEvent -profiilin mukaisen AuditEvent -resurssin. (V1)
  2. Järjestelmä allekirjoittaa AuditEvent-resurssin. (V2)
  3. Järjestelmä muodostaa SocialWelfareServiceProvenance -profiilin mukaisen Provenance-resurssin. (V3)
    • luovutusilmoituksen valmistumisen tila on "Arkistointivalmis".
  4. Järjestelmä muodostaa SocialWelfareServiceBundle -profiilin mukaisen Bundle-resurssin ja liittää siihen AuditEvent- ja Provenance -resurssit. (V4)
  5. Järjestelmä muodostaa Authorization token-operaation. (V5)
  6. Järjestelmä allekirjoittaa Authorization token-operaation. (V6)
  7. Järjestelmä lähettää operaation lokirekisterien säilytyspalveluun. (V7)
  8. Lokirekisterin säilytyspalvelu tallentaa AuditEvent- ja Provenance -resurssit.
  9. Lokirekisterien säilytyspalvelu lähettää järjestelmälle kuittauksen HTTP statuskoodilla.
    • Jos luovutusilmoituksen tallennus ei onnistu, lokirekisterien säilytyspalvelu palauttaa HTTP virhestatuskoodin sekä HTTP bodyssa OperationOutcome resurssi-instanssin, jolla ilmoitetaan tarkempi virhe.
  10. Käyttötapaus jatkuu järjestelmän oman logiikan mukaan.

Virhetilanteet

  1. AuditEvent-resurssin muodostaminen epäonnistuu.
  2. AuditEvent-resurssin allekirjoittaminen epäonnistuu.
  3. Provenance-resurssin muodostaminen epäonnistuu.
  4. Bundle-resurssin muodostaminen epäonnistuu.
  5. Authorization Token -operaation muodostaminen epäonnistuu.
  6. Authorization Token -operaation allekirjoittaminen epäonnistuu.
  7. Operaation lähettäminen epäonnistuu.