GET Lấy trạng thái đơn hàng FBF MCF
Lấy trạng thái đơn hàng FBF MCF Shop Scope yêu cầu: seller.fbt.info API này cho phép bạn truy vấn trạng thái của các đơn hàng MCF. Khi một đơn hàng chưa được giao, trường consign_orders sẽ không chứa dữ liệu; sau khi đơn hàng đã được giao, trường consign_orders sẽ hiển thị chi tiết ký gửi của đơn hàng. Nếu một kiện hàng đơn lẻ không thể chứa toàn bộ đơn hàng (do giới hạn của đơn vị vận chuyển hoặc giới hạn kích thước đóng gói), hệ thống FBT sẽ chia đơn hàng thành nhiều kiện để thực hiện, trong trường hợp đó trường consign_orders sẽ chứa nhiều mục tương ứng với các kiện hàng tương ứng. Phiên bản 202601
GET/fbt/202601/mcf_outbound_orders
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được cho phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của seller từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của seller. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn. |
| sign Required | string | Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi các yêu cầu API tới TTS, bạn phải ký chúng để TTS có thể nhận dạng người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trong tất cả các yêu cầu API. Nhà phát triển có thể dùng giá trị này để chuyển đổi sang giờ địa phương. |
| mcf_order_id Required | string | Một ID duy nhất xác định các đơn hàng MCF khác nhau |
| shop_cipher Required | string | Sử dụng property này để truyền thông tin shop khi gọi API. Việc không truyền đúng giá trị khi gọi API cho các shop xuyên biên giới sẽ trả về response không chính xác. Lấy bằng 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 | Mã trạng thái thành công hoặc thất bại được trả về trong response của API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong response của API. Lý do thất bại sẽ được mô tả trong thông báo. |
| request_id | string | Log yêu cầu |
| data | object | Thông tin trả về cụ thể |
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
Xem các mã lỗi phổ biến
| Code | Message | | --- | --- | | 177001009 | Lỗi nội bộ. Vui lòng thử lại. Nếu vấn đề vẫn tiếp diễn sau nhiều lần thử, vui lòng liên hệ bộ phận hỗ trợ nền tảng. | | 177001010 | Không thể truy xuất thông tin đơn hàng qua mcf_order_id bạn cung cấp; vui lòng kiểm tra xem ID của bạn có chính xác không. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext