Tiktok

The TikTok Integration App connects your ShopWired account to TikTok Shop, enabling automated product sync, order importing, real-time stock management, and conversion tracking. This guide explains each feature, how to configure the app, and how to resolve common issues.

---

Connect your ShopWired account to TikTok Shop using OAuth authorisation.

• The app displays the connection status at the top of the page.
• Select Disconnect from TikTok to immediately disable all product sync and order import functionality.
• When you reconnect, your configuration is restored automatically.

---

Configure how products and orders are managed between ShopWired and TikTok Shop.

When enabled, each product variant is sent as a separate TikTok product with its own title. The default is No. Changes only affect products exported after the setting is changed. A notice is displayed when the setting is changed.

Enables automatic synchronisation of all eligible products whenever they are created, updated, or set to active in ShopWired.

• When turned on, a Sync now button appears, allowing a one-off export of all products not yet exported to TikTok.
• The Sync now button disappears when the sync completes, but will reappear if automatic sync is turned off and on again.
• Manual send options are hidden when this is enabled.

Allows manual export of products via a Send now button for each product in the Products table. This setting is only visible if Automatic product sync is off.

Automatically imports TikTok Shop orders into ShopWired’s orders page. If disabled, orders will only appear in the app’s Orders section.

If order importing is off, this setting allows TikTok orders to deduct stock from ShopWired inventory without importing the order itself.

Runs a nightly check (2:00am UK time) to reconcile ShopWired and TikTok stock levels, correcting mismatches automatically.
Select View logs to see a full record of stock checks and corrections.

Enables updating ShopWired order status when an imported order’s status changes on TikTok.

Select the shipping rate to apply to imported TikTok orders.

---

Map ShopWired categories, brands, and order statuses to TikTok’s requirements.

Used when no category mapping exists.

Map each ShopWired category to a TikTok category (only leaf categories are valid).

Map ShopWired brands to TikTok brands.
If no mapping exists, TikTok will assign “No Brand” where permitted.

Map TikTok order statuses to ShopWired order statuses.

---

Displays all ShopWired products and their sync status with TikTok.

• Use the search bar to find products by name or SKU.
• Select checkboxes to send multiple products in batch.
• Pagination: 50 products per page.
• TikTok Short URLs are generated for use in TikTok content and ads.
  Short URLs do not affect TikTok Shop listings.

---

Shows all products exported to TikTok, approval status, and rejection reasons.

• Use checkboxes to batch delete products from TikTok (does not delete from ShopWired).
• Exported products can be re-exported after deletion.

---

Lists all TikTok Shop orders with full status and log details.

• Filter by TikTok order status (e.g. Awaiting Shipment, Delivered, Completed).
• The ShopWired Status column shows whether the order was imported.
• Orders imported to ShopWired appear in both the app and your main ShopWired orders page.
• Orders not imported appear only in the app.

---

Enables server-side event tracking for TikTok Ads (similar to Facebook Conversions API).

Toggle integration on/off.

Enter your TikTok API access token.

Select the TikTok Pixel to send event data to.

Logs all event requests and responses.

Exported Events Table:

Event Errors Table:

---

To meet TikTok’s data requirements, set these custom fields on your products:

• TikTok Length: Length value (numeric, required for some categories)
• TikTok Width: Width value (numeric, required for some categories)
• TikTok Height: Height value (numeric, required for some categories)
• TikTok Unit: Choice: CENTIMETER or INCH (required for some categories)
• TikTok Video: Optional direct URL to .mp4 file (publicly accessible)

---

ShopWired fields are mapped to TikTok as follows:

By default, variations are sent as a single TikTok product with specs and SKUs unless List variants as separate TikTok products is enabled.

---

• Ensure all required fields and custom fields are completed before exporting products.
• Product images must be between 300x300px and 4000x4000px, and aspect ratio between 3:4 and 4:3 (ideally 1:1).
• If a product fails to sync, select View log in the Products or Exports section to view detailed error messages from TikTok.
• TikTok may reject products for missing or invalid dimensions, brand/category mapping, or unsupported formats.
• The Events API and TikTok Pixel require a live TikTok Ads Manager account for full functionality.

---

Check that all required product information, images, and TikTok custom fields are present and valid. Review the logs for specific errors.

Use the generated TikTok Short URL in your TikTok content, shop ads, or external campaigns. These URLs redirect to your current product page, even if you change its canonical URL.

You can send products manually using the Send now button in the Products table.

All statuses (e.g. Awaiting Shipment, Delivered, Completed, Cancelled) must be mapped to corresponding ShopWired statuses for orders to import correctly.

---

For additional help, contact ShopWired support or view logs for detailed error information.