RelatedPerson

The relatedPerson FHIR resource maps to the Account and Contact objects in Salesforce, and is connected to the person that person’s related to using the ContactContactRelation__c object​.

FHIR V4​.0 - Clinical ​Data Model Mapping 

Here’s how the fields defined by FHIR for RelatedPerson map to the fields in Salesforce​.

RelatedPerson ResourceSalesforce FieldTypeSalesforce CardinalityNotes
identifierIdentifierObject0​.MThe identifier information for a related person is represented as Identifier records that reference the related person’s person account using their Identifier​.Parent​RecordId field​.
activeAccount​.IsActiveBoolean0​.1N/A
patientContact​Contact​Relation__c​.Contact__cLookup: Contact1.1Though Salesforce can tehnically accommodate patient as a zero-to-many association, it is recommended to align with the FHIR defined one-to-one association.
relationshipContact​​Contact​​Relation__c​​.Role__cLookup: ReciprocalRole__c0​.MWhile FHIR defines relatedPerson​.relationship as a code set bundle, its Salesforce implementation is a reference to ReicprocalRole__c​.
namePerson​NameObject0​.MThe name information for a related person is represented as Person​Name records that reference the related person’s person account using their Person​Name​.Parent​RecordId field​.
telecomContact​Point​PhoneObject0​.MThe telecom information for a related person is represented as Contact​Point​Phone records that reference the related person’s person account using their Contact​Point​Phone​.ParentId field​.
genderContact​.GenderPicklist0​.1While FHIR defines relatedPerson​.gender as a code set, its Salesforce implementation is a picklist​.
birth​DateContact​.Birthdate​Date0​.1N/A
addressContact​Point​AddressObject0​.MThe address information for a related person is represented as Contact​Point​Address records that reference the related person’s person account using their Contact​Point​Address​.ParentId field​.
photoN/AN/AN/ANot supported
periodContact​​Contact​​Relation__c​​.StartDate__c​Date0​.1Because Salesforce doesn’t support a native period data type, the relatedPerson.period FHIR resource is flattened to a set of strart and end dates​.
periodContact​​Contact​​Relation__c​​.EndDate__c​Date0​.1Because Salesforce doesn’t support a native period data type, the relatedPerson.period FHIR resource is flattened to a set of strart and end dates​.
communicationPerson​LanguageObject0​.MThe language information for a related person is represented as Person​Language records that reference the related person’s person account using their Person​Language​.IndividualId field​.
communication​.languagePerson​Language​.​LanguagePicklist0​.1While FHIR defines relatedPerson​.communication​.language as a code set bundle, its Salesforce implementation is a picklist​.
communication​.preferredPerson​Language​.RankDouble0​.1While FHIR defines relatedPerson​.communication​.preferred as a boolean, its Salesforce implementation is an integer field that ranks the degree of preference​.