Patsiendi elulõpu tahteavaldus
0.1.0 - trial-use

Patsiendi elulõpu tahteavaldus, published by TEHIK. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/TEHIK-EE/ig-ee-pet/ and changes regularly. See the Directory of published versions

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Example: Example Instances from external systems

Example resources that are referenced in this IG, but are from external systems.

MPI patient example

Example instance of the patient from master patient index.

Behavior: Operation Definitions

These are custom operations that can be supported by and/or invoked by systems conforming to this implementation guide.

PET cancellation ($cancel)

UC-AHD-056: cancels a confirmed patient's end-of-life directive (PET). A new version with status entered-in-error is created. The operation accepts no input parameters and answers HTTP 200 with an empty body.

PET confirmation ($complete)

UC-AHD-055: confirms a patient's end-of-life directive (PET). Input is exactly one of: a digitally signed PET as a Binary (signedBinary) or a QuestionnaireResponse and Provenance collection Bundle for paper signing (bundle). Under the stage-1 mock configuration, the digital path parses the ASiC-E container without DigiDoc signature verification and stores it locally instead of DRIT. Where digital signing is not enabled, the digital path responds with HTTP 501.

Trusted person confirmation by a healthcare worker ($confirm)

UC-AHD-058: a healthcare worker adds and confirms a trusted person who signed on paper during the appointment. Input is a collection Bundle with the RelatedPerson and the paper-signing Provenance.

Trusted person invitation acceptance ($complete)

UC-AHD-060: the invitation recipient accepts the trusted person invitation with a digitally signed RelatedPerson (ASiC-E container). Under the stage-1 mock configuration, the operation parses the container without DigiDoc signature verification and stores it locally instead of DRIT. Where digital signing is not enabled, the operation responds with HTTP 501.

Trusted person invitation rejection ($reject)

UC-AHD-060 alternative flow 2.2.1: the invitation recipient rejects the trusted person invitation. The operation accepts no input parameters.

Behavior: Search Parameters

These define the properties by which a RESTful server can be searched. They can also be used for sorting and including related resources.

AhdCounselingLast

Custom parameter (UC-AHD-054): last=true returns only the chronologically latest valid counselling decision for the patient and linked persons.

AhdQuestionnaireResponseId

Search for trusted-person invitations (Task) and trusted persons (RelatedPerson) by PET (QuestionnaireResponse) id. The relation runs through the trusted person and is resolved by the PET search service, so expression is deliberately unset.

Structures: Resource Profiles

These define constraints on FHIR resources for systems conforming to this implementation guide.

AHD consultation result (Observation)

AHD consultation data stating whether the patient is allowed to sign their decision. If the consultant decides the patient should not be able to sign their document, the consultant must provide a reason.

AHD content (QuestionnaireResponse)

The actual content of the AHD and the patient's wishes

AHD data bundle (Bundle)

Bundle of data consisting of questionnaire response and the signature

AHD response signature (Binary)

Binary resource of the AHD questionnaire response in asice container

AHD signature data (Provenance)

Data about the signing process of the AHD questionnaire response. Provides info about when the signing occurred, whether the signer was the patient or a capable witness and the signature itself.

AHD trustee (RelatedPerson)

Patient can request a trustee who will represent thir wishes when the patient is incapable of doing so. Difference with witness: witness represents the patient in the AHD signing process when the trustee represents the patient's wishes when the AHD has activated.

AHD trustee request (Task)

The patient can request a person to be their representative in the AHD employing process. The request can be made by the patient or a healthcare practitioner and the performer will be the requested trustee.

AHD trustee's data bundle (Bundle)

Bundle of data consisting of information who the trustee is and their signature agreeing to be the patient's representative.

AHD trustee's signature (Binary)

Binary resource of the AHD RelatedPerson in asice container

AHD trustee's signature data (Provenance)

Data about the signing process when a person agrees to be a patient's trustee represeting their wishes.

AHD witness (RelatedPerson)

If the patient is physically incapable of filling out their AHD document and signing it (while being capable of decision-making), a witness must be provided who will fill out the content in paper form sign the document on their behalf. Difference with trustee: witness represents the patient in the AHD signing process when the trustee represents the patient's wishes when the AHD has activated.

Structures: Extension Definitions

These define constraints on FHIR data types for systems conforming to this implementation guide.

AHD content reference

Reference to the content that the trustee is connected with.

AHD trustee status (Code)

Status that shows whether the trustee has accepted the request. The statuses are ootel (Requested), kehtiv (Completed), tagasilükatud (Rejected), tühistatud (Cancelled).

AHD witness identity in MPI

Reference to the witness as a patient from MPI (will be made to Person eventually). This extension points to the witness, so that the witness's name and identity can be resolved from MPI

AHD witness reference

Reference to the witness if a witness was used in the AHD signing process

Digitally signed (Boolean)

Shows whether the AHD content was filled and signed digitally by the patient (via National Health Portal Terviseportaal) or as a paper format by the patient or a witness (digitalized by the practitioner via TJT).

Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

AHD QuestionnaireResponse status value set

Acceptable statuses for filled out AHD content. In-progress defines AHD that has been started but not finished. Completed states a finished AHD. Entered in error defines AHD that has been cancelled

AHD consultation status value set

Status values for consultation to see whether the consultation was completed (final) or cancelled (entered-in-error).

AHD language value set

Acceptable languages for AHD. Currently accepting three languages: Estonian, English, Russian

AHD signer role value set

Signer role values are used for Provenance resources in the AHD service. AHD trustee uses Provenance for the signature and the signer role will be the data subject. AHD content may be signed be either the patient (role data subject) or a witness if the patient is incapable (role legal).

AHD trustee request status value set

The status values for defining the completeness of the request (adding an AHD trustee). Subsection of the FHIR statuses showing if the request is pending (request was sent but has yet to be answered - Requested), if the request is finalized and agreed (Completed), or the request was rejected by the trustee (Rejected).

AHD trustee status value set

Status values defining the trustee (partly depends on the request). A subsection of FHIR statuses with Estonian designation. Requested = ootel, Completed = kehtiv, Rejected = tagasilükatud, Cancelled = tühistatud.

Example: Example Instances

These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.

AHD counselling result - Negative

Example instance of the counselling observation, where the HCP has deemed patient unfit to sign their AHD. Must provide the reason.

AHD counselling result - Positive

Example instance of the counselling observation, where the HCP has deemed patient fit to sign their AHD. Does not need to describe the observation further.

AHD questionnaire response

Example instance of the AHD content and its structure. The questionnaire itself is defined in QRE service.

AHD trustee

Example instance of the trustee (related person) who represents patient's wishes according to their AHD.

AHD witness

Example instance of the witness (related person) who represents the patient in the AHD signing.

SPD organization example

Example organization where the consultation takes place. Data will come from SPD service

SPD practitioner example

Example healthcare practitioner (doctor) who will conduct the consultation process. Data will come from SPD service