FHIR Artifacts > Structure Definition: MessageHeader Profile

Structure Definition: MessageHeader Profile

Canonical URL:http://ehealthontario.ca/fhir/StructureDefinition/ca-on-eReferral-profile-MessageHeader

Simplifier project page: MessageHeader

Derived from: Message Header (CA:eReC)

Base FHIR: MessageHeader (R4)

Formal Views of Profile Content

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

Hybrid View

responsibleΣ0..1Reference(Practitioner | PractitionerRole | Organization)
focusS Σ1..*Reference(EReferralServiceRequest | EReferralTask | EReferralAppointment | EReferralCommunication)
definitionΣ0..1canonical(MessageDefinition)

Usage

A MessageHeader resource with a unique id and appropriate eventCoding, source.endpoint, destination.endpoint and focus SHALL be the first entry in each message Bundle.

The MessageHeader is used to convey the purpose of the message (i.e.: eventCoding), to direct the receiver toward the information acted upon (i.e.: focus) and to support message routing.

Notes

.id

  • used to uniquely identify a message
  • populate this element with a UUID each time a message is created
  • note: a FHIR message contains two identifiers that are unique within the message stream, rules:
    • a MessageHeader.id (this element) SHALL be assigned when the message is created
    • a Bundle.id SHALL be assigned each time the message is sent

.meta.profile

  • used to declare conformance to this profile
  • populate with the fixed value: http://ehealthontario.ca/fhir/StructureDefinition/ca-on-eReferral-profile-MessageHeader|1.1.0

.extension:RoutingOptions

  • used to communicate referral source type information to support referral processes with automated referral processing rules
  • for "add-servicerequest" messsages, this element SHALL be populated with the same value as ServiceRequest.extension:RoutingOptions if present
  • see requisition for more informaiton

.extension:ContentType

  • used to distinguish between messages used for clinical purposes, and messages used for analytics
  • MAY be populated with a code of Clinical or Analytical
  • Message Bundles not containing this extension SHALL be considered clinical

.eventCoding

  • used to convey the business event that triggered the message
  • SHALL be populated with a code from MessageEventCode and coding system

.destination.endpoint

  • used to enable message routing through an intermediary
  • SHALL be populated with either:
    • a literal URL that identifies the addresses to which the message should be delivered, or
    • a logical URI (i.e. non-dereferenceable) known to the intermediary.

.destination.receiver

  • used to reference the receiver (PractitionerRole) of the request referral or consult

.author

.source.endpoint

  • used to enable message routing of responses through an intermediary
  • SHALL be populated with either:
    • a literal URL that identifies the addresses to which the message should be delivered, or
    • a logical URI (i.e. non-dereferenceable) known to the intermediary.

.response

  • indicates that a message is a response to a request message (with status)
  • if used:
    • .response.identifier SHALL be populated with the MessageHeader.id of the message to which this message is a response
    • .response.code SHALL be populated with a valid ResponseType
    • .response.details MAY be provided in a referenced OperationOutcome included in the Bundle

.focus

  • identifies the information acted upon when the message was triggered
  • SHALL include a reference to a ServiceRequest, Task, Appointment, Communication that:
  • a MessageHeader SHALL include only a single instance of focus on messages used to transmit event information between and RMS Source and RMS Target (either direction)
  • a MessageHeader SHALL include multiple instances of focus when needed to transmit a full snapshot of referral information including Appointment information.