US Veterans Health Administration FHIR Map Set Implementation Guide
1.3.1 - 250401
Publication Build: This will be filled in by the publication tooling
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.
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 |
SmokingStatusObservation | ||
Observation | ||
identifier | ||
system | 1241-1: fixed value = http://va.gov/identifiers/$Sta3n/9000010.23 | generated from mapParameter line 1 |
value | 1241: source value based on V HEALTH FACTORS - IEN (9000010.23-.001) | |
status | 1242: fixed value = #final | |
category (SocialHistory) | 1243: fixed value = http://terminology.hl7.org/CodeSystem/observation-category#social-history | |
code | 1244: 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] | , |
subject | 1245: reference based on V HEALTH FACTORS - PATIENT NAME > PATIENT/IHS - NAME (9000010.23-.02 > 9000001-.01) | |
encounter | 1246: 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) | |
performer | 1248: 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. |
text | 1249-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 | ||
text | 1250: source value based on V HEALTH FACTORS - COMMENTS (9000010.23-81101) |
SmokingStatusObservation | ||
Observation | ||
code | HF.HealthFactor.HealthFactorTypeIEN Dim.HealthFactorType.CategoryHealthFactorTypeIEN | |
subject | HF.HealthFactor.PatientIEN | |
encounter | HF.HealthFactor.VisitDateTime,HF.HealthFactor.VisitIEN | |
effective[x] (effectiveDateTime) | HF.HealthFactor.EventDateTime | |
performer | HF.HealthFactor.EncounterStaffIEN | |
value[x] | ||
value[x] (valueCodeableConcept) | HF.HealthFactor.HealthFactorTypeIEN Dim.HealthFactorType.HealthFactorCategory,Dim.HealthFactorType.HealthFactorType | |
text | HF.HealthFactor.HealthFactorTypeIEN Dim.HealthFactorType.HealthFactorCategory,Dim.HealthFactorType.HealthFactorType | |
note | ||
text | HF.HealthFactor.Comments |
SmokingStatusObservation | ||
Observation | ||
code | 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 | |
encounter | SocialHistory.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 | |
performer | Vaccination.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 | |
text | 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 | |
note | ||
text | SocialHistory.SocialHabitComments,Vaccination.Administration.RefusalReason,FamilyHistory.NoteText |
SmokingStatusObservation | ||
Observation | Event | |
identifier | Event.identifier | |
basedOn | Event.basedOn | |
partOf | Event.partOf | |
status | Event.status | |
code | Event.code | |
subject | Event.subject | |
encounter | Event.context | |
effective[x] | Event.occurrence[x] | |
effective[x] (effectiveDateTime) | Event.occurrence[x] | |
performer | Event.performer.actor |
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| |
SmokingStatusObservation | ||
Observation | OBX | |
identifier | OBX.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. | |
use | N/A | |
type | CX.5 | |
system | CX.4 / EI-2-4 | |
value | CX.1 / EI.1 | |
period | CX.7 + CX.8 | |
assigner | CX.4 / (CX.4,CX.9,CX.10) | |
basedOn | ORC | |
partOf | Varies by domain | |
status | OBX-11 | |
code | OBX-3 | |
subject | PID-3 | |
focus | OBX-3 | |
encounter | PV1 | |
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) | |
issued | OBR.22 (or MSH.7), or perhaps OBX-19 (depends on who observation made) | |
performer | OBX.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 | |
coding | C*E.1-8, C*E.10-22 | |
text | C*E.9. But note many systems use C*E.2 for this | |
dataAbsentReason | N/A | |
interpretation | OBX-8 | |
note | NTE.3 (partner NTE to OBX, or sometimes another (child?) OBX) | |
author[x] | N/A | |
time | N/A | |
text | N/A | |
bodySite | OBX-20 | |
method | OBX-17 | |
specimen | SPM segment | |
device | OBX-17 / PRT -10 | |
referenceRange | OBX.7 | |
low | OBX-7 | |
high | OBX-7 | |
type | OBX-10 | |
appliesTo | OBX-10 | |
text | OBX-7 | |
hasMember | Relationships established by OBX-4 usage | |
derivedFrom | Relationships established by OBX-4 usage | |
component | containment by OBX-4? | |
code | OBX-3 | |
value[x] | OBX.2, OBX.5, OBX.6 | |
dataAbsentReason | N/A | |
interpretation | OBX-8 | |
referenceRange | OBX.7 |
SmokingStatusObservation | ||
Observation | Entity. Role, or Act, Observation[classCode=OBS, moodCode=EVN] | |
text | Act.text? | |
contained | N/A | |
extension | N/A | |
modifierExtension | N/A | |
identifier | id | |
id | n/a | |
extension | n/a | |
use | Role.code or implied by context | |
type | Role.code or implied by context | |
system | II.root or Role.id.root | |
value | II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root) | |
period | Role.effectiveTime or implied by context | |
assigner | II.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 | |
status | status 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 | |
code | code | |
subject | participation[typeCode=RTGT] | |
focus | participation[typeCode=SBJ] | |
encounter | inboundRelationship[typeCode=COMP].source[classCode=ENC, moodCode=EVN] | |
effective[x] | effectiveTime | |
effective[x] (effectiveDateTime) | effectiveTime | |
issued | participation[typeCode=AUT].time | |
performer | participation[typeCode=PRF] | |
value[x] | value | |
value[x] (valueCodeableConcept) | value | |
id | n/a | |
extension | n/a | |
coding | union(., ./translation) | |
text | ./originalText[mediaType/code="text/plain"]/data | |
dataAbsentReason | value.nullFlavor | |
interpretation | interpretationCode | |
note | subjectOf.observationEvent[code="annotation"].value | |
id | n/a | |
extension | n/a | |
author[x] | Act.participant[typeCode=AUT].role | |
time | Act.effectiveTime | |
text | Act.text | |
bodySite | targetSiteCode | |
method | methodCode | |
specimen | participation[typeCode=SPC].specimen | |
device | participation[typeCode=DEV] | |
referenceRange | outboundRelationship[typeCode=REFV]/target[classCode=OBS, moodCode=EVN] | |
id | n/a | |
extension | n/a | |
modifierExtension | N/A | |
low | value:IVL_PQ.low | |
high | value:IVL_PQ.high | |
type | interpretationCode | |
appliesTo | interpretationCode | |
age | outboundRelationship[typeCode=PRCN].targetObservationCriterion[code="age"].value | |
text | value:ST | |
hasMember | outBoundRelationship | |
derivedFrom | .targetObservation | |
component | outBoundRelationship[typeCode=COMP] | |
id | n/a | |
extension | n/a | |
modifierExtension | N/A | |
code | code | |
value[x] | value | |
dataAbsentReason | value.nullFlavor | |
interpretation | interpretationCode | |
referenceRange | outboundRelationship[typeCode=REFV]/target[classCode=OBS, moodCode=EVN] |
SmokingStatusObservation | ||
Observation | ||
identifier | FiveWs.identifier | |
status | FiveWs.status | |
category | FiveWs.class | |
category (SocialHistory) | FiveWs.class | |
code | FiveWs.what[x] | |
subject | FiveWs.subject[x], FiveWs.subject | |
focus | FiveWs.subject[x], FiveWs.subject | |
encounter | FiveWs.context | |
effective[x] | FiveWs.done[x] | |
effective[x] (effectiveDateTime) | FiveWs.done[x] | |
issued | FiveWs.recorded | |
performer | FiveWs.actor | |
component | ||
code | FiveWs.what[x] |
SmokingStatusObservation | ||
Observation | ||
code | 116680003 |Is a| | |
value[x] | 363714003 |Interprets| | |
value[x] (valueCodeableConcept) | 363714003 |Interprets| | |
interpretation | 363713009 |Has interpretation| | |
bodySite | 718497002 |Inherent location| | |
specimen | 704319004 |Inherent in| | |
device | 424226004 |Using device| | |
component | ||
value[x] | 363714003 |Interprets| | |
interpretation | 363713009 |Has interpretation| |