Integrating Salesforce B2C Commerce

Capabilities

DataGrail's Salesforce B2C Commerce integration provides the following capabilities:

Product	Capability
Request Manager	Request Types Access Identifier Categories Email

Before You Start

To successfully configure this integration, please ensure you have sufficient privileges:

• DataGrail User Role: Super Admin, Connections Manager
• Salesforce B2C Commerce User Role: Admin

Create an API Client

1. Log in to Salesforce Commerce Cloud Account Manager.
2. Select API Client from the left navigation and then Add API Client.
3. Create a Client Password and store it in a secure, temporary location.
4. Select Organizations section and add one or more organizations.
5. Select the Roles section and add instances.

Adding Instances

1. Select Add
2. Look for the Salesforce Commerce API category and select the Salesforce Commerce API.
3. Select Add
4. Select the filter button.
5. Select an organization.
6. Select and add all instances you want to access using the API client.

6. Go to the OpenID Connect section.
7. Configure the Default Scopes.

Required Default Scopes

• mail
• roles
• tenantFilter
• profile
• openId

8. Configure the Allowed Scopes.

Allowed Scopes

• sfcc.orders.rw

9. For the Token Endpoint Auth Method field, select client_secret_post.
10. For the Access Token Format field, select JWT.
11. In the Redirect URIs field, add http://localhost:8080.
12. Select Save.
13. Find your new API client in the table of API clients that appears after saving.
14. Copy the value in the API Client ID column of the table and store it in a secure, temporary location.
15. Look up the Organization ID.

Locating The Organization ID

1. Go to the Business Manager URL for your instance.
2. Log in using your Account Manager credentials.
3. Select App Launcher and then select Administration > Site Development > Salesforce Commerce API Settings.
4. The organization ID is displayed on the page. Copy and store it.

16. Retrieve the Shortcode.

Locating The Shortcode

1. Go to the Business Manager URL for your instance.
2. Log in using your Account Manager credentials.
3. Select App Launcher and then select Administration > Site Development > Salesforce Commerce API Settings.
4. If you’ve never used the B2C Commerce API in your realm, select Request Short Code. It can take up to 24 hours for the short code to propagate through the CDN and all the routing systems in your configuration.

17. Retrieve the Site ID (sometimes called a “channel”) for which you want to access data.

Locating The Site ID

1. Go to the Business Manager URL for your instance.
2. Log in using your Account Manager credentials.
3. Select App Launcher and then select Administration > Sites > Manage Sites.

Connect to DataGrail

1. In DataGrail, navigate to Integrations and select Configure New Integration to search for Salesforce B2C Commerce.
2. Enter the Client ID, Client Password, Shortcode, Organization ID and Site IDs (you can specify one or more Site IDs as a comma-separated list).
3. Select Configure Integration.

Next Steps

Now that you've successfully connected the integration, check out the following resources:

• Synchronous vs. Asynchronous Integrations
• Direct Contact Integrations
• Access Request Lifecycle
• Request Manager Overview

Troubleshooting

If you are unable to successfully connect the integration, review these common troubleshooting steps:

Ensure Required Permissions Are Granted on API Keys/Resources

DataGrail checks required permissions and scopes on API keys/resources used by each integration. If all necessary permissions are not granted, new connections will fail.

Review Required Account Types and User Roles

If users do not have the necessary permissions or the minimum required user role in the connecting system, the connection to DataGrail will fail. Additionally, connections will fail if your account type does not match the one required by the integration.

See Before You Start to review these requirements.

Technical Details

Access Type	Asynchronous

API Documentation

Learn more about this API implementation and DataGrail functionality in our API Integration Documentation.