Salesforce Health Cloud Developer Guide
jNewer Version Available
Storing FHIR Data in the Packaged EHR Data Model
The FHIR (Fast Healthcare Interoperability Resources) specification is offered as a
consistent, easy to implement, and rigorous mechanism for exchanging data between healthcare
applications. It can be used as a stand-alone data exchange standard or in combination with
other standards, such as HL7.
FHIR Patient Resource to Salesforce Account Object
The Patient resource in FHIR maps to the Account object and the EhrPatient object in
Salesforce. This table shows the target fields in the Account object.
| FHIR Field | Salesforce Field | Notes |
|---|---|---|
| name.given | FirstName | In the FHIR name object, filter for use=official. |
| name.family | LastName | |
| active | Active__c | |
| gender | Gender__pc | |
| maritalStatus.coding..display | Marital_Status__pc | |
| birthDate | PersonBirthdate | |
| telecom.value | PersonHomePhone | Filter for use=home and then for use=mobile. |
| identifier.value | MedicalRecordNumber__c | In the FHIR Identifier object, filter for type.coding.code=MR. |
| identifier.value | SourceSystemId__c | |
| address.line | PersonMailingStreet | In the FHIR address object, filter for type=both or type=postal. |
| address.city | PersonMailingCity | |
| address.state | PersonMailingState | |
| address.postalCode | PersonMailingPostalCode | |
| address.country | PersonMailingCountry |
FHIR Patient Resource to Salesforce EhrPatient Object
The Patient resource in FHIR maps to the EhrPatient object and the Account object in
Salesforce. This table shows the target fields in the EhrPatient object.
| FHIR Field | Salesforce Field | Notes |
|---|---|---|
| name.given | GivenName1__c | In the FHIR name object, filter for use=official. |
| name.family | FamilyName1__c | |
| gender | GenderLabel__c | |
| deceasedBoolean | Deceased__c | |
| birthDate | BirthDate__c | |
| maritalStatus.coding.display | MaritalStatusLabel__c | |
| identifier.value | MedicalRecordNumber__c | In the FHIR identifier object, filter for type.coding.code=MR. |
| identifier.value | SourceSystemId__c | |
| identifier.system | SourceSystem__c | |
| address.line | Address1Line1__c | In the FHIR address object, filter for type=both or type=postal. |
| address.city | Address1City__c | |
| address.state | Address1State__c | |
| address.postalCode | Address1PostalCode__c | |
| address.country | Address1Country__c | |
| telecom.system | Telecom[ind]System__c | In the FHIR telecom object, the destination field contains an integer that is the index to the telecom record. |
| telecom.use | Telecom[ind]Use__c | |
| telecom.value | Telecom[ind]Value__c |
FHIR Condition Resource to Salesforce EhrCondition Object
The FHIR Condition resource maps to the Salesforce EhrCondition object.
| FHIR Field | Salesforce Field | Notes |
|---|---|---|
| id | Id | A lookup in Health Cloud is done to verify that this exists. |
| subject.reference | Account__c | Split this value on / and take the part to the right. |
| category.coding.code | CategoryCode__c | |
| category.coding.system | CategorySystem__c | |
| category.coding.code | Code__c | |
| category.coding.display | CodeLabel__c | |
| category.coding.system | CodeSystem__c | |
| stage.summary.coding | Stage__c | |
| identifier.value | SourceSystemId__c | |
| clinicalStatus.coding.code | StatusCode__c | In the FHIR Coding object, filter for code=active. |
| clinicalStatus.coding.display | StatusLabel__c | |
| clinicalStatus.coding.system | StatusSystem__c | |
| severity.code | SeverityCode__c | |
| severity.display | SeverityLabel__c | |
| severity.system | SeveritySystem__c | |
| evidence.code | EvidenceCode__c | |
| evidence.display | EvidenceDetail__c | |
| evidence.display | EvidenceLabel__c | |
| evidence.system | EvidenceSystem__c |
FHIR Observation Resource to Salesforce EhrObservation Object
Map the Observation resource in FHIR to the EhrObservation object in
Salesforce.
| FHIR Field | Salesforce Field | Notes |
|---|---|---|
| id | Id | A lookup in Health Cloud is done to verify this exists. |
| identifier.value | SourceSystemId__c | Split this value on / and take the part to the right. |
| status | Status__c | |
| bodySite.coding.code | BodySiteCode__c | |
| bodySite.coding.display | BodySiteLabel__c | |
| bodySite.coding.system | BodySiteSystem__c | |
| note | Comments__c | |
| interpretation.coding.code | InterpretationCode__c | |
| interpretation.coding.display | InterpretationLabel__c | |
| interpretation.coding.system | InterpretationSystem__c | |
| method.coding.code | MethodCode__c | |
| method.coding.display | MethodLabel__c | |
| method.coding.system | MethodSystem__c | |
| valueCodeableConcept.coding.code | ValueCode__c | |
| valueString | ValueLabel__c | |
| valuePeriod.end | ValuePeriodEndDate__c | |
| valuePeriod.start | ValuePeriodStartDate__c | |
| valueQuantity.value | ValueQuantity__c | |
| valueQuantity.unit | ValueQuantityUnit__c |
FHIR AllergyIntolerance Resource to Salesforce EhrAllergyIntolerance Object
The AllergyIntolerance resource in FHIR maps to the EhrAllergyIntolerance object in
Salesforce.
| FHIR Field | Salesforce Field | Notes |
|---|---|---|
| id | Id | A lookup in Health Cloud is done to verify that this exists. |
| subject.reference | Account__c | Split this value on / and take the part to the right. |
| criticality | CriticalityCode__c | |
| reaction.manifestation.coding.code/display | Reaction255__c | Code is concatenated for display and is limited to 255 characters. |
| reaction.manifestation.coding.display | Reaction__c | |
| identifier.value | SourceSystemId__c | |
| code.coding.code | SubstanceCode__c | |
| code.coding.display | Substance255__c | |
| criticality | CriticalityLabel__c | |
| verificationStatus.coding.code | StatusLabel__c |