Brontekst bekijken van MedMij:Vissue-MM-3977/FHIR Patient Corrections

{{IssuePaginaWaarschuwing|MM-3977|MedMij:V6/FHIR_Patient_Corrections}}
__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:FHIR Implementation Guide: Patient Corrections {{VersieInfo|Dossierwijzigingsverzoek|release=V6}}}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]

=Introduction=
This page describes the process of filing correction requests on medical records. A correction request is initiated by a patient on an existing medical record and received by a healthcare provider.

This information standard is inspired by the international [https://build.fhir.org/ig/HL7/fhir-patient-correction/index.html HL7 Patient Corrections IG]. However, the first version of this information standard is more restricted than Patient Corrections; specifically, the possibility of doing follow-up on a correction request is omitted. Also, contrary to most other use cases for MedMij, no specific HCIM model has been identified for exchanging communication between patient (PHR) and practitioner (XIS).

This IG is a technical representation of the [[MedMij:Vprepub-6/OntwerpDossierwijzigingsverzoek|functional design]] and follows the principles of the general [[MedMij:IG:V1/FHIR_IG|MedMij FHIR IG]].

=Actors involved=
The table shows the relevant actors, systems and FHIR CapabilityStatements. The CapabilityStatements demonstrate the minimum conformance requirements for the described use cases.

{| class="wikitable"
! colspan="2" style="text-align:left; background-color: #4AB8A7; color: white; font-weight: bold;" | Actors
! colspan="2" style="text-align:left; background-color: #4AB8A7; color: white; font-weight: bold;" | Systems
! colspan="2" style="text-align:left; background-color: #4AB8A7; color: white; font-weight: bold;" | FHIR CapabilityStatements
|-
! style="text-align:left; |Name
! style="text-align:left; |Description
! style="text-align:left; |Name
! style="text-align:left; |Description
! style="text-align:left; |Name
! style="text-align:left; |Description
|-
| Patient
| The user of a personal healthcare environment
| PHR
| Personal health record
* sends a PatientCorrectionsCommunication
* receives a confirmation of receipt (OperationOutcome)
| rowspan="2" | {{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/dwv-SendReceive|nictiz.fhir.nl.r4.patientcorrections|title=CapabilityStatement: Send Receive}}
| rowspan="2" | FHIR client/server requirements 
|-
| Healthcare provider
| The user of a XIS
| XIS
| Healthcare information system
* receives a PatientCorrectionsCommunication
* returns a confirmation of receipt (OperationOutcome)
|}

=Boundaries and relationships=
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]

This FHIR implementation guide assumes that the PHR system is able to make a connection with the XIS and create resources. It does not provide information on finding the right XIS nor does it provide information about security. These infrastructure and interface specifications are described in the [https://www.medmij.nl/afsprakenstelsel/ 'MedMij Afsprakenstelsel'].

The MedMij use case for Patient Corrections overlaps partially with the uses cases described in the [https://build.fhir.org/ig/HL7/fhir-patient-correction/index.html HL7 Patient Corrections IG]. Therefore, this IG tries to align as closely as possible to the HL7 Patient Corrections IG. However, there are key differences that prevent the verbatim use:
* The current use case is more restricted.
* The profiles for the MedMij use case reference HCIM based profiles for common resources like Patient, Practitioner, PractitionerRole and Organization.
* This IG uses the OperationOutcome resource as a confirmation of receipt.
* The use case specific FHIR profiles (like Communication) are not derived but copied in order for them to align with other FHIR materials in the Dutch realm.
* {{fhir|mustSupport}} flags are not used in this IG.
* {{fhir|Bundle.type}}={{term|transaction}} and {{term|transaction-response}} are used instead of {{fhir|Bundle.type}}={{term|collection}}.

=Use case: send correction request on medical record=
This use case covers the process of sending a correction request on an existing medical record. Other use cases might be added in the future.

==Client sends PatientCorrectionsCommunication - PHR==
Because sending a correction request can consist of (one or more) Communication resource(s) along with supporting resources, a [https://www.hl7.org/fhir/http.html#transaction {{fhir|transaction}} interaction] is used. This allows for creating a set of resources in a single interaction and makes it possible to [[MedMij:IG:V1/FHIR_IG#Including_.22secondary.22_resources_when_sending_information|include referenced secondary resources]] if needed. Querying resources on the server before submitting the transaction Bundle (for instance: to be able to reference a Patient resource on the server) is not part of this FHIR IG, nor is it required that a client is able to reuse previously requested resources from use cases outside this IG.

A {{fhir|transaction}} interaction is performed by an HTTP POST command as shown:

<pre>POST [base]</pre>

The body of the POST submission is a Bundle with {{fhir|Bundle.type}}={{term|transaction}}. Each entry carries request details ({{fhir|Bundle.entry.request}}) that provides the HTTP details of the action in order to inform the system processing the transaction of what to do for the entry. (Note: {{fhir|Bundle.request}} is optional in FHIR, but SHALL be present, even for the resources which aren't Communications. See [[MedMij:IG:V1/FHIR_IG#Including_.22secondary.22_resources_when_sending_information|the overarching principles]] for more information.)

In order for the server to return each created resource in its entire form, the client SHOULD include the following [https://www.hl7.org/fhir/http.html#ops HTTP Prefer header]: {{fhir|<nowiki>Prefer: return=representation</nowiki>}}.

The resources included in the bundle SHALL conform to the profiles listed in the [[#FHIR_profiles|table below]].

Examples: 
{{Collapse top|Bundle containing one Communication resource}}
<syntaxhighlight lang="xml" style="max-height:400px; overflow: auto;">
<Bundle xmlns="http://hl7.org/fhir">
    <type value="transaction"/>
    <entry>
        <fullUrl value="urn:uuid:0bd97f28-a942-4cd4-a929-dd8391cbc83f"/>
        <resource>
            <Communication xmlns="http://hl7.org/fhir">
                <meta>
                    <profile value="http://nictiz.nl/fhir/StructureDefinition/dwv-PatientCorrectionsCommunication"/>
                </meta>
                <identifier>
                    <system value="urn:oid:2.16.840.1.113883.2.4.3.11.999.130.1.40"/>
                    <value value="4c6a73b0-bf86-43f4-bd98-2eed52d7161e"/>
                </identifier>
                <status value="completed"/>
                <category>
                    <coding>
                        <system value="https://hl7.org/fhir/uv/fhir-patient-correction/CodeSystem/PatientCorrectionCommunicationTypes"/>
                        <code value="medRecCxReq"/>
                        <display value="Correction request by the Patient or RelatedPerson"/>
                    </coding>
                </category>
                <subject>
                    <reference value="Patient/..."/>
                    ...
                </subject>
                <topic>
                    <text value="Wijzigingsverzoek: telefoonnummer"/>
                </topic>
                <sent value="2022-03-29T09:41:00Z"/>
                <recipient>
                    <reference value="Organization/..."/>
                    ...
                </recipient>
                <sender>
                    <reference value="Patient/..."/>
                    ...
                </sender>
                <payload>
                    <contentString value="Het telefoonnummer van mijn eerste contactpersoon klopt niet. Jaap Stiekema heeft het nummer 06-12345678."/>
                </payload>
            </Communication>
        </resource>
        <request>
            <method value="POST"/>
            <url value="Communication"/>
        </request>
    </entry>
</Bundle>
</syntaxhighlight>
{{Collapse bottom}}
{{Collapse top|Bundle containing multiple Communication resources and secondary resources}}
<syntaxhighlight lang="xml" style="max-height:400px; overflow: auto;">
<Bundle xmlns="http://hl7.org/fhir">
    <type value="transaction"/>
    <entry>
        <fullUrl value="urn:uuid:f8384e4e-6549-492a-b82a-b8f6101876b3"/>
        <resource>
            <Communication xmlns="http://hl7.org/fhir">
                <meta>
                    <profile value="http://nictiz.nl/fhir/StructureDefinition/dwv-PatientCorrectionsCommunication"/>
                </meta>
                <identifier>
                    <system value="urn:oid:2.16.840.1.113883.2.4.3.11.999.130.1.40"/>
                    <value value="0287d8e7-d47b-4465-9cff-fab15bb3dfd2"/>
                </identifier>
                <status value="completed"/>
                <category>
                    <coding>
                        <system value="https://hl7.org/fhir/uv/fhir-patient-correction/CodeSystem/PatientCorrectionCommunicationTypes"/>
                        <code value="medRecCxReq"/>
                        <display value="Correction request by the Patient or RelatedPerson"/>
                    </coding>
                </category>
                <subject>
                    <reference value="urn:uuid:c4e8dce5-0f69-42b2-b10b-f480cc377cd2"/>
                    <type value="Patient"/>
                    <display value="Willemijn Wijziger"/>
                </subject>
                <topic>
                    <text value="Allergie niet juist"/>
                </topic>
                <sent value="2022-03-29T09:41:00Z"/>
                <recipient>
                    <reference value="urn:uuid:a846de6b-a709-42e8-9a49-eaa359e666a5"/>
                    <type value="Organization"/>
                    <display value="Erasmus Medisch Centrum"/>
                </recipient>
                <sender>
                    <reference value="urn:uuid:c4e8dce5-0f69-42b2-b10b-f480cc377cd2"/>
                    <type value="Patient"/>
                    <display value="Willemijn Wijziger"/>
                </sender>
                <payload>
                    <contentString value="In mijn dossier staat dat ik allergisch ben voor bijengif, dit is niet juist. Kunt u dit verwijderen?"/>
                </payload>
            </Communication>
        </resource>
        <request>
            <method value="POST"/>
            <url value="Communication"/>
        </request>
    </entry>
    <entry>
        <fullUrl value="urn:uuid:6c2f1861-76bb-48fb-8a76-a80adfd2243f"/>
        <resource>
            <Communication xmlns="http://hl7.org/fhir">
                <meta>
                    <profile value="http://nictiz.nl/fhir/StructureDefinition/dwv-PatientCorrectionsCommunication"/>
                </meta>
                <identifier>
                    <system value="urn:oid:2.16.840.1.113883.2.4.3.11.999.130.1.40"/>
                    <value value="7c9e1076-4e13-4010-a166-7ca3fe6618fc"/>
                </identifier>
                <status value="completed"/>
                <category>
                    <coding>
                        <system value="https://hl7.org/fhir/uv/fhir-patient-correction/CodeSystem/PatientCorrectionCommunicationTypes"/>
                        <code value="medRecCxReq"/>
                        <display value="Correction request by the Patient or RelatedPerson"/>
                    </coding>
                </category>
                <subject>
                    <reference value="urn:uuid:c4e8dce5-0f69-42b2-b10b-f480cc377cd2"/>
                    <type value="Patient"/>
                    <display value="Willemijn Wijziger"/>
                </subject>
                <topic>
                    <text value="Mijn gewicht is fout"/>
                </topic>
                <sent value="2021-03-29T09:41:00Z"/>
                <recipient>
                    <reference value="urn:uuid:a846de6b-a709-42e8-9a49-eaa359e666a5"/>
                    <type value="Organization"/>
                    <display value="Erasmus Medisch Centrum"/>
                </recipient>
                <sender>
                    <reference value="urn:uuid:c4e8dce5-0f69-42b2-b10b-f480cc377cd2"/>
                    <type value="Patient"/>
                    <display value="Willemijn Wijziger"/>
                </sender>
                <payload>
                    <contentString value="Op 14 februari 2022 woog ik 72 kg en er staat dat ik 74 kg weeg, dit is fout."/>
                </payload>
            </Communication>
        </resource>
        <request>
            <method value="POST"/>
            <url value="Communication"/>
        </request>
    </entry>
    <entry>
        <fullUrl value="urn:uuid:287837d4-ae09-49b8-a4dd-07efac1e81fa"/>
        <resource>
            <Communication xmlns="http://hl7.org/fhir">
                <meta>
                    <profile value="http://nictiz.nl/fhir/StructureDefinition/dwv-PatientCorrectionsCommunication"/>
                </meta>
                <identifier>
                    <system value="urn:oid:2.16.840.1.113883.2.4.3.11.999.130.1.40"/>
                    <value value="3bb12830-8b93-4484-a595-97653a68f17c"/>
                </identifier>
                <status value="completed"/>
                <category>
                    <coding>
                        <system value="https://hl7.org/fhir/uv/fhir-patient-correction/CodeSystem/PatientCorrectionCommunicationTypes"/>
                        <code value="medRecCxReq"/>
                        <display value="Correction request by the Patient or RelatedPerson"/>
                    </coding>
                </category>
                <subject>
                    <reference value="urn:uuid:c4e8dce5-0f69-42b2-b10b-f480cc377cd2"/>
                    <type value="Patient"/>
                    <display value="Willemijn Wijziger"/>
                </subject>
                <topic>
                    <text value="Tijdelijk adres aanpassen"/>
                </topic>
                <sent value="2021-03-29T09:41:00Z"/>
                <recipient>
                    <reference value="urn:uuid:a846de6b-a709-42e8-9a49-eaa359e666a5"/>
                    <type value="Organization"/>
                    <display value="Erasmus Medisch Centrum"/>
                </recipient>
                <sender>
                    <reference value="urn:uuid:c4e8dce5-0f69-42b2-b10b-f480cc377cd2"/>
                    <type value="Patient"/>
                    <display value="Willemijn Wijziger"/>
                </sender>
                <payload>
                    <contentString value="Wij gaan tijdelijk op een ander adres wonen in verband met een verbouwing, kunt u mijn adres aanpassen naar: Knolweg 1000, 9999 XA Stitswerd."/>
                </payload>
            </Communication>
        </resource>
        <request>
            <method value="POST"/>
            <url value="Communication"/>
        </request>
    </entry>
    <entry>
        <fullUrl value="urn:uuid:c4e8dce5-0f69-42b2-b10b-f480cc377cd2"/>
        <resource>
            <Patient xmlns="http://hl7.org/fhir">
                <meta>
                    <profile value="http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient"/>
                </meta>
                <identifier>
                    <system value="urn:oid:2.16.840.1.113883.2.4.3.11.999.130.1.135"/>
                    <value value="123456789"/>
                </identifier>
                <name>
                    <use value="official" />
                    <text value="Willemijn Wijziger" />
                    <family value="Wijziger">
                        <extension url="http://hl7.org/fhir/StructureDefinition/humanname-own-name">
                            <valueString value="Wijziger" />
                        </extension>
                    </family>
                    <given value="Willemijn">
                        <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier">
                            <valueCode value="BR" />
                        </extension>
                    </given>
                </name>
            </Patient>
        </resource>
        <request>
            <method value="POST"/>
            <url value="Patient"/>
        </request>
    </entry>
    <entry>
        <fullUrl value="urn:uuid:a846de6b-a709-42e8-9a49-eaa359e666a5"/>
        <resource>
            <Organization xmlns="http://hl7.org/fhir">
                <meta>
                    <profile value="http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization"/>
                </meta>
                <identifier>
                    <system value="http://fhir.nl/fhir/NamingSystem/agb-z"/>
                    <value value="06020806"/>
                </identifier>
                <name value="Erasmus Medisch Centrum"/>
            </Organization>
        </resource>
        <request>
            <method value="POST"/>
            <url value="Organization"/>
        </request>
    </entry>
</Bundle>
</syntaxhighlight>
{{Collapse bottom}}
===Guidance on resource contents===
On top of the guidance in the [[MedMij:Vprepub-6/OntwerpDossierwijzigingsverzoek#Informatie-elementen|functional design]] and the descriptions in the relevant FHIR profiles, the list below provides direction on how to use the elements in the resources used in this information standard.

Examples of the resources below can be found on [https://simplifier.net/nictiz-r4-patientcorrections/~resources?category=Example Simplifier].

====PatientCorrectionsCommunication====
Every instance of PatientCorrectionsCommunication (Communication) SHALL contain at least the following elements upon initial creation:
* {{fhir|identifier}}: [[MedMij:IG:V1/FHIR_IG#Usage_of_the_.id.2C_.identifier_and_.fullUrl_elements_in_FHIR_instances|unique identifier]] for the purpose of data deduplication
* {{fhir|status}}: with fixed value {{term|completed}}
* {{fhir|category}}: with fixed value {{term|medRecCxReq}}
* {{fhir|subject}}: the patient that the correction request applies to
* {{fhir|topic}}: subject line, like the subject of an email
* {{fhir|sent}}: the date and time the correction request was sent
* {{fhir|recipient}}: the recipient of the correction request, healthcare provider and optionally (if known) the health professional
* {{fhir|sender}}: a reference to the sender of the correction request
* {{fhir|payload}}: the actual correction request message as a string

====Patient====
The Patient instance SHOULD contain at least the following elements:
* {{fhir|name}}: the patient's birth name

It is encouraged to include an internal hospital patient number using the {{fhir|identifier}} element, if known.

====HealthcareProvider====
The HealthcareProvider (Organization) instance SHOULD contain at least the following elements:
* {{fhir|name}}: the name of the healthcare provider, in MedMij context this name can be derived from the entry in the ZAL (healthcare providers list, Dutch: Zorgaanbiederslijst)

It is encouraged to include the organization's unique identifier like AGB or URA using the {{fhir|identifier}} element, if known.

====HealthProfessional====
The HealthProfessional (Practitioner/PractitionerRole) instance SHOULD contain at least the following elements:
* {{fhir|name}}: the name of the practitioner

It is encouraged to include a practitioner's unique identifier like AGB or BIG using the {{fhir|identifier}} element, if known.

==Server response - XIS==
The server returns an [[MedMij:IG:V1/FHIR_IG|HTTP Status code]] appropriate to the processing outcome and returns a Bundle, with {{fhir|Bundle.type}}={{term|transaction-response}}, that contains one entry for each entry in the request, in the same order, with the outcome of processing the entry. Because the client request contains the HTTP Prefer header {{fhir|<nowiki>Prefer: return=representation</nowiki>}}, the server SHOULD return a full version of all created resources.

{{ReminderBox|It is conceivable that future versions of this information standard will provide more detailed information on further processing and workflow using the Task resource, thus follow the international [https://build.fhir.org/ig/HL7/fhir-patient-correction/index.html HL7 Patient Corrections IG]. At this point in time, it is not expected that a XIS spawns a Task and creates a reference to this Task in {{fhir|Communication.about}}, nor is it expected that a PHR can resolve and process this Task reference.}}

Example:
<syntaxhighlight lang="xml" highlight="6,12">
<Bundle xmlns="http://hl7.org/fhir">
    <type value="transaction-response"/>
        <entry>
            <resource>
                <Communication xmlns="http://hl7.org/fhir">
                    <id value="a9f7a826-fd3f-444a-9457-0d444ee7a966"/><!-- ID assigned by the XIS after receiving this resource-->
                    <meta>
                        <profile value="http://nictiz.nl/fhir/StructureDefinition/dwv-PatientCorrectionsCommunication"/>
                    </meta>
                    <identifier>
                        <system value="urn:oid:2.16.840.1.113883.2.4.3.11.999.130.1.40"/>
                        <value value="4c6a73b0-bf86-43f4-bd98-2eed52d7161e"/><!-- Identifier assigned by the PHR upon initial POST -->
                    </identifier>
                    ...
                </Communication>
            </resource>
            ...
</Bundle>
</syntaxhighlight>

A server SHOULD provide additional information (an acknowledgment of receipt) on the received correction request(s) by adding an OperationOutcome to the response with {{fhir|OperationOutcome.severity}}={{term|information}}, {{fhir|OperationOutcome.code}}={{term|informational}} and the actual message on the {{fhir|OperationOutcome.details.text}} element.

{{ReminderBox|This IG does not cover the actual contents of the text in the OperationOutcome, as this text can be subject to agreements made in programmes like MedMij, VIPP 5 or between healthcare providers. This also applies to support for multiple languages (localization).}}

Example:
<syntaxhighlight lang="xml">
<OperationOutcome xmlns="http://hl7.org/fhir">
    <language value="nl-NL"/>
    <issue> 
        <severity value="information"/> 
        <code value="informational"/> 
        <details>  
            <text value="Uw wijzigingsverzoek is ontvangen, neem voor meer informatie contact op met uw zorgaanbieder. Bij levensbedreigende situaties belt u 112."/>     
        </details> 
    </issue>
</OperationOutcome>
</syntaxhighlight>

==RESTful interactions==
                                 ┌───┐                                                             ┌───┐
                                 │PHR│                                                             │XIS│
                                 └─┬─┘                                                             └─┬─┘
  ╔═══════════════════════════════╗│                                                                 │  
  ║Send a new correction request ░║│                                                                 │  
  ╚═══════════════════════════════╝│                                                                 │  
                                   │        Create (POST) Bundle containing Communication(s)         │  
                                   │────────────────────────────────────────────────────────────────>│  
                                   │                                                                 │  
                                   │Return Bundle with created Communication(s) and OperationOutcome │  
                                   │<─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ │  
                                 ┌─┴─┐                                                             ┌─┴─┐
                                 │PHR│                                                             │XIS│
                                 └───┘                                                             └───┘

=FHIR profiles=

{{MedMij:V2020.01/NoteBoxPackage|p1=nictiz.fhir.nl.r4.patientcorrections|v1Min=0.3.0-poc|p2=nictiz.fhir.nl.r4.nl-core|v2Min=0.5.0-beta1}}

{| class="wikitable"
! style="text-align:left; background-color: #4AB8A7; color: white; font-weight: bold;" | Profile name
! style="text-align:left; background-color: #4AB8A7; color: white; font-weight: bold;" | FHIR Resource
! style="text-align:left; background-color: #4AB8A7; color: white; font-weight: bold;" | HCIM EN
! style="text-align:left; background-color: #4AB8A7; color: white; font-weight: bold;" | Canonical URL
|-
| dwv-PatientCorrectionsCommunication
| Communication
| n/a
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/dwv-PatientCorrectionsCommunication|nictiz.fhir.nl.r4.patientcorrections}}
|-
| nl core Patient
| Patient
| [https://zibs.nl/wiki/Patient-v3.2(2020EN) Patient]
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core}}
|-
| nl core HealthcareProvider
| Organization
| [https://zibs.nl/wiki/HealthcareProvider-v3.4(2020EN) HealthcareProvider]
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core}}
|-
| nl core HealthProfessional Practitioner
| Practitioner
| rowspan="2" | [https://zibs.nl/wiki/HealthProfessional-v3.5(2020EN) HealthProfessional]
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core}}
|-
| nl core HealthProfessional PractitionerRole
| PractitionerRole
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core}}
|-
|}

=Release notes=
Release notes can be found on the [[MedMij:Vprepub-6/OntwerpDossierwijzigingsverzoek#Release_notes| functional design page]].

=Support=
For questions and change requests regarding this IG, please create a ticket in [https://bits.nictiz.nl/projects/MM BITS].