Salesforce Commerce Cloud

The following steps outline how to get the API credentials needed to integrate Content Studio with Salesforce Commerce Cloud to be able to browse and select products.

What you'll need

The following details are required:

• Salesforce Client ID
• Salesforce Site ID
• Salesforce Catalog ID
• Salesforce Shop API URL
• Salesforce Shop API Version

The information on this page will explain how to set up a client ID in Salesforce Commerce Cloud with the Open Commerce API (OCAPI) permissions required to access the Shop API. You can also use the information from an existing API Client.

Creating an API Client

In order to allow Content Studio to integrate with you Salesforce instance, you need to create a new API client in the SFCC Account Manager.

• Log in to the SFCC Account Manager as an admin user.
• Select the API Client section and click "Add API Client"
• Fill in the information in the API Client screen

• In the organizations section, add an organization. In the example below we're adding an organization named "10CMS".

• Assign some roles to the API Client. For the Content Studio integration choose "Salesforce Commerce API".

You will get a warning saying that no role scopes are defined.

• Choose a specific scope or "All sandboxes".

• From the "Token Endpoint Auth Method" menu choose "client_secret_basic" and click "Add".

The newly created API Client will be shown in the list.

Configuring your site

• Log in to SFCC Business Manager and select the site you want to configure to use with Content Studio. In this case we're using RefArchGlobal.

• In SFCC Business Manager, go to Administration > Site Development > Open Commerce API Settings.
• In the Shop API section choose your scope. In this example we have chosen organization wide scope.
• Add the following in your OCAPI settings. Set the client_id to the one you created previously.

{
  "_v": "21.3",
  "clients": [
    {
      "client_id": "**********",
      "allowed_origins": [],
      "resources": [
        {
          "methods": ["get"],
          "read_attributes": "(**)",
          "write_attributes": "(**)",
          "resource_id": "/product_search"
        },
        {
          "methods": ["get"],
          "read_attributes": "(**)",
          "write_attributes": "(**)",
          "resource_id": "/products/{id}"
        }
      ]
    }
  ]
}

Getting the information you need

When everything is set up, you can get the required information to set up the Content Studio integration as follows.

Salesforce Site ID

• Go to Administration > Sites > Manage Sites
• Copy the ID of the site (for example, RefArchGlobal)

Salesforce Catalog ID

• Go to Merchant Tools > Products and Catalogs > Catalogs and copy the id of the catalog (for example, storefront-catalog-en)

Salesforce Shop URL

This is the Salesforce Shop. It's the URL shown in the browser when you are in business manager. It will end with: commercecloud.salesforce.com)

Salesforce Shop API Version

• This is the API version configured in the JSON of your OCAPI shop Settings.

In the Content Studio configuration dialog, you need to add it the format such as: v22_4.

Setting up the integration in Content Studio

• In Content Studio choose the Commerce Repositories icon and click "Add Commerce Repository".

• Choose "Salesforce" from the dialog and add the integration.

Note you only need to enter:

• Label
• Description
• Salesforce Site ID
• Salesforce Catalog ID
• Salesforce Shop API URL
• Salesforce Shop API version
• Salesforce Client ID

The other fields are not used and you can enter any values in these fields.

Once the integration is set up, your product data is available to browse and add when using Content Studio templates such as "Rewrite product description".

Related pages

Content Studio- generating content