(58) Get FBT MCF Order Status

POST

This webhook is triggered when the FBT multi-channel-fulfillment order status has changed/updated.

Prerequisite: The Fulfilled by TikTok(FBT) Info API scope is enabled in Partner Center. For more information, refer to Access Scope.

Authorizations

• webhookSignature

Request Body^required

Media typeapplication/json

object

type

required

The ID of the webhook type.

integer

Allowed value: 58

tts_notification_id

The ID of the notification.

string

seller_open_id

The open_id of the seller. For more information, refer to Authorization overview.

string

timestamp

The UNIX timestamp when this webhook was triggered.

integer format: int64

data

object

mcf_order

MCF order information

object

external_order_id

The corresponding order ID in your OMS.

string

mcf_order_id

A unique ID that identifies different MCF orders

string

consign_orders

Once the order has been shipped, the consign_orders field will display the consignment details of the order.

Array<object>

object

id

consign order unique id

string

tracking_number

The tracking number of this consign order. If the order has not yet been handed over to the logistics carrier, this field may be a null value.

string | null

status

The status of this consign order

Possible Status Enumerations

1. SHIPPED - Order has been shipped out from the warehouse
2. HANDOVER - Order has been received by the logistics carrier and is in transit
3. CLOSED - Order has been closed
4. LOST - Order is lost
5. DAMAGE - Order is damaged
6. COMPLETED - Order has been completed
7. ABNORMAL - There is an issue related to this order and cannot be fulfilled.

string

goods

The goods id and quantity in this consign order.

Array<object>

object

id

Identifier for goods generated by Fulfilled by TikTok systemgoods id

string

quantity

The goods quantity in this consign order

integer format: int64

is_platform_closed

This field indicates whether a consign order has been canceled by the FBT platform. If the value is true, it means the order has been canceled by the platform; if it is false, it means the order has been canceled by your OMS.

string

issue

This field displays the reason for order stalling. When a consign order is in an abnormal status (such as ABNORMAL, LOST, etc.), specific issue reasons will be shown here.

string

shipping_provider

Any of:

object

object

id

The shipping carrier unique id.

string

name

The shipping carrier name.

string

null

null

create_time

The time when the mcf order is created

integer format: int64

Responses

200

Return HTTP 200 to acknowledge receipt.