Skip to main content

​
Supported syncing

​
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)
  • email
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:

​
Tips and troubleshooting

To see the exact API requests and responses from each sync run, use the live debugger. To get notified by Slack, PagerDuty, SMS, or email when a sync fails, set up sync alerts. If you run into an issue this page doesn’t cover, .
Last modified on December 27, 2023