How to Enable Salesforce Commerce Cloud Data Access

SoundCommerce customers can use these instructions to give us access to their Salesforce Commerce Cloud (formerly Demandware).

To establish permissions for SoundCommerce, you’ll need to add the company as a new user, using the email account SoundCommerce provided for you. Once you add the user, you will need to grant the user access to your Business Manager and Reports.

You will also need to create and share API credentials with SoundCommerce.

To add SoundCommerce as a user:

1. Sign in to the SFCC Account Manager
2. Click User. The Users page opens, showing a list of accounts.
3. Click Add User. The Email validation page opens
4. In the Email Address field, enter the email address SoundCommerce created for you. This email Is typically formatted as client-[yourclientname]@soundcommerce.com.
5. Click Add.
   1. If Account Manager cannot find the account, the Add User page opens and you can create an account (see Create a User Account). If Account Manager finds the account, you can click Add to add the account to your organization.
   2. If the user account is from another organization (for example, a partner account), the added account shows up in the user list of your organization under Invited Users. A message is sent to the user's email address, which notifies the user about the membership in your organization.
   3. After the user account is added to your organization, you can manage the account's access to various Commerce Cloud applications. (see below)

To grant SoundCommerce the roles necessary to view sales reports in SFCC:

1. On the Users page, click the email address of the account whose access you want to manage
2. In the Roles section, click Add to open the Assign Roles window
3. In the Assign Roles window, search for roles, and select the following roles:
   1. Business Manager User
   2. Reports and Dashboards Customer Manager
4. Click Add.

To grant SoundCommerce read-only access to the Open Commerce API:

1. Sign in to the SFCC Account Manager
2. Click API Client
   1. The API Clients page opens, showing a list of API clients. For each client, the page shows the API client ID, the display name, and the status.
3. Click Add API Client
   1. The Add API Client page opens.
4. Enter SoundCommerce in the Display Name field
5. In the Password field, enter a password (you will need to share this password with SoundCommerce)
6. In the Confirm Password field, reenter the password
   1. The Access Control section indicates the status of the API client
7. In the Organizations section, click Add
   1. The Assign Organizations page opens
8. In the Assign Organizations page, do the following:
   1. Search for organizations
   2. To add the API client to an organization, select the organization’s checkbox (each API client must belong to one or more organizations)
   3. Click Add
9. To allow the API client to access the OCAPI, in the Roles section, click Add, and do the following:
   1. Look for the OCAPI category and select it
   2. To assign the role to the API client, click Add
   3. In the Add Instance Filters tab, select an organization
   4. Enter the names of the instances to which you want the API client to have access
   5. Select the instances
   6. Click Add
   7. For the Token Endpoint Auth Method drop-down menu, select client_secret_post
   8. For the Access Token Format drop-down menu, select JWT
   9. Click Save
10. Configure the OCAPI security settings:
    1. 1. Go to Administration > Site Development > Open Commerce API Settings.
       2. In the Select Type drop-down menu, select Shop
       3. In the Select Context drop-down menu, select Global
       4. In the editor, add this JSON block (if there is an existing configuration, you will likely need to merge it in):
          

          {
            "_v":"19.5",
            "clients":
            [
              {
                "client_id":"{client_id_goes_here}",
                "allowed_origins":[],
                "resources":
                [
                  {
                    "resource_id":"/order_search",
                    "methods":["post"],
                    "read_attributes":"(**)"
                  }
                ]
              }
            ]
          }

       5. Click Save
11. Share the API Client ID and password with SoundCommerce by adding to 1Pass. 
    1. Instructions for adding credentials to 1Pass are located here.

References:

1. Add an Account to Your Organization (SFCC Help doc)

2. Manage Access of User Accounts (SFCC Help doc)

3. Add an API Client (SFCC Help doc)

4. Configuring OCAPI Settings