Patient Request for Corrections Implementation Guide
1.0.0 - STU 1 Ballot International flag

Patient Request for Corrections Implementation Guide, published by HL7 International - Patient Empowerment Workgroup. This is not an authorized publication; it is the continuous build for version 1.0.0). This version is based on the current content of https://github.com/HL7/fhir-patient-correction/ and changes regularly. See the Directory of published versions

Resource Profile: Patient Correction Communication

Official URL: http://hl7.org/fhir/uv/patient-corrections/StructureDefinition/patient-correction-communication Version: 1.0.0
Draft as of 2023-09-11 Computable Name: PatientCorrectionCommunication

A Communication between a patient and a fulfiller relating to a patient correction request.

This is the profile for the Patient Correction Communication, which is used for back and forth conversation about a patient’s request for correction to their medical record. Each Patient Correction Communication resource instance represents a message in the bidirectional conversation needed to complete a patient’s request for correction to their medical record or for logging their disagreement to a correction denial. This profile sets minimum expectations for the Communication resource to support this workflow. It is expected to be used in conjunction with the Patient Correction Task profile.

Mandatory and Must Support data elements

The following data-elements must always be present (Mandatory) definition]) or must be supported if the data is present (Must Support) definition). They are presented below in a simple human-readable explanation. Profile specific guidance is provided as well. The Formal Profile Definition below provides the formal summary, definitions, and terminology requirements. Refer to the Examples section of the guide for example resources provided in the context of an example workflow.

Each implementation of PatientCorrectionCommunication must provide:

  1. id: An id
  2. status: fixed to “completed”
  3. category: indicates whether it’s a “Request for Correction” or “Log Disagreement” process
  4. subject: the person whose record is to be corrected
  5. sender: who is sending this communication
  6. recipient: who is receiving this communication
  7. sent: date/time communication was sent
  8. about: When the initial Communication request for correction resource is created by the Requester, Communication.about will be empty. When the Fulfiller spawns a Task to support the request, the Fulfiller sets Communication.about to reference the spawned Task that represents the entire request for correction or log disagreement process. On all other Communication resources, Communication.about references the Communication resource that contained the initial request. When a Log Disagreement Task is created, the Fulfiller will update the Communication containing the Log Disagreement request such that Communication.about references the Log Disagreement Task as well as the original correction request Communication.
  9. topic: a heading/subject line for the message being sent. Could be thought of as the subject line in an email thread.
  10. inResponseTo: points to the prior Communication resource in a conversation thread.
  11. Payload: contains the actual message being communicated, including any attachments or references.

Profile-specific implementation guidance

  • If the Communication resource represents the start of a Request for Correction or Log Disagreement process, Communication.about will reference the Task representing the overall associated Fulfiller process. On the start of a Log Disagreement, Communication.about will also reference the Communication resource of the initial correction request that is being disagreed with.
  • Additional Communication resources are created to represent each component of the back and forth conversation between the Requester and Fulfiller. The sender and recipient is set appropriately based on the direction of the conversation. All Communication resources are stored and queryable on the Fulfiller.
  • The Communication resources associated with a request for correction or log disagreement can be assembled into a conversation by first referring to the Communication of the original request, and then finding any Communication resources that reference it in the about field. If there are any threads of conversation, these are connected via Communication.inResponseTo.

Usage:

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

This structure is derived from Communication

NameFlagsCard.TypeDescription & Constraintsdoco
.. Communication 0..*CommunicationA record of information transmitted from a sender to a receiver
... partOf S0..1Reference(Patient Correction Communication)Initial Patient Correction Communication resource for this request.
... inResponseTo S0..1Reference(Patient Correction Communication)Reply to
... status 1..1codeFixed: completed.
Required Pattern: completed
... subject S1..1Reference(Patient)The Patient that the correction request or the log disagreement applies to.
... topic S0..1CodeableConceptA heading/subject line for the message being sent.
... Slices for about 0..*Reference(Resource)Resources that pertain to this communication
Slice: Unordered, Open by type:reference
.... about:correctionTask S0..1Reference(Patient Correction Task)Patient Correction Task requesting a correction.
... sent 1..1dateTimeWhen this communication was sent
... recipient S1..*Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | CareTeam | HealthcareService)Message recipient: either a Requestor or a Fulfiller
... sender S1..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | HealthcareService)Message sender: either a Requestor or a Fulfiller
... payload S0..*BackboneElementContents of this communication.
... note 0..*AnnotationNon-actionable notes about this communication.

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet
Communication.categoryrequiredPatientCorrectionCommunicationTypesVS
NameFlagsCard.TypeDescription & Constraintsdoco
.. Communication 0..*CommunicationA record of information transmitted from a sender to a receiver
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... partOf SΣ0..1Reference(Patient Correction Communication)Initial Patient Correction Communication resource for this request.
... status ?!Σ1..1codeFixed: completed.
Binding: EventStatus (required): The status of the communication.


Required Pattern: completed
... category S1..1CodeableConceptMessage category
Binding: Patient Correction Communication Types Value Set (required)
... subject SΣ1..1Reference(Patient)The Patient that the correction request or the log disagreement applies to.
... topic S0..1CodeableConceptA heading/subject line for the message being sent.
Binding: CommunicationTopic (example): Codes describing the purpose or content of the communication.

... Slices for about 0..*Reference(Resource)Resources that pertain to this communication
Slice: Unordered, Open by type:reference
.... about:correctionTask S0..1Reference(Patient Correction Task)Patient Correction Task requesting a correction.
... sent 1..1dateTimeWhen this communication was sent
... recipient S1..*Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | CareTeam | HealthcareService)Message recipient: either a Requestor or a Fulfiller
... sender S1..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | HealthcareService)Message sender: either a Requestor or a Fulfiller
... payload S0..*BackboneElementContents of this communication.
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... content[x] 1..1Message part content
..... contentStringstring
..... contentAttachmentAttachment
..... contentReferenceReference(Resource)
... note 0..*AnnotationNon-actionable notes about this communication.

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
Communication.statusrequiredPattern: completed
Communication.categoryrequiredPatientCorrectionCommunicationTypesVS
Communication.topicexampleCommunicationTopic
NameFlagsCard.TypeDescription & Constraintsdoco
.. Communication 0..*CommunicationA record of information transmitted from a sender to a receiver
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier Σ0..*IdentifierUnique identifier
... instantiatesCanonical Σ0..*canonical(PlanDefinition | ActivityDefinition | Measure | OperationDefinition | Questionnaire)Instantiates FHIR protocol or definition
... instantiatesUri Σ0..*uriInstantiates external protocol or definition
... basedOn Σ0..*Reference(Resource)Request fulfilled by this communication
... partOf SΣ0..1Reference(Patient Correction Communication)Initial Patient Correction Communication resource for this request.
... inResponseTo S0..1Reference(Patient Correction Communication)Reply to
... status ?!Σ1..1codeFixed: completed.
Binding: EventStatus (required): The status of the communication.


Required Pattern: completed
... statusReason Σ0..1CodeableConceptReason for current status
Binding: CommunicationNotDoneReason (example): Codes for the reason why a communication did not happen.

... category S1..1CodeableConceptMessage category
Binding: Patient Correction Communication Types Value Set (required)
... priority Σ0..1coderoutine | urgent | asap | stat
Binding: RequestPriority (required): Codes indicating the relative importance of a communication.

... medium 0..*CodeableConceptA channel of communication
Binding: ParticipationMode (example): Codes for communication mediums such as phone, fax, email, in person, etc.


... subject SΣ1..1Reference(Patient)The Patient that the correction request or the log disagreement applies to.
... topic S0..1CodeableConceptA heading/subject line for the message being sent.
Binding: CommunicationTopic (example): Codes describing the purpose or content of the communication.

... Slices for about 0..*Reference(Resource)Resources that pertain to this communication
Slice: Unordered, Open by type:reference
.... about:correctionTask S0..1Reference(Patient Correction Task)Patient Correction Task requesting a correction.
... encounter Σ0..1Reference(Encounter)Encounter created as part of
... sent 1..1dateTimeWhen this communication was sent
... received 0..1dateTimeWhen received
... recipient S1..*Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | CareTeam | HealthcareService)Message recipient: either a Requestor or a Fulfiller
... sender S1..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | HealthcareService)Message sender: either a Requestor or a Fulfiller
... reasonCode Σ0..*CodeableConceptIndication for message
Binding: SNOMEDCTClinicalFindings (example): Codes for describing reasons for the occurrence of a communication.


... reasonReference Σ0..*Reference(Condition | Observation | DiagnosticReport | DocumentReference)Why was communication done?
... payload S0..*BackboneElementContents of this communication.
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... content[x] 1..1Message part content
..... contentStringstring
..... contentAttachmentAttachment
..... contentReferenceReference(Resource)
... note 0..*AnnotationNon-actionable notes about this communication.

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
Communication.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Communication.statusrequiredPattern: completed
Communication.statusReasonexampleCommunicationNotDoneReason
Communication.categoryrequiredPatientCorrectionCommunicationTypesVS
Communication.priorityrequiredRequestPriority
Communication.mediumexampleParticipationMode
Communication.topicexampleCommunicationTopic
Communication.reasonCodeexampleSNOMEDCTClinicalFindings

This structure is derived from Communication

Summary

Mandatory: 5 elements
Must-Support: 9 elements

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

  • The element Communication.about is sliced based on the value of type:reference

Differential View

This structure is derived from Communication

NameFlagsCard.TypeDescription & Constraintsdoco
.. Communication 0..*CommunicationA record of information transmitted from a sender to a receiver
... partOf S0..1Reference(Patient Correction Communication)Initial Patient Correction Communication resource for this request.
... inResponseTo S0..1Reference(Patient Correction Communication)Reply to
... status 1..1codeFixed: completed.
Required Pattern: completed
... subject S1..1Reference(Patient)The Patient that the correction request or the log disagreement applies to.
... topic S0..1CodeableConceptA heading/subject line for the message being sent.
... Slices for about 0..*Reference(Resource)Resources that pertain to this communication
Slice: Unordered, Open by type:reference
.... about:correctionTask S0..1Reference(Patient Correction Task)Patient Correction Task requesting a correction.
... sent 1..1dateTimeWhen this communication was sent
... recipient S1..*Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | CareTeam | HealthcareService)Message recipient: either a Requestor or a Fulfiller
... sender S1..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | HealthcareService)Message sender: either a Requestor or a Fulfiller
... payload S0..*BackboneElementContents of this communication.
... note 0..*AnnotationNon-actionable notes about this communication.

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet
Communication.categoryrequiredPatientCorrectionCommunicationTypesVS

Key Elements View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Communication 0..*CommunicationA record of information transmitted from a sender to a receiver
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... partOf SΣ0..1Reference(Patient Correction Communication)Initial Patient Correction Communication resource for this request.
... status ?!Σ1..1codeFixed: completed.
Binding: EventStatus (required): The status of the communication.


Required Pattern: completed
... category S1..1CodeableConceptMessage category
Binding: Patient Correction Communication Types Value Set (required)
... subject SΣ1..1Reference(Patient)The Patient that the correction request or the log disagreement applies to.
... topic S0..1CodeableConceptA heading/subject line for the message being sent.
Binding: CommunicationTopic (example): Codes describing the purpose or content of the communication.

... Slices for about 0..*Reference(Resource)Resources that pertain to this communication
Slice: Unordered, Open by type:reference
.... about:correctionTask S0..1Reference(Patient Correction Task)Patient Correction Task requesting a correction.
... sent 1..1dateTimeWhen this communication was sent
... recipient S1..*Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | CareTeam | HealthcareService)Message recipient: either a Requestor or a Fulfiller
... sender S1..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | HealthcareService)Message sender: either a Requestor or a Fulfiller
... payload S0..*BackboneElementContents of this communication.
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... content[x] 1..1Message part content
..... contentStringstring
..... contentAttachmentAttachment
..... contentReferenceReference(Resource)
... note 0..*AnnotationNon-actionable notes about this communication.

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
Communication.statusrequiredPattern: completed
Communication.categoryrequiredPatientCorrectionCommunicationTypesVS
Communication.topicexampleCommunicationTopic

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Communication 0..*CommunicationA record of information transmitted from a sender to a receiver
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier Σ0..*IdentifierUnique identifier
... instantiatesCanonical Σ0..*canonical(PlanDefinition | ActivityDefinition | Measure | OperationDefinition | Questionnaire)Instantiates FHIR protocol or definition
... instantiatesUri Σ0..*uriInstantiates external protocol or definition
... basedOn Σ0..*Reference(Resource)Request fulfilled by this communication
... partOf SΣ0..1Reference(Patient Correction Communication)Initial Patient Correction Communication resource for this request.
... inResponseTo S0..1Reference(Patient Correction Communication)Reply to
... status ?!Σ1..1codeFixed: completed.
Binding: EventStatus (required): The status of the communication.


Required Pattern: completed
... statusReason Σ0..1CodeableConceptReason for current status
Binding: CommunicationNotDoneReason (example): Codes for the reason why a communication did not happen.

... category S1..1CodeableConceptMessage category
Binding: Patient Correction Communication Types Value Set (required)
... priority Σ0..1coderoutine | urgent | asap | stat
Binding: RequestPriority (required): Codes indicating the relative importance of a communication.

... medium 0..*CodeableConceptA channel of communication
Binding: ParticipationMode (example): Codes for communication mediums such as phone, fax, email, in person, etc.


... subject SΣ1..1Reference(Patient)The Patient that the correction request or the log disagreement applies to.
... topic S0..1CodeableConceptA heading/subject line for the message being sent.
Binding: CommunicationTopic (example): Codes describing the purpose or content of the communication.

... Slices for about 0..*Reference(Resource)Resources that pertain to this communication
Slice: Unordered, Open by type:reference
.... about:correctionTask S0..1Reference(Patient Correction Task)Patient Correction Task requesting a correction.
... encounter Σ0..1Reference(Encounter)Encounter created as part of
... sent 1..1dateTimeWhen this communication was sent
... received 0..1dateTimeWhen received
... recipient S1..*Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | CareTeam | HealthcareService)Message recipient: either a Requestor or a Fulfiller
... sender S1..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | HealthcareService)Message sender: either a Requestor or a Fulfiller
... reasonCode Σ0..*CodeableConceptIndication for message
Binding: SNOMEDCTClinicalFindings (example): Codes for describing reasons for the occurrence of a communication.


... reasonReference Σ0..*Reference(Condition | Observation | DiagnosticReport | DocumentReference)Why was communication done?
... payload S0..*BackboneElementContents of this communication.
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... content[x] 1..1Message part content
..... contentStringstring
..... contentAttachmentAttachment
..... contentReferenceReference(Resource)
... note 0..*AnnotationNon-actionable notes about this communication.

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
Communication.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Communication.statusrequiredPattern: completed
Communication.statusReasonexampleCommunicationNotDoneReason
Communication.categoryrequiredPatientCorrectionCommunicationTypesVS
Communication.priorityrequiredRequestPriority
Communication.mediumexampleParticipationMode
Communication.topicexampleCommunicationTopic
Communication.reasonCodeexampleSNOMEDCTClinicalFindings

This structure is derived from Communication

Summary

Mandatory: 5 elements
Must-Support: 9 elements

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

  • The element Communication.about is sliced based on the value of type:reference

 

Other representations of profile: CSV, Excel, Schematron