GET Get FBF MCF Order Status
Get FBF MCF Order Status Shop Required scope: seller.fbt.info 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. Version 202601
GET/fbt/202601/mcf_outbound_orders
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Allowed type: application/json |
| x-tts-access-token Required | string | The seller access_token value from Get Access Token, when user_type = 0. Follow this guide to get seller access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Every single app will have a unique key. Please use the specific key assigned to your app. |
| sign Required | string | Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time. |
| mcf_order_id Required | string | A unique ID that identifies different MCF orders |
| shop_cipher Required | string | Use this property to pass shop information in requesting the API. Failure in passing the correct value when requesting the API for cross-border shops will return incorrect response. Get by API Get Authorization Shop |
Example
CurlGoNode.jsJavaEnable word wrap
1234curl-XGET 'https://open-api.tiktokglobalshop.com/fbt/202601/mcf_outbound_orders?shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3&mcf_order_id=7136104329798256386&app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c×tamp=1623812664' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json'
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | The success or failure status code returned in API response. |
| message | string | The success or failure messages returned in API response. Reasons of failure will be described in the message. |
| request_id | string | Request log |
| data | object | Specific return information |
Example
JSONEnable word wrap
{"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"
Error Code
View common error codes
| Code | Message | | --- | --- | | 177001009 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 177001010 | Order information cannot be retrieved via the mcf_order_id you provided; please check if your ID is correct. |
Is this content helpful?Helpful
Not Helpful
PreviousNext