--- type: "doc" source: "source/datatypes-mappings.html" ---  \[%settitle Datatype Mappings%\] \[%file newheader%\] \[%file newnavbar%\] <%dtheader mappings%> ## Datatype Mappings | Responsible Owner: [\[%wgt fhir%\]]([%wg fhir%]) Work Group | [Standards Status](versions#std-process):[Informative](versions#std-process) | | --- | --- | This page provides mappings for the datatypes. There are mappings to [HL7 V2](http://www.hl7.org/implement/standards/product_brief.cfm?product_id=185), [HL7 v3](https://www.hl7.org/implement/standards/product_brief.cfm?product_id=186), and (where appropriate) vCard (see [Mappings to Other Standards](mappings) for further information & status). **Datatypes Index** **Primitive Types** \[%diagram datatypes/allprimitivetypes.diagram 1dt%\] **General-Purpose Datatypes** \[%diagram datatypes/alltypes.diagram 2dt%\] **Metadata Types** \[%diagram datatypes/metadatatypes.diagram 3dt%\] **Special Purpose Datatypes** \[%diagram datatypes/specialtypes.diagram 4dt%\] ### Primitive Types See also [Base Definition](datatypes#primitive), [Examples](datatypes-examples#primitive), [Detailed Descriptions](datatypes-definitions#primitive), [Profiles](datatypes-profiles#primitive) and [Extensions]([%extensions-location%]extensions-datatypes#primitive) and [Extensions]([%extensions-location%]conversions-datatypes#primitive) <%dtmappings primitives%> ### Attachment See also [Base Definition](datatypes#Attachment), [Examples](datatypes-examples#Attachment), [Detailed Descriptions](datatypes-definitions#Attachment), [Profiles](datatypes-profiles#Attachment) and [Extensions]([%extensions-location%]extensions-datatypes#primitive) and [Extensions]([%extensions-location%]conversions-datatypes#Attachment) <%dtmappings Attachment%> ### Identifier See also [Base Definition](datatypes#identifier), [Examples](datatypes-examples#identifier), [Detailed Descriptions](datatypes-definitions#identifier), [Profiles](datatypes-profiles#identifier) and [Extensions]([%extensions-location%]extensions-datatypes#primitive) and [Extensions]([%extensions-location%]conversions-datatypes#identifier) <%dtmappings Identifier%> #### V3 Mapping Issues for Identifier When mapping an HL7 v3 II datatype to a FHIR Identifier, there are two possibilities: - If the II has only a root and no extension, the FHIR Identifier will have a system of 'urn:ietf:rfc:3986' and the II.root will appear in Identifier.value - If the II has both a root and an extension, the II.root will be mapped to a URI - either a human-friendly URL or URN or (less preferred) an OID expressed as a urn, and the II.extension will be sent in Identifier.value To search on a CDA `II.root` - which may appear in either `Identifier.system` or `Identifier.value`, use the syntax `identifier=|[root],[root]`. See [v3 Mapping examples](datatypes-examples#ii) ### Coding See also [Base Definition](datatypes#Coding), [Examples](datatypes-examples#Coding), [Detailed Descriptions](datatypes-definitions#Coding), [Profiles](datatypes-profiles#Coding) and [Extensions]([%extensions-location%]extensions-datatypes#primitive) and [Extensions]([%extensions-location%]conversions-datatypes#Coding) <%dtmappings Coding%> ### CodeableConcept See also [Base Definition](datatypes#CodeableConcept), [Examples](datatypes-examples#CodeableConcept), [Detailed Descriptions](datatypes-definitions#CodeableConcept), [Profiles](datatypes-profiles#CodeableConcept) and [Extensions]([%extensions-location%]extensions-datatypes#primitive) and [Extensions]([%extensions-location%]conversions-datatypes#CodeableConcept) <%dtmappings CodeableConcept%> ### Quantity See also [Base Definition](datatypes#Quantity), [Examples](datatypes-examples#Quantity), [Detailed Descriptions](datatypes-definitions#Quantity), [Profiles](datatypes-profiles#Quantity) and [Extensions]([%extensions-location%]extensions-datatypes#primitive) and [Extensions]([%extensions-location%]conversions-datatypes#Quantity) <%dtmappings Quantity%> ### Money See also [Base Definition](datatypes#Money), [Examples](datatypes-examples#Money), [Detailed Descriptions](datatypes-definitions#Money), [Profiles](datatypes-profiles#Money) and [Extensions]([%extensions-location%]extensions-datatypes#primitive) and [Extensions]([%extensions-location%]conversions-datatypes#Money) <%dtmappings Money%> ### Range See also [Base Definition](datatypes#Range), [Examples](datatypes-examples#Range), [Detailed Descriptions](datatypes-definitions#Range), [Profiles](datatypes-profiles#Range) and [Extensions]([%extensions-location%]extensions-datatypes#primitive) and [Extensions]([%extensions-location%]conversions-datatypes#Range) <%dtmappings Range%> ### Ratio See also [Base Definition](datatypes#Ratio), [Examples](datatypes-examples#Ratio), [Detailed Descriptions](datatypes-definitions#Ratio), [Profiles](datatypes-profiles#Ratio) and [Extensions]([%extensions-location%]extensions-datatypes#primitive) and [Extensions]([%extensions-location%]conversions-datatypes#Ratio) <%dtmappings Ratio%> ### Ratio See also [Base Definition](datatypes#RatioRange), [Examples](datatypes-examples#RatioRange), [Detailed Descriptions](datatypes-definitions#RatioRange), [Profiles](datatypes-profiles#RatioRange) and [Extensions]([%extensions-location%]extensions-datatypes#primitive) and [Extensions]([%extensions-location%]conversions-datatypes#RatioRange) <%dtmappings RatioRange%> ### Period See also [Base Definition](datatypes#Period), [Examples](datatypes-examples#Period), [Detailed Descriptions](datatypes-definitions#Period), [Profiles](datatypes-profiles#Period) and [Extensions]([%extensions-location%]extensions-datatypes#primitive) and [Extensions]([%extensions-location%]conversions-datatypes#Period) <%dtmappings Period%> ### SampledData See also [Base Definition](datatypes#SampledData), [Examples](datatypes-examples#SampledData), [Detailed Descriptions](datatypes-definitions#SampledData), [Profiles](datatypes-profiles#SampledData) and [Extensions]([%extensions-location%]extensions-datatypes#primitive) and [Extensions]([%extensions-location%]conversions-datatypes#SampledData) <%dtmappings SampledData%> ### HumanName See also [Base Definition](datatypes#HumanName), [Examples](datatypes-examples#HumanName), [Detailed Descriptions](datatypes-definitions#HumanName), [Profiles](datatypes-profiles#HumanName) and [Extensions]([%extensions-location%]extensions-datatypes#primitive) and [Extensions]([%extensions-location%]conversions-datatypes#HumanName) <%dtmappings HumanName%> **[vCard](http://tools.ietf.org/html/rfc6350) Mappings** - HumanName.text = vCard "FN" field - HumanName.use = use of the vCard "TYPE" parameter - HumanName.family, .given, .prefix, .suffix = parts of vCard "N" field. Note that there is no FHIR equivalent for the poorly defined "additional" name field. In FHIR, given names go in "middle" names - The vCard nickname corresponds to a name with the use "nickname" ### Address See also [Base Definition](datatypes#Address), [Examples](datatypes-examples#Address), [Detailed Descriptions](datatypes-definitions#Address), [Profiles](datatypes-profiles#Address) and [Extensions]([%extensions-location%]extensions-datatypes#primitive) and [Extensions]([%extensions-location%]conversions-datatypes#Address) <%dtmappings Address%> ### ContactPoint See also [Base Definition](datatypes#ContactPoint), [Examples](datatypes-examples#ContactPoint), [Detailed Descriptions](datatypes-definitions#ContactPoint), [Profiles](datatypes-profiles#ContactPoint) and [Extensions]([%extensions-location%]extensions-datatypes#primitive) and [Extensions]([%extensions-location%]conversions-datatypes#ContactPoint) <%dtmappings ContactPoint%> ### Timing See also [Base Definition](datatypes#Timing), [Examples](datatypes-examples#Timing), [Detailed Descriptions](datatypes-definitions#Timing), [Profiles](datatypes-profiles#Timing) and [Extensions]([%extensions-location%]extensions-datatypes#primitive) and [Extensions]([%extensions-location%]conversions-datatypes#Timing) <%dtmappings Timing%> ### RelativeTime See also [Base Definition](datatypes#RelativeTime), [Examples](datatypes-examples#RelativeTime), [Detailed Descriptions](datatypes-definitions#RelativeTime), [Profiles](datatypes-profiles#RelativeTime) and [Extensions]([%extensions-location%]extensions-datatypes#primitive) and [Extensions]([%extensions-location%]conversions-datatypes#RelativeTime) <%dtmappings RelativeTime%> ### Signature See also [Base Definition](datatypes#Signature), [Examples](datatypes-examples#Signature), [Detailed Descriptions](datatypes-definitions#Signature), [Profiles](datatypes-profiles#Signature) and [Extensions]([%extensions-location%]extensions-datatypes#primitive) and [Extensions]([%extensions-location%]conversions-datatypes#Signature) <%dtmappings Signature%> ### Annotation See also [Base Definition](datatypes#Annotation), [Examples](datatypes-examples#Annotation), [Detailed Descriptions](datatypes-definitions#Annotation), [Profiles](datatypes-profiles#Annotation) and [Extensions]([%extensions-location%]extensions-datatypes#primitive) and [Extensions]([%extensions-location%]conversions-datatypes#Annotation) <%dtmappings Annotation%> \[%file newfooter%\]