Skip to content
English
Submit a Ticket Sign in
What's new
  • There are no suggestions because the search field is empty.

TikTok Shop Integration with ShipWise

Setup, Requirements & API Guide | This guide explains how to onboard and configure TikTok Shop with ShipWise for seamless order fulfillment and shipping. It covers account setup, required permissions, order handling, shipping rules, and API configuration.

Onboarding Overview

Requirements

  • Account login details for TikTok Shop account(s).
  • A TikTok account will need to be configured in ShipWise for each individual shop for a given TikTok Shop account.

Workflow

  • Navigate to the ShipWise app in the TikTok Shop App Store.
  • Click install.

  • Approve ShipWise for all requested permissions and select the shop being onboarded.

  • The user will then be redirected to ShipWise. If the user is not already logged in they will be prompted to login.

  • At the next screen, the user will select the onboarding type, the shop from the drop down menu, and then the Confirm button to complete the onboarding process.

  • The user will then hit save and the TikTok Carrier or TikTok Carrier and Integration will be onboarded.

Order Integration Details

Direct Integrations with TikTok

  • No action is required with a direct TikTok integration as ShipWise will have all of the necessary details for shipping.

Other Integrations and WMS/ERP systems connected to ShipWise

  • No action is required for the following integrations as ShipWise will update the handling to properly mark these orders as TikTok orders.
    • Rithum

  • SellerActive

  • SellerCloud

  • Shopify

For all other integrations please contact ShipWise Support to review the necessary updates required for supporting TikTok.

Shipping Details

Order Requirements

  • TikTok Orders can only be processed with the TikTok carrier.
  • Customers will need to onboard each of their TikTok shops as a separate carrier account for fulfilling TikTok orders.
  • The TikTok Order ID is required for shipping.
  • The TikTok Item ID is required for shipping unless this requirement is disabled on the TikTok account settings page in ShipWise.
  • The order is required to be marked as a TikTok order for shipping.
  • For direct TikTok integrations and the above supported integrations (see: Order Integration Details section) the TikTok Order ID, TikTok Item ID, and marking the order as a TikTok order are handled automatically.

Required package attributes

  • Package weight
    • Must be a positive value for package weight.
  • Package dimensions
    • Must pass positive values for length, width, and height.

ShipWise API

  • POST /api/v1/Rate
    • The "marketSecondaryKey" field should be set to “TikTok_US”
    • The TikTok Order ID must be passed in the “orderNumber” field.
    • The TikTok Item ID must be passed in the “marketOrderItemKey” field.
  • POST /api/v1/Ship/RateAndShip
    • The "marketSecondaryKey" field should be set to “TikTok_US”
    • The TikTok Order ID must be passed in the “orderNumber” field.
    • The TikTok Item ID must be passed in the “marketOrderItemKey” field.
  • POST /api/v1/Ship/RateAndShip/{orderId}
    • There are no requirements for this endpoint as the required fields can be handled automatically.
  • POST /api/v1/Order/Create
    • The "marketSecondaryKey" field should be set to “TikTok_US”
    • The TikTok Order ID must be passed in the "marketOrderId" field.
    • The TikTok Item ID must be passed in the "uniqueId" field.