POST Cancel FBT MCF Order
Hủy đơn hàng FBT MCF Shop Scope bắt buộc: seller.fbt.info Sau khi một đơn hàng được giao qua FBT, một MCF Order có thể được tách thành một hoặc nhiều consign order để xử lý giao hàng. API này hỗ trợ hủy đơn hàng ở cấp độ từng consign order riêng lẻ, có thể thực hiện bằng cách cung cấp mcf_order_id tương ứng và thông tin consign order liên quan của nó. Bạn có thể truy xuất thông tin của các consign order liên quan đến một mcf_order_id thông qua API Get FBF MCF Order Status. Phiên bản 202601
POST/fbt/202601/mcf_outbound_orders/cancel
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được 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 API request tới TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được dùng cho tất cả các API request. Lập trình viên có thể dùng để chuyển đổi sang giờ địa phương. |
| 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 |
Body
| Properties | Type | Description |
|---|---|---|
| mcf_order_id Required | string | Một ID duy nhất xác định các MCF order khác nhau |
| consign_orders | []object | Danh sách hủy của consign order |
Example
CurlGoNode.jsJavaEnable word wrap
123456789101112curl-X POST 'https://open-api.tiktokglobalshop.com/fbt/202601/mcf_outbound_orders/cancel?timestamp=1623812664&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3&app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json' -d '{ "mcf_order_id": "7136104329798256386", "consign_orders": [ { "id": "OBF7136104329798256386" } ]}'
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 API response. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong API response. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Log của request |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
{"code":0,"data":{"mcf_order":{"external_order_id":"shopify7136104329798256386","mcf_order_id":"7136104329798256386","consign_orders":[{"id":"OBF1234","status":"cancelled"}]}},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}
Error Code
Xem các mã lỗi thường gặp
| Code | Message | | --- | --- | | 177001009 | Lỗi nội bộ. Vui lòng thử lại. Nếu sự cố 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. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext