POST Cancel Inbound Order
Hủy đơn hàng nhập kho Shop Scope yêu cầu: seller.fbt.info API này được dùng để hủy một đơn hàng nhập kho trước khi đến kho, ngăn việc xử lý tiếp theo và cập nhật trạng thái đơn hàng.
Nếu hủy một đơn hàng nhập kho thuộc một kế hoạch nhập kho D2FC, vui lòng đảm bảo hủy tất cả các đơn hàng trong kế hoạch nhập kho đó, nếu không có thể bị tính phí không tuân thủ. Version 202602
POST/fbt/202602/inbound_orders/cancel
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được cho phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của seller lấy 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 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 yêu cầu API đến 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 yêu cầu API. Nhà phát triển có thể dùng để chuyển đổi sang giờ địa phương. |
| shop_cipher Required | string | 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ề phản hồi không chính xác. Lấy bằng API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| order_id Required | string | Mã định danh dạng số của đơn hàng nhập kho cần cập nhật thông tin theo dõi. Lưu ý: Chỉ cung cấp chuỗi số; không bao gồm tiền tố "IBR" (ví dụ: dùng 123456 thay vì IBR123456). |
| cancel_reason Required | string | Lý do hủy đơn hàng nhập kho. |
Example
CurlGoNode.jsJavaEnable word wrap
12345678curl-X POST 'https://open-api.tiktokglobalshop.com/fbt/202602/inbound_orders/cancel?app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c×tamp=1623812664&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json' -d '{ "order_id": "5766071177167344427", "cancel_reason": "Order created by mistake."}'
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 phản hồi API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong phản hồi API. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Nhật ký yêu cầu |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
{"code":0,"data":{},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}
Error Code
Xem các mã lỗi thường gặp
| Code | Message | | --- | --- | | 36009003 | 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. | | 39001002 | Yêu cầu hoặc các tham số yêu cầu trống. Vui lòng kiểm tra lại các tham số đầu vào. | | 39015007 | Truy cập bị từ chối. API yêu cầu seller phải được liên kết với đúng một merchant. | | 39015009 | SellerId đầu vào không hợp lệ | | 39015010 | Không tìm thấy đơn hàng nhập kho nào cho merchant. | | 39015013 | Lý do hủy không hợp lệ hoặc bị thiếu. | | 39015014 | Không thể hủy đơn hàng nhập kho do trạng thái hoặc các hạn chế nghiệp vụ khác. Vui lòng kiểm tra trạng thái đơn hàng nhập kho và thử lại. Nếu sự cố vẫn tiếp diễn và không rõ nguyên nhân, 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