Order integrations and external order IDs

Introduction

The advanced order matching feature allows you to link returns in TikTok Shop directly to the original sales orders in your Order Management System (OMS) and ReBound. This is an optional feature. If enabled, it provides richer data, more accurate return processing, and improved reporting. However, it requires a separate order integration between your OMS and ReBound’s API

What Is Advanced Order Matching?

• Advanced order matching connects each return to its original sales order using a unique external order ID (the ID assigned to the order by your OMS).
• This ensures that all order and item data is available during return processing, reducing errors and enabling more detailed analytics.
• If you do not enable this feature, return labels are still generated and returns are still processed, but are not linked to the original sales order (“direct return creation”). This will result in some limitations, such as less complete data (e.g., return rates) or being unable to link unexpected items in the warehouse to the original order.

How it works

1. Order integration setup (required)

   You must build and maintain two integrations:

   • TTS → OMS: Syncs new orders from TikTok Shop to your OMS. Your OMS generates unique order and item IDs. The OMS order and item IDs are pushed back to TTS as external order ids through the TTS API. The TTS App Store already contains some 1P and 3P integrations with other platforms, such as Shopify. You may be able to use these.

   • OMS → ReBound: Pushes order and item data (including the OMS-generated IDs) to ReBound’s API.

     

2. Platform origin selection

   • During ReBound app installation, you’ll select the platform origin for your external order IDs (e.g., Shopify, Magento, Order Management System). This tells ReBound which IDs to use when matching orders.

     

3. Return initiation

   • When a buyer starts a return in TikTok Shop, the app receives a webhook and retrieves the external order ID and item IDs from TikTok Shop.
   • The app then matches these IDs to the corresponding order and items in ReBound using the data you’ve synced.

4. Return Processing

   • If a match is found, the return is linked to the original sales order, ensuring all order details are available for processing, customs, and reporting.

   • If no match is found, the system can fall back to direct return creation.

     

Key Features

• Optional & flexible: Advanced order matching is not required for basic returns, but highly recommended for enterprise sellers or those with complex OMS setups.
• Full data sync: Ensures all order and item data is available for returns, customs, and analytics.
• Accurate item matching: Uses OMS-generated item IDs (not just SKUs) for precise item-level matching.
• Supports any platform Works with any OMS that can push order data to both TikTok Shop and ReBound.
• Configurable platform origin: Select the correct platform during onboarding to ensure proper ID matching.
• Fallback: If advanced matching is not enabled or a match cannot be found, the app will use direct return creation. That way, buyers are always to sure they can drop off their return.

ReBound order integration

• When creating sales orders through the ReBound API, ensure that the following data is included:
  • The clientOrderId field (in the based order object) should be the same as the external order ID that was pushed to TTS. (i.e., the ID assigned to the order by your OMS)
  • In the order clientMetadata object, there should be an omsOrderId field with the same value as the clientOrderId.
  • In the item clientMetadata object, there should be an omsItemId field with the same value as the external item ID that was pushed to TTS.

Best Practices

• Keep OMS and TikTok Shop in sync: Always push the latest order and item IDs to both TikTok Shop and ReBound.
• Test your integration: Before going live, test returns to ensure IDs are matched correctly and labels are generated.
• Consult your ReBound Implementation Manager: If you’re unsure about setup or best practices, contact your ReBound implementation manager for support.