POST Tìm kiếm Hủy đơn
Tìm kiếm Hủy đơn Shop Scope yêu cầu: seller.return_refund.basic Sử dụng API này để tìm kiếm và truy xuất một hoặc nhiều yêu cầu hủy đơn hàng. Phiên bản 202602
POST/return_refund/202602/cancellations/search
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 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 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 yêu cầu API đến TTS, bạn phải ký chúng để TTS có thể xác định người gửi. |
| timestamp Required | 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 để chuyển đổi sang giờ địa phương. |
| sort_field | string | Kết quả trả về sẽ được sắp xếp theo trường được chỉ định. Mặc định: create_timeCác giá trị có thể có:- create_time- update_timeChỉ định thứ tự sắp xếp cho kết quả trả về bằng cách sử dụng tham số sort_order. |
| sort_order | string | Thứ tự sắp xếp cho tham số sort_field. Mặc định: ASCCác giá trị có thể có:- ASC: Thứ tự tăng dần- DESC: Thứ tự giảm dần |
| page_size | string | Số lượng kết quả trả về mỗi trang. Mặc định: 10. Phạm vi hợp lệ: [1-50]. |
| page_token | string | Một token mờ được dùng để truy xuất trang tiếp theo của một tập kết quả phân trang. Lấy giá trị này từ kết quả next_page_token của phản hồi trước đó. Không cần thiết cho trang đầu tiên. |
| shop_cipher Required | string | Sử dụng property này để truyền thông tin shop khi yêu cầu API. Việc không truyền đúng giá trị khi yêu cầu 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 |
|---|---|---|
| cancel_ids | []string | Danh sách các ID yêu cầu hủy đơn hàng. |
| order_ids | []string | Danh sách các ID đơn hàng TikTok Shop. |
| buyer_user_ids | []string | Danh sách các ID người dùng người mua TikTok Shop. |
| cancel_types | []string | Danh sách các loại hủy đơn hàng.Các giá trị có thể có:- CANCEL: Hủy bởi người bán hoặc hệ thống.- BUYER_CANCEL: Hủy bởi người mua. Cần được người bán hoặc hệ thống phê duyệt. |
| cancel_status | []string | Danh sách các trạng thái hủy đơn hàng.Các giá trị có thể có:- CANCELLATION_REQUEST_PENDING- CANCELLATION_REQUEST_SUCCESS- CANCELLATION_REQUEST_CANCEL- CANCELLATION_REQUEST_COMPLETEVui lòng xem "API Overview" để biết thêm thông tin về các trạng thái này. |
| create_time_ge | int | Lọc các yêu cầu hủy để chỉ hiển thị các đơn hàng đã được tạo sau một ngày và giờ được chỉ định. Unix timestamp. |
| create_time_lt | int | Lọc các yêu cầu hủy để chỉ hiển thị các đơn hàng đã được tạo trước một ngày và giờ được chỉ định. Unix timestamp. |
| update_time_ge | int | Lọc các yêu cầu hủy để chỉ hiển thị các đơn hàng đã được cập nhật sau một ngày và giờ được chỉ định. Unix timestamp. |
| update_time_lt | int | Lọc các yêu cầu hủy để chỉ hiển thị các đơn hàng đã được cập nhật trước một ngày và giờ được chỉ định. Unix timestamp. |
| locale | string | Các mã locale BCP-47 để hiển thị đơn hàng, phân tách bằng dấu phẩy. Mặc định: en-USTham khảo Locale codes để biết danh sách các mã locale được hỗ trợ. |
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 | Nhật ký yêu cầu |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
Xem các mã lỗi phổ biến
| Code | Message | | --- | --- | | 25001001 | Một tham số yêu cầu không hợp lệ đã được truyền. Vui lòng kiểm tra rằng bạn có (các) kiểu và định dạng tham số chính xác. | | 25020005 | Không có quyền xử lý đơn hàng này | | 25020008 | 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. | | 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. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext