| Package | hl7.fhir.uv.v2mappings |
| Resource Type | ConceptMap |
| Id | segment-nk1-to-patient |
| FHIR Version | R4 |
| Source | http://hl7.org/fhir/uv/v2mappings/https://build.fhir.org/ig/HL7/v2-to-fhir/ConceptMap-segment-nk1-to-patient.html |
| URL | http://hl7.org/fhir/uv/v2mappings/ConceptMap/segment-nk1-to-patient |
| Version | 1.0.0 |
| Status | active |
| Date | 2025-07-23 |
| Name | SegmentNK1ToPatient |
| Title | Segment NK1 to Patient Map |
| Realm | uv |
| Authority | hl7 |
| Description | This ConceptMap represents a mapping from the HL7 V2 Segment NK1 to the FHIR Patient Resource. |
| Copyright | Copyright (c) 2025, HL7 International, Inc., All Rights Reserved. |
No resources found
No resources found
Note: links and images are rebased to the (stated) source
Generated Narrative: ConceptMap segment-nk1-to-patient
Mapping from (not specified) to (not specified)
Group 1 Mapping from unspecified code system to unspecified code system
| Source Code | Relationship | Target Code | Comment |
| NK1-2 (Name) | is equivalent to | contact.name | |
| NK1-3 (Relationship) | is equivalent to | contact.relationship[1] | |
| NK1-4 (Address) | is equivalent to | contact.address | Note the decreased cardinality for the FHIR map |
| NK1-5 (Phone Number) | is equivalent to | contact.telecom[1] | |
| NK1-6 (Business Phone Number) | is equivalent to | contact.telecom[2] | |
| NK1-6 (Business Phone Number) | is equivalent to | contact.telecom[2].use | |
| NK1-7 (Contact Role) | is equivalent to | contact.relationship[2] | Should we update the names in the base FHIR standard as the names and value sets are confusing? It's normative, so has to have a very strong case. |
| NK1-8 (Start Date) | is equivalent to | contact.period.start | |
| NK1-9 (End Date) | is equivalent to | contact.period.end | |
| NK1-13 (Organization Name - NK1) | is equivalent to | contact.organization[1](Organization) | |
| NK1-15 (Administrative Sex) | is equivalent to | contact.gender | |
| NK1-30 (Contact Person's Name) | is equivalent to | contact.organization[1](Organization.contact.name) | |
| NK1-31 (Contact Person's Telephone Number) | is equivalent to | contact.organization[1](Organization.contact.telecom) | |
| NK1-32 (Contact Person's Address) | is equivalent to | contact.organization[1](Organization.contact.address) | |
| NK1-40 (Next of Kin Telecommunication Information) | is equivalent to | contact.telecom[3] | |
| NK1-41 (Contact Person's Telecommunication Information) | is equivalent to | contact.telecom[4] |
FHIR{
"resourceType": "ConceptMap",
"id": "segment-nk1-to-patient",
"text": {
"status": "generated",
"div": "<!-- snip (see above) -->"
},
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "derived-from"
},
{
"url": "label",
"valueString": "Segment NK1 to Patient.fsh"
},
{
"url": "url",
"valueUri": "https://docs.google.com/spreadsheets/d/1h9Z67WhrMJ5Va4CEY1UV_Fowy_mPHGJK-OvN6fW0GIk/edit#gid=0"
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/RelatedArtifact"
},
{
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
"valueCode": "oo"
},
{
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
"valueCode": "informative",
"_valueCode": {
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
"valueCanonical": "http://hl7.org/fhir/uv/v2mappings/ImplementationGuide/hl7.fhir.uv.v2mappings"
}
]
}
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/ConceptMap/segment-nk1-to-patient",
"version": "1.0.0",
"name": "SegmentNK1ToPatient",
"title": "Segment NK1 to Patient Map",
"status": "active",
"experimental": true,
"date": "2025-07-23",
"publisher": "HL7 International / Orders and Observations",
"contact": [
{
"name": "HL7 Orders and Observations Workgroup",
"telecom": [
{
"system": "url",
"value": "http://www.hl7.org/Special/committees/orders"
}
]
}
],
"description": "This ConceptMap represents a mapping from the HL7 V2 Segment NK1 to the FHIR Patient Resource.",
"jurisdiction": [
{
"coding": [
{
"system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
"code": "001"
}
]
}
],
"copyright": "Copyright (c) 2025, HL7 International, Inc., All Rights Reserved.",
"group": [
{
"element": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "XPN"
},
{
"url": "cardinalityMin",
"valueInteger": -1
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "NK1-2",
"display": "Name",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "HumanName"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "contact.name",
"display": "contact.name",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CWE"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "NK1-3",
"display": "Relationship",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CodeableConcept"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
},
{
"url": "mappedVia",
"valueUrl": "ConceptMap/table-hl70063-to-v3-rolecode"
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "contact.relationship[1]",
"display": "contact.relationship[1]",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "XAD"
},
{
"url": "cardinalityMin",
"valueInteger": -1
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "NK1-4",
"display": "Address",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "Address"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "contact.address",
"display": "contact.address",
"equivalence": "equivalent",
"comment": "Note the decreased cardinality for the FHIR map"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "XTN"
},
{
"url": "cardinalityMin",
"valueInteger": -1
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "NK1-5",
"display": "Phone Number",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "ContactPoint"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "contact.telecom[1]",
"display": "contact.telecom[1]",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "XTN"
},
{
"url": "cardinalityMin",
"valueInteger": -1
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "NK1-6",
"display": "Business Phone Number",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "ContactPoint"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "contact.telecom[2]",
"display": "contact.telecom[2]",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "XTN"
},
{
"url": "cardinalityMin",
"valueInteger": -1
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "NK1-6",
"display": "Business Phone Number",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "code"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
},
{
"url": "assignment",
"valueString": "\"work\""
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "contact.telecom[2].use",
"display": "contact.telecom[2].use",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CWE"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "NK1-7",
"display": "Contact Role",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CodeableConcept"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": -1
},
{
"url": "mappedVia",
"valueUrl": "ConceptMap/table-hl70131-to-v2-0131"
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "contact.relationship[2]",
"display": "contact.relationship[2]",
"equivalence": "equivalent",
"comment": "Should we update the names in the base FHIR standard as the names and value sets are confusing? It's normative, so has to have a very strong case."
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "DT"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "NK1-8",
"display": "Start Date",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "dateTime"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "contact.period.start",
"display": "contact.period.start",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "DT"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "NK1-9",
"display": "End Date",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "dateTime"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "contact.period.end",
"display": "contact.period.end",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "XON"
},
{
"url": "cardinalityMin",
"valueInteger": -1
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "NK1-13",
"display": "Organization Name - NK1",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "Reference(Organization)"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "contact.organization[1](Organization)",
"display": "contact.organization[1](Organization)",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CWE"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "NK1-15",
"display": "Administrative Sex",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "code"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
},
{
"url": "mappedVia",
"valueUrl": "ConceptMap/table-hl70001-to-administrative-gender"
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "contact.gender",
"display": "contact.gender",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "XPN"
},
{
"url": "cardinalityMin",
"valueInteger": -1
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "NK1-30",
"display": "Contact Person's Name",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "HumanName"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "contact.organization[1](Organization.contact.name)",
"display": "contact.organization[1](Organization.contact.name)",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "XTN"
},
{
"url": "cardinalityMin",
"valueInteger": -1
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "NK1-31",
"display": "Contact Person's Telephone Number",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "ContactPoint"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "contact.organization[1](Organization.contact.telecom)",
"display": "contact.organization[1](Organization.contact.telecom)",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "XAD"
},
{
"url": "cardinalityMin",
"valueInteger": -1
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "NK1-32",
"display": "Contact Person's Address",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "Address"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "contact.organization[1](Organization.contact.address)",
"display": "contact.organization[1](Organization.contact.address)",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "XTN"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "NK1-40",
"display": "Next of Kin Telecommunication Information",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "ContactPoint"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "contact.telecom[3]",
"display": "contact.telecom[3]",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "XTN"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "NK1-41",
"display": "Contact Person's Telecommunication Information",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "ContactPoint"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "contact.telecom[4]",
"display": "contact.telecom[4]",
"equivalence": "equivalent"
}
]
}
]
}
]
}