POST Cancel Order
Hủy đơn hàng Shop Scope yêu cầu: seller.return_refund.basic Sử dụng API này để hủy một đơn hàng thay mặt cho người bán. Tại thị trường Mỹ và Anh, khi một mặt hàng hết hàng, API này hỗ trợ hủy một phần ở cấp độ từng mặt hàng đơn lẻ. Version 202602
POST/return_refund/202602/cancellations
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 người bán từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của người bán. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key | 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 | 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 | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên tất cả các yêu cầu API. Nhà phát triển có thể dùng cái này để chuyển đổi sang giờ địa phương. |
| shop_cipher Required | string | Sử dụng thuộc tính 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 | TikTok Shop order id |
| skus | []object | Danh sách SKU cần hủy |
| order_line_item_ids | []string | Danh sách các order line item id cần hủy. Tại thị trường Mỹ và Anh, khi một mặt hàng hết hàng, hỗ trợ hủy một phần ở cấp độ từng mặt hàng đơn lẻ. Để khởi tạo hủy một phần, hãy chỉ định order line id của mặt hàng. Lưu ý: Đây là trường cũ (legacy), với mọi tích hợp mới vui lòng sử dụng trường order_line_items thay thế. |
| cancel_reason Required | string | Lý do hủy đơn hàng. Vui lòng xem "Return API Overview" để biết danh sách các lý do mà người bán có thể chọn để hủy đơn hàng. |
| order_line_list | []object | Danh sách order-lines/sub order-lines cần hủy. Tại thị trường Mỹ và Anh, khi một mặt hàng hết hàng, hỗ trợ hủy một phần ở cấp độ từng mặt hàng đơn lẻ. Lưu ý: Trường này hoàn toàn tương thích ngược với trường order_line_items_ids trước đó. |
Example
CurlGoNode.jsJavaEnable word wrap
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 | Request log |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 25001001 | An invalid request parameter was passed. Please check that you have the correct parameter type(s) and format. | | 25001011 | A return request is already in process, or the order has already been cancelled. | | 25001014 | Unknown return reason. Please ensure you are passing a valid return reason. | | 25001015 | The provided return reason cannot be used by the seller. Please select a valid return reason and try again. | | 25001020 | The provided return reason is currently offline. Please select a different return reason. | | 25001021 | Reason not match order status | | 25001028 | reverse lock failed | | 25001045 | The order has already been shipped and we are unable to cancel shipment with the courier. | | 25001046 | Return request has failed due to an interception by TikTok risk control. | | 25001051 | Not allowed to return or cancel since order is completed or cancelled | | 25005010 | Unable to cancel individual line items within this request. | | 25005011 | The requested line item(s) for return or refund exceeds the allowable limit. | | 25020005 | No permission to process this order | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext