The Practitioner FHIR resource maps to the HealthcareProvider object and person accounts in Salesforce.
The Practitioner resource in FHIR is represented as a combination of HealthcareProvider records and person accounts in Salesforce, where the HealthcareProvider record is the base. The person account is associated to the HealthcareProvider record by referencing the person account record using the AccountId field on HealthcareProvider.
If your implementation models providers as contacts instead of person accounts, you can’t associate the fields mapped to Account to your providers. You can instead associate your HealthcareProvider record to the Contact record using the PractitionerId field on HealthcareProvider.
Note
FHIR V4.0 - Clinical Data Model Mapping
Here’s how the fields defined by FHIR for Practitioner map to the fields in Salesforce.
Practitioner Resource
Salesforce Field
Type
Salesforce Cardinality
Notes
identifier
Identifier
Object
0.M
The identifier information for a documentReference is represented as Identifier records that reference the HealthcareProvider record using their Identifier.ParentRecordId field.
active
Account.IsActive
Boolean
0.1
The practitioner.active field is mapped to the account record of the provider’s person account. This account record is referenced using the HealthcareProvider.AccountId field. If your Implementation models providers as Contacts instead of Person Accounts, then you can’t map practitioner.active to your providers.
name
PersonName
Object
0.M
The name information for a practitioner is represented as PersonName records that reference the practitioner’s person account record using their PersonName.ParentRecordId field.
telecom
ContactPointPhone
Object
0.M
The telecom information for a practitioner is represented as ContactPointPhone records that reference the account record of the practitioner’s person account using the ContactPointPhone.ParentId field. If your Implementation models providers as Contacts instead of Person Accounts, then you can’t map practitioner.telecom to your providers.
address
ContactPointAddress
Object
0.M
The address information for a practitioner is represented as ContactPointAddress records that reference the account record of the practitioner’s person account using the ContactPointAddress.ParentId field. If your Implementation models providers as Contacts instead of Person Accounts, then you can’t map practitioner.address to your providers.
gender
Contact.Gender
Picklist
0.1
While FHIR defines practitioner.gender as a code set, its Salesforce implementation is a picklist. The practitioner’s gender is mapped to the contact record of their person account. This contact record is referenced using the HealthcareProvider.PractitionerId field on HealthcareProvider.
birthDate
Contact.Birthdate
Date
0.1
N/A
photo
N/A
N/A
N/A
Not supported
qualification
BoardCertification
Object
0.M
The qualification information for a practitioner is represented as BoardCertification records that reference the practitioner’s HealthcareProvider record using their BoardCertification.HealthcareProviderId field.
qualification.identifier
Identifier
Object
0.M
The identifier information for a qualification is represented as Identifier records that reference the BoardCertification record using their Identifier.ParentRecordId field.
qualification.code
BoardCertification.CertificationType
Picklist
0.1
While FHIR defines practitioner.qualification.code as a code set bundle, its Salesforce implementation is a picklist.
qualification.period
BoardCertification.EffectiveFrom
Date
0.1
Because Salesforce doesn’t support a native period data type, the practitioner.qualification.period FHIR resource is flattened to a set of from and to dates.
qualification.period
BoardCertification.EffectiveTo
Date
0.1
Because Salesforce doesn’t support a native period data type, the practitioner.qualification.period FHIR resource is flattened to a set of from and to dates.
qualification.issuer
BoardCertification.BoardName
String
0.1
N/A
communication
PersonLanguage
Object
0.M
The language information for a practitioner is represented as PersonLanguage records that reference the practitioner’s person account using their PersonLanguage.IndividualId field. While FHIR defines practitioner.communication as a code set bundle, the Salesforce implementation is a reference to PersonLanguage.
Sample Record Diagram
Here’s a diagram that shows an example of how this resource is represented in Salesforce.
j