Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

Encounter

The Encounter F​HI​R resource maps to the ​​Clinical​Encounter​, ​​Clinical​Encounter​​Diagnosis, ​​Clinical​Encounter​​Facility, ​​Clinical​Encounter​Identifier, ​​Clinical​Encounter​​Provider, ​​Clinical​Encounter​​Reason, and ​​Clinical​Encounter​Svc​Request objects in Salesforce​.

F​HI​R V4​.0 - ​Clinical ​Data ​Model ​Mapping

​Here’s how the fields defined by F​HI​R for Encounter map to the fields in Salesforce​.

Table 1. ​Patient - Salesforce

Encounter ​Resource	Salesforce Field	​Type	Salesforce ​Cardinality	Notes
identifier	​​Clinical​Encounter​Identifier	Object	0​.​M	The identifier information for an encounter is represented as ​​Clinical​Encounter​Identifier records that reference the encounter record using their ​​Clinical​Encounter​Identifier​.​Parent​RecordId field​.
status	​Clinical​Encounter​.Status	​Picklist	1​.1	While F​HI​R defines encounter​.status as a code, its Salesforce implementation is a picklist​.
status​History	N/​A	N/​A	N/​A	Not supported
class	​​Clinical​Encounter​​.​Category	​Picklist	1​.1	While F​HI​R defines encounter​.class as a code set, its Salesforce implementation is a picklist​.
class​History	N/​A	N/​A	N/​A	Not supported
type	​​Clinical​Encounter​​.​TypeId	Lookup: ​CodeSet​Bundle	0​.1	While F​HI​R defines encounter​.type as a zero-to-many resource, the Salesforce implementation is zero-to-one​.
service​Type	​​Clinical​Encounter​​.Service​Type	​Picklist	0​.1	While F​HI​R defines encounter​.service​Type as a code set bundle, its Salesforce implementation is a picklist​.
priority	​​Clinical​Encounter​​.​PriorityId	Lookup: ​CodeSet​Bundle	0​.1	N/​A
subject	​​Clinical​Encounter​​.​PatientId	Lookup: ​Account	1​.1	While F​HI​R defines encounter​.subject as a zero-to-one resource, the Salesforce implementation is one-to-one​.
episodeOf​Care	N/​A	N/​A	N/​A	Not supported
basedOn	​​Clinical​Encounter​Svc​Request	Object	0​.​M	The service request information that an encounter is based on is represented as ​​Clinical​Encounter​Svc​Request records that reference the encounter record using their ​​Clinical​Encounter​Svc​Request​.​​Clinical​Encounter​Id field​.
participant	​​Clinical​Encounter​​Provider	Object	0​.​M	The participant information for an encounter is represented as ​​Clinical​Encounter​​Provider records that reference the encounter record using their ​​Clinical​Encounter​​Provider​.​​Clinical​Encounter​Id field​.
participant​.type	​​Clinical​Encounter​​Provider​.​Practitioner​TypeId	Lookup: ​CodeSet​Bundle	0​.1	While F​HI​R defines encounter​.participant​.type as a zero-to-many resource, the Salesforce implementation is zero-to-one​.
participant​.period	​​Clinical​Encounter​​Provider​.Start​Date	​Date​Time	0​.1	Because Salesforce doesn’t have a native period data type, the encounter​.participant​.period resource is flattened into a set of start date and end date fields, and set of duration and duration unit fields​.
	​​Clinical​Encounter​​Provider​.End​Date	​Date​Time	0​.1
	​​Clinical​Encounter​​Provider​.​Duration	​Double	0​.1
	​​Clinical​Encounter​​Provider​.​Duration​UnitId	Lookup: ​UnitOf​Measure	0​.1
participant​.individual	​​Clinical​Encounter​​Provider​.​Practitioner​Id	Lookup: ​Healthcare​Provider	0​.1	N/​A
appointment	N/​A	N/​A	N/​A	Not supported
period	​​Clinical​Encounter​​.Start​Date	​Date​Time	0​.1	Because Salesforce doesn’t have a native period data type, the encounter​.period resource is flattened into a set of start date and end date fields​.
	​​Clinical​Encounter​​.End​Date	​Date​Time	0​.1
length	​​Clinical​Encounter​​.​Duration	​Double	0​.1	Because Salesforce doesn’t have a native duration data type, the encounter​.length resource is flattened into a set of duration and duration unit fields​.
	​​Clinical​Encounter​​.​Duration​UnitId	Lookup: ​UnitOf​Measure	0​.1
reason​Code	​​Clinical​Encounter​​Reason​.​Reason​CodeId	Lookup: ​CodeSet​Bundle	0​.​M	The reason for an encounter is represented as ​​Clinical​Encounter​​Reason records that reference the encounter record using their ​​Clinical​Encounter​​Reason​.​​Clinical​Encounter​Id field​.
reason​Reference	​​Clinical​Encounter​​Reason​.​Reason​Reference​Id	​Polymorphic Lookup: ​Health​Condition, ​Care​Observation, and ​Patient​Medical​Procedure	0​.​M	The reason for an encounter is represented as ​​Clinical​Encounter​​Reason records that reference the encounter record using their ​​Clinical​Encounter​​Reason​.​​Clinical​Encounter​Id field​.
diagnosis	​​Clinical​Encounter​​Diagnosis	Object	0​.​M	The diagnosis information for an encounter is represented as ​​Clinical​Encounter​​Diagnosis records that reference the encounter record using their ​​Clinical​Encounter​​Diagnosis​.​​Clinical​Encounter​Id field​.
diagnosis​.condition	​​Clinical​Encounter​​Diagnosis​.​DiagnosisId	​Polymorphic Lookup: ​Health​​Condition, and ​Patient​​Medical​Procedure	0​.1	N/​A
diagnosis​.use	​​Clinical​Encounter​​Diagnosis​.Usage​TypeId	Lookup: ​CodeSet​Bundle	0​.1	N/​A
diagnosis​.rank	​​Clinical​Encounter​​Diagnosis​.​Diagnosis​Rank	​Double	0​.1	N/​A
account	N/​A	N/​A	N/​A	Not supported
hospitalization​.pre​Admission​Identifier​.	​​Clinical​Encounter​​.​Pre​Admission​Identifier​Id	Lookup: ​​Clinical​Encounter​Identifier	0​.1	N/​A
hospitalization​.origin	​​Clinical​Encounter​​.​Previous​FacilityId	Lookup: ​Healthcare​Facility	0​.1	While F​HI​R defines encounter​.hospitalization​.origin as a single resource, the Salesforce implementation flattens it into two fields​.
	​​Clinical​Encounter​​.​Previous​Organization​Id	Lookup: ​Account	0​.1
hospitalization​.admitSource	​​Clinical​Encounter​​.​Admission​Source	​Picklist	0​.1	While F​HI​R defines encounter​.hospitalization​.admitSource as a code set bundle, its Salesforce implementation is a picklist​.
hospitalization​.re​Admission	​​Clinical​Encounter​​.​Readmission​CodeId	Lookup: ​CodeSet​Bundle	0​.1	N/​A
hospitalization​.diet​Preference	​​Clinical​Encounter​​.​Diet​Preference	​Multi-Select ​Picklist	0​.​M	While F​HI​R defines encounter​.hospitalization​.diet​Preference as a code set bundle, its Salesforce implementation is a picklist​.
hospitalization​.special​Courtesy	​​Clinical​Encounter​​.Special​Courtesy	​Picklist	0​.1	While F​HI​R defines encounter​.hospitalization​.special​Courtesy as a zero-to-many code set bundle, its Salesforce implementation is a zero-to-one picklist​.
hospitalization​.special​Arrangement	N/​A	N/​A	N/​A	Not supported
hospitalization​.destination	​​Clinical​Encounter​​.​Destination​FacilityId	Lookup: ​Healthcare​Facility	0​.1	While F​HI​R defines encounter​.hospitalization​.destination as a single resource, the Salesforce implementation flattens it into two fields​.
	​​Clinical​Encounter​​.​Destination​Organization​Id	Lookup: ​Account	0​.1
hospitalization​.discharge​Disposition	​​Clinical​Encounter​​.​Discharge​Disposition​Id	Lookup: ​CodeSet​Bundle	0​.1	N/​A
location	​​Clinical​Encounter​​Facility	Object	0​.​M	The facility information for an encounter is represented as ​​Clinical​Encounter​​Facility records that reference the encounter record using their ​​Clinical​Encounter​​Facility​.​​Clinical​Encounter​Id field​.
location​.location	​​Clinical​Encounter​​Facility​.​FacilityId	Lookup: ​Healthcare​Facility	0​.1	N/​A
location​.status	​​Clinical​Encounter​​Facility​.Status	​Picklist	0​.1	While F​HI​R defines encounter​.location​.status as a code, its Salesforce implementation is a picklist​.
location​.physical​Type	​​Clinical​Encounter​​Facility​.​Facility​TypeId	Lookup: ​CodeSet​Bundle	0​.1	N/​A
location​.period	​​Clinical​Encounter​​Facility​.Start​Date	​Date​Time	0​.1	Because Salesforce doesn’t have a native period data type, the encounter​.location​.period resource is flattened into a set of start date and end date fields, and set of duration and duration unit fields​.
	​​Clinical​Encounter​​Facility​.End​Date	​Date​Time	0​.1
	​​Clinical​Encounter​​Facility​.​Duration	​Double	0​.1
	​​Clinical​Encounter​​Facility​.​Duration​UnitId	Lookup: ​UnitOf​Measure	0​.1
service​Provider	​​Clinical​Encounter​​.​FacilityId	Lookup: ​Healthcare​Facility	0​.1	While F​HI​R defines encounter​.service​Provider as referencing an organization, the Salesforce implementation references a facility​.
partOf	​​Clinical​Encounter​​.​Related​​Clinical​Encounter​Id	Lookup: ​​Clinical​Encounter​	0​.1	N/​A

Sample Record Diagram

Here's a diagram that shows an example of how this resource is represented in Salesforce.