Get FBT MCF Order Status

This API allows you to query the status of MCF Orders. When an order has not been shipped, the consign_orders field will contain no data; once the order has been shipped, the consign_orders field will display the consignment details of the order. If a single package cannot accommodate the entire order (due to carrier restrictions or packaging size limitations), the FBT system will split the order into multiple packages for fulfillment, in which case the consign_orders field will contain multiple entries corresponding to the respective packages.

---

For common parameters, refer to How to call TikTok Shop APIs - Common Parameters

Query

https://open-api.tiktokglobalshop.com/fbt/202601/mcf_outbound_orders?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&shop_cipher=ROW_RHkDDABBAAB8tKAVoAqsMTjsQZFLyNfY&mcf_order_id=7136104329798256386

Possible Status Enumerations

1. PENDING - Order is pending warehouse processing
2. HANDLE_BY_WAREHOUSE - Order is being processed by the warehouse
3. SHIPPED - Order has been shipped out from the warehouse
4. HANDOVER - Order has been received by the logistics carrier and is in transit
5. CLOSED - Order has been closed
6. LOST - Order is lost
7. DAMAGE - Order is damaged
8. COMPLETED - Order has been completed
9. ABNORMAL - There is an issue related to this order and cannot be fulfilled | ^^^is_platform_closed |bool |false |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. | ^^^issue |string |Lack of inventory |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. | ^^^shipping_provider |object | |The shipping carrier detailed informatioin of this consign order. If the order has not yet been handed over to the logistics carrier, this field may be a null value. | ^^^^id |string |7345645330412603141 |The shipping carrier unique id. | ^^^^name |string |UPS |The shipping carrier name. | ^^create_time |int |1661756811 |The time when the mcf order is created |

{"code":0,"data":{"mcf_order":{"external_order_id":"shopify202208291503530001100220033","mcf_order_id":"7136104329798256386","consign_orders":[{"id":"OBF1234","goods":[{"id":"123124124","quantity":1}],"tracking_number":"TN87654321","carrier":"USPS","status":"PENDING","is_platform_closed":false,"issue":"Lack of inventory","shipping_provider":{"id":"7345645330412603141","name":"UPS"}}],"create_time":1661756811}},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

For common error codes, refer to How to call TikTok Shop APIs - Common Error Code