Articles on: Getting Started

How to Integrate Salesforce Commerce Cloud With AfterShip Feed

Plans: All plans Platforms: All platforms

Overview



Unlock the potential of integrating AfterShip Feed with Salesforce Commerce Cloud. The integration offers the advantage of automating the process of product listings while seamlessly synchronizing order data with TikTok Shop.

What you’ll learn



In this article, we will show you:

Steps to integrate Salesforce Commerce Cloud with AfterShip Feed
i) Generate a new API Client ID
ii) Configure OCAPI settings
iii) Update OCAPI settings

Steps to integrate Salesforce Commerce Cloud with AfterShip Feed



Step 1: Generate a new API Client ID


Go to the [Account Manager](https://account.demandware.com/)settings
Click on the API Client and select Add API Client option
Fill in the fields mentioned under the General Settings

Note: Let the JWT and OpenID sections stay as it is

Choose the client_secret_basic option from the Token Endpoint Auth Method menu
Click Add to create a new API Client ID

Create a Business Manager User



Follow the steps given in this article create business manager users.

recommendation: change user password every 90 days

Step 2: Configure OCAPI settings



Go to the SFCC Business Manager > Administration > Site Development > Open Commerce API Settings

Set the Select Type field to Shop by default. Change the Select Context field to Global

Paste the following JSON and then hit the Save button

Shop API setting



{
    "_v": "SHOP_API_VERSION",
    "clients": [
        {
            "client_id": "YOUR_CLIENT_ID",
            "resources": [
                {
                    "resource_id": "/order_search",
                    "methods": [
                        "post"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/customers/*",
                    "methods": [
                        "get",
                        "patch"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/categories/(*)",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/product_search",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/products/(*)",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/baskets",
                    "methods": [
                        "post"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/baskets/*",
                    "methods": [
                        "delete",
                        "get",
                        "patch"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/baskets/*/customer",
                    "methods": [
                        "put"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/baskets/*/notes",
                    "methods": [
                        "get",
                        "post"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/baskets/*/payment_instruments",
                    "methods": [
                        "post"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/baskets/*/payment_methods",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/baskets/*/price_adjustments",
                    "methods": [
                        "post"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/baskets/*/price_adjustments/*",
                    "methods": [
                        "delete",
                        "patch"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/baskets/*/shipments/*/shipping_method",
                    "methods": [
                        "put"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/baskets/*/shipments/*/shipping_methods",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/orders",
                    "methods": [
                        "post"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/orders/*",
                    "methods": [
                        "get",
                        "patch",
                        "put"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/orders/*/notes",
                    "methods": [
                        "get",
                        "post"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/orders/*/notes/*",
                    "methods": [
                        "delete"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/site",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/stores",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/stores/(*)",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/stores/*",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                }
            ]
        }
    ]
}


Now, change the Select Type field to ‘Data’ and paste this JSON

Data API setting



{
    "_v": "DATA_API_VERSION",
    "clients": [
        {
            "client_id": "YOUR_CLIENT_ID",
            "resources": [
                {
                    "resource_id": "/category_search",
                    "methods": [
                        "post"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/catalog_search",
                    "methods": [
                        "post"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/catalogs",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/catalogs/*",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/catalogs/*/categories",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/product_search",
                    "methods": [
                        "post"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/products/*/variations",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/products/*/variation_attributes",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/site_search",
                    "methods": [
                        "post"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/sites",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/sites/*",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/sites/*/gift_certificates",
                    "methods": [
                        "get",
                        "post"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/sites/*/gift_certificates/*",
                    "methods": [
                        "delete",
                        "get",
                        "patch"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/sites/*/orders/*/payment_status",
                    "methods": [
                        "put"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/sites/*/orders/*/shipping_status",
                    "methods": [
                        "put"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/sites/*/orders/*/status",
                    "methods": [
                        "put"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/inventory_list_search",
                    "methods": [
                        "post"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/inventory_lists",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/inventory_lists/*",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/inventory_lists/*/product_inventory_records",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                },
                {
                    "resource_id": "/inventory_lists/*/product_inventory_records/*",
                    "methods": [
                        "get"
                    ],
                    "read_attributes": "(**)",
                    "write_attributes": "(**)"
                }
            ]
        }
    ]
}


Hit Save to confirm the settings

Step 3: Update OCAPI settings



After adding the JSON, please update these values

PropertyValue
_VModify this to the latest version of the configuration file structure. This property doesn't rely on any OCAPI version, thus allowing the configuration of resources.
client_idUpdate this to match your API Client ID. It is crucial as far as staging, development, and production are concerned. All sandboxes use the default client ID: "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa”


Refer to the SFCC Documentation and search for OCAPI Settings for additional help.

Once you are done with updating these values, click on Save

Step 4: Provide additional information for successful integration



Go to [Apps](https://organization.automizely.com/apps/feed) in the AfterShip Feed admin

Click View more apps, and you will be redirected to the AfterShip Feed integration page.



Find Salesforce Commerce Cloud and select it to land on the detailed integration page

Select AfterShip Feed from the dropdown and then click Install app



Select the right organization (online store) if you have multiple organizations configured in AfterShip Feed (Optional) for which you are establishing this integration

To install the Salesforce Commerce Cloud app, you must complete the required details to authenticate the connection



On the Authorization window, Click Install app

Updated on: 21/09/2023

Was this article helpful?

Share your feedback

Cancel

Thank you!