Order integrations and external order IDs

The order integration

An order integration shares order data between your order management system (OMS) and ReBound APIs. When a new order is placed, it syncs it to ReBound, enabling returns management.

In practice, there are two separate order integrations:

TTS-OMS: Pushes order data from TikTok Shop (TTS) to your OMS. The OMS generates unique IDs for the order and line items, stored in TikTok as “external order id” and “external line item ids”. These should be pushed back to TTS.
OMS-ReBound: Pushes order data from your OMS to ReBound, sending order and item IDs as “oms order id” and “oms item ids”.

**Blue arrow:** TTS ⇄ OMS integration | **Red arrow:** OMS ⇄ ReBound integration

Why are they needed?

A return label is generated by linking a return to an existing order. Without an order integration, the ReBound-TikTok Shop integration can’t create returns or provide return labels, preventing customers from dropping off returns and us from processing them.

Without the two order integrations (TTS → OMS and OMS → ReBound), the ReBound-TTS integration will be unable to generate return labels.

TTS-OMS integration

On a high level, it should:

Push new order data from TTS to your OMS. This should include all the data that will later be shared with ReBound.
Retrieve the unique IDs for the order and line items generated by the OMS and add them to the TTS order as “external order id” and “external line item ids”. The [TTS Add External Order References API](TikTok Shop Partner Center) can be used.

OMS-ReBound integration

It should:

Push the full order, customer and product data to ReBound. This data is needed to ensure smooth returns management - e.g., full product data forcustoms clearance documentation.
Push the order data once it’s fully created, confirmed, and the items list is final, ideally after fulfillment or delivery, to ensure customers only see orders they can return. Avoid pushing draft orders.
Send the external order ID as orderOmsId and the external item ids as itemOmsId (client metadata fields in the order and item objects). We use these to match the data between the two systems. More details below.

Our Order Service API [TO ADD LINK] allows you to easily push order data to ReBound. Ask your ReBound implementation manager for more details.

If you are using Shopify as an OMS, check out our Shopify integration, which already supports all the requirements listed above.

External order ID

The TTS-ReBound integration matches data from the two sources: TikTok Shop orders and ReBound orders using the “external order ID”.

Your OMS generates a unique ID for each order and its line items. These should be pushed to TikTok as "external order ID" and "external item IDs" and to ReBound as "oms order ID" and "oms item IDs". More details above.

The higlighted blue step is the match on the "external order ID"

Configure external order ID origin

TikTok Shop allows storing multiple external order IDs for the same order if they were generated through different platforms (e.g., Shopify and your ERP system). This is the platform from the TTS API.

Our integration needs to know which platform the ID originated from, so it can retrieve it from TTS. You can configure the origin platform during the integration set up: