Overview of TikTok Shop for SFCC V2 Integration

This guide walks you through the process of connecting and onboarding Salesforce Commerce Cloud (SFCC) with TikTok Shop through SFCC Catalog Widget V2 admin. You can sync your products, shop settings and grow your business on TikTok without switching between platforms.
This page serves as your starting point for all TikTok for SFCC guides and resources. Find step-by-step instructions for setup, product management, shop settings and growing your business on TikTok Shop.
Note: This solution is currently available in the US and UK regions only.

TTS x SFCC High Level Architecture

TTS x SFCC 1P Integration

Prerequisites

• System Requirements: List of required versions of Salesforce Commerce Cloud, TikTok Shop APIs, and any middleware components.
  • Social Channel Integrations Cartridge:
    • We recommend upgrading to the latest version of the social_channel_integrations cartridge (preferably released on or after March 10, 2025).
    • If upgrading is not feasible, work with your TTS CSM / SA, the new features should still be accessible without the latest version.
    • Cartridge repository: Salesforce Commerce Cloud Social Channel Integrations.
  • SFCC Configuration:
    • To activate API-driven flows and the new Catalog Widget, please gather the following information and share it with your CSM.

• OCAPI Configuration:
  • Under OCAPI API settings ( Administration > Site Development > Open Commerce API Settings ), add/modify the following API permissions under the Client ID shared with TTS to communicate with SFCC through APIs.

Shop API Permission Settings

{

"_v": "21.3",

"clients": [

{

"client_id": "[-------OCAPI Account Manager Client ID-------]",

"resources": [

{

"resource_id": "/orders/*",

"methods": [

"get",

"patch",

"put"

],

"read_attributes": "(**)",

"write_attributes": "(**)"

},

{

"resource_id": "/products/*/availability",

"methods": [

"get"

],

"read_attributes": "(**)",

"write_attributes": "(**)"

},

{

"resource_id": "/products/*",

"methods": [

"get"

],

"read_attributes": "(**)",

"write_attributes": "(**)"

}

]

}

]

}

Data API Permission Settings

{

"_v": "21.3",

"clients": [

{

"client_id": "[-------OCAPI Account Manager Client ID-------]",

"resources": [

{

"resource_id": "/user_search",

"methods": [

"post"

],

"read_attributes": "(**)",

"write_attributes": "(**)"

},

{

"resource_id": "/product_search",

"methods": [

"post"

],

"read_attributes": "(**)",

"write_attributes": "(**)"

},

{

"resource_id": "/catalogs/**",

"methods": [

"get",

"post"

],

"read_attributes": "(**)",

"write_attributes": "(**)"

},

{

"resource_id": "/catalogs/*/categories/*/category_product_assignment_search",

"methods": [

"post"

],

"read_attributes": "(**)"

},

{

"resource_id": "/inventory_lists/**",

"methods": [

"get",

"post"

],

"read_attributes": "(**)",

"write_attributes": "(**)"

},

{

"resource_id": "/products/*",

"methods": [

"get"

],

"read_attributes": "(**)",

"write_attributes": "(**)"

},

{

"resource_id": "/inventory_lists/*/product_inventory_records/*",

"methods": [

"get"

],

"read_attributes": "(**)",

"write_attributes": "(**)"

}

]

}

]

}

Launch TTS from SFCC

Updated Plugin JS URL

If you are using a previous version of social_integrations cartridge, ensure you updated the Plugin JS Version to this URL - https://sf-ttmp.ttcdn-row.com/obj/ttastatic-sg/tiktok-business-plugin/tbp_external_platform-v2.3.11.jsNavigate to Merchant Tools --> Site Preferences --> Custom Site Preference Groups --> TikTok Settings

Access "TikTok for Business" from Salesforce Business Manager

1. Navigate to Salesforce BM → Merchant Tools → Select the Site to connect with TTS → Social Channels → TikTok for Business.
2. Input the OCAPI credentials and the connection details and click Launch.
   
3. You will be redirected to the TikTok for Business launch page. Click on "Connect" button
   
4. You will be redirected to TikTok for Business with the below options. Choose "TikTok Shop" and click "Next"
   

Connect to your TikTok Shop:

1. Click Connect Account.
   
2. Log in with your seller credentials and click Login.

If the TT Shop account is not created, the seller needs to create a new TT Shop. Here is the link to create a new TTS: https://seller-us.tiktok.com/university/essay?amp%3Bcourse_type=1&amp%3Bfrom=search&amp%3Bidentity=1&amp%3Brole=1&identity=1&knowledge_id=5159959451715374

3. Once connected, you will see a confirmation that your shop is successfully linked
   

Enable the Shop in TTS backend

Work with your CSM to enable the Shop in the backend (This requires your AM/CSM to work with TT support team). Once the Shop is enabled, you can continue with the steps below.

Add Warehouse information:

1. Add all the Pickup and Return warehouse details.
   
   

Once the warehouse information is added, you can see the green check mark showing the step is completed.

Enable Catalog Widget in the Backend

Reach out to your CSM to perform this step to enable and push the products into catalog widget

Initiate Product Listing on TTS

Refresh the page and click manage and sync products

Manage and sync products:

SFCC V2 Catalog Widget-->Products --> Manage and Sync Products. Click Edit and Sync option and edit the products you would like to sync to TT. Once all the required fields are filled in click "save and sync".
Click "Edit and sync" to sync the product to make the product live

Category Template:

Category templates are essential tools for efficient product management within TikTok Shop. Category templates enable you to collectively update vital product details for products in batch, that are required by TikTok Shop, simplifying the synchronization process between your SFCC store and TikTok. By linking a group of products to a single category template, you're making both the preparation and sync tasks quicker and smoother.

What are Category Templates and why use them?

Category templates are essential tools for efficient product management within the TikTok Shop. These templates enable you to collectively update vital product details, simplifying the synchronization process between your SFCC store and TikTok. By linking a group of products to a single category template, you're making both the preparation and sync tasks quicker and smoother.
Now, let's look at your options for working with these templates:

Category Template Features

The Category Template feature aims to simplify the seller experience. Here's what it allows you to do:

• Assign each product to a unique category template, ensuring a one-to-one relationship between products and templates.
• Associate multiple templates with a single TikTok category, providing flexibility in product management.
• Set a "default" template within a TikTok category to which new eCommerce products are automatically mapped.
• Instantly create a category template using your SFCC product choices . Manual selection becomes necessary only if this automated process fails.
• Update and manage your templates via the 'Category Templates' tab. This includes renaming, recategorizing, and even deleting templates.
• Change product category for a product through the template

Managing Product Information in Category Template

We support a range of product attributes that you can maintain within the app:

• TikTok Category
• Brand Name
• Product Features
• Shipping Dimensions (Weight, Length, Width, Height)
• Size Chart
• Certifications

Managing Product Information without Category Template

We offer two ways to update the required product details:

1. Template-Level: You can link multiple products to a category template and edit their attributes in bulk.
2. Product-Level: Alternatively, go to the 'Product List' to update individual product details.

Note:

• Each product must be associated with a category template.
• If a template doesn't cover your specific product details, go to the individual product page and select "I want to set product information individually."
• The hierarchy for syncing data is as follows: existing eCommerce data > product-specific data > template data.
• You can check the individually set template from the category tabs

Creating a New Category Template

1. If the auto-suggested TikTok category isn't what you need, or if mapping fails, you can create a new template.
2. Go to the "Category List Tab."
3. Click "Add New Template."
4. Fill in all required information for the new template and save
5. Associate the new template with your desired products for quick sync.

The seller can either update Category from existing category templates or can create a new template.

Shop Settings

Product syncing:

• Product Info: Synchronize changes in Product information such as title, description, images, skus etc.
• Inventory: Synchronize changes in product Inventory
• Price: Synchronize changes in product price

All three controls are set to active or switched on by default.

Synchronization settings are active or switched on

• Product Info: Any changes made to products on SFCC to product description, title, images etc. are synched over to the corresponding product's title and description etc. on TikTok Shop Seller Center
• Inventory: Any changes made to inventory for products or SKUs on SFCC are synched over to the corresponding product's or SKU's inventory on TikTok Shop Seller Center
• Price: Any changes made to price for products or SKUs on SFCC are synched over to the corresponding product's or SKU's inventory on TikTok Shop Seller Center

When synchronization settings are switched on, all product information, price, and inventory edits for product on TikTok Shop Seller Center should be made through SFCC with synchronization settings switched on.

Synchronization settings are not active or switched off

• Product Info: Any changes made to products on SFCC to product description, title, images etc. are NOT synched over to the corresponding product's title and description etc. on TikTok Shop Seller Center

This setting can be used to edit detailed product information for store products on SFCC without affecting any product information on TikTok Shop. Allowing sellers to keep TikTok Shop product information different and unchanged from their product information edits on SFCC

• Inventory: Any changes made to inventory for products or SKUs on SFCC are NOT synched over to the corresponding product's or SKU's inventory on TikTok Shop Seller Center

This setting can be used to edit product inventory of store products on SFCC without affecting any product inventory on TikTok Shop. Allowing sellers to keep TikTok Shop inventory different and unchanged from their inventory on SFCC. This is especially useful for Sellers and Merchants wanting to keep a reserved exclusive TikTok Shop Inventory during high sale periods such as Black Friday and Cyber Monday.

• Price: Any changes made to price for products or SKUs on SFCC are NOT synched over to the corresponding product's or SKU's inventory on TikTok Shop Seller Center

This setting can be used to edit product prices of store products on SFCC without affecting any product prices on TikTok Shop. Allowing sellers to keep TikTok Shop prices different and unchanged from their product prices on SFCC. This is especially useful for sellers and merchants wanting to keep an exclusive TikTok Shop price for products and offer exclusive deals on the platform.

• Synchronization settings for Product Information, Inventory, and Price can all be individually controlled and set
• Synchronization settings also affect all products and can't be switched on/off for a selected list of products
• If synchronization settings are switched off, all individual product inventory and price syncs will fail as well as a result. Please make sure synchronization settings for Inventory and Price are switched on to make the individual syncs work as shown below

Shop Settings lets you control default product sync settings for your SFCC Store with TikTok Shop. The current sync controls include Product Info, Inventory, and Price. Product Settings' controls affect all products.
If you would like to manage the product data (title, description etc) separate from Salesforce, ensure the toggle is turned off.

Fulfillment:

Seller should go to SFCC Catalog Widget V2 --> Shop Settings-->Fulfillment to map Warehouse information, Carrier mapping and Shipping templates.

Warehouse Settings:

Sellers can add new warehouse mapping relationships by

• Clicking the 'Fulfillment' tab from "Shop Settings" tab --> Warehouse name mapping
• Click on "Edit" option to add/modify new warehouse
  
  

Carrier name mapping:

The shipping provider mapping function will be apart of the 'Shop settings' section in SFCC 1P & will allow sellers to map their SFCC shipping providers to a corresponding shipping provider on TikTok Shop. The mapping function will be done at the shop level. When sellers fulfill an order, the 1P app will use the corresponding TikTok Shop Shipping provider ID that the seller has mapped.
Sellers can add new mapping relationships by

• Clicking the 'Fulfillment' tab from "Shop Settings" tab --> Carrier name mapping
• Click on "Edit" option
  
  
• Click on 'Add mapping' button
• Click on "Add new carrier" and type in the carrier name you wish to map to corresponding TTS carrier
  
• Click on 'Save'

Shipping templates:

If you set "Seller Shipping" as the preferred logistics service , you need to complete the shipping fees template before uploading products

, otherwise, there will be a reminder when uploading the product.
The seller can follow the steps to create shipping templates here