Patient Request for Corrections Implementation Guide
1.0.0-ballot - STU 1 Ballot

This page is part of the Patient Request for Corrections Implementation Guide (v1.0.0-ballot: STU 1 Ballot 1) based on FHIR R4. . For a full list of available versions, see the Directory of published versions

Resource Profile: Patient Correction Communication

Defining URL:http://hl7.org/fhir/uv/patient-corrections/StructureDefinition/patient-correction-communication
Version:1.0.0-ballot
Name:PatientCorrectionCommunication
Title:Patient Correction Communication
Status:Active as of 2022-03-29 04:29:26+0000
Definition:

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

Publisher:HL7 International - Patient Empowerment Workgroup
Source Resource:XML / JSON / Turtle

The official URL for this profile is:

http://hl7.org/fhir/uv/patient-corrections/StructureDefinition/patient-correction-communication

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.

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
... basedOn 0..0
... partOf 0..0
... inResponseTo S0..1Reference(Patient Correction Communication)Patient Correction Request Communication that this is in response to. This will only be filled in if it represents a response to another Communication resource. It can be used to query and assemble conversation threads related to the request process.
... category S1..1CodeableConceptMessage category
Binding: PatientCorrectionCommunicationTypesVS (required)
... 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. Could be thought of as the subject line in an email thread.
... about S0..2Reference(Patient Correction Task | Patient Correction Communication)If this is the original Patient Correction Request then Communication.about will initially be empty when posted by the Requester but populated with the Request for Correction Task reference by the Fulfiller when the Fulfiller spawn a Task to represent the Request for Correction or Logging of Disagreement process. For all subsequent Communication resources that represent conversations help between Requester and Fulfiller as part of the process, Communication.about references the Communication resource that contains the original request. If this Communication represents the start of a Log Disagreement request, then when the Fulfiller spawns a Task to support the logging of the disagreement, Communication.about will also reference the spawned Task.
... encounter 0..0
... sent 1..1dateTimeThe date that this particular part of the conversation is sent. On the initial request from the Requestor for either correction or logging a disagreement, this date/time will be used as Task.authoredOn to signify when the process was initiated on the Fulfiller.
... recipient S1..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | CareTeam | HealthcareService)Depending on the direction of the patient correction communication, the recipient of the communication may be the Fulfiller, or it may be the Requester.
... sender S1..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | HealthcareService)Depending on the direction of the patient correction communication, the sender of the communication may be the Requester or it may be the Fulfiller. On the initial request for correction or logging of disagreement, the Fulfiller will use sender to represent the Task.requester.
... payload S0..*BackboneElementThe contents of this particular conversation component. If this is the original correction request or logging of a disagreement, then the payload would contain the request. If it is the final outcome of the request, then the payload would contain the final outcome information. Otherwise it contains a single message in back and forth conversation needed to process the initial request. Since it is possible to have a Communication resource reference a conversation held outside of the FHIR Rest protocol (email, mail, portal messaging – see Communication.channel) the minimum cardinality is zero. However, it is expected in most cases payload will be valued.
... note 0..*AnnotationNotes from those that are working on the correction about that work (this is not the correction request itself).

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Communication 0..*CommunicationA record of information transmitted from a sender to a receiver
... id Σ0..1stringLogical 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)
Max Binding: AllLanguages: A human language.

... 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
... inResponseTo S0..1Reference(Patient Correction Communication)Patient Correction Request Communication that this is in response to. This will only be filled in if it represents a response to another Communication resource. It can be used to query and assemble conversation threads related to the request process.
... 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: PatientCorrectionCommunicationTypesVS (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. Could be thought of as the subject line in an email thread.
Binding: CommunicationTopic (example): Codes describing the purpose or content of the communication.

... about S0..2Reference(Patient Correction Task | Patient Correction Communication)If this is the original Patient Correction Request then Communication.about will initially be empty when posted by the Requester but populated with the Request for Correction Task reference by the Fulfiller when the Fulfiller spawn a Task to represent the Request for Correction or Logging of Disagreement process. For all subsequent Communication resources that represent conversations help between Requester and Fulfiller as part of the process, Communication.about references the Communication resource that contains the original request. If this Communication represents the start of a Log Disagreement request, then when the Fulfiller spawns a Task to support the logging of the disagreement, Communication.about will also reference the spawned Task.
... sent 1..1dateTimeThe date that this particular part of the conversation is sent. On the initial request from the Requestor for either correction or logging a disagreement, this date/time will be used as Task.authoredOn to signify when the process was initiated on the Fulfiller.
... received 0..1dateTimeWhen received
... recipient S1..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | CareTeam | HealthcareService)Depending on the direction of the patient correction communication, the recipient of the communication may be the Fulfiller, or it may be the Requester.
... sender S1..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | HealthcareService)Depending on the direction of the patient correction communication, the sender of the communication may be the Requester or it may be the Fulfiller. On the initial request for correction or logging of disagreement, the Fulfiller will use sender to represent the Task.requester.
... 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..*BackboneElementThe contents of this particular conversation component. If this is the original correction request or logging of a disagreement, then the payload would contain the request. If it is the final outcome of the request, then the payload would contain the final outcome information. Otherwise it contains a single message in back and forth conversation needed to process the initial request. Since it is possible to have a Communication resource reference a conversation held outside of the FHIR Rest protocol (email, mail, portal messaging – see Communication.channel) the minimum cardinality is zero. However, it is expected in most cases payload will be valued.
.... 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..*AnnotationNotes from those that are working on the correction about that work (this is not the correction request itself).

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Communication 0..*CommunicationA record of information transmitted from a sender to a receiver
... inResponseTo 0..1Reference(Patient Correction Communication)Patient Correction Request Communication that this is in response to. This will only be filled in if it represents a response to another Communication resource. It can be used to query and assemble conversation threads related to the request process.
... category 1..1CodeableConceptMessage category
Binding: PatientCorrectionCommunicationTypesVS (required)
... subject Σ1..1Reference(Patient)The Patient that the correction request or the log disagreement applies to.
... about 0..2Reference(Patient Correction Task | Patient Correction Communication)If this is the original Patient Correction Request then Communication.about will initially be empty when posted by the Requester but populated with the Request for Correction Task reference by the Fulfiller when the Fulfiller spawn a Task to represent the Request for Correction or Logging of Disagreement process. For all subsequent Communication resources that represent conversations help between Requester and Fulfiller as part of the process, Communication.about references the Communication resource that contains the original request. If this Communication represents the start of a Log Disagreement request, then when the Fulfiller spawns a Task to support the logging of the disagreement, Communication.about will also reference the spawned Task.
... recipient 1..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | CareTeam | HealthcareService)Depending on the direction of the patient correction communication, the recipient of the communication may be the Fulfiller, or it may be the Requester.
... sender 1..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | HealthcareService)Depending on the direction of the patient correction communication, the sender of the communication may be the Requester or it may be the Fulfiller. On the initial request for correction or logging of disagreement, the Fulfiller will use sender to represent the Task.requester.
... payload 0..*BackboneElementThe contents of this particular conversation component. If this is the original correction request or logging of a disagreement, then the payload would contain the request. If it is the final outcome of the request, then the payload would contain the final outcome information. Otherwise it contains a single message in back and forth conversation needed to process the initial request. Since it is possible to have a Communication resource reference a conversation held outside of the FHIR Rest protocol (email, mail, portal messaging – see Communication.channel) the minimum cardinality is zero. However, it is expected in most cases payload will be valued.

doco Documentation for this format

This structure is derived from Communication

Differential View

This structure is derived from Communication

NameFlagsCard.TypeDescription & Constraintsdoco
.. Communication 0..*CommunicationA record of information transmitted from a sender to a receiver
... basedOn 0..0
... partOf 0..0
... inResponseTo S0..1Reference(Patient Correction Communication)Patient Correction Request Communication that this is in response to. This will only be filled in if it represents a response to another Communication resource. It can be used to query and assemble conversation threads related to the request process.
... category S1..1CodeableConceptMessage category
Binding: PatientCorrectionCommunicationTypesVS (required)
... 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. Could be thought of as the subject line in an email thread.
... about S0..2Reference(Patient Correction Task | Patient Correction Communication)If this is the original Patient Correction Request then Communication.about will initially be empty when posted by the Requester but populated with the Request for Correction Task reference by the Fulfiller when the Fulfiller spawn a Task to represent the Request for Correction or Logging of Disagreement process. For all subsequent Communication resources that represent conversations help between Requester and Fulfiller as part of the process, Communication.about references the Communication resource that contains the original request. If this Communication represents the start of a Log Disagreement request, then when the Fulfiller spawns a Task to support the logging of the disagreement, Communication.about will also reference the spawned Task.
... encounter 0..0
... sent 1..1dateTimeThe date that this particular part of the conversation is sent. On the initial request from the Requestor for either correction or logging a disagreement, this date/time will be used as Task.authoredOn to signify when the process was initiated on the Fulfiller.
... recipient S1..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | CareTeam | HealthcareService)Depending on the direction of the patient correction communication, the recipient of the communication may be the Fulfiller, or it may be the Requester.
... sender S1..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | HealthcareService)Depending on the direction of the patient correction communication, the sender of the communication may be the Requester or it may be the Fulfiller. On the initial request for correction or logging of disagreement, the Fulfiller will use sender to represent the Task.requester.
... payload S0..*BackboneElementThe contents of this particular conversation component. If this is the original correction request or logging of a disagreement, then the payload would contain the request. If it is the final outcome of the request, then the payload would contain the final outcome information. Otherwise it contains a single message in back and forth conversation needed to process the initial request. Since it is possible to have a Communication resource reference a conversation held outside of the FHIR Rest protocol (email, mail, portal messaging – see Communication.channel) the minimum cardinality is zero. However, it is expected in most cases payload will be valued.
... note 0..*AnnotationNotes from those that are working on the correction about that work (this is not the correction request itself).

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Communication 0..*CommunicationA record of information transmitted from a sender to a receiver
... id Σ0..1stringLogical 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)
Max Binding: AllLanguages: A human language.

... 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
... inResponseTo S0..1Reference(Patient Correction Communication)Patient Correction Request Communication that this is in response to. This will only be filled in if it represents a response to another Communication resource. It can be used to query and assemble conversation threads related to the request process.
... 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: PatientCorrectionCommunicationTypesVS (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. Could be thought of as the subject line in an email thread.
Binding: CommunicationTopic (example): Codes describing the purpose or content of the communication.

... about S0..2Reference(Patient Correction Task | Patient Correction Communication)If this is the original Patient Correction Request then Communication.about will initially be empty when posted by the Requester but populated with the Request for Correction Task reference by the Fulfiller when the Fulfiller spawn a Task to represent the Request for Correction or Logging of Disagreement process. For all subsequent Communication resources that represent conversations help between Requester and Fulfiller as part of the process, Communication.about references the Communication resource that contains the original request. If this Communication represents the start of a Log Disagreement request, then when the Fulfiller spawns a Task to support the logging of the disagreement, Communication.about will also reference the spawned Task.
... sent 1..1dateTimeThe date that this particular part of the conversation is sent. On the initial request from the Requestor for either correction or logging a disagreement, this date/time will be used as Task.authoredOn to signify when the process was initiated on the Fulfiller.
... received 0..1dateTimeWhen received
... recipient S1..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | CareTeam | HealthcareService)Depending on the direction of the patient correction communication, the recipient of the communication may be the Fulfiller, or it may be the Requester.
... sender S1..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization | HealthcareService)Depending on the direction of the patient correction communication, the sender of the communication may be the Requester or it may be the Fulfiller. On the initial request for correction or logging of disagreement, the Fulfiller will use sender to represent the Task.requester.
... 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..*BackboneElementThe contents of this particular conversation component. If this is the original correction request or logging of a disagreement, then the payload would contain the request. If it is the final outcome of the request, then the payload would contain the final outcome information. Otherwise it contains a single message in back and forth conversation needed to process the initial request. Since it is possible to have a Communication resource reference a conversation held outside of the FHIR Rest protocol (email, mail, portal messaging – see Communication.channel) the minimum cardinality is zero. However, it is expected in most cases payload will be valued.
.... 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..*AnnotationNotes from those that are working on the correction about that work (this is not the correction request itself).

doco Documentation for this format

 

Other representations of profile: CSV, Excel, Schematron

Terminology Bindings

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