Mitätöi luovutusilmoitus

Mitätöi luovutusilmoitus -käyttötapausta käytetään, kun mitätöidään lokirekisterien säilytyspalveluun tallennettu sosiaalihuollon luovutusilmoitus. Luovutusilmoitus mitätöidään seuraavissa tilanteissa:

  • Luovutusta ei ole tapahtunut.
  • Luovutusilmoitus on kirjattu väärälle henkilölle.
  • Luovutusilmoitus on sisällöltään virheellinen.

Jos luovutusilmoituksessa on virheellisiä tietoja, luovutusilmoitus mitätöidään ja tämän jälkeen tallennetaan luovutustapahtumasta uusi luovutusilmoitus korjatuilla tiedoilla. Luovutusilmoituksen virheellisiä tietoja ei voi korjata tallentamalla siitä uutta versiota.

Luovutusilmoituksen voi mitätöidä Sosiaalihuollon asiakastiedon arkiston arkistonhoitajan käyttöliittymästä.

Luovutuslokitietoja mitätöidystä luovutusilmoituksesta ei näytetä OmaKannassa.

Normaali tapahtumankulku

Luovutusilmoituksen mitätöimisessä 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.

Esiehdot

  • Lokirekisterien säilytyspalvelussa on sosiaalihuollon luovutusilmoitus, joka voidaan mitätöidä.

Tapahtumankulku

  1. Järjestelmä hakee luovutusilmoituksen edellisen (ensimmäisen) version lokirekisterien säilytyspalvelusta.
  2. Järjestelmä muodostaa SocialWelfareServiceAuditEvent -profiilin mukaisen AuditEvent -resurssin. (V1)
  3. Järjestelmä allekirjoittaa AuditEvent-resurssin. (V2)
  4. Järjestelmä muodostaa SocialWelfareServiceProvenance -profiilin mukaisen Provenance-resurssin. (V3)
    • luovutusilmoituksen valmistumisen tila on "Poistettu".
  5. Järjestelmä muodostaa SocialWelfareServiceBundle -profiilin mukaisen Bundle-resurssin ja liittää siihen AuditEvent- ja Provenance -resurssit. (V4)
  6. Järjestelmä muodostaa Authorization token-operaation. (V5)
  7. Järjestelmä allekirjoittaa Authorization token-operaation. (V6)
  8. Järjestelmä lähettää operaation lokirekisterien säilytyspalveluun. (V7)
  9. Lokirekisterien säilytyspalvelu mitätöi AuditEvent- ja Provenance -resurssit.
  10. Lokirekisterien säilytyspalvelu lähettää järjestelmälle kuittauksen HTTP statuskoodilla.
    • Jos luovutusilmoituksen mitätöinti ei onnistu, lokirekisterien säilytyspalvelu palauttaa HTTP virhestatuskoodin sekä HTTP bodyssa OperationOutcome resurssi-instanssin, jolla ilmoitetaan tarkempi virhe.
  11. 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.