Generated Narrative: ConceptMap segment-pid-to-patient Mapping from (not specified) to (not specified) Group 1 Mapping from unspecified code system to unspecified code system Source Concept Details Relationship Target Concept Details Comment Codes from NarrativeCondition ComputableANTLR Codes from PID-2 Patient ID is equivalent to identifier[1] identifier[1] PID-3 Patient Identifier List is equivalent to identifier[2] identifier[2] PID-4 Alternate Patient ID - PID is equivalent to identifier[3] identifier[3] PID-5 Patient Name is equivalent to name[1] name[1] PID-6 Mother's Maiden Name is equivalent to extension[1].url extension[1].url PID-6 Mother's Maiden Name is equivalent to extension[1].valueString extension[1].valueString This may not be the second name if there are repeats in PID-5. ext.patientMothersMaiden (string) also exists if we prefer. PID-7 Date/Time of Birth is equivalent to birthDate birthDate PROPOSAL MOVE TO IG IMPLEMENTATION GUIDANCE SECTION: Use ISO 8601 to establish the re-formatting from HL7 v2 data type to HL7 FHIR data type, particularly when mapping a platform datetime to platform date. ADD OTHER REFERENCES ON HOW TO ACHIEVE THESE CONVERSIONS in Java, CSHarp, etc., etc. PID-7 Date/Time of Birth IF PID-7 LENGTH GREATER THAN 8 is equivalent to birthDate.extension[1].url birthDate.extension[1].url PID-7 Date/Time of Birth IF PID-7 LENGTH GREATER THAN 8 is equivalent to birthDate.extension[1].valueDateTime birthDate.extension[1].valueDateTime PID-8 Administrative Sex is equivalent to gender gender PID-9 Patient Alias is equivalent to name[2] name[2] PID-11 Patient Address is equivalent to address[1] address[1] PID-12 County Code IF PID-11 LST.COUNT EQUALS 1 AND PID-11.9 IS NOT VALUED is equivalent to address[1].district address[1].district This may not be the second occurrence if PID-11 repeats. Because PID-11 can repeat but PID-12 cannot, it's not appropriate to include PID-12 in an iteration of .address populated from PID-11 PID-12 County Code IF PID-11 LST.COUNT EQUALS 1 AND PID-11.9 IS VALUED NOT EQUAL PID-12 is equivalent to address[2].district address[2].district PID-12 County Code IF PID-11 LST.COUNT GREATER THAN 1 is equivalent to address[2].district address[2].district PID-12 County Code IF PID-11 IS NOT VALUED is equivalent to address[1].district address[1].district PID-13 Phone Number - Home is equivalent to telecom[1] telecom[1] PID-13 Phone Number - Home IF PID-13.2 IS NOT VALUED is equivalent to telecom[1].use telecom[1].use PID-14 Phone Number - Business is equivalent to telecom[2] telecom[2] PID-14 Phone Number - Business IF PID-14.2 IS NOT VALUED is equivalent to telecom[2].use telecom[2].use PID-15 Primary Language is equivalent to communication.language communication.language During implementation, if you know that the value in PID-15 is the preferred patient language, then Patient.communication.preferred can be set to "true". PID-16 Marital Status is equivalent to maritalStatus maritalStatus PID-17 Religion is equivalent to extension[2].url extension[2].url PID-17 Religion is equivalent to extension[2].valueCodeableConcept extension[2].valueCodeableConcept PID-19 SSN Number - Patient is equivalent to identifier[4].value identifier[4].value the value set for Identifier.type doesn't contain SSN but it does have SB (social beneficiary) PID-19 SSN Number - Patient If in the US and various other jurisdictions is equivalent to identifier[4].type.coding.code identifier[4].type.coding.code PID-19 SSN Number - Patient If outside the US for certain jurisdictions is equivalent to identifier[4].type.coding.code identifier[4].type.coding.code PID-19 SSN Number - Patient is equivalent to identifier[4].type.coding.system identifier[4].type.coding.system PID-19 SSN Number - Patient is equivalent to identifier[4].system identifier[4].system If working in a jurisdiction other than the US and this field is used for the local SSN equivalent, a different system will need to be identified. PID-20 Driver's License Number - Patient is equivalent to identifier[5] identifier[5] PID-21 Mother's Identifier is equivalent to $this $this PID-23 Birth Place is equivalent to extension[3].url extension[3].url PID-23 Birth Place is equivalent to extension[3].valueAddress.text extension[3].valueAddress.text PID-24 Multiple Birth Indicator IF PID-25 NOT VALUED is equivalent to multipleBirthBoolean multipleBirthBoolean PID-25 Birth Order is equivalent to multipleBirthInteger multipleBirthInteger PID-26 Citizenship is equivalent to extension[4].url extension[4].url PID-26 Citizenship is equivalent to extension[4].extension[1].url extension[4].extension[1].url PID-26 Citizenship is equivalent to extension[4].extension[1].valueCodeableConcept extension[4].extension[1].valueCodeableConcept The standard extension does not include a value set PID-28 Nationality is equivalent to extension[5].url extension[5].url PID-28 Nationality is equivalent to extension[5].extension[1].url extension[5].extension[1].url PID-28 Nationality is equivalent to extension[5].extension[1].valueCodeableConcept extension[5].extension[1].valueCodeableConcept The standard extension does not include a value set PID-29 Patient Death Date and Time is equivalent to deceasedDateTime deceasedDateTime PID-30 Patient Death Indicator IF PID-29 NOT VALUED is equivalent to deceasedBoolean deceasedBoolean PID-35 Taxonomic Classification Code is equivalent to extension[6].url extension[6].url PID-35 Taxonomic Classification Code is equivalent to extension[6].extension[1].url extension[6].extension[1].url PID-35 Taxonomic Classification Code is equivalent to extension[6].extension[1].valueCodeableConcept extension[6].extension[1].valueCodeableConcept PID-36 Breed Code is equivalent to extension[6].url extension[6].url PID-36 Breed Code is equivalent to extension[6].extension[2].url extension[6].extension[2].url PID-36 Breed Code is equivalent to extension[6].extension[2].valueCodeableConcept extension[6].extension[2].valueCodeableConcept PID-39 Tribal Citizenship is equivalent to extension[7].url extension[7].url PID-39 Tribal Citizenship is equivalent to extension[7].extension[1].url extension[7].extension[1].url PID-39 Tribal Citizenship is equivalent to extension[7].extension[1].valueCodeableConcept extension[7].extension[1].valueCodeableConcept The standard extension does not include a value set. Also suggest that the extension should not be limited to "country". Consider adding a .type to the extension to distinguish tribal vs. "country" (or whatever we call it), or otherwise add an extension for tribal citizenship to accommodate the return flow. PID-40 Patient Telecommunication Information is equivalent to telecom[3] telecom[3]
HL7 International / Orders and Observations
This ConceptMap represents a mapping from the HL7 V2 Segment PID to the FHIR Patient Resource.
Copyright (c) 2025, HL7 International, Inc., All Rights Reserved.
This may not be the second name if there are repeats in PID-5. ext.patientMothersMaiden (string) also exists if we prefer.
PROPOSAL MOVE TO IG IMPLEMENTATION GUIDANCE SECTION: Use ISO 8601 to establish the re-formatting from HL7 v2 data type to HL7 FHIR data type, particularly when mapping a platform datetime to platform date. ADD OTHER REFERENCES ON HOW TO ACHIEVE THESE CONVERSIONS in Java, CSHarp, etc., etc.
This may not be the second occurrence if PID-11 repeats. Because PID-11 can repeat but PID-12 cannot, it's not appropriate to include PID-12 in an iteration of .address populated from PID-11
IF PID-11 LST.COUNT EQUALS 1 AND PID-11.9 IS NOT VALUED
IF PID-11 LST.COUNT EQUALS 1 AND PID-11.9 IS VALUED NOT EQUAL PID-12
During implementation, if you know that the value in PID-15 is the preferred patient language, then Patient.communication.preferred can be set to "true".
the value set for Identifier.type doesn't contain SSN but it does have SB (social beneficiary)
If in the US and various other jurisdictions
If outside the US for certain jurisdictions
If working in a jurisdiction other than the US and this field is used for the local SSN equivalent, a different system will need to be identified.
The standard extension does not include a value set
The standard extension does not include a value set. Also suggest that the extension should not be limited to "country". Consider adding a .type to the extension to distinguish tribal vs. "country" (or whatever we call it), or otherwise add an extension for tribal citizenship to accommodate the return flow.