Salesforce Commerce, a renowned platform in the realm of e-commerce, empowers businesses to establish and manage online stores with unparalleled efficiency and flexibility.

Our dedicated Salesforce Commerce plugin takes this capability to new heights by facilitating a seamless integration between your Salesforce Commerce platform and Storyblok, a dynamic content management system.

Embrace this integration to unlock the full potential of your online store, harnessing the combined strengths of the two platforms to create a seamless fusion of content and commerce.

How to set up

1. In the block library, select a block to edit. Add a new field, set the Field Type to Plugin, and set the Custom Type to sb-salesforce.

2. Now configure the options: The Salesforce Commerce Cloud field plugin allows the following options:

• clientId (required): The clientId from your created API Client
• clientSecret (required): The clientSecret from your created API Client
• shortCode (required): It's an eight-character string assigned to your realm. Learn more
• organizationId (required): The organization ID is a short string that identifies a B2C Commerce instance. Learn more
• siteId (required): The site ID is the name of the site (sometimes called a “channel”) for which you want to access data. Learn more
• limit (optional): maximum number of selected products and categories.
• selectOnly (optional): can be used to limit the selection to just one type (e.g.: product or category)

How to create your API Client

To have this integration working, you'll need to first create a new and exclusive API Client.

These are the following steps you will need to do to have your API Client set correctly.

1. Basic setup

NOTE: Save the password you chose in a secure place it's going to be used later on as the plugin's clientSecret.

2. Select the Organization

You'll need to select the organization you want this plugin to integrate with, as in the example below.

3. Select the Roles

Look for the Salesforce Commerce API category and select it.

Now you will need to select the role scope as in the following images:

NOTE: Please select the instance you want to integrate with. If you set the role to All Sandbox when defining the role scope, the integration won't work.

4. Define the scopes

NOTE DO NOT add other scopes rather than the necessary ones, which are the following:

• sfcc.catalogs
• sfcc.products

5. Select the correct Token Endpoint Auth Method and save

Now, you'll be able to use the generated clientId and the clientSecret (password filled) in the respective plugin's options.

If something is still unclear, you can check also this Salesforce tutorial