description: A clinical or business level record of information being transmitted or shared; e.g. an alert that was sent to a responsible provider, a public health agency communication to a provider/reporter in response to a case report for a reportable condition.
package_name: hl7.fhir.r5.examples
derivation: specialization
name: Communication
type: Communication
elements:
  category:
    short: Message category
    type: CodeableConcept
    array: true
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/communication-category'}
    index: 8
  received: {type: dateTime, short: When received, index: 16}
  instantiatesCanonical: {short: Instantiates FHIR protocol or definition, type: canonical, array: true, isSummary: true, index: 1}
  payload:
    type: BackboneElement
    short: Message payload
    array: true
    index: 20
    elements:
      content:
        short: Message part content
        choices: [contentAttachment, contentReference, contentCodeableConcept]
        index: 22
      contentAttachment: {short: Message part content, type: Attachment, choiceOf: content, index: 23}
      contentReference:
        short: Message part content
        refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
        type: Reference
        choiceOf: content
        index: 24
      contentCodeableConcept: {short: Message part content, type: CodeableConcept, choiceOf: content, index: 25}
    required: [contentAttachment, contentReference, content, contentCodeableConcept]
  instantiatesUri: {short: Instantiates external protocol or definition, type: uri, array: true, isSummary: true, index: 2}
  encounter:
    short: The Encounter during which this Communication was created
    refers: ['http://hl7.org/fhir/StructureDefinition/Encounter']
    type: Reference
    isSummary: true
    index: 14
  medium:
    type: CodeableConcept
    short: A channel of communication
    binding: {strength: example, valueSet: 'http://terminology.hl7.org/ValueSet/v3-ParticipationMode'}
    array: true
    index: 10
  recipient:
    short: Who the information is shared with
    refers: ['http://hl7.org/fhir/StructureDefinition/CareTeam', 'http://hl7.org/fhir/StructureDefinition/Device', 'http://hl7.org/fhir/StructureDefinition/Endpoint', 'http://hl7.org/fhir/StructureDefinition/Group', 'http://hl7.org/fhir/StructureDefinition/HealthcareService', 'http://hl7.org/fhir/StructureDefinition/Location', 'http://hl7.org/fhir/StructureDefinition/Organization', 'http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole', 'http://hl7.org/fhir/StructureDefinition/RelatedPerson']
    type: Reference
    array: true
    index: 17
  statusReason:
    short: Reason for current status
    type: CodeableConcept
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/communication-not-done-reason'}
    isSummary: true
    index: 7
  topic:
    short: Description of the purpose/content
    type: CodeableConcept
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/communication-topic'}
    index: 12
  sent: {type: dateTime, short: When sent, index: 15}
  note: {type: Annotation, short: Comments made about the communication, array: true, index: 26}
  reason:
    short: Indication for message
    type: CodeableReference
    array: true
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/clinical-findings'}
    isSummary: true
    index: 19
  priority:
    short: routine | urgent | asap | stat
    type: code
    meaningWhenMissing: If missing, this communication should be treated with normal priority
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/request-priority|4.5.0'}
    isSummary: true
    index: 9
  status:
    isModifier: true
    short: preparation | in-progress | not-done | on-hold | stopped | completed | entered-in-error | unknown
    type: code
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/event-status|4.5.0'}
    isModifierReason: This element is labelled as a modifier because it is a status element that contains status entered-in-error which means that the resource should not be treated as valid
    isSummary: true
    index: 6
  sender:
    short: Who shares the information
    refers: ['http://hl7.org/fhir/StructureDefinition/Device', 'http://hl7.org/fhir/StructureDefinition/Endpoint', 'http://hl7.org/fhir/StructureDefinition/HealthcareService', 'http://hl7.org/fhir/StructureDefinition/Organization', 'http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole', 'http://hl7.org/fhir/StructureDefinition/RelatedPerson']
    type: Reference
    index: 18
  identifier: {short: Unique identifier, type: Identifier, array: true, isSummary: true, index: 0}
  inResponseTo:
    type: Reference
    short: Reply to
    refers: ['http://hl7.org/fhir/StructureDefinition/Communication']
    array: true
    index: 5
  basedOn:
    short: Request fulfilled by this communication
    refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
    type: Reference
    array: true
    isSummary: true
    index: 3
  partOf:
    short: Part of referenced event (e.g. Communication, Procedure)
    refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
    type: Reference
    array: true
    isSummary: true
    index: 4
  subject:
    short: Focus of message
    refers: ['http://hl7.org/fhir/StructureDefinition/Group', 'http://hl7.org/fhir/StructureDefinition/Patient']
    type: Reference
    isSummary: true
    index: 11
  about:
    short: Resources that pertain to this communication
    refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
    type: Reference
    array: true
    index: 13
package_version: 4.5.0
class: resource
kind: resource
url: http://hl7.org/fhir/StructureDefinition/Communication
base: http://hl7.org/fhir/StructureDefinition/DomainResource
version: 4.5.0
required: [status]