HL7 Version 2 to FHIR
1.0.0 - STU 1
HL7 Version 2 to FHIR
1.0.0 - STU 1
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 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
| Official URL: http://hl7.org/fhir/uv/v2mappings/ConceptMap/segment-nk1-to-relatedperson | Version: 1.0.0 | |||
| Standards status: Informative | Computable Name: SegmentNK1ToRelatedPerson | |||
Copyright/Legal: Copyright (c) 2025, HL7 International, Inc., All Rights Reserved. |
||||
This ConceptMap represents a mapping from the HL7 V2 Segment NK1 to the FHIR RelatedPerson Resource.
This ConceptMap represents the mapping from the HL7 V2 NK1 Segment to the FHIR RelatedPerson Resource. See also the FHIR Shorthand or the CSV Source.
| HL7 v2 | Condition (IF True, args) | HL7 FHIR | Comments | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Sort Order | Identifier | Name | Data Type | Cardinality - Min | Cardinality - Max | Computable ANTLR | Computable FHIRPath | Narrative | FHIR Attribute | Extension | Data Type | Cardinality - Min | Cardinality - Max | Data Type Mapping | Vocabulary Mapping (IS, ID, CE, CEN, CWE) | Assignment | |
| 1 | NK1-1 | Set ID - NK1 | SI | 1 | 1 | ||||||||||||
| 2 | NK1-2 | Name | XPN | 0 | -1 | RelatedPerson.name | HumanName | 0 | -1 | XPN[HumanName] | |||||||
| 3 | NK1-3 | Relationship | CWE | 0 | 1 | RelatedPerson.relationship | CodeableConcept | 0 | -1 | CWE[CodeableConcept] | Relationship | Note that the value sets between Patient.contact.relationship and RelatedPerson.relationship are quite different. See https://chat.fhir.org/#narrow/stream/179166-implementers/topic/relationship.20in.20Patient.2Econtact.20and.20RelatedPersonfor further discussion | |||||
| 4 | NK1-4 | Address | XAD | 0 | -1 | Address | Address | 0 | -1 | XAD[Address] | |||||||
| 5 | NK1-5 | Phone Number | XTN | 0 | -1 | RelatedPerson.telecom | ContactPoint | 0 | -1 | XTN[ContactPoint] | ContactPoint.use would likely be "home" or "mobile", but picked up from XTN.2 | ||||||
| 6 | NK1-6 | Business Phone Number | XTN | 0 | -1 | RelatedPerson.telecom | ContactPoint | 0 | -1 | XTN[ContactPoint] | |||||||
| 6 | NK1-6 | Business Phone Number | XTN | 0 | -1 | RelatedPerson.telecom.use | "work" | ||||||||||
| 7 | NK1-7 | Contact Role | CWE | 0 | 1 | RelatedPerson.relationship | CodeableConcept | 0 | -1 | CWE[CodeableConcept] | ContactRole | Note that the value sets between Patient.contact.relationship and RelatedPerson.relationship are quite different. RelatedPerson.relationship is allowed to repeat and so can accept values from both NK1-3 and NK1-7 See https://chat.fhir.org/#narrow/stream/179166-implementers/topic/relationship.20in.20Patient.2Econtact.20and.20RelatedPerson for further discussion | |||||
| 8 | NK1-8 | Start Date | DT | 0 | 1 | RelatedPerson.period.start | dateTime | 0 | 1 | ||||||||
| 9 | NK1-9 | End Date | DT | 0 | 1 | RelatedPerson.period.end | dateTime | 0 | 1 | ||||||||
| 10 | NK1-10 | Next of Kin / Associated Parties Job Title | ST | 0 | 1 | ||||||||||||
| 11 | NK1-11 | Next of Kin / Associated Parties Job Code/Class | JCC | 0 | 1 | ||||||||||||
| 12 | NK1-12 | Next of Kin / Associated Parties Employee Number | CX | 0 | 1 | Identifier | Identifier | 0 | -1 | CX[Identifier] | |||||||
| 13 | NK1-13 | Organization Name - NK1 | XON | 0 | -1 | Do we need to enhance the Organization resource to be able to serve as a next of kin or associated party? | |||||||||||
| 14 | NK1-14 | Marital Status | CWE | 0 | 1 | ||||||||||||
| 15 | NK1-15 | Administrative Sex | CWE | 0 | 1 | RelatedPerson.gender | code | 0 | 1 | CWE[Code] | AdministrativeSex | ||||||
| 16 | NK1-16 | Date/Time of Birth | DTM | 0 | 1 | RelatedPerson.birthDate | date | 0 | 1 | ||||||||
| 17 | NK1-17 | Living Dependency | CWE | 0 | -1 | ||||||||||||
| 18 | NK1-18 | Ambulatory Status | CWE | 0 | -1 | ||||||||||||
| 19 | NK1-19 | Citizenship | CWE | 0 | -1 | ||||||||||||
| 20 | NK1-20 | Primary Language | CWE | 0 | 1 | RelatedPerson.communication.language | CodeableConcept | 0 | -1 | CWE[CodeableConcept] | PrimaryLanguage | ||||||
| 21 | NK1-21 | Living Arrangement | CWE | 0 | 1 | ||||||||||||
| 22 | NK1-22 | Publicity Code | CWE | 0 | 1 | ||||||||||||
| 23 | NK1-23 | Protection Indicator | ID | 0 | 1 | ||||||||||||
| 24 | NK1-24 | Student Indicator | CWE | 0 | 1 | ||||||||||||
| 25 | NK1-25 | Religion | CWE | 0 | 1 | ||||||||||||
| 26 | NK1-26 | Mother's Maiden Name | XPN | 0 | -1 | We could dupicate the patient-mothersmaidenname extension and add it to RelatedPerson if we need to | |||||||||||
| 27 | NK1-27 | Nationality | CWE | 0 | 1 | ||||||||||||
| 28 | NK1-28 | Ethnic Group | CWE | 0 | -1 | ||||||||||||
| 29 | NK1-29 | Contact Reason | CWE | 0 | -1 | ||||||||||||
| 30 | NK1-30 | Contact Person's Name | XPN | 0 | -1 | RelatedPerson.name | HumanName | 0 | -1 | XPN[HumanName] | Do we need a way in RelatedPerson to distinguish between a "next of kin" and a "contact Person"? | ||||||
| 31 | NK1-31 | Contact Person's Telephone Number | XTN | 0 | -1 | RelatedPerson.telecom | ContactPoint | 0 | -1 | XTN[ContactPoint] | |||||||
| 32 | NK1-32 | Contact Person's Address | XAD | 0 | -1 | Address | Address | 0 | -1 | XAD[Address] | |||||||
| 33 | NK1-33 | Next of Kin/Associated Party's Identifiers | CX | 0 | -1 | Identifier | Identifier | 0 | -1 | CX[Identifier] | |||||||
| 34 | NK1-34 | Job Status | CWE | 0 | 1 | ||||||||||||
| 35 | NK1-35 | Race | CWE | 0 | -1 | Use your local extension, e.g., US = US Core Race Extension, AUS = indiginous extension. | |||||||||||
| 36 | NK1-36 | Handicap | CWE | 0 | 1 | ||||||||||||
| 37 | NK1-37 | Contact Person Social Security Number | ST | 0 | 1 | RelatedPerson.identifier.value | Identifier | 0 | -1 | ||||||||
| 37 | NK1-37 | Contact Person Social Security Number | ST | 0 | 1 | RelatedPerson.identifier.system | uri | 0 | -1 | "http://hl7.org/fhir/sid/us-ssn" | |||||||
| 37 | NK1-37 | Contact Person Social Security Number | ST | 0 | 1 | If in the US and various other jurisdictions | RelatedPerson.identifier.type.coding.code | code | 0 | 1 | "SS" | ||||||
| 37 | NK1-37 | Contact Person Social Security Number | ST | 0 | 1 | If outside the US for certain jurisdictions | RelatedPerson.identifier.type.coding.code | code | 0 | 1 | "SB" | ||||||
| 38 | NK1-38 | Next of Kin Birth Place | ST | 0 | 1 | ||||||||||||
| 39 | NK1-39 | VIP Indicator | CWE | 0 | 1 | ||||||||||||
| 40 | NK1-40 | Next of Kin Telecommunication Information | XTN | 0 | 1 | RelatedPerson.telecom | ContactPoint | 0 | -1 | XTN[ContactPoint] | |||||||
| 41 | NK1-41 | Contact Person's Telecommunication Information | XTN | 0 | 1 | RelatedPerson.telecom | ContactPoint | 0 | -1 | XTN[ContactPoint] | |||||||
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 | Codes from | ||||
| NK1-2 | Name | is equivalent to | name[1] | name[1] | ||
| NK1-3 | Relationship | is equivalent to | relationship[1] | relationship[1] | Note that the value sets between Patient.contact.relationship and RelatedPerson.relationship are quite different. See https://chat.fhir.org/#narrow/stream/179166-implementers/topic/relationship.20in.20Patient.2Econtact.20and.20RelatedPersonfor further discussion\ | |
| NK1-4 | Address | is equivalent to | address[1] | address[1] | ||
| NK1-5 | Phone Number | is equivalent to | telecom[1] | telecom[1] | ContactPoint.use would likely be "home" or "mobile", but picked up from XTN.2 | |
| NK1-6 | Business Phone Number | is equivalent to | telecom[2] | telecom[2] | ||
| NK1-6 | Business Phone Number | is equivalent to | telecom[2].use | telecom[2].use | ||
| NK1-7 | Contact Role | is equivalent to | relationship[2] | relationship[2] | Note that the value sets between Patient.contact.relationship and RelatedPerson.relationship are quite different. RelatedPerson.relationship is allowed to repeat and so can accept values from both NK1-3 and NK1-7 See https://chat.fhir.org/#narrow/stream/179166-implementers/topic/relationship.20in.20Patient.2Econtact.20and.20RelatedPerson for further discussion\ | |
| NK1-8 | Start Date | is equivalent to | period.start | period.start | ||
| NK1-9 | End Date | is equivalent to | period.end | period.end | ||
| NK1-12 | Next of Kin / Associated Parties Employee Number | is equivalent to | identifier[1] | identifier[1] | ||
| NK1-15 | Administrative Sex | is equivalent to | gender | gender | ||
| NK1-16 | Date/Time of Birth | is equivalent to | birthDate | birthDate | ||
| NK1-20 | Primary Language | is equivalent to | communication.language | communication.language | ||
| NK1-30 | Contact Person's Name | is equivalent to | name[2] | name[2] | Do we need a way in RelatedPerson to distinguish between a "next of kin" and a "contact Person"? | |
| NK1-31 | Contact Person's Telephone Number | is equivalent to | telecom[3] | telecom[3] | ||
| NK1-32 | Contact Person's Address | is equivalent to | address[2] | address[2] | ||
| NK1-33 | Next of Kin/Associated Party's Identifiers | is equivalent to | identifier[2] | identifier[2] | ||
| NK1-37 | Contact Person Social Security Number | is equivalent to | identifier[3].value | identifier[3].value | ||
| NK1-37 | Contact Person Social Security Number | is equivalent to | identifier[3].system | identifier[3].system | ||
| NK1-37 | Contact Person Social Security Number | If in the US and various other jurisdictions | is equivalent to | identifier[3].type.coding.code | identifier[3].type.coding.code | |
| NK1-37 | Contact Person Social Security Number | If outside the US for certain jurisdictions | is equivalent to | identifier[3].type.coding.code | identifier[3].type.coding.code | |
| NK1-40 | Next of Kin Telecommunication Information | is equivalent to | telecom[4] | telecom[4] | ||
| NK1-41 | Contact Person's Telecommunication Information | is equivalent to | telecom[5] | telecom[5] | ||
IG © 2020+ HL7 International / Orders and Observations. Package hl7.fhir.uv.v2mappings#1.0.0 based on FHIR 4.0.1. Generated 2025-08-25
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change