2 VRK Kuolinilmoitus Sanomat Topic
Introduction

Tässä osiossa kuvataan Väestörekisterikeskukselle lähetettävän kuolinilmoituksen päivityssanoman ja siihen liittyvien Interaktioiden rakenne.

Sairaalan lähettämä kuolinilmoitussanoma on "VRK Death Update", jonka RMIM on PRPA_RM010001FI01 ja Message Type PRPA_MT010001FI01 ja sanoman lähettämiseen liittyy Interaktio "VRK Death Updete Request" (PRPA_IN010001FI01).
Lisäksi kuvataan Väestörekisterikeskuksen Update sanoman onnistuneen käsittelyn jälkeen lähettämän positiivisen sovellustason kuittaussanoman rakenne ja siihen liittyvä Interaktio "VRK Death Updete Request Accepted" (PRPA_IN110001FI01) sekä epäonnistuneen käsittelyn jälkeisen negatiivisen sovellustason kuittaussanoman rakenne ja siihen liittyvä Interaktio "VRK Death Updete Request Rejected" (PRPA_IN120001FI01).
Sanoman käsittely voi epäonnistua teknisen syyn vuoksi tai koska sanoman identifioimaa henkilöä ei löydy tai henkilön tiedot ovat muutoin virheelliset.

2.1 Storyboards

Go To Top

▼ Storyboards (Sorted by Title)
| VRK Kuolinilmoitus(PRPA_ST010001FI01)
▼ Storyboards (Sorted by Structured Sort Name)
| Vrkdeathupdate Request(PRPA_ST010001FI01)
▼ Storyboards (Sorted by Display Order)
| VRK Kuolinilmoitus(PRPA_ST010001FI01)

Reference

For details on the interpretation of this section, see the storyboard discussion in the Version 3 Guide.

2.1.1 VRK Kuolinilmoitus (PRPA_ST010001FI01)
Purpose

Potilas on kuollut sairaalassa ja sairaalan lääkäri on todennut kuoleman. Kuolintodistus voidaan kirjoittaa ja hautauslupa on annettu. Sairaalasta lähetetään kuolinilmoitussanoma Väestörekisterikeskukseen ja sanomassa ilmoitetaan potilaan nimi ja henkilötunnus, arkistointinumero, kuolinaika, kuolinilmoituksen tehneen lääkärin SV-numero ja tieto, että hautauslupa on annettu. Väestörekisterikeskus lähettää kuolinilmoitussanoman kuittaussanoman joko onnistuneesta tai epäonnistuneesta käsittelystä. Sanoman käsittely voi epäonnistua teknisen syyn vuoksi tai koska sanoman identifioimaa henkilöä ei kyetä tunnistamaan tai henkilön tiedot ovat muutoin virheelliset

Alla olevassa kuvassa PRPA_AR010000FI01 kuvaa sairaalaa, joka lähettää kuolinilmoitussanoman VRK:lle (PRPA_AR020000FI01) Sanoma lähetetään osana Interaktiota PRPA_IN010000FI01, johon vastataan Accept Ack sanomalla (= Interaktio MCCI_IN000002UV01) jos lähetetyn sanoman Message Wrapperin acceptAckCode kentässä pyydetään Accept Ack kuittausta. Nuoli on katkoviiva koska sanoma on ehdollinen. Accept Ack kuittaukseen ei lähetetä enää kuittausta vaikka sen onkin teknisesti oma Interaktio.
HL7 v3:ssa vastaanottajan on kyettävä vastaamaan tarvittaessa jokaiseen Interaktioon MCCI_IN000002UV01 Interaktiolla (eli lähettämään Accept Ack kuittaus) vaikka sitä ei ole merkitty receiver responsibilities osioon.

Kuvan alaosassa on esitetty nuolilla sovellustason kuittaussanomiin liittyvät Interaktiot PRPA_IN110000FI01 (positiivinen sovellustason kuittaus) ja PRPA_IN120000FI01 (negatiivinen sovellustason kuittaus). Sovellustason kuittaussanomaan vastataan Accept Ack sanomalla pyydettäessä kuten varsinaiseen päivityssanomaan.

Diagram

Interaction List
VRK Death Update Request | PRPA_IN010001FI01

2.2 Application Roles

▼ Application Roles (Sorted by Artifact Code)
| VRK Update Requester w/ Accept Ack (PRPA_AR010000FI01)
| VRK Update Fulfiller w/ Accept Ack (PRPA_AR020000FI01)
▼ Application Roles (Sorted by Structured Sort Name)
| Vrkdeathupdate Request Comprehensive Fulfiller (with Accept Ack) (PRPA_AR020000FI01)
| Vrkdeathupdate Request Comprehensive Placer (with Accept Ack) (PRPA_AR010000FI01)
▼ Application Roles (Sorted by Display Order)
| VRK Update Requester w/ Accept Ack(PRPA_AR010000FI01)
| VRK Update Fulfiller w/ Accept Ack(PRPA_AR020000FI01)

Reference

For details on the interpretation of this section, see the discussion of application roles and their relationships in the Version 3 Guide.

2.2.1 VRK Update Requester w/ Accept Ack (PRPA_AR010000FI01)
Description

Structured Name: | Vrkdeathupdate Request Comprehensive Placer (with Accept Ack)

VRK Update Requester on organisaatio, joka lähettää tietojen päivityssanoman (Update) Väestörekisterikeskukselle ja vastaanottaa mahdollisen vastaussanoman. Tämä osapuoli vastaanottaa vastaanottokuittauksen (Accept Ack) välittömästi päivityssanoman lähetyksen jälkeen ja lahettää vastaanottokuittauksen sovellustason vastaussanoman vastaanoton jälkeen mikäli vastaanottokuittausta pyydetään.

Toistaiseksi on toteutettu vain kuolinilmoitussanoma ja sen vastaussanomat.

2.2.2 VRK Update Fulfiller w/ Accept Ack (PRPA_AR020000FI01)
Description

Structured Name: | Vrkdeathupdate Request Comprehensive Fulfiller (with Accept Ack)

VRK Update Fulfiller on Väestörekisterikeskus, joka vastaanottaa tietojen päivityssanoman (Update) ja lähettää vastaussanoman tietojen päivityksen onnistumisesta. Tämä osapuoli lähettää vastaanottokuittauksen (Accept Ack) välittömästi päivityssanoman vastaanoton jälkeen ja vastaanottaa vastaanottokuittauksen sovellustason vastaussanoman lähetyksen jälkeen mikäli vastaanottokuittausta pyydetään.

2.3 Trigger Events

▼ Trigger Events (Sorted by Title)
| VRK Death Update Request(PRPA_TE100000FI01)
| VRK Death Update Request Accepted(PRPA_TE010000FI01)
| VRK Death Update Request Rejected(PRPA_TE020000FI01)
▼ Trigger Events (Sorted by Structured Sort Name)
| Vrkdeathupdate Event Activate Confirmation(PRPA_TE010000FI01)
| Vrkdeathupdate Event Activate Rejection(PRPA_TE020000FI01)
| Vrkdeathupdate Event Activate Request(PRPA_TE100000FI01)
▼ Trigger Events (Sorted by Display Order)
| VRK Death Update Request(PRPA_TE100000FI01)
| VRK Death Update Request Accepted(PRPA_TE010000FI01)
| VRK Death Update Request Rejected(PRPA_TE020000FI01)

Reference

For details on the interpretation of this section, see the discussion of trigger events in the Version 3 Guide.

2.3.1 VRK Death Update Request (PRPA_TE100000FI01)
Description

Structured Name: | Vrkdeathupdate Event Activate Request
Type: | User request

"VRK Death Update Request" trigger event ilmoittaa että tietoja potilaan kuolemasta lähetetään Väestörekisterikeskukseen

2.3.2 VRK Death Update Request Accepted (PRPA_TE010000FI01)
Description

Structured Name: | Vrkdeathupdate Event Activate Confirmation
Type: | Interaction based

"VRK Death Update Request Accepted" trigger event ilmoittaa että henkilön tiedot on päivitetty onnistuneesti Väestörekisterikeskukseen

2.3.3 VRK Death Update Request Rejected (PRPA_TE020000FI01)
Description

Structured Name: | Vrkdeathupdate Event Activate Rejection
Type: | Interaction based

"VRK Death Update Request Rejected" trigger event ilmoittaa että tietojen päivitys Väestörekisterikeskukseen epäonnistui joko teknisen/data virheen vuoksi tai koska kyseistä henkilöä ei kyetä tunnistamaan tai tiedot ovat muutoin virheelliset.

2.4 Refined Message Information Models

▼ Refined Message Information Models (Sorted by Title)
| VRK Death Update(PRPA_RM010001FI01)
▼ Refined Message Information Models (Sorted by Structured Sort Name)
| Vrkdeathupdate Event Activate(PRPA_RM010001FI01)
▼ Refined Message Information Models (Sorted by Display Order)
| VRK Death Update(PRPA_RM010001FI01)

Reference

For details on the interpretation of this section, see the description of RMIMs in the Version 3 Guide.

2.4.1 VRK Death Update (PRPA_RM010001FI01)

Diagram

Link to wide graphic with hyperlinks (opens in a new window)
Description

Parent: | Patient Administration (PRPA_DM000000UV01)

VRK Death Update R-MIM kuvaa kuolinilmoitussanomassa ja sen kuittaussanomissa kaytettävän payloadin rakenteen. Kuittaussanomissa palautetaan pyyntösanoman payload, jonka VRKUpdateRequest luokan statusCode on muuttunut. Kuolinilmoitussanomassa VRKUpdateRequest luokan statusCode="active" , OK kuittaussanomassa statusCode="completed" ja virhekuittaussanomassa statusCode="aborted".
R-MIM:in luokkien ja niiden attribuuttien tarkka rakenne sekä käytettävät koodistot ja XML rakenteet on kuvattu taulukossa PRPA_HD010001FI01

Contained Hierarchical Message Descriptions
Vrkdeathupdate Event Activate | PRPA_HD010001FI01

2.5 Hierarchical Message Descriptions

▼ Hierarchical Message Descriptions (Sorted by Title)
| VRK Death Update(PRPA_HD010001FI01)
▼ Hierarchical Message Descriptions (Sorted by Structured Sort Name)
| Vrkdeathupdate Event Activate(PRPA_HD010001FI01)
▼ Hierarchical Message Descriptions (Sorted by Display Order)
| VRK Death Update(PRPA_HD010001FI01)

Reference

For details on the interpretation of this section, see the description of HMDs in the Version 3 Guide.

2.5.1 VRK Death Update (PRPA_HD010001FI01)
Description

Tämä HMD kuvaa kuolintietojen päivityssanoman rakenteen. Päivityssanomassa VrkUpdateRequest luokan statusCode attribuutti on "active", sovellustason kuittaussanomassa palautetaan sama payload sanoma mutta statusCode saa arvon "completed" onnistuneen käsittelyn jälkeen ja arvon "aborted" epäonnistuneen käsittelyn jälkeen. Sanoman yksityiskohtainen rakenne selviää taulukosta, jonne on linkki alla olevasta ikonista.

Base Hierarchical Message Description

Message Type List
Vrkupdate Request Activate | PRPA_MT010001FI01 |

2.6 Interactions

▼ List of Interactions (Sorted by Title)
| VRK Death Update Request(PRPA_IN010001FI01)
| VRK Death Update Request Accepted(PRPA_IN110001FI01)
| VRK Death Update Request Rejected(PRPA_IN120001FI01)
▼ List of Interactions (Sorted by Structured Sort Name)
| Vrkdeathupdate Event Activate Confirmation(PRPA_IN110001FI01)
| Vrkdeathupdate Event Activate Rejection(PRPA_IN120001FI01)
| Vrkdeathupdate Event Activate Request(PRPA_IN010001FI01)
▼ List of Interactions (Sorted by Display Order)
| VRK Death Update Request(PRPA_IN010001FI01)
| VRK Death Update Request Accepted(PRPA_IN110001FI01)
| VRK Death Update Request Rejected(PRPA_IN120001FI01)

Reference

For details on the interpretation of this section, see the definition of Interactions in the Version 3 Guide.

2.6.1 VRK Death Update Request (PRPA_IN010001FI01)
Description

Structured Name: | Vrkdeathupdate Event Activate Request

PRPA_IN010001FI01 Interaktio tapahtuu kun henkilön kuolemasta tallennetaan tieto Väestörekisterikeskukseen. "VRK Update Requester" (Sairaala) lähettää VRK Death Update sanoman "VRK Update Fulfiller":lle (Väestörekisterikeskukselle)

Käsittelyn onnistumisesta riippuen Väestörekisterikeskus aloittaa joko PRPA_IN110001FI01 interaktion (onnistunut käsittely) tai PRPA_IN120001FI01 interaktion (epäonnistunut käsittely). Nämä on määritelty Receiver Responsibilities osiossa.
Lisäksi vastaanottaja lähettää Accept Ack kuittauksen (Ineraktio MCCI_IN000002UV01) mikäli lähettäjä sellaista pyytää.

Esimerkki: PRPA_IN010001FI01.xml

Trigger Event | VRK Death Update Request | PRPA_TE100000FI01
Transmission Wrapper | Send Message Payload | MCCI_MT000100UV01
Control Act Wrapper | Trigger Event Control Act | MCAI_MT700201UV01
Message Type | VRK Death Update | PRPA_MT010001FI01

Receiver Responsibilities
Reason | Trigger Event | Interaction
Tietojen päivitys onnistui | PRPA_TE010000FI01 | PRPA_IN110001FI01
Tietojen päivitys epäonnistui - henkilön tiedot virheelliset, tekninen tai datavirhe | PRPA_TE020000FI01 | PRPA_IN120001FI01

Sending and Receiving Roles
Sender | VRK Update Requester w/ Accept Ack | PRPA_AR010000FI01
Receiver | VRK Update Fulfiller w/ Accept Ack | PRPA_AR020000FI01

2.6.2 VRK Death Update Request Accepted (PRPA_IN110001FI01)
Description

Structured Name: | Vrkdeathupdate Event Activate Confirmation

PRPA_IN110001FI01 Interaktio tapahtuu kun Väestörekisterikeskuksessa tietojen päivitys onnistuu. "VRK Update Fulfiller" (Väestörekisterikeskus) lähettää vastaussanoman "VRK Update Requester":lle (sairaala) ja vastaanottaa vastaanottokuittauksen (Accept Ack) mikäli sellaista pyydetään. Vastaussanoma payloadina palautetaan pyynnön payload siten että VrkUpdateRequest luokan statusCode on onnistuneen käsittelyn jälkeen "completed". Käsittelyn onnistuminen näkyy myös suoraan vastaussanoman Message Wrapperin acknowledgement luokan typeCode:sta.

Esimerkki: PRPA_IN110001FI01.xml

Trigger Event | VRK Death Update Request Accepted | PRPA_TE010000FI01
Transmission Wrapper | Application Level Acknowledgement | MCCI_MT000300UV01
Control Act Wrapper | Trigger Event Control Act | MCAI_MT700201UV01
Message Type | VRK Death Update | PRPA_MT010001FI01

Sending and Receiving Roles
Sender | VRK Update Fulfiller w/ Accept Ack | PRPA_AR020000FI01
Receiver | VRK Update Requester w/ Accept Ack | PRPA_AR010000FI01

2.6.3 VRK Death Update Request Rejected (PRPA_IN120001FI01)
Description

Structured Name: | Vrkdeathupdate Event Activate Rejection

PRPA_IN120001FI01 Interaktio tapahtuu kun tietojen päivitys epäonnistuu Väestörekisterikeskuksessa joko teknisen syyn vuoksi tai koska sanomassa olevat henkilön tiedot ovat virheelliset. "VRK Update Fulfiller" (Väestörekisterikeskus) lähettää vastaussanoman "VRK Update Requester":lle (sairaala) ja vastaanottaa vastaanottokuittauksen (Accept Ack) mikäli sellaista pyydetään. Vastaussanoma payloadina palautetaan pyynnön payload siten että VrkUpdateRequest luokan statusCode on epäonnistuneen käsittelyn jälkeen "aborted". Käsittelyn epäonnistuminen näkyy myös suoraan vastaussanoman Message Wrapperin acknowledgement luokan typeCode:sta.

Sanoman virhetieto välitetään Control Act Wrapperin reasonOf/DetectedIssueEvent rakanteessa. Ks Control Act Infrastructure osio.

Esimerkki: PRPA_IN120001FI01.xml

Trigger Event | VRK Death Update Request Rejected | PRPA_TE020000FI01
Transmission Wrapper | Application Level Acknowledgement | MCCI_MT000300UV01
Control Act Wrapper | Trigger Event Control Act | MCAI_MT700201UV01
Message Type | VRK Death Update | PRPA_MT010001FI01

Sending and Receiving Roles
Sender | VRK Update Fulfiller w/ Accept Ack | PRPA_AR020000FI01
Receiver | VRK Update Requester w/ Accept Ack | PRPA_AR010000FI01