Keep your storefront up-to-date with the latest customer info from your data warehouse
Supported syncing
| Type | Description | Supported Sync Modes | API Reference |
|---|---|---|---|
| Customers | Sync data from any source to Salesforce Commerce Cloud customers | Upsert, Update, Insert | Customers |
Connect to Salesforce Commerce Cloud
If you don't have an API client already, follow these steps to create one.
Make sure you include the sfcc.customerlists.rw scope to your list of Allowed Scopes.
Go to the Destinations overview page and click the Add destination button. Select Salesforce Commerce Cloud and click Continue. You can then authenticate Hightouch to Salesforce Commerce Cloud.
Enter the following fields into Hightouch:
- Organization ID
- Short code
- Site ID
- Client ID
- Password
Sync configuration
Once you've set up your Salesforce Commerce Cloud destination and have a model to pull data from, you can set up your sync configuration to begin syncing data. Go to the Syncs overview page and click the Add sync button to begin. Then, select the relevant model and the Salesforce Commerce Cloud destination you want to sync to.
Syncing customers
Sync data from any source to Salesforce Commerce Cloud customers.
Record matching
To match rows from your model to customers in Salesforce Commerce Cloud, you need to select a model column and corresponding Salesforce Commerce Cloud field. You can match on any of the following Salesforce Commerce Cloud fields:
- customerNo (customer number)
If you decide to match on email, you can still map the customerNo field if you prefer to generate this yourself.
If customerNo is not mapped, Salesforce Commerce Cloud generates one for you when inserting new customers.
Field mapping
Hightouch lets you sync customer fields via field mapping. You can map data from any of your model columns to default and custom customer fields. Ensure the data types in your model match the data types of the fields you want to sync to.
You can refer to this API doc for the customer's schema.
You can upsert customer addresses by mapping the addresses field in the mappings section.
Hightouch expects an array of address objects from your model. You can refer to this API doc
on how to build your address object in your model or in our inline mapper.
For each customer record, Hightouch gets all addresses in Salesforce Commerce Cloud tied to the customer to match with the record's addresses. Hightouch updates the ones that exist and inserts the ones that don't.
You can map your custom fields by entering your custom field's key, which is case sensitive (e.g. customField), in the custom mappings section.
Delete behavior
The delete behavior you select dictates what to do when a row no longer appears in your model's query results. You have the following options:
| Behavior | Description |
|---|---|
| Do nothing | Keep the customer in Salesforce Commerce Cloud with all its synced fields |
| Delete | Delete the synced customers from Salesforce Commerce Cloud |
Tips and troubleshooting
Common errors
To date, our customers haven't experienced any errors while using this destination. If you run into any issues, please don't hesitate to . We're here to help.
Live debugger
Hightouch provides complete visibility into the API calls made during each of your sync runs. We recommend reading our article on debugging tips and tricks to learn more.
Sync alerts
Hightouch can alert you of sync issues via Slack, PagerDuty, SMS, or email. For details, please visit our article on alerting.