Vital Signs: SpO2 - Mappings - US Veterans Health Administration FHIR Map Set Implementation Guide v1.9.0

US Veterans Health Administration FHIR Map Set Implementation Guide
1.9.0 - 251001 United States of America flag

US Veterans Health Administration FHIR Map Set Implementation Guide - Downloaded Version 1.9.0 See the Directory of published versions

Resource Profile: VitalSignsSpO2 - Mappings

Active as of 2025-09-30

Mappings for the VitalSignsSpO2 resource profile.

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

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

Mapping Sources

Raw Mappings

key	status	direction	source	mapApproach	mapCase	FHIR Path	subPath	mapValue	mapParameter	mapComment	FHIR URL \| Ver
1239	for review	V2F	GMRV VITAL MEASUREMENT - SUPPLEMENTAL O2 (120.5-1.4)	transform	VUID = 4500637	Observation.component[FlowRate]	.valueQuantity.value	Split_SpO2_value.Flow()	.valueQuantity.code = #L/min .valueQuantity.unit = L/min .code = http://loinc.org#3151-8	Value needs to be parsed from VistA	http://hl7.org/fhir/us/core/StructureDefinition/us-core-pulse-oximetry \| 5.0.1
1240	for review	V2F	GMRV VITAL MEASUREMENT - SUPPLEMENTAL O2 (120.5-1.4)	transform	VUID = 4500637	Observation.component[Concentration]	.valueQuantity.value	Split_SpO2_value.Consentration()	.valueQuantity.code = #% .valueQuantity.unit = % .code = http://loinc.org#3150-0	Value needs to be parsed from VistA	http://hl7.org/fhir/us/core/StructureDefinition/us-core-pulse-oximetry \| 5.0.1
652	for review	V2F	GMRV VITAL MEASUREMENT - DATE/TIME VITALS ENTERED (120.5-.04)	source value		Observation.issued					http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs \| 5.0.1
1653	for review	V2F	GMRV VITAL MEASUREMENT - HOSPITAL LOCATION (120.5-.05)	reference		Observation.performer		/Organization			http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs \| 5.0.1
655	for review	V2F	GMRV VITAL MEASUREMENT - REASON ENTERED IN ERROR (120.5-4)	fixed value	null	Observation.status		#final			http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs \| 5.0.1
656	for review	V2F	GMRV VITAL MEASUREMENT - REASON ENTERED IN ERROR (120.5-4)	fixed value	not null	Observation.status		#entered-in-error			http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs \| 5.0.1
657	for review	V2F	GMRV VITAL MEASUREMENT - DATE/TIME VITALS TAKEN (120.5-.01)	source value		Observation.effectiveDateTime					http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs \| 5.0.1
658	for review	V2F		fixed value		Observation.category[VSCat]		http://terminology.hl7.org/CodeSystem/observation-category#vital-signs			http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs \| 5.0.1
659	for review	V2F	GMRV VITAL MEASUREMENT - PATIENT (120.5-.02)	reference		Observation.subject		/Patient			http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs \| 5.0.1
660	for review	V2F	GMRV VITAL MEASUREMENT - IEN (120.5-.001)	source value		Observation.identifier	.value		.system = http://va.gov/identifiers/$Sta3n/120.5		http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs \| 5.0.1
661	for review	V2F	GMRV VITAL MEASUREMENT - VITAL TYPE > GMRV VITAL TYPE - VUID (120.5-.03 > 120.51-99.99)	terminologyMaps		Observation.code	.coding	VF_VitalsCodes		Pulse Oximetry has 2 code values per US Core	http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs \| 5.0.1
662	for review	V2F	GMRV VITAL MEASUREMENT - QUALIFIER > GMRV VITAL QUALIFIER - VUID (120.5-5 > 120.52-99.99)	terminologyMaps		Observation.bodySite		VF_VitalsBodySite			http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs \| 5.0.1
663	for review	V2F	GMRV VITAL MEASUREMENT - QUALIFIER > GMRV VITAL QUALIFIER - VUID (120.5-5 > 120.52-99.99)	terminologyMaps		Observation.extension[http://hl7.org/fhir/StructureDefinition/observation-deviceCode].valueCodeableConcept		VF_VitalsMeasurementDevice			http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs \| 5.0.1
867	for review	V2F	GMRV VITAL MEASUREMENT - QUALIFIER > GMRV VITAL QUALIFIER - VUID (120.5-5 > 120.52-99.99)	terminologyMaps		Observation.method		VF_VitalsMethod			http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs \| 5.0.1
1802	for review	V2F	GMRV VITAL MEASUREMENT - QUALIFIER > GMRV VITAL QUALIFIER - VUID (120.5-5 > 120.52-99.99)	terminologyMaps		Observation.component[va-pre-condition]	.valueCodeableConcept	VF_VitalsPrecondition	.code = http://loinc.org#104158-1 "Associated precondition - Reported"		http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs \| 5.0.1
1803	for review	V2F	GMRV VITAL MEASUREMENT - QUALIFIER > GMRV VITAL QUALIFIER - VUID (120.5-5 > 120.52-99.99)	terminologyMaps		Observation.component[va-pre-condition-device]	.valueCodeableConcept	VF_VitalsQualifyingDevice	.code = http://loinc.org#104158-1 "Associated precondition - Reported"		http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs \| 5.0.1
1804	for review	V2F	GMRV VITAL MEASUREMENT - QUALIFIER > GMRV VITAL QUALIFIER - VUID (120.5-5 > 120.52-99.99)	terminologyMaps		Observation.extension[http://hl7.org/fhir/StructureDefinition/observation-bodyPosition]	.valueCodeableConcept	VF_VitalsBodyPosition			http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs \| 5.0.1
664	for review	V2F	GMRV VITAL MEASUREMENT - RATE (120.5-1.2)	source value	VUID not = 4500634	Observation.valueQuantity	.value				http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs \| 5.0.1
665	for review	V2F	GMRV VITAL MEASUREMENT - VITAL TYPE (120.5-.03)	transform		Observation.valueQuantity	.code	VF_VitalsUnits		VPR may transform	http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs \| 5.0.1

key

status

direction

source

mapApproach

mapCase

FHIR Path

subPath

mapValue

mapParameter

mapComment

FHIR URL | Ver

1239

for review

V2F

GMRV VITAL MEASUREMENT - SUPPLEMENTAL O2 (120.5-1.4)

transform

VUID = 4500637

Observation.component[FlowRate]

.valueQuantity.value

Split_SpO2_value.Flow()

.valueQuantity.code = #L/min
.valueQuantity.unit = L/min
.code = http://loinc.org#3151-8

Value needs to be parsed from VistA

http://hl7.org/fhir/us/core/StructureDefinition/us-core-pulse-oximetry | 5.0.1

1240

for review

V2F

GMRV VITAL MEASUREMENT - SUPPLEMENTAL O2 (120.5-1.4)

transform

VUID = 4500637

Observation.component[Concentration]

.valueQuantity.value

Split_SpO2_value.Consentration()

.valueQuantity.code = #%
.valueQuantity.unit = %
.code = http://loinc.org#3150-0

Value needs to be parsed from VistA

http://hl7.org/fhir/us/core/StructureDefinition/us-core-pulse-oximetry | 5.0.1

652

for review

V2F

GMRV VITAL MEASUREMENT - DATE/TIME VITALS ENTERED (120.5-.04)

source value

Observation.issued

http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs | 5.0.1

1653

for review

V2F

GMRV VITAL MEASUREMENT - HOSPITAL LOCATION (120.5-.05)

reference

Observation.performer

/Organization

http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs | 5.0.1

655

for review

V2F

GMRV VITAL MEASUREMENT - REASON ENTERED IN ERROR (120.5-4)

fixed value

null

Observation.status

#final

http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs | 5.0.1

656

for review

V2F

GMRV VITAL MEASUREMENT - REASON ENTERED IN ERROR (120.5-4)

fixed value

not null

Observation.status

#entered-in-error

http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs | 5.0.1

657

for review

V2F

GMRV VITAL MEASUREMENT - DATE/TIME VITALS TAKEN (120.5-.01)

source value

Observation.effectiveDateTime

http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs | 5.0.1

658

for review

V2F

fixed value

Observation.category[VSCat]

http://terminology.hl7.org/CodeSystem/observation-category#vital-signs

http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs | 5.0.1

659

for review

V2F

GMRV VITAL MEASUREMENT - PATIENT (120.5-.02)

reference

Observation.subject

/Patient

http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs | 5.0.1

660

for review

V2F

GMRV VITAL MEASUREMENT - IEN (120.5-.001)

source value

Observation.identifier

.value

.system = http://va.gov/identifiers/$Sta3n/120.5

http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs | 5.0.1

661

for review

V2F

GMRV VITAL MEASUREMENT - VITAL TYPE > GMRV VITAL TYPE - VUID (120.5-.03 > 120.51-99.99)

terminologyMaps

Observation.code

.coding

VF_VitalsCodes

Pulse Oximetry has 2 code values per US Core

http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs | 5.0.1

662

for review

V2F

GMRV VITAL MEASUREMENT - QUALIFIER > GMRV VITAL QUALIFIER - VUID (120.5-5 > 120.52-99.99)

terminologyMaps

Observation.bodySite

VF_VitalsBodySite

http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs | 5.0.1

663

for review

V2F

GMRV VITAL MEASUREMENT - QUALIFIER > GMRV VITAL QUALIFIER - VUID (120.5-5 > 120.52-99.99)

terminologyMaps

Observation.extension[http://hl7.org/fhir/StructureDefinition/observation-deviceCode].valueCodeableConcept

VF_VitalsMeasurementDevice

http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs | 5.0.1

867

for review

V2F

GMRV VITAL MEASUREMENT - QUALIFIER > GMRV VITAL QUALIFIER - VUID (120.5-5 > 120.52-99.99)

terminologyMaps

Observation.method

VF_VitalsMethod

http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs | 5.0.1

1802

for review

V2F

GMRV VITAL MEASUREMENT - QUALIFIER > GMRV VITAL QUALIFIER - VUID (120.5-5 > 120.52-99.99)

terminologyMaps

Observation.component[va-pre-condition]

.valueCodeableConcept

VF_VitalsPrecondition

.code = http://loinc.org#104158-1 "Associated precondition - Reported"

http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs | 5.0.1

1803

for review

V2F

GMRV VITAL MEASUREMENT - QUALIFIER > GMRV VITAL QUALIFIER - VUID (120.5-5 > 120.52-99.99)

terminologyMaps

Observation.component[va-pre-condition-device]

.valueCodeableConcept

VF_VitalsQualifyingDevice

.code = http://loinc.org#104158-1 "Associated precondition - Reported"

http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs | 5.0.1

1804

for review

V2F

GMRV VITAL MEASUREMENT - QUALIFIER > GMRV VITAL QUALIFIER - VUID (120.5-5 > 120.52-99.99)

terminologyMaps

Observation.extension[http://hl7.org/fhir/StructureDefinition/observation-bodyPosition]

.valueCodeableConcept

VF_VitalsBodyPosition

http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs | 5.0.1

664

for review

V2F

GMRV VITAL MEASUREMENT - RATE (120.5-1.2)

source value

VUID not = 4500634

Observation.valueQuantity

.value

http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs | 5.0.1

665

for review

V2F

GMRV VITAL MEASUREMENT - VITAL TYPE (120.5-.03)

transform

Observation.valueQuantity

.code

VF_VitalsUnits

VPR may transform

http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs | 5.0.1

Mappings to Structures in this Implementation Guide

No Mappings Found

Mappings to other Structures

No Mappings Found

Other Mappings

Name	Veterans Health Information Systems Technology and Architecture (VistA)	Clinical Data Warehouse (CDW)	Summary Document Architecure (SDA)	Virtual Patient Record XML (VPR)	Workflow Pattern	SNOMED CT Concept Domain Binding	SNOMED CT Attribute Binding
Observation					Event	< 363787002 \|Observable entity\|
id
meta
implicitRules
language
text
contained
Slices for extension
extension:observation-deviceCode
id
extension
url
value[x]	terminologyMaps using VF_VitalsMeasurementDevice on GMRV VITAL MEASUREMENT - QUALIFIER > GMRV VITAL QUALIFIER - VUID (120.5-5 > 120.52-99.99)		Observation.ObservationMethods
extension:observation-bodyPosition
id
extension
url
value[x]	terminologyMaps using VF_VitalsBodyPosition on GMRV VITAL MEASUREMENT - QUALIFIER > GMRV VITAL QUALIFIER - VUID (120.5-5 > 120.52-99.99)		Observation.ObservationMethods
modifierExtension
identifier					Event.identifier
id
extension
use
type
system	fixed value = http://va.gov/identifiers/$Sta3n/120.5 mapParameter line 1
value	source value based on GMRV VITAL MEASUREMENT - IEN (120.5-.001)
period
assigner
basedOn					Event.basedOn
partOf					Event.partOf
status	fixed value = #entered-in-error when GMRV VITAL MEASUREMENT - REASON ENTERED IN ERROR (120.5-4) if not null		Observation.Extension[ObservationExtension].Removed	vital.removed [m]	Event.status	< 445584004 \|Report by finality status\|
Slices for category
category:VSCat	fixed value = http://terminology.hl7.org/CodeSystem/observation-category#vital-signs
id
extension
coding
id
extension
system
version
code
display
userSelected
text
code					Event.code	< 363787002 \|Observable entity\| OR < 386053000 \|Evaluation procedure\|	116680003 \|Is a\|
id
extension
Slices for coding	terminologyMaps using VF_VitalsCodes on GMRV VITAL MEASUREMENT - VITAL TYPE > GMRV VITAL TYPE - VUID (120.5-.03 > 120.51-99.99) Pulse Oximetry has 2 code values per US Core	Vital.VitalSign.VitalTypeIEN Dim.VitalType.VUID	Observation.ObservationCode Observation.Extension[ObservationExtension].BMI	vital.vuid (>120.51-99.99) vital.name (>120.51-.01)
coding:PulseOx
coding:O2Sat
text
subject	reference based on GMRV VITAL MEASUREMENT - PATIENT (120.5-.02)	Vital.VitalSign.PatientIEN			Event.subject
focus
encounter					Event.context
Slices for effective[x]					Event.occurrence[x]
effective[x]:effectiveDateTime	source value based on GMRV VITAL MEASUREMENT - DATE/TIME VITALS TAKEN (120.5-.01)	Vital.VitalSign.VitalSignTakenDateTime Vital.VitalSignQualifier.VitalSignTakenDateTime	Observation.ObservationCode[Observation].Description Observation.ObservationMethods[ObservationMethod].Description	vital.taken	Event.occurrence[x]
issued	source value based on GMRV VITAL MEASUREMENT - DATE/TIME VITALS ENTERED (120.5-.04)	Vital.VitalSign.VitalSignEnteredDateTime		vital.entered
performer	reference based on GMRV VITAL MEASUREMENT - HOSPITAL LOCATION (120.5-.05)	Vital.VitalSign.LocationIEN	Observation.EnteredAt Observation.Extension[ObservationExtension].Location	vital.facility (>44-3) vital.facility (>44-.07) vital.location (>44-.01)	Event.performer.actor
Slices for value[x]						< 441742003 \|Evaluation finding\|	363714003 \|Interprets\|
value[x]:valueQuantity						< 441742003 \|Evaluation finding\|	363714003 \|Interprets\|
id
extension
value	source value based on GMRV VITAL MEASUREMENT - RATE (120.5-1.2) if VUID not = 4500634	Vital.VitalSign.Diastolic Vital.VitalSign.Systolic Vital.VitalSign.VitalResult Vital.VitalSign.VitalResultNumeric	Observation.ObservationValue Observation.Extension[ObservationExtension].BMI	vital.value vital.units vital.metricvalue vital.metricUnits vital.bmi
comparator
unit
system
code	transform using VF_VitalsUnits on GMRV VITAL MEASUREMENT - VITAL TYPE (120.5-.03) VPR may transform	Vital.VitalSign.VitalTypeIEN	Observation.ObservationCode Observation.Extension[ObservationExtension].BMI	vital.vuid (>120.51-99.99) vital.name (>120.51-.01)
dataAbsentReason
interpretation						< 260245000 \|Findings values\|	363713009 \|Has interpretation\|
note
bodySite	terminologyMaps using VF_VitalsBodySite on GMRV VITAL MEASUREMENT - QUALIFIER > GMRV VITAL QUALIFIER - VUID (120.5-5 > 120.52-99.99)		Observation.ObservationMethods			< 123037004 \|Body structure\|	718497002 \|Inherent location\|
method	terminologyMaps using VF_VitalsMethod on GMRV VITAL MEASUREMENT - QUALIFIER > GMRV VITAL QUALIFIER - VUID (120.5-5 > 120.52-99.99)		Observation.ObservationMethods
specimen						< 123038009 \|Specimen\|	704319004 \|Inherent in\|
device						< 49062001 \|Device\|	424226004 \|Using device\|
referenceRange
id
extension
modifierExtension
low
high
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\|
age
text
hasMember
derivedFrom
Slices for component
component:All Slices
id
extension
modifierExtension
code						< 363787002 \|Observable entity\| OR < 386053000 \|Evaluation procedure\|
value[x]						363714003 \|Interprets\| < 441742003 \|Evaluation finding\|	363714003 \|Interprets\|
dataAbsentReason
interpretation						< 260245000 \|Findings values\|	363713009 \|Has interpretation\|
referenceRange
component:FlowRate
id
extension
modifierExtension
code	fixed value = http://loinc.org#3151-8 if VUID = 4500637 mapParameter line 3					< 363787002 \|Observable entity\| OR < 386053000 \|Evaluation procedure\|
value[x]						363714003 \|Interprets\| < 441742003 \|Evaluation finding\|	363714003 \|Interprets\|
id
extension
value	transform using Split_SpO2_value.Flow() on GMRV VITAL MEASUREMENT - SUPPLEMENTAL O2 (120.5-1.4) if VUID = 4500637 Value needs to be parsed from VistA	Vital.VitalSign.SupplementalO2	Observation.Extension[ObservationExtension].SupplementalO2
comparator
unit	fixed value = L/min if VUID = 4500637 mapParameter line 2
system
code	fixed value = #L/min if VUID = 4500637 mapParameter line 1
dataAbsentReason
interpretation						< 260245000 \|Findings values\|	363713009 \|Has interpretation\|
referenceRange
component:Concentration
id
extension
modifierExtension
code	fixed value = http://loinc.org#3150-0 if VUID = 4500637 mapParameter line 3					< 363787002 \|Observable entity\| OR < 386053000 \|Evaluation procedure\|
value[x]						363714003 \|Interprets\| < 441742003 \|Evaluation finding\|	363714003 \|Interprets\|
id
extension
value	transform using Split_SpO2_value.Consentration() on GMRV VITAL MEASUREMENT - SUPPLEMENTAL O2 (120.5-1.4) if VUID = 4500637 Value needs to be parsed from VistA	Vital.VitalSign.SupplementalO2	Observation.Extension[ObservationExtension].SupplementalO2
comparator
unit	fixed value = % if VUID = 4500637 mapParameter line 2
system
code	fixed value = #% if VUID = 4500637 mapParameter line 1
dataAbsentReason
interpretation						< 260245000 \|Findings values\|	363713009 \|Has interpretation\|
referenceRange
component:va-pre-condition
id
extension
modifierExtension
code	fixed value = http://loinc.org#104158-1 "Associated precondition - Reported" mapParameter line 1					< 363787002 \|Observable entity\| OR < 386053000 \|Evaluation procedure\|
Slices for value[x]						363714003 \|Interprets\| < 441742003 \|Evaluation finding\|	363714003 \|Interprets\|
value[x]:valueCodeableConcept	terminologyMaps using VF_VitalsPrecondition on GMRV VITAL MEASUREMENT - QUALIFIER > GMRV VITAL QUALIFIER - VUID (120.5-5 > 120.52-99.99)		Observation.ObservationMethods			363714003 \|Interprets\| < 441742003 \|Evaluation finding\|	363714003 \|Interprets\|
dataAbsentReason
interpretation						< 260245000 \|Findings values\|	363713009 \|Has interpretation\|
referenceRange
component:va-pre-condition-device
id
extension
modifierExtension
code	fixed value = http://loinc.org#104158-1 "Associated precondition - Reported" mapParameter line 1					< 363787002 \|Observable entity\| OR < 386053000 \|Evaluation procedure\|
Slices for value[x]						363714003 \|Interprets\| < 441742003 \|Evaluation finding\|	363714003 \|Interprets\|
value[x]:valueCodeableConcept	terminologyMaps using VF_VitalsQualifyingDevice on GMRV VITAL MEASUREMENT - QUALIFIER > GMRV VITAL QUALIFIER - VUID (120.5-5 > 120.52-99.99)		Observation.ObservationMethods			363714003 \|Interprets\| < 441742003 \|Evaluation finding\|	363714003 \|Interprets\|
dataAbsentReason
interpretation						< 260245000 \|Findings values\|	363713009 \|Has interpretation\|
referenceRange
Documentation for this format

<prev

top

next>

IG © 2025 VA. Package va.maps#1.9.0 based on FHIR 4.0.1. Generated 2025-09-30
Links: Table of Contents | QA Report | Propose a change