Segment MSH to MessageHeader Map

This ConceptMap represents a mapping from the HL7 V2 Segment MSH to the FHIR MessageHeader Resource.
View in v2-to-FHIR IG
#V2 FieldNameV2 TypeCard.FHIR AttributeFHIR TypeEquiv.
1MSH-3Sending ApplicationHD1..1
source[1]
source[1].endpoint

We believe that if MSH-24 is vaued, although MSH-24 is rarely valued, it contains better information for the MessageHeader.source.endpoint than MSH-3. However, one may either still want to use MSH-3 in total or a combination of content from MSH-3 and MSH-24. That is a local implementation decision to adjust the mapping accordingly based on clear knowledge of the content. If both MSH-3 and MSH-24 are not valued, which is valid in HL7 v2, then the implementer needs to resolve how to assign MessageHeader.source as it is a required attribute. Note that a data absent reason extension could be used to provide a reason and satisfy the mandatory FHIR attribute rules. But do note that the use of the data-absent-reason extension may result in a FHIR resource that is not usable by the recipient.\

-uri
equivalentequivalent
2MSH-4Sending FacilityHD1..1
sender(Organization)
Reference(Organization)
equivalent
3MSH-5Receiving ApplicationHD1..1
destination[1].target(Device)

Similar as for MSH-3, MSH-5 is paired with MSH-25 and depending on local use may need to use one, the other, or a combination of both. We believe that MSH-25, when valued, provides the better information given its addition to the standard more recently.

destination[1].name
destination[1].endpoint
Reference(Device)nameurl
equivalentequivalentequivalent
4MSH-6Receiving FacilityHD-1..*
destination[1].receiver(Organization)
Reference(Organization)
equivalent
5MSH-8SecurityST1..1
meta.security
string
equivalent
6MSH-9Message TypeMSG1..1
eventCoding
Coding
equivalent
7MSH-11Processing IDPT1..1
meta
meta
equivalent
8MSH-17Country CodeID1..1
sender(Organization.address.country)
string
equivalent
9MSH-19Principal Language Of MessageCWE1..1
language

This does only cover the MessageHeader resource. Need to have clarity that if other resources that are part of the message that do not have Resource.meta.language valued, then it is assumed to follow MessageHeader.meta.language?? Doesn't seem RESTful, so what is the default for Resource.meta.language?

code
equivalent
10MSH-22Sending Responsible OrganizationXON1..1
responsible(Organization)
Reference(Organization)
equivalent
11MSH-23Receiving Responsible OrganizationXON1..1
destination[1].receiver(Organization)

This is an alternate representation of MSH-6. The local implementation needs to determine whech components of HD vs. XON to be used and whether it may even yield a separate Organization reference.

Reference(Organization)
equivalent
12MSH-24Sending Network AddressHD1..1
source

We believe that if MSH-24 is vaued, although it is rarely valued, it contains better information for the MessageHeader.source.endpoint. However, one may either still want to use MSH-3 in total or a combination of content from MSH-3 and MSH-24. That is a local implementation decision to adjust the mapping accordingly.

source.endpoint.extension.url

= "http://hl7.org/fhir/R4/extension-data-absent-reason.html"

source.endpoint.extension.valueCode

= "unknown"

If both MSH-3 and MSH-24 are not valued, which is valid, then the implementer needs to resolve whether to assign this a known value since they know the context, or add the data absent reason extension to provide a reason and satisfies the mandatory FHIR attribute rules. Note that the use of the data-absent-reason extension may result in a FHIR resource that is not usable by the recipient.

stringuricode
equivalentequivalentequivalent
13MSH-25Receiving Network AddressHD1..1
destination[1]

We believe that if MSH-25 is vaued, although it is rarely valued, it contains better information for the MessageHeader.source.endpoint. However, one may either still want to use MSH-5 in total or a combination of content from MSH-5 and MSH-25. That is a local implementation decision to adjust the mapping accordingly.

destination[1].endpoint.extension.url

= "http://hl7.org/fhir/R4/extension-data-absent-reason.html"

destination[1].endpoint.extension.valueCode

= "unknown"

uriuricode
equivalentequivalentequivalent
14MSH-26Security Classification TagCWE1..1
meta.security[2]
Coding
equivalent
15MSH-27Security Handling InstructionsCWE-1..*
meta.security[2]
Coding
equivalent

Equivalence Legend

equivalentExact match
wider/narrowerBroader/more specific meaning
relatedtoRelated but not exact
unmatchedNo equivalent in target