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: Segment NK1 to RelatedPerson Map (Experimental)

Official URL: http://hl7.org/fhir/uv/v2mappings/segment-nk1-to-relatedperson Version: 1.0.0-ballot
Active as of 2024-12-20 Computable Name: SegmentNK1ToRelatedPerson

Copyright/Legal: Copyright (c) 2020, 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 v2Condition (IF True, args)HL7 FHIRComments
Sort OrderIdentifierNameData TypeCardinality - MinCardinality - MaxComputable ANTLRComputable FHIRPathNarrativeFHIR AttributeExtensionData TypeCardinality - MinCardinality - MaxData Type MappingVocabulary Mapping
(IS, ID, CE, CEN, CWE)		Assignment
1NK1-1Set ID - NK1SI11
2NK1-2NameXPN0-1RelatedPerson.nameRelatedPerson.HumanName0-1XPN[HumanName]
3NK1-3RelationshipCWE01RelatedPerson.relationshipRelatedPerson.CodeableConcept0-1CWE[CodeableConcept]RelationshipNote 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
4NK1-4AddressXAD0-1RelatedPerson.addressRelatedPerson.Address0-1XAD[Address]
5NK1-5Phone NumberXTN0-1RelatedPerson.telecomRelatedPerson.ContactPoint0-1XTN[ContactPoint]ContactPoint.use would likely be "home" or "mobile", but picked up from XTN.2
6NK1-6Business Phone NumberXTN0-1RelatedPerson.telecomRelatedPerson.ContactPoint0-1XTN[ContactPoint]
6NK1-6Business Phone NumberXTN0-1RelatedPerson.telecom.use"work"
7NK1-7Contact RoleCWE01RelatedPerson.relationshipRelatedPerson.CodeableConcept0-1CWE[CodeableConcept]ContactRoleNote 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
8NK1-8Start DateDT01RelatedPerson.period.startRelatedPerson.dateTime01
9NK1-9End DateDT01RelatedPerson.period.endRelatedPerson.dateTime01
10NK1-10Next of Kin / Associated Parties Job TitleST01
11NK1-11Next of Kin / Associated Parties Job Code/ClassJCC01
12NK1-12Next of Kin / Associated Parties Employee NumberCX01RelatedPerson.identifierRelatedPerson.Identifier0-1CX[Identifier]
13NK1-13Organization Name - NK1XON0-1Do we need to enhance the Organization resource to be able to serve as a next of kin or associated party?
14NK1-14Marital StatusCWE01
15NK1-15Administrative SexCWE01RelatedPerson.genderRelatedPerson.code01CWE[Code]AdministrativeSex
16NK1-16Date/Time of BirthDTM01RelatedPerson.birthDateRelatedPerson.date01
17NK1-17Living DependencyCWE0-1
18NK1-18Ambulatory StatusCWE0-1
19NK1-19CitizenshipCWE0-1
20NK1-20Primary LanguageCWE01RelatedPerson.communication.languageRelatedPerson.CodeableConcept0-1CWE[CodeableConcept]PrimaryLanguage
21NK1-21Living ArrangementCWE01
22NK1-22Publicity CodeCWE01
23NK1-23Protection IndicatorID01
24NK1-24Student IndicatorCWE01
25NK1-25ReligionCWE01
26NK1-26Mother's Maiden NameXPN0-1We could dupicate the patient-mothersmaidenname extension and add it to RelatedPerson if we need to
27NK1-27NationalityCWE01
28NK1-28Ethnic GroupCWE0-1
29NK1-29Contact ReasonCWE0-1
30NK1-30Contact Person's NameXPN0-1RelatedPerson.nameRelatedPerson.HumanName0-1XPN[HumanName]Do we need a way in RelatedPerson to distinguish between a "next of kin" and a "contact Person"?
31NK1-31Contact Person's Telephone NumberXTN0-1RelatedPerson.telecomRelatedPerson.ContactPoint0-1XTN[ContactPoint]
32NK1-32Contact Person's AddressXAD0-1RelatedPerson.addressRelatedPerson.Address0-1XAD[Address]
33NK1-33Next of Kin/Associated Party's IdentifiersCX0-1RelatedPerson.identifierRelatedPerson.Identifier0-1CX[Identifier]
34NK1-34Job StatusCWE01
35NK1-35RaceCWE0-1Use your local extension, e.g., US = US Core Race Extension, AUS = indiginous extension.
36NK1-36HandicapCWE01
37NK1-37Contact Person Social Security NumberST01RelatedPerson.identifier.valueRelatedPerson.Identifier0-1
37NK1-37Contact Person Social Security NumberST01RelatedPerson.identifier.systemRelatedPerson.uri0-1"http://hl7.org/fhir/sid/us-ssn"
37NK1-37Contact Person Social Security NumberST01If in the US and various other jurisdictionsRelatedPerson.identifier.type.coding.codeRelatedPerson.code01"SS"
37NK1-37Contact Person Social Security NumberST01If outside the US for certain jurisdictionsRelatedPerson.identifier.type.coding.codeRelatedPerson.code01"SB"
38NK1-38Next of Kin Birth PlaceST01
39NK1-39VIP IndicatorCWE01
40NK1-40Next of Kin Telecommunication InformationXTN01RelatedPerson.telecomRelatedPerson.ContactPoint0-1XTN[ContactPoint]
41NK1-41Contact Person's Telecommunication InformationXTN01RelatedPerson.telecomRelatedPerson.ContactPoint0-1XTN[ContactPoint]

Generated Narrative: ConceptMap segment-nk1-to-relatedperson

Mapping from NK1 to RelatedPerson


Group 1 Mapping from unspecified code system to unspecified code system

Source CodeRelationshipTarget CodeComment
NK1-2 (Name)is equivalent toname[1]
NK1-3 (Relationship)is equivalent torelationship[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 toaddress[1]
NK1-5 (Phone Number)is equivalent totelecom[1]ContactPoint.use would likely be "home" or "mobile", but picked up from XTN.2
NK1-6 (Business Phone Number)is equivalent totelecom[2]
NK1-6 (Business Phone Number)is equivalent totelecom[2].use
NK1-7 (Contact Role)is equivalent torelationship[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 toperiod.start
NK1-9 (End Date)is equivalent toperiod.end
NK1-12 (Next of Kin / Associated Parties Employee Number)is equivalent toidentifier[1]
NK1-15 (Administrative Sex)is equivalent togender
NK1-16 (Date/Time of Birth)is equivalent tobirthDate
NK1-20 (Primary Language)is equivalent tocommunication.language
NK1-30 (Contact Person's Name)is equivalent toname[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 totelecom[3]
NK1-32 (Contact Person's Address)is equivalent toaddress[2]
NK1-33 (Next of Kin/Associated Party's Identifiers)is equivalent toidentifier[2]
NK1-37 (Contact Person Social Security Number)is equivalent toidentifier[3].value
NK1-37 (Contact Person Social Security Number)is equivalent toidentifier[3].system
NK1-37 (Contact Person Social Security Number)is equivalent toidentifier[3].type.coding.code
NK1-37 (Contact Person Social Security Number)is equivalent toidentifier[3].type.coding.code
NK1-40 (Next of Kin Telecommunication Information)is equivalent totelecom[4]
NK1-41 (Contact Person's Telecommunication Information)is equivalent totelecom[5]

Notes: