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

• Content
• Detailed Descriptions
• Mappings
• JSON
• History

Resource Profile: EncounterOutpatient - Mappings

Draft as of 2025-06-13

Mappings for the EncounterOutpatient resource profile.

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

EncounterOutpatient
Encounter
extension
extension (resource-serviceConnection)
value[x]	2035: fixed value = http://va.gov/fhir/vistaDefinedTerms/409.1#SC "Service Connected" when OUTPATIENT ENCOUNTER - APPOINTMENT TYPE > APPOINTMENT TYPE - NAME (409.68-.1 > 409.1-.01) if {.03>9000010} SERVICE CONNECTED, 2036: fixed value = http://va.gov/fhir/vistaDefinedTerms/409.1#NSC "Not Service Connected" when OUTPATIENT ENCOUNTER - APPOINTMENT TYPE > APPOINTMENT TYPE - NAME (409.68-.1 > 409.1-.01) if {.03>9000010} Not SERVICE CONNECTED	Outpatient Encounter points to Visit (409.68-.05) , Outpatient Encounter points to Visit (409.68-.05)
identifier
system	429-1: fixed value = http://va.gov/identifiers/$Sta3n/9000010-15001	generated from mapParameter line 1
value	429: source value based on VISIT - VISIT ID (9000010-15001)
status	430: fixed value = #planned when VISIT - VISIT/ADMIT DATE&TIME (9000010-.01) if null or > now, 431: fixed value = #in-progress when VISIT - VISIT/ADMIT DATE&TIME (9000010-.01) if not null, < now, .18 null, 432: fixed value = #finished when VISIT - CHECK OUT DATE&TIME (9000010-.18) if not null, < now	, ,
class	614: terminologyMaps using VF_encounterClass on VISIT - PATIENT STATUS IN/OUT (9000010-15002)	84% are Outpatient (2024 Jan-Mar)
type	1615: source value based on V CPT - CPT > CPT (9000010.18-.01 > 81-) if {.03>9000010}
coding
system	1615-1: fixed value = http://www.ama-assn.org/go/cpt if {.03>9000010}	generated from mapParameter line 1
code	1615-2: source value based on V CPT - CPT > CPT - CPT CODE (9000010.18-.01 > 81-.01) if {.03>9000010}	generated from mapParameter line 2
display	1615-3: source value based on V CPT - CPT > CPT - SHORT NAME (9000010.18-.01 > 81-2) if {.03>9000010}	generated from mapParameter line 3
text	1615-4: source value based on V CPT - CPT > CPT - SHORT NAME (9000010.18-.01 > 81-2) if {.03>9000010}	generated from mapParameter line 4
serviceType
coding
system	439-1: fixed value = http://va.gov/terminology/VistADefinedTerms/9000010-.07	generated from mapParameter line 1
code	439: source value based on VISIT - SERVICE CATEGORY (9000010-.07)
subject	440: reference based on VISIT - PATIENT NAME > PATIENT/IHS - NAME (9000010-.05 > 9000001-.01)
participant
type	1854: terminologyMaps using VF_encounterParticipationType on V PROVIDER - PRIMARY/SECONDARY (9000010.06-.04) if {.03>9000010}
period	1799: target not supported
individual	1614: reference based on V PROVIDER - PROVIDER > NEW PERSON (9000010.06-.01 > 200-) if {.03>9000010}
period
start	443: source value based on VISIT - VISIT/ADMIT DATE&TIME (9000010-.01)
end	444: source value based on VISIT - CHECK OUT DATE&TIME (9000010-.18)
reasonCode
coding
system	447-1: fixed value = urn:see-termmap-in-mapParameter if {.03>9000010}	generated from mapParameter line 1
code	447: source value based on V POV - POV > ICD DIAGNOSIS - CODE NUMBER (9000010.07-.01 > 80-.01) if {.03>9000010}
reasonReference	2152: target not supported	auto added because of must-support
diagnosis
condition	452: reference based on V POV - PROBLEM LIST ENTRY (9000010.07-.16) if {.03>9000010}
hospitalization	2030: target not supported	because of must-support: Outpatient so no hospitalization
location
location (va-stop)
location	458: reference based on VISIT - DSS ID (9000010-.08)	Stop Code
location (va-loc)
location	459: reference based on VISIT - HOSPITAL LOCATION (9000010-.22)
serviceProvider	1599: reference based on VISIT - LOC. OF ENCOUNTER > LOCATION - NAME (9000010-.06 > 9999999.06-.01)

Mappings for Clinical Data Warehouse (CDW) ()

EncounterOutpatient
Encounter
extension
extension (resource-serviceConnection)
value[x]	Outpat.Visit.AppointmentTypeIEN Outpat.Workload.AppointmentTypeIEN Dim.AppointmentType.AppointmentType
identifier
value	Outpat.Visit.VisitIdentifier Outpat.Workload.VisitIdentifier
status	Immun.ImmunizationContraRefusalEvent.VisitDateTime Outpat.Visit.VisitDateTime Outpat.VisitLogic.VisitDateTime Outpat.Workload.VisitDateTime, Outpat.Visit.CheckOutDateTime Outpat.Workload.CheckOutDateTime
class	Outpat.Visit.PatientStatusInOut Outpat.Workload.PatientStatusInOut
type	Outpat.VProcedure.CPTIEN Outpat.VProcedureCPTModifier.CPTIEN Outpat.VProcedureDiagnosis.CPTIEN Outpat.WorkloadVProcedure.CPTIEN Outpat.WorkloadVProcedureCPTModifier.CPTIEN Outpat.WorkloadVProcedureDiagnosis.CPTIEN
coding
code	Outpat.VProcedure.CPTIEN Outpat.VProcedureCPTModifier.CPTIEN Outpat.VProcedureDiagnosis.CPTIEN Outpat.WorkloadVProcedure.CPTIEN Outpat.WorkloadVProcedureCPTModifier.CPTIEN Outpat.WorkloadVProcedureDiagnosis.CPTIEN Dim.CPT.CPTCode Dim.CPT.CPTCode
display	Outpat.VProcedure.CPTIEN Outpat.VProcedureCPTModifier.CPTIEN Outpat.VProcedureDiagnosis.CPTIEN Outpat.WorkloadVProcedure.CPTIEN Outpat.WorkloadVProcedureCPTModifier.CPTIEN Outpat.WorkloadVProcedureDiagnosis.CPTIEN Dim.CPT.CPTName Dim.CPT.CPTName
text	Outpat.VProcedure.CPTIEN Outpat.VProcedureCPTModifier.CPTIEN Outpat.VProcedureDiagnosis.CPTIEN Outpat.WorkloadVProcedure.CPTIEN Outpat.WorkloadVProcedureCPTModifier.CPTIEN Outpat.WorkloadVProcedureDiagnosis.CPTIEN Dim.CPT.CPTName Dim.CPT.CPTName
serviceType
coding
code	Outpat.Visit.ServiceCategory Outpat.Workload.ServiceCategory
subject	Outpat.Visit.PatientIEN Outpat.Workload.PatientIEN
participant
type	Outpat.VProvider.PrimarySecondary Outpat.WorkloadVProvider.PrimarySecondary
individual	Outpat.VProvider.ProviderIEN Outpat.WorkloadVProvider.ProviderIEN
period
start	Immun.ImmunizationContraRefusalEvent.VisitDateTime Outpat.Visit.VisitDateTime Outpat.VisitLogic.VisitDateTime Outpat.Workload.VisitDateTime
end	Outpat.Visit.CheckOutDateTime Outpat.Workload.CheckOutDateTime
reasonCode
coding
code	Outpat.VDiagnosis.ICDIEN Outpat.WorkloadVDiagnosis.ICDIEN Dim.ICD10.ICD10Code Dim.ICD9.ICD9Code
diagnosis
condition	Outpat.VDiagnosis.ProblemListIEN Outpat.WorkloadVDiagnosis.ProblemListIEN
location
location (va-stop)
location	Outpat.Visit.PrimaryStopCodeIEN Outpat.Visit.SecondaryStopCodeIEN Outpat.Workload.PrimaryStopCodeIEN Outpat.Workload.SecondaryStopCodeIEN
location (va-loc)
location	Outpat.Visit.LocationIEN Outpat.Workload.LocationIEN
serviceProvider	Outpat.Visit.InstitutionIEN Outpat.Workload.InstitutionIEN

Mappings for Summary Document Architecure (SDA) ()

EncounterOutpatient
Encounter
identifier
value	Encounter.Extension[EncounterExtension].VisitID Encounter.Extension[EncounterExtension].VisitID
status	Encounter.ConsultingClinician[CareProvider].Description Encounter.ConsultingClinician[CareProvider].Name, Encounter.ToTime
type	Encounter.Extension[EncounterExtension].Cpt Encounter.Extension[EncounterExtension].Cpt Procedure.Procedure Procedure.Procedure[CodeTableDetail.Procedure].Code
coding
code	Encounter.Extension[EncounterExtension].Cpt Encounter.Extension[EncounterExtension].Cpt Procedure.Procedure Procedure.Procedure[CodeTableDetail.Procedure].Code
display	Encounter.Extension[EncounterExtension].Cpt Encounter.Extension[EncounterExtension].Cpt Procedure.Procedure Procedure.Procedure[CodeTableDetail.Procedure].Code
text	Encounter.Extension[EncounterExtension].Cpt Encounter.Extension[EncounterExtension].Cpt Procedure.Procedure Procedure.Procedure[CodeTableDetail.Procedure].Code
serviceType
coding
code	Encounter.EncounterCodedType Encounter.ExternalId Encounter.ToTime
subject	Encounter.EncounterMRN
participant
individual	Encounter.ConsultingClinicians
period
start	Encounter.ConsultingClinician[CareProvider].Description Encounter.ConsultingClinician[CareProvider].Name
end	Encounter.ToTime
reasonCode
coding
code	Diagnosis.Diagnosis Diagnosis.Diagnosis[CodeTableDetail.Diagnosis].Code
diagnosis
condition	Diagnosis.Extension[DiagnosisExtension].ProblemId
location
location (va-stop)
location	Encounter.Extension[EncounterExtension].StopCode
location (va-loc)
location	Encounter.ExternalId Encounter.HealthCareFacility
serviceProvider	Encounter.EncounterMRNAA Encounter.EncounterNumberAssigningAuthority Encounter.EnteredAt

Mappings for Virtual Patient Record XML (VPR) ()

EncounterOutpatient
Encounter
status	visit.dateTime visit.visitString
class	visit.patientClass
type	visit.cpt [m] (>81-.01) visit.cpt [m] (>81-2) visit.type (>81-.01) visit.type (>81-2)
coding
code	visit.cpt [m] (>81-.01) visit.cpt [m] (>81-2) visit.type (>81-.01) visit.type (>81-2)
display	visit.cpt [m] (>81-.01) visit.cpt [m] (>81-2) visit.type (>81-.01) visit.type (>81-2)
text	visit.cpt [m] (>81-.01) visit.cpt [m] (>81-2) visit.type (>81-.01) visit.type (>81-2)
serviceType
coding
code	visit.serviceCategory visit.visitString
participant
type	visit.provider [m]
individual	visit.provider [m] (>200-.01) visit.provider [m] (>200-8932.1)
period
start	visit.dateTime visit.visitString
reasonCode
coding
code	visit.icd [m] (>80-.01) visit.icd [m] (>80-1.1) visit.icd [m] (>80-10) visit.reason (>80-.01) visit.reason (>80-1.1) visit.reason (>80-10)
location
location (va-stop)
location	visit.stopCode (>40.7-.01)
location (va-loc)
location	visit.creditStopCode (>44-2503) visit.location (>44-.01) visit.visitString
serviceProvider	visit.facility (>4-.01) visit.facility (>4-99)

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

EncounterOutpatient
Encounter	Event
identifier	Event.identifier
status	Event.status
type	Event.code
serviceType	Event.code
subject	Event.subject
episodeOfCare	Event.context
basedOn	Event.basedOn
participant	Event.performer
type	Event.performer.function
individual	Event.performer.actor
appointment	Event.basedOn
period	Event.occurrence[x]
length	Event.occurrence[x]
reasonCode	Event.reasonCode
reasonReference	Event.reasonCode
diagnosis
condition	Event.reasonReference
location
location	Event.location
location (va-stop)
location	Event.location
location (va-loc)
location	Event.location
serviceProvider	Event.performer.actor
partOf	Event.partOf

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

EncounterOutpatient
Encounter	Entity. Role, or Act, Encounter[@moodCode='EVN']
text	Act.text?
contained	N/A
extension
extension (resource-serviceConnection)
id	n/a
url	N/A
value[x]	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
status	.statusCode
statusHistory	n/a
id	n/a
extension	n/a
modifierExtension	N/A
status	n/a
period	n/a
class	.inboundRelationship[typeCode=SUBJ].source[classCode=LIST].code
classHistory	n/a
id	n/a
extension	n/a
modifierExtension	N/A
class	n/a
period	n/a
type	.code
id	n/a
extension	n/a
coding	union(., ./translation)
id	n/a
extension	n/a
system	./codeSystem
version	./codeSystemVersion
code	./code
display	CV.displayName
userSelected	CD.codingRationale
text	./originalText[mediaType/code="text/plain"]/data
serviceType	n/a
id	n/a
extension	n/a
coding	union(., ./translation)
id	n/a
extension	n/a
system	./codeSystem
version	./codeSystemVersion
code	./code
display	CV.displayName
userSelected	CD.codingRationale
text	./originalText[mediaType/code="text/plain"]/data
priority	.priorityCode
subject	.participation[typeCode=SBJ]/role[classCode=PAT]
episodeOfCare	n/a
basedOn	.reason.ClinicalDocument
participant	.participation[typeCode=PFM]
id	n/a
extension	n/a
modifierExtension	N/A
type	.functionCode
period	.time
individual	.role
appointment	.outboundRelationship[typeCode=FLFS].target[classCode=ENC, moodCode=APT]
period	.effectiveTime (low & high)
id	n/a
extension	n/a
start	./low
end	./high
length	.lengthOfStayQuantity
reasonCode	.reasonCode
id	n/a
extension	n/a
coding	union(., ./translation)
id	n/a
extension	n/a
system	./codeSystem
version	./codeSystemVersion
code	./code
display	CV.displayName
userSelected	CD.codingRationale
text	./originalText[mediaType/code="text/plain"]/data
reasonReference	.reasonCode
diagnosis	.outboundRelationship[typeCode=RSON]
id	n/a
extension	n/a
modifierExtension	N/A
condition	.outboundRelationship[typeCode=RSON].target
use	n/a
rank	.outboundRelationship[typeCode=RSON].priority
account	.pertains.A_Account
hospitalization	.outboundRelationship[typeCode=COMP].target[classCode=ENC, moodCode=EVN]
id	n/a
extension	n/a
modifierExtension	N/A
preAdmissionIdentifier	.id
origin	.participation[typeCode=ORG].role
admitSource	.admissionReferralSourceCode
reAdmission	n/a
dietPreference	.outboundRelationship[typeCode=COMP].target[classCode=SBADM, moodCode=EVN, code="diet"]
specialCourtesy	.specialCourtesiesCode
specialArrangement	.specialArrangementCode
destination	.participation[typeCode=DST]
dischargeDisposition	.dischargeDispositionCode
location	.participation[typeCode=LOC]
id	n/a
extension	n/a
modifierExtension	N/A
location	.role
status	.role.statusCode
period	.time
location (va-stop)	.participation[typeCode=LOC]
id	n/a
extension	n/a
modifierExtension	N/A
location	.role
status	.role.statusCode
period	.time
location (va-loc)	.participation[typeCode=LOC]
id	n/a
extension	n/a
modifierExtension	N/A
location	.role
status	.role.statusCode
period	.time
serviceProvider	.particiaption[typeCode=PFM].role
partOf	.inboundRelationship[typeCode=COMP].source[classCode=COMP, moodCode=EVN]

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

EncounterOutpatient
Encounter
identifier	FiveWs.identifier
status	FiveWs.status
class	FiveWs.class
type	FiveWs.class
priority	FiveWs.grade
subject	FiveWs.subject[x], FiveWs.subject
episodeOfCare	FiveWs.context
participant
individual	FiveWs.who
period	FiveWs.done[x]
reasonCode	FiveWs.why[x]
reasonReference	FiveWs.why[x]
diagnosis
condition	FiveWs.why[x]
location
location	FiveWs.where[x]
location (va-stop)
location	FiveWs.where[x]
location (va-loc)
location	FiveWs.where[x]

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

EncounterOutpatient
Encounter
identifier	PV1-19
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)
status	No clear equivalent in HL7 v2; active/finished could be inferred from PV1-44, PV1-45, PV2-24; inactive could be inferred from PV2-16
class	PV1-2
type	PV1-4 / PV1-18
coding	C*E.1-8, C*E.10-22
system	C*E.3
version	C*E.7
code	C*E.1
display	C*E.2 - but note this is not well followed
userSelected	Sometimes implied by being first
text	C*E.9. But note many systems use C*E.2 for this
serviceType	PV1-10
coding	C*E.1-8, C*E.10-22
system	C*E.3
version	C*E.7
code	C*E.1
display	C*E.2 - but note this is not well followed
userSelected	Sometimes implied by being first
text	C*E.9. But note many systems use C*E.2 for this
priority	PV2-25
subject	PID-3
episodeOfCare	PV1-54, PV1-53
participant	ROL
type	ROL-3 (or maybe PRT-4)
period	ROL-5, ROL-6 (or maybe PRT-5)
individual	ROL-4
appointment	SCH-1 / SCH-2
period	PV1-44, PV1-45
start	DR.1
end	DR.2
length	(PV1-45 less PV1-44) iff ( (PV1-44 not empty) and (PV1-45 not empty) ); units in minutes
reasonCode	EVN-4 / PV2-3 (note: PV2-3 is nominally constrained to inpatient admissions; HL7 v2 makes no vocabulary suggestions for PV2-3; would not expect PV2 segment or PV2-3 to be in use in all implementations )
coding	C*E.1-8, C*E.10-22
system	C*E.3
version	C*E.7
code	C*E.1
display	C*E.2 - but note this is not well followed
userSelected	Sometimes implied by being first
text	C*E.9. But note many systems use C*E.2 for this
reasonReference	EVN-4 / PV2-3 (note: PV2-3 is nominally constrained to inpatient admissions; HL7 v2 makes no vocabulary suggestions for PV2-3; would not expect PV2 segment or PV2-3 to be in use in all implementations )
diagnosis
condition	Resources that would commonly referenced at Encounter.indication would be Condition and/or Procedure. These most closely align with DG1/PRB and PR1 respectively.
hospitalization
preAdmissionIdentifier	PV1-5
admitSource	PV1-14
reAdmission	PV1-13
dietPreference	PV1-38
specialCourtesy	PV1-16
specialArrangement	PV1-15 / OBR-30 / OBR-43
destination	PV1-37
dischargeDisposition	PV1-36
location
location	PV1-3 / PV1-6 / PV1-11 / PV1-42 / PV1-43
location (va-stop)
location	PV1-3 / PV1-6 / PV1-11 / PV1-42 / PV1-43
location (va-loc)
location	PV1-3 / PV1-6 / PV1-11 / PV1-42 / PV1-43
serviceProvider	PL.6 & PL.1