--- schema_version: "1" id: 8628d88128cad8d3546c1192043dbb23f4590fb9f84bfe28b94ecba97d18d529 title: Encounter collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/life_sciences_dev_guide/map_fhir_Encounter.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/map_fhir_Encounter.htm source_site: developer.salesforce.com content_type: documentation content_hash: c1c28da3e180b47cd995aa94312935acf8574adbbc271ac2189fbcf1936d3492 description: 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​. --- # 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](https://www.hl7.org/fhir/encounter.html) 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​. | | participant​.period | ​​Clinical​Encounter​​Provider​.End​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​. | | participant​.period | ​​Clinical​Encounter​​Provider​.​Duration | ​Double | 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​. | | participant​.period | ​​Clinical​Encounter​​Provider​.​Duration​UnitId | Lookup: ​UnitOf​Measure | 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​. | | 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​. | | period | ​​Clinical​Encounter​​.End​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​. | | 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​. | | length | ​​Clinical​Encounter​​.​Duration​UnitId | Lookup: ​UnitOf​Measure | 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​. | | 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​. | | hospitalization​.origin | ​​Clinical​Encounter​​.​Previous​Organization​Id | Lookup: ​Account | 0​.1 | While F​HI​R defines encounter​.hospitalization​.origin as a single resource, the Salesforce implementation flattens it into two fields​. | | 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​. | | hospitalization​.destination | ​​Clinical​Encounter​​.​Destination​Organization​Id | Lookup: ​Account | 0​.1 | While F​HI​R defines encounter​.hospitalization​.destination as a single resource, the Salesforce implementation flattens it into two fields​. | | 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​. | | location​.period | ​​Clinical​Encounter​​Facility​.End​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​. | | location​.period | ​​Clinical​Encounter​​Facility​.​Duration | ​Double | 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​. | | location​.period | ​​Clinical​Encounter​​Facility​.​Duration​UnitId | Lookup: ​UnitOf​Measure | 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​. | | 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. ![A diagram that represents an encounter related to the patient Charles Green in Salesforce.](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/dev_guides/healthcare_api/Mappings_FHIR/images/srd_hc_encounter.png) #### See Also - [ClinicalEncounter](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/hc_r4_api_objects_ClinicalEncounter.htm "Represents a healthcare related encounter of a patient with a care provider. This is a broad object that covers multiple phases of a patient’s healthcare service experience, all the way from pre-admission to stay to discharge, and everything in between. This object is available in API version 51.0 and later.") - [ClinicalEncounterDiagnosis](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/hc_r4_api_objects_ClinicalEncounterDiagnosis.htm "Represents a diagnosis related to a clinical encounter. This object is a child object of ClinicalEncounter. This object is available in API version 51.0 and later.") - [ClinicalEncounterFacility](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/hc_r4_api_objects_ClinicalEncounterFacility.htm "Represents information about the different facilities involved in an encounter, the time spent at those facilies, and other relevant details. This is a child object of ClinicalEncounter. This object is available in API version 51.0 and later.") - [ClinicalEncounterIdentifier](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/hc_r4_api_objects_ClinicalEncounterIdentifier.htm "Represents the identifier information for a clinical encounter. This object is a child object of ClinicalEncounter. This object is available in API version 51.0 and later.") - [ClinicalEncounterProvider](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/hc_r4_api_objects_ClinicalEncounterProvider.htm "Represents the providers involved in an encounter. This object is a child object of ClinicalEncounter. This object is available in API version 51.0 and later.") - [ClinicalEncounterReason](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/hc_r4_api_objects_ClinicalEncounterReason.htm "Represents the reasons for why the encounter was required. This object is a child object of ClinicalEncounter. This object is available in API version 51.0 and later.") - [ClinicalEncounterSvcRequest](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/hc_r4_api_objects_ClinicalEncounterSvcRequest.htm "Represents the service requests related to a clinical encounter. This object is a child object of ClinicalEncounter. This object is available in API version 51.0 and later.")