US Veterans Health Administration FHIR Map Set Implementation Guide
1.3.1 - 250401 United States of America flag

Publication Build: This will be filled in by the publication tooling

Resource Profile: SmokingStatusObservation - Mappings

Active as of 2025-03-31

Mappings for the SmokingStatusObservation resource profile.

Scroll down for the Raw FHIR, CDW & SDA mappings (if any).

Note that the CDW and SDA mappings are derived from a look-up based on the VistA source mappings in CDW and VPR SDA.

Mapping Sources

Use Case: Smoking Status Observation (Source)PATIENT/IHS (9000001).01NAMEV HEALTH FACTORS (9000010.23).001IEN.01HEALTH FACTOR.02PATIENT NAME.03VISIT1201EVENT DATE AND TIME1204ENCOUNTER PROVIDER81101COMMENTSHEALTH FACTORS (9999999.64).01FACTOR.03CATEGORY[TOBACCO [C]][Not TOBACCO [C]]

Raw Mappings

key status direction source mapApproach mapCase FHIR Path subPath mapValue mapParameter mapComment FHIR URL | Ver
1241 for review V2F V HEALTH FACTORS - IEN (9000010.23-.001) source value Observation.identifier .value .system = http://va.gov/identifiers/$Sta3n/9000010.23 http://hl7.org/fhir/us/core/StructureDefinition/us-core-smokingstatus | 5.0.1
1241-1 for review V2F fixed value Observation.identifier .system http://va.gov/identifiers/$Sta3n/9000010.23 generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-smokingstatus | 5.0.1
1242 for review V2F fixed value Observation.status #final http://hl7.org/fhir/us/core/StructureDefinition/us-core-smokingstatus | 5.0.1
1243 for review V2F fixed value Observation.category[SocialHistory] http://terminology.hl7.org/CodeSystem/observation-category#social-history http://hl7.org/fhir/us/core/StructureDefinition/us-core-smokingstatus | 5.0.1
1244 for review V2F V HEALTH FACTORS - HEALTH FACTOR > HEALTH FACTORS - CATEGORY (9000010.23-.01 > 9999999.64-.03) fixed value TOBACCO [C] Observation.code http://loinc.org#72166-2 http://hl7.org/fhir/us/core/StructureDefinition/us-core-smokingstatus | 5.0.1
1862 for review V2F V HEALTH FACTORS - HEALTH FACTOR > HEALTH FACTORS - CATEGORY (9000010.23-.01 > 9999999.64-.03) exclude record Not TOBACCO [C] Observation.code http://hl7.org/fhir/us/core/StructureDefinition/us-core-smokingstatus | 5.0.1
1245 for review V2F V HEALTH FACTORS - PATIENT NAME > PATIENT/IHS - NAME (9000010.23-.02 > 9000001-.01) reference Observation.subject /Patient http://hl7.org/fhir/us/core/StructureDefinition/us-core-smokingstatus | 5.0.1
1246 for review V2F V HEALTH FACTORS - VISIT (9000010.23-.03) reference Observation.encounter /EncounterOutpatient http://hl7.org/fhir/us/core/StructureDefinition/us-core-smokingstatus | 5.0.1
1247 for review V2F V HEALTH FACTORS - EVENT DATE AND TIME (9000010.23-1201) source value Observation.effectiveDateTime http://hl7.org/fhir/us/core/StructureDefinition/us-core-smokingstatus | 5.0.1
1248 for review V2F V HEALTH FACTORS - ENCOUNTER PROVIDER (9000010.23-1204) reference Observation.performer /Practitioner Only encounter provider is in CDW, so ordering provider was not included at this time. If ordering provider needs to be included in the future, will need to determine a way to distinguish ordering provider from encounter provider in the practitioner resource. http://hl7.org/fhir/us/core/StructureDefinition/us-core-smokingstatus | 5.0.1
1249 for review V2F V HEALTH FACTORS - HEALTH FACTOR > HEALTH FACTORS - FACTOR (9000010.23-.01 > 9999999.64-.01) terminologyMaps Observation.valueCodeableConcept VF_SmokingStatus .text = {FACTOR (.01)} If duplicates occur, the latest instance only should be sent. http://hl7.org/fhir/us/core/StructureDefinition/us-core-smokingstatus | 5.0.1
1249-1 for review V2F V HEALTH FACTORS - HEALTH FACTOR > HEALTH FACTORS - FACTOR (9000010.23-.01 > 9999999.64-.01) source value Observation.valueCodeableConcept .text generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-smokingstatus | 5.0.1
1250 for review V2F V HEALTH FACTORS - COMMENTS (9000010.23-81101) source value Observation.note .text http://hl7.org/fhir/us/core/StructureDefinition/us-core-smokingstatus | 5.0.1

Mappings for Veterans Health Information Systems Technology and Architecture (VistA) ()

SmokingStatusObservation
Observation
   identifier
      system1241-1: fixed value = http://va.gov/identifiers/$Sta3n/9000010.23

generated from mapParameter line 1

      value1241: source value based on V HEALTH FACTORS - IEN (9000010.23-.001)
   status1242: fixed value = #final
   category (SocialHistory)1243: fixed value = http://terminology.hl7.org/CodeSystem/observation-category#social-history
   code1244: fixed value = http://loinc.org#72166-2 when V HEALTH FACTORS - HEALTH FACTOR > HEALTH FACTORS - CATEGORY (9000010.23-.01 > 9999999.64-.03) if TOBACCO [C], 1862: exclude record if Not TOBACCO [C],
   subject1245: reference based on V HEALTH FACTORS - PATIENT NAME > PATIENT/IHS - NAME (9000010.23-.02 > 9000001-.01)
   encounter1246: reference based on V HEALTH FACTORS - VISIT (9000010.23-.03)
   effective[x] (effectiveDateTime)1247: source value based on V HEALTH FACTORS - EVENT DATE AND TIME (9000010.23-1201)
   performer1248: reference based on V HEALTH FACTORS - ENCOUNTER PROVIDER (9000010.23-1204)

Only encounter provider is in CDW, so ordering provider was not included at this time. If ordering provider needs to be included in the future, will need to determine a way to distinguish ordering provider from encounter provider in the practitioner resource.

   value[x]
   value[x] (valueCodeableConcept)1249: terminologyMaps using VF_SmokingStatus on V HEALTH FACTORS - HEALTH FACTOR > HEALTH FACTORS - FACTOR (9000010.23-.01 > 9999999.64-.01)

If duplicates occur, the latest instance only should be sent.

      text1249-1: source value based on V HEALTH FACTORS - HEALTH FACTOR > HEALTH FACTORS - FACTOR (9000010.23-.01 > 9999999.64-.01)

generated from mapParameter line 1

   note
      text1250: source value based on V HEALTH FACTORS - COMMENTS (9000010.23-81101)

Mappings for Clinical Data Warehouse (CDW) ()

SmokingStatusObservation
Observation
   codeHF.HealthFactor.HealthFactorTypeIEN Dim.HealthFactorType.CategoryHealthFactorTypeIEN
   subjectHF.HealthFactor.PatientIEN
   encounterHF.HealthFactor.VisitDateTime,HF.HealthFactor.VisitIEN
   effective[x] (effectiveDateTime)HF.HealthFactor.EventDateTime
   performerHF.HealthFactor.EncounterStaffIEN
   value[x]
   value[x] (valueCodeableConcept)HF.HealthFactor.HealthFactorTypeIEN Dim.HealthFactorType.HealthFactorCategory,Dim.HealthFactorType.HealthFactorType
      textHF.HealthFactor.HealthFactorTypeIEN Dim.HealthFactorType.HealthFactorCategory,Dim.HealthFactorType.HealthFactorType
   note
      textHF.HealthFactor.Comments

Mappings for Summary Document Architecure (SDA) ()

SmokingStatusObservation
Observation
   codeSocialHistory.SocialHabit,SocialHistory.SocialHabitCategory,SocialHistory.Extension[SocialHistoryExtension].Category,SocialHistory.Extension[SocialHistoryExtension].QuantityLabel,SocialHistory.SocialHabitCategory.Description,Vaccination.OrderItem,FamilyHistory.Diagnosis,FamilyHistory.Extension[FamilyHistoryExtension].Category,FamilyHistory.Diagnosis.Description
   encounterSocialHistory.EncounterNumber,SocialHistory.EnteredAt,SocialHistory.EnteredBy,SocialHistory.EnteredOn,Vaccination.EncounterNumber,Vaccination.EnteredAt,Vaccination.EnteredBy,Vaccination.EnteredOn,Vaccination.Administration.AdministeredAtLocation,FamilyHistory.EncounterNumber,FamilyHistory.EnteredAt,FamilyHistory.EnteredBy,FamilyHistory.EnteredOn
   effective[x] (effectiveDateTime)SocialHistory.FromTime,Vaccination.FromTime,Vaccination.ToTime,FamilyHistory.FromTime
   performerVaccination.Administration.AdministeringProvider
   value[x]
   value[x] (valueCodeableConcept)SocialHistory.SocialHabit,SocialHistory.SocialHabitCategory,SocialHistory.Extension[SocialHistoryExtension].Category,SocialHistory.Extension[SocialHistoryExtension].QuantityLabel,SocialHistory.SocialHabitCategory.Description,Vaccination.OrderItem,FamilyHistory.Diagnosis,FamilyHistory.Extension[FamilyHistoryExtension].Category,FamilyHistory.Diagnosis.Description Vaccination.OrderItem[Order].Description
      textSocialHistory.SocialHabit,SocialHistory.SocialHabitCategory,SocialHistory.Extension[SocialHistoryExtension].Category,SocialHistory.Extension[SocialHistoryExtension].QuantityLabel,SocialHistory.SocialHabitCategory.Description,Vaccination.OrderItem,FamilyHistory.Diagnosis,FamilyHistory.Extension[FamilyHistoryExtension].Category,FamilyHistory.Diagnosis.Description Vaccination.OrderItem[Order].Description
   note
      textSocialHistory.SocialHabitComments,Vaccination.Administration.RefusalReason,FamilyHistory.NoteText

Mappings for Workflow Pattern (http://hl7.org/fhir/workflow)

SmokingStatusObservation
ObservationEvent
   identifierEvent.identifier
   basedOnEvent.basedOn
   partOfEvent.partOf
   statusEvent.status
   codeEvent.code
   subjectEvent.subject
   encounterEvent.context
   effective[x]Event.occurrence[x]
   effective[x] (effectiveDateTime)Event.occurrence[x]
   performerEvent.performer.actor

Mappings for SNOMED CT Concept Domain Binding (http://snomed.info/conceptdomain)

SmokingStatusObservation
Observation< 363787002 |Observable entity|
   status< 445584004 |Report by finality status|
   code< 363787002 |Observable entity| OR < 386053000 |Evaluation procedure|
   value[x]< 441742003 |Evaluation finding|
   value[x] (valueCodeableConcept)< 441742003 |Evaluation finding|
   interpretation< 260245000 |Findings values|
   bodySite< 123037004 |Body structure|
   specimen< 123038009 |Specimen|
   device< 49062001 |Device|
   referenceRange
      type< 260245000 |Findings values| OR < 365860008 |General clinical state finding| OR < 250171008 |Clinical history or observation findings| OR < 415229000 |Racial group| OR < 365400002 |Finding of puberty stage| OR < 443938003 |Procedure carried out on subject|
      appliesTo< 260245000 |Findings values| OR < 365860008 |General clinical state finding| OR < 250171008 |Clinical history or observation findings| OR < 415229000 |Racial group| OR < 365400002 |Finding of puberty stage| OR < 443938003 |Procedure carried out on subject|
   component
      code< 363787002 |Observable entity| OR < 386053000 |Evaluation procedure|
      value[x]363714003 |Interprets| < 441742003 |Evaluation finding|
      interpretation< 260245000 |Findings values|

Mappings for HL7 v2 Mapping (http://hl7.org/v2)

SmokingStatusObservation
ObservationOBX
   identifierOBX.21 For OBX segments from systems without OBX-21 support a combination of ORC/OBR and OBX must be negotiated between trading partners to uniquely identify the OBX segment. Depending on how V2 has been implemented each of these may be an option: 1) OBR-3 + OBX-3 + OBX-4 or 2) OBR-3 + OBR-4 + OBX-3 + OBX-4 or 2) some other way to uniquely ID the OBR/ORC + OBX-3 + OBX-4.
      useN/A
      typeCX.5
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodCX.7 + CX.8
      assignerCX.4 / (CX.4,CX.9,CX.10)
   basedOnORC
   partOfVaries by domain
   statusOBX-11
   codeOBX-3
   subjectPID-3
   focusOBX-3
   encounterPV1
   effective[x]OBX-14, and/or OBX-19 after v2.4 (depends on who observation made)
   effective[x] (effectiveDateTime)OBX-14, and/or OBX-19 after v2.4 (depends on who observation made)
   issuedOBR.22 (or MSH.7), or perhaps OBX-19 (depends on who observation made)
   performerOBX.15 / (Practitioner) OBX-16, PRT-5:PRT-4='RO' / (Device) OBX-18 , PRT-10:PRT-4='EQUIP' / (Organization) OBX-23, PRT-8:PRT-4='PO'
   value[x]OBX.2, OBX.5, OBX.6
   value[x] (valueCodeableConcept)OBX.2, OBX.5, OBX.6
      codingC*E.1-8, C*E.10-22
      textC*E.9. But note many systems use C*E.2 for this
   dataAbsentReasonN/A
   interpretationOBX-8
   noteNTE.3 (partner NTE to OBX, or sometimes another (child?) OBX)
      author[x]N/A
      timeN/A
      textN/A
   bodySiteOBX-20
   methodOBX-17
   specimenSPM segment
   deviceOBX-17 / PRT -10
   referenceRangeOBX.7
      lowOBX-7
      highOBX-7
      typeOBX-10
      appliesToOBX-10
      textOBX-7
   hasMemberRelationships established by OBX-4 usage
   derivedFromRelationships established by OBX-4 usage
   componentcontainment by OBX-4?
      codeOBX-3
      value[x]OBX.2, OBX.5, OBX.6
      dataAbsentReasonN/A
      interpretationOBX-8
      referenceRangeOBX.7

Mappings for RIM Mapping (http://hl7.org/v3)

SmokingStatusObservation
ObservationEntity. Role, or Act, Observation[classCode=OBS, moodCode=EVN]
   textAct.text?
   containedN/A
   extensionN/A
   modifierExtensionN/A
   identifierid
      idn/a
      extensionn/a
      useRole.code or implied by context
      typeRole.code or implied by context
      systemII.root or Role.id.root
      valueII.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
      periodRole.effectiveTime or implied by context
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   basedOn.inboundRelationship[typeCode=COMP].source[moodCode=EVN]
   partOf.outboundRelationship[typeCode=FLFS].target
   statusstatus Amended & Final are differentiated by whether it is the subject of a ControlAct event with a type of "revise"
   category.outboundRelationship[typeCode="COMP].target[classCode="LIST", moodCode="EVN"].code
   category (SocialHistory).outboundRelationship[typeCode="COMP].target[classCode="LIST", moodCode="EVN"].code
   codecode
   subjectparticipation[typeCode=RTGT]
   focusparticipation[typeCode=SBJ]
   encounterinboundRelationship[typeCode=COMP].source[classCode=ENC, moodCode=EVN]
   effective[x]effectiveTime
   effective[x] (effectiveDateTime)effectiveTime
   issuedparticipation[typeCode=AUT].time
   performerparticipation[typeCode=PRF]
   value[x]value
   value[x] (valueCodeableConcept)value
      idn/a
      extensionn/a
      codingunion(., ./translation)
      text./originalText[mediaType/code="text/plain"]/data
   dataAbsentReasonvalue.nullFlavor
   interpretationinterpretationCode
   notesubjectOf.observationEvent[code="annotation"].value
      idn/a
      extensionn/a
      author[x]Act.participant[typeCode=AUT].role
      timeAct.effectiveTime
      textAct.text
   bodySitetargetSiteCode
   methodmethodCode
   specimenparticipation[typeCode=SPC].specimen
   deviceparticipation[typeCode=DEV]
   referenceRangeoutboundRelationship[typeCode=REFV]/target[classCode=OBS, moodCode=EVN]
      idn/a
      extensionn/a
      modifierExtensionN/A
      lowvalue:IVL_PQ.low
      highvalue:IVL_PQ.high
      typeinterpretationCode
      appliesTointerpretationCode
      ageoutboundRelationship[typeCode=PRCN].targetObservationCriterion[code="age"].value
      textvalue:ST
   hasMemberoutBoundRelationship
   derivedFrom.targetObservation
   componentoutBoundRelationship[typeCode=COMP]
      idn/a
      extensionn/a
      modifierExtensionN/A
      codecode
      value[x]value
      dataAbsentReasonvalue.nullFlavor
      interpretationinterpretationCode
      referenceRangeoutboundRelationship[typeCode=REFV]/target[classCode=OBS, moodCode=EVN]

Mappings for FiveWs Pattern Mapping (http://hl7.org/fhir/fivews)

SmokingStatusObservation
Observation
   identifierFiveWs.identifier
   statusFiveWs.status
   categoryFiveWs.class
   category (SocialHistory)FiveWs.class
   codeFiveWs.what[x]
   subjectFiveWs.subject[x], FiveWs.subject
   focusFiveWs.subject[x], FiveWs.subject
   encounterFiveWs.context
   effective[x]FiveWs.done[x]
   effective[x] (effectiveDateTime)FiveWs.done[x]
   issuedFiveWs.recorded
   performerFiveWs.actor
   component
      codeFiveWs.what[x]

Mappings for SNOMED CT Attribute Binding (http://snomed.org/attributebinding)

SmokingStatusObservation
Observation
   code116680003 |Is a|
   value[x]363714003 |Interprets|
   value[x] (valueCodeableConcept)363714003 |Interprets|
   interpretation363713009 |Has interpretation|
   bodySite718497002 |Inherent location|
   specimen704319004 |Inherent in|
   device424226004 |Using device|
   component
      value[x]363714003 |Interprets|
      interpretation363713009 |Has interpretation|