Getting Started with TikTok Shop

In this article

• Overview
• Supported Flows
• Getting Started
• Connector Setup
• Get Connected to TikTok Shop
• Settings Configuration
• Testing

Overview

The TikTok Shop Connector enables seamless integration between your TikTok Shop and Pipe17, allowing you to automate order management, inventory synchronization, and fulfillment processes. This connector is primarily used to pull orders from TikTok Shop to be sent to your fulfillment channels, streamlining your e-commerce operations.

Supported Flows

Basic Flows

• Pull Orders from TikTok Shop
• Pull or Push Products from/to TikTok Shop
• Push inventory to TikTok Shop
• Push fulfillments to TikTok Shop
• Pull Locations from TikTok Shop

Advanced Flows

• Push or Pull Returns from/to TikTok Shop 
• Pull or Push Refunds from/to TikTok Shop
• Pull Statements from TikTok Shop

Getting Started

1. TikTok authentication requires a master account. Accounts below a master will not have sufficient permissions
2. TikTok has specific product requirements that they enforce, and will need to be met. Ensuring all these requirements are met will help ensure that your orders and fulfillment are able to flow without any difficulties when pushing your catalog to TikTok.
3. TikTok has the ability to edit or modify orders within an hour of the order being placed. A hold for the orders during their modification period will help ensure that we do not route the order, or submit the information before it is changed (if it is changed).

Shop Requirements

Each shop needs to satisfy a series of TikTok Shop (TTS) requirements before you can start listing products. Ensure the below checklist items have been created / configured in your TTS:

• SHOP_STATUS - shop should be active
• SHOP_TAX - taxes should be filled in
• PICKUP_WAREHOUSE - should be created
• RETURN_WAREHOUSE - should be created
• DELIVERY_OPTION - should be selected default option
• SHIPPING_TEMPLATE - should be created
• PRODUCT_QUANTITY_LIMIT - **** All new shops (both individual and corporate) on TikTok Shop are subject to a probation period that limits the number of daily orders sellers can accept and the number of product uploads sellers can list per day. Once sellers graduate from probation, sellers are not subject to order limits but are limited to 1,000 product uploads per day.
  • New individual sellers are limited to 100 orders per day.
  • New corporate sellers are limited to 200 orders per day.
  • All new sellers are limited to 100 product uploads per day.

• BANK_ACCOUNT - should be filled in

• CONTACT_INFO - should be filled in
• Brand Authorization - Brand authorization allows sellers to demonstrate they can sell branded products on TikTok Shop. In order to comply with this process, sellers need to provide valid documentation from trademark or brand owners. Sellers can submit brand authorization requests through Seller Center by navigating to My Account > Account Settings > Qualification Center > Brand Qualification > Add Brand Authorization.

Product Listing Requirements

Below is a common list of fields that are required to create Products in TTS regardless of the product category/type.

• Product Name
• Description
  • Must conform to html syntax
  • Currently, it only supports html tags <p> <img> <ul> <ol> <li> <br> <strong> <b> <i> <em> <u>, other HTML tags will be filtered out and will not take effect.
  • Tags can not be nested
  • This field character limit needs to be within 10000 characters.
  • 30 images maximum in description body
• images
  • 1 to 9 images in png, jpg or jpeg format with file size not more than 5 MB.
  • The resolution of the image should not be lower than 300300px, and not higher than 4000px4000px
• package_weight
• price
• category_id

Product Category

TTS assigns Category Id based on the Product name (TTS recommends at least 40 characters), description, and images. Only after a Category Id is assigned we will know the fields required to create the Product in TTS.

Once Pipe17 fetches the Category_Id & category rules for this category_Id; one or more of the below fields may be required:

• product_certifications - Refers to certain types of products that require prior approval from TikTok Shop to be sold. Sellers who wish to sell restricted products may be required to pass a category approval process before selling such products.
• size_chart - Size chart information related to the category.
• package_dimension

Besides the above fields TTS will provide a list of required Product Attributes.

Pre-owned products

If you are selling pre-owned Products on TTS - please review - TikTok Shop Pre-Owned Products Policy. Pre-Owned live products on TTS always have inventory 1. Once the Product is sold instead of updating inventory to 0 Pipe17 is deactivating the Product to remove it from online shop. Once product is sold - inventory cannot be updated back to 1 - the only option is for the seller to create a new product.

Connector Setup

1. Add the TikTok Shop Connector in Pipe17
   • Log in to your Pipe17 Dashboard.
   • Go to Integrations on the left sidebar.
   • Click on Add Integration.
   • Select TikTok Shop Connector from the list.
   • Click Connect to establish the connection.
   • Follow the on-screen instructions to complete the connection.

Settings Configuration

Orders

• Pull shipped by platform orders: When this option is enabled Pipe17 will pull Orders fulfilled by TTS. These Orders are pulled into Pipe17 as already Fulfilled (assumed Fulfilled at TTS) - Pipe17 will not create Shipments or Fulfillment (tracking) for such Orders.
• Pull Orders in On Hold status: Orders in ‘On Hold’ status on TikTok will be pulled in to Pipe17 and kept as onHold. TikTok releases the Order after 1hr at this time Pipe17 will pull the Order and update the status as New in Pipe17. This setting will help in accounting for Inventory already committed on TikTok.
• Support virtual bundles
• Send a Message to the buyer once an Order is created: Once an Order is created in Pipe17, the buyer will receive a text message as per the template created.
• Send Order card to buyer once an Order is created.

Fulfillments

• Use fallback carrier if fulfilment carrier does not match supported carriers on TTS: If your fulfillment carrier is not on the list, we will use a fallback carrier to ensure delivery to TikTok. Please note that tracking information may not be available for the fallback carrier on TikTok Seller Center.
  
  

Products

• Prepare for Product Push to TikTok: Enabling this setting will help you fix errors & missing attributes on the Products before enabling Push Products to TTS. Any missing errors / attributes will be saved on the Product and can be accessed by clicking "Export Incomplete Products" on the Products listing page. Once the errors & missing attributes are resolved, Product Push can be enabled.
• Update only specific product properties: Choose which properties like Price, Description or Images will get updated.
• Attributes Mapping: To support mapping between variantOptions & customFields  in TikTok. Example “color:colour”. 
• Upload first child product image as variant image: First image of child product will be uploaded as variant image to TikTok.
• Allow Pipe17 to deactivate Products that are active in TikTok:Pipe17 Product status will determine if Product in TikTok should activated/deactivated. This is controlled by mapping defaults and can be overridden by updating the mapping.
• Allow Pipe17 to recover deleted Products by SKU or Product Id in TikTok instead of creating new one: If you do not want Pipe17 to recover deleted Products in TikTok - turn this setting off.
• Block update if variants inconsistent: When enabled - if Product Variants in TTS are not consistent with Pipe17 - Pipe17 will not update Product variants for those SKUs on TTS. When disabled - Pipe17 pushes Product updates and brings Product Variants on TTS to parity with Pipe17. NOTE: Product Variants not in Pipe17 will be deleted!
• Choose how Pipe17 handles missing Product attributes: 
  • Use AI to fill missing attributes: Pipe17 will use AI for figuring out missing required attribute values, based on product properties.
  • Raise an exception about missing attribute: If product has required fields that does not have corresponding attributes in Pipe17 - by default an exception would be created, and product would be created as DRAFT in TTS
• Pull values only for required attributes.
• Enter list of Product SKUs for which Pipe17 will apply AI generated product attribute values: This setting works only when AI option is selected for 'Choose how Pipe17 handles missing Product attributes'.
• Enter black list of Product SKUs for which Pipe17 will NOT apply AI generated product attribute values.
• Add a list of Product Attributes for which Pipe17 will use AI generated values.
• Add a Black list of Product Attributes for which Pipe17 will NOT use AI generated values
• Use promotion feature in TikTok: This setting allows to create promotions in TikTok for products with compare_at price. If product has compare_at_price and it is higher than default price - promotion for this product would be created. Product on TikTok would be displayed with strike-through price. Once compare_at_price is removed from a product (or equal to default price), it will be excluded from promotion. Difference between default price and compare_at_price should be inside 5-95% range.

Inventory

• Force inventory resync
• Push inventory from a specific location only: When a location is selected here - Inventory from the selected location will be reported to the default TikTok location. 
• Send total inventory to a default warehouse id: When this switch is turned on - Inventory totals from all locations in Pipe17 will be reported to the default TikTok location.
• Only apply inventory updates for specific SKUs 

Testing

Test Data Synchronization

1. Products
   • Add a new product in TikTok Shop.
   • Confirm the product appears in Pipe17 under Products.
2. Inventory
   • Update inventory levels in your warehouse system.
   • Confirm the inventory updates are reflected in Pipe17 and pushed to TikTok Shop.
3. Orders
   • Place a test order in TikTok Shop.
   • Confirm the order appears in Pipe17 under Orders.
   • Verify that the order is routed correctly based on your configuration.
4. Fulfillments
   • Fulfill the test order in your fulfillment system.
   • Confirm the fulfillment information is updated in Pipe17.
   • Ensure that shipping confirmations and tracking numbers are pushed back to TikTok Shop.

Use Cases to Consider

• Standard Order Processing: Verify the complete flow from order import to fulfillment update.
• Order with Discounts or Promotions: Ensure pricing and discount details are accurately captured.
• Partial Fulfillment: Test orders that are split into multiple shipments.
• Order Cancellations: Cancel an order in TikTok Shop and confirm it updates in Pipe17.
• Order Modifications: Modify an order in TikTok Shop before and after fulfillment to test update flows.
• Pre-Owned Products