HL7 Version 2 to FHIR
1.0.0-ballot - ballot International flag

HL7 Version 2 to FHIR, published by HL7 International / Orders and Observations. This guide is not an authorized publication; it is the continuous build for version 1.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/v2-to-fhir/ and changes regularly. See the Directory of published versions

ConceptMap: Datatype XTN to ContactPoint Map (Experimental)

Official URL: http://hl7.org/fhir/uv/v2mappings/datatype-xtn-to-contactpoint Version: 1.0.0-ballot
Active as of 2024-12-20 Computable Name: DatatypeXTNToContactPoint

Copyright/Legal: Copyright (c) 2020, HL7 International, Inc., All Rights Reserved.

This ConceptMap represents a mapping from the HL7 V2 Datatype XTN to the FHIR ContactPoint Data Type.

This ConceptMap represents the mapping from the HL7 V2 XTN Data Type to the FHIR ContactPoint Data Type. See also the FHIR Shorthand or the CSV Source.

HL7 v2Condition (IF True, args)HL7 FHIRComments
Sort OrderIdentifierNameData TypeCardinality - MinCardinality - MaxComputable ANTLRComputable FHIRPathNarrativeFHIR AttributeProposed ExtensionData TypeCardinality - MinCardinality - MaxData Type MappingVocabulary Mapping
(IS, ID, CE, CEN, CWE)
Assignment
1XTN.1Telephone NumberST01IF XTN.3 NOT IN ("Internet", "X.400") AND XTN.7 NOT VALUED AND XTN.12 NOT VALUEDContactPoint.valueContactPoint.string01
2XTN.2Telecommunication Use CodeID01ContactPoint.useContactPoint.code01ID[Code]TelecommunicationUseCode
3XTN.3Telecommunication Equipment TypeID11ContactPoint.systemContactPoint.code01ID[Code]TelecommunicationEquipmentType
3XTN.3Telecommunication Equipment TypeID11IF XTN.3 NOT VALUED AND XTN.4 VALUEDContactPoint.systemContactPoint.code01ID[Code]"email"
3XTN.3Telecommunication Equipment TypeID11IF XTN.3 NOT VALUED AND XTN.4 NOT VALUEDContactPoint.system.extension-data-absent-reasonContactPoint.code01ID[Code]"unknown"This element became required in v2.7, before that, it was optional. FHIR has a requirement that system be populated when a value is present. If the source v2 message does not contain an Equipment Type, a default system may be selected based on other information in the XTN instance (eg, if XTN.4 is valued, then the Equipment Type should default to "email). However, if neither XTN.3 nor XTN.4 are valued then it is unclear what the ContactPoint.system would be, thus the data absent reason would clearly indicate it is "unknown".
4XTN.4Communication AddressST01IF XTN.3 IN ("Internet", "X.400")ContactPoint.valueContactPoint.string01
5XTN.5Country CodeSNM01ContactPoint.extension.urlContactPoint.uri01"http://hl7.org/fhir/StructureDefinition/contactpoint-country"
5XTN.5Country CodeSNM01ContactPoint.extension.valueStringContactPoint.string01
6XTN.6Area/City CodeSNM01ContactPoint.extension.urlContactPoint.uri01"http://hl7.org/fhir/StructureDefinition/contactpoint-area"
6XTN.6Area/City CodeSNM01ContactPoint.extension.valueStringContactPoint.string01
7XTN.7Local NumberSNM01IF XTN.3 NOT IN ("Internet", "X.400")ContactPoint.extension.urlContactPoint.uri01"http://hl7.org/fhir/StructureDefinition/contactpoint-local"
7XTN.7Local NumberSNM01IF XTN.3 NOT IN ("Internet", "X.400")ContactPoint.extension.valueStringContactPoint.string01
7XTN.7Local NumberSNM01IF XTN.3 NOT IN ("Internet", "X.400") AND XTN.5 NOT VALUED AND XTN.6 VALUED AND XTN.7 VALUED AND XTN.8 NOT VALUEDContactPoint.valueContactPoint.string01XTN.6+" "+XTN.7
7XTN.7Local NumberSNM01IF XTN.3 NOT IN ("Internet", "X.400") AND XTN.5 VALUED AND XTN.6 VALUED AND XTN.7 VALUED AND XTN.8 NOT VALUEDContactPoint.valueContactPoint.string01"+"+XTN.5+" "+XTN.6+" "+XTN.7
7XTN.7Local NumberSNM01IF XTN.3 NOT IN ("Internet", "X.400") AND XTN.5 VALUED AND XTN.6 VALUED AND XTN.7 VALUED AND XTN.8 VALUEDContactPoint.valueContactPoint.string01"+"+XTN.5+" "+XTN.6+" "+XTN.7+" X"+XTN.8
7XTN.7Local NumberSNM01IF XTN.3 NOT IN ("Internet", "X.400") AND XTN.5 NOT VALUED AND XTN.6 VALUED AND XTN.7 VALUED AND XTN.8 VALUEDContactPoint.valueContactPoint.string01XTN.6+" "+XTN.7+" X"+XTN.8
8XTN.8ExtensionSNM01ContactPoint.extension.urlContactPoint.uri01"http://hl7.org/fhir/StructureDefinition/contactpoint-extension"
8XTN.8ExtensionSNM01ContactPoint.extension.valueStringContactPoint.string01
9XTN.9Any TextST01extension?-textContactPoint.string01
10XTN.10Extension PrefixST01
11XTN.11Speed Dial CodeST01
12XTN.12Unformatted Telephone numberST01IF XTN.3 NOT IN ("Internet", "X.400")ContactPoint.valueContactPoint.string01
13XTN.13Effective Start DateDTM01ContactPoint.period.startContactPoint.dateTime01DTM[DateTime]
14XTN.14Expiration DateDTM01ContactPoint.period.endContactPoint.dateTime01DTM[DateTime]
15XTN.15Expiration ReasonCWE01
16XTN.16Protection CodeCWE01
17XTN.17Shared Telecommunication IdentifierEI01
18XTN.18Preference OrderNM01ContactPoint.rankContactPoint.positiveInt01NM[PositiveInt]

Generated Narrative: ConceptMap datatype-xtn-to-contactpoint

Mapping from XTN to ContactPoint


Group 1 Mapping from unspecified code system to unspecified code system

Source CodeRelationshipTarget CodeComment
XTN.1 (Telephone Number)is equivalent tovalue
XTN.2 (Telecommunication Use Code)is equivalent touse
XTN.3 (Telecommunication Equipment Type)is equivalent tosystem
XTN.3 (Telecommunication Equipment Type)is equivalent tosystem
XTN.3 (Telecommunication Equipment Type)is equivalent tosystem.extension-data-absent-reasonThis element became required in v2.7, before that, it was optional. FHIR has a requirement that system be populated when a value is present. If the source v2 message does not contain an Equipment Type, a default system may be selected based on other information in the XTN instance (eg, if XTN.4 is valued, then the Equipment Type should default to "email). However, if neither XTN.3 nor XTN.4 are valued then it is unclear what the ContactPoint.system would be, thus the data absent reason would clearly indicate it is "unknown".
XTN.4 (Communication Address)is equivalent tovalue
XTN.5 (Country Code)is equivalent toextension[1].url
XTN.5 (Country Code)is equivalent toextension[1].valueString
XTN.6 (Area/City Code)is equivalent toextension[2].url
XTN.6 (Area/City Code)is equivalent toextension[2].valueString
XTN.7 (Local Number)is equivalent toextension[3].url
XTN.7 (Local Number)is equivalent toextension[3].valueString
XTN.7 (Local Number)is equivalent tovalue
XTN.7 (Local Number)is equivalent tovalue
XTN.7 (Local Number)is equivalent tovalue
XTN.7 (Local Number)is equivalent tovalue
XTN.8 (Extension)is equivalent toextension[4].url
XTN.8 (Extension)is equivalent toextension[4].valueString
XTN.12 (Unformatted Telephone number)is equivalent tovalue
XTN.13 (Effective Start Date)is equivalent toperiod.start
XTN.14 (Expiration Date)is equivalent toperiod.end
XTN.18 (Preference Order)is equivalent torank

Notes: