Testing orders with TikTok Shop

Before you begin

Confirm the following:

• TikTok Shop is connected to the app. See Getting Started with TikTok Shop.
• If you plan to test with a downstream fulfillment provider, complete the relevant setup:
  • Connecting TikTok Shop to Amazon MCF
  • Connecting TikTok Shop to Amazon Seller Central
• At least one product exists in the app with order information that can move through the system.

Enable order and fulfillment flows

1. Open the TikTok Shop Integration settings.

2. Toggle Orders to enabled so the app can ingest orders from TikTok Shop.

3. Toggle Fulfillments to enabled to test the standard order workflow end-to-end.

4. Save your changes.

If you have configured order filters, automation rules, or holds, temporarily disable them so your test order is not blocked. Pay particular attention to Automation Engine rules that place new orders on hold - held orders do not advance to routing until the hold is released.

How orders flow through the app

A TikTok Shop order moves through the following lifecycle stages:

1. new - The app ingests the order from TikTok Shop.
2. readyForFulfillment - Once Automation Engine rules complete, the order becomes eligible for routing.
3. sentToFulfillment - The Order Routing Engine (ORE) automatically creates a shipment and sends it to the configured fulfillment provider.
4. partialFulfillment or fulfilled - The fulfillment provider responds with shipping details and item-level fulfillment.
5. Push back to TikTok Shop - When Fulfillments is enabled, the app pushes shipping and tracking information back to TikTok Shop.

If Fulfillments is disabled, the app does not push fulfillment data back to TikTok Shop after fulfillment completes.

How to test the order flow

1. Create an order in TikTok Shop. Use a SKU that routes to your test fulfillment provider - orders fulfilled by TikTok (TTS or FBT) are ingested as already fulfilled and will not exercise the routing flow. See TikTok-fulfilled orders below.
2. Wait for the app to ingest the order. Polling intervals vary by connector - check the configured interval for your TikTok connector if the order does not appear promptly.
3. Navigate to Orders and select the test order to open it.
4. Confirm the order reaches readyForFulfillment. If it stalls in new or on hold, review your Automation Engine rules.
5. Once the order is readyForFulfillment, the ORE automatically creates a shipment and the order moves to sentToFulfillment. If you need to trigger routing manually for a held or stuck order, click Request shipping in the order detail view.
6. Allow time for the fulfillment provider to respond. Processing time varies by provider and by polling interval.
7. Confirm the order status updates to partialFulfillment or fulfilled, with the corresponding shipping and item-level details.
8. Verify that the app pushes the final shipping information back to TikTok Shop.

TikTok-fulfilled orders (TTS and FBT)

Orders fulfilled directly by TikTok - Ships from TikTok (TTS) or Fulfilled by TikTok (FBT) - are ingested as already fulfilled. The app does not create shipments or fulfillment tracking for these orders, and they do not pass through the Order Routing Engine. To test the standard routing flow, use a SKU and order configuration that is not TikTok-fulfilled.

Best practices

• Disable order filters and automation holds during testing so test orders flow through without interference.
• Use a test product configured to route to your intended fulfillment provider, and avoid TikTok-fulfilled SKUs unless that flow is specifically what you want to test.
• Allow several polling cycles before investigating a stuck order - both ingestion and fulfillment response depend on connector polling.

Troubleshooting

• Orders are not appearing in the app after creation in TikTok Shop
  Confirm that Orders is enabled in the TikTok Shop Integration settings and that no order filters are blocking the test order. Allow at least one polling cycle before investigating further.
• Order is stuck in new or on hold and never reaches readyForFulfillment
  Review your Automation Engine rules. Rules that place orders on hold prevent them from routing until the hold is released.
• Order is stuck in sentToFulfillment
  The fulfillment provider has not yet responded. Verify the connection to your fulfillment integration and allow additional polling cycles. If the status does not update, contact support.
• TikTok Shop is not receiving fulfillment updates
  Confirm that Fulfillments is enabled in the TikTok Shop Integration settings. Without it, the app does not push fulfillment information back to TikTok Shop.
• Test order shows as fulfilled immediately after ingestion
  The order is likely TikTok-fulfilled (TTS or FBT). These orders bypass the standard routing flow. Use a non-TikTok-fulfilled SKU to test the routing and fulfillment workflow.

Need Help?

If you need additional assistance:

• Use Ask Pippen, our AI agent, located at the top of the app page.
• Submit a support request with as much relevant detail as possible. Learn how to submit a request.
• For urgent issues, email us directly at support@pipe17.com.

We're here to help you succeed with your operations.