POST Search Returns

Tìm kiếm Returns Shop Scope bắt buộc: seller.return_refund.basic Sử dụng API này để tìm kiếm returns theo return ID, order ID, buyer, loại return, trạng thái return, trạng thái phân xử, hoặc khoảng thời gian tạo/cập nhật. Response được phân trang. Để lấy trang tiếp theo, truyền next_page_token trước đó làm page_token và giữ nguyên tất cả các bộ lọc và sắp xếp khác. Version 202602

POST/return_refund/202602/returns/search

Request

Header

Properties	Type	Description
content-type Required	string	Loại đượ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 các yêu cầu API đến 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 dùng cho 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.
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 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ề trên mỗi trang. Mặc định: 10. Khoảng hợp lệ: [10-50].
page_token	string	Một token mờ dùng để lấy trang tiếp theo của tập kết quả được phân trang. Lấy giá trị này từ kết quả next_page_token của response trước đó. Không cần cho trang đầu tiên.
shop_cipher Required	string	Sử dụng thuộc tính này để truyền thông tin shop khi gọi API. Nếu 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
return_ids	[]string	Danh sách các return ID.
order_ids	[]string	Danh sách các order ID của TikTok Shop.
buyer_user_ids	[]string	Danh sách các buyer user ID của TikTok Shop.
return_types	[]string	Danh sách các loại return.Các giá trị có sẵn:- REFUND- RETURN_AND_REFUND- REPLACEMENT
return_status	[]string	Danh sách các trạng thái return.Các giá trị có sẵn:- RETURN_OR_REFUND_REQUEST_PENDING: Buyer đã khởi tạo yêu cầu return hoặc refund. Yêu cầu đang chờ seller hoặc hệ thống xem xét. - REFUND_OR_RETURN_REQUEST_REJECT: Yêu cầu return hoặc refund đã bị từ chối. - AWAITING_BUYER_SHIP: Yêu cầu return đã được chấp thuận. Seller đang chờ buyer gửi các mặt hàng đã được chấp thuận cho seller. Nếu buyer không gửi các mặt hàng cho seller trước hạn chót, nền tảng sẽ đóng yêu cầu.- BUYER_SHIPPED_ITEM: Buyer đã gửi các mặt hàng đã được chấp thuận cho seller.- REJECT_RECEIVE_PACKAGE: Seller đã kiểm tra các mặt hàng được trả lại và từ chối yêu cầu return. - RETURN_OR_REFUND_REQUEST_SUCCESS: Yêu cầu return/refund đã thành công. Buyer sẽ được hoàn tiền.- RETURN_OR_REFUND_REQUEST_CANCEL: Yêu cầu đã bị hủy bởi buyer hoặc hệ thống.- RETURN_OR_REFUND_REQUEST_COMPLETE: Việc return/refund đã được xử lý thành công. Buyer đã được hoàn tiền.- REPLACEMENT_REQUEST_PENDING: Buyer đã khởi tạo yêu cầu replacement. Yêu cầu đang chờ seller xem xét.- REPLACEMENT_REQUEST_REJECT: Seller từ chối yêu cầu replacement của buyer.- REPLACEMENT_REQUEST_REFUND_SUCCESS: Yêu cầu replacement của buyer đã được giải quyết bằng cách hoàn tiền do thiếu hàng tồn kho.- REPLACEMENT_REQUEST_CANCEL: Buyer đã hủy yêu cầu replacement.- REPLACEMENT_REQUEST_COMPLETE: Seller đã chấp thuận yêu cầu replacement của buyer, nền tảng sẽ tạo một order mới để seller thực hiện.- AWAITING_BUYER_RESPONSE: Seller đề xuất một loại return khác cho buyer và đang chờ buyer phản hồi. Loại return do seller đề xuất có thể kiểm tra tại seller_proposed_return_type.
seller_proposed_return_type	[]string	Danh sách các loại return do seller đề xuất.Các giá trị có sẵn:- PARTIAL_REFUND
create_time_ge	int	Lọc returns để chỉ hiển thị những returns được tạo vào hoặc sau ngày và giờ được chỉ định. Unix timestamp.Lưu ý:create_time_ge và create_time_le cùng nhau cấu thành điều kiện lọc theo thời gian tạo.- Nếu create_time_ge được điền nhưng create_time_le để trống, create_time_le sẽ mặc định là thời gian hiện tại.- Nếu create_time_lt được điền nhưng create_time_ge để trống, create_time_ge sẽ mặc định là thời gian sớm nhất của shop.
arbitration_status	[]string	Danh sách các trạng thái phân xử. Các giá trị có sẵn:- IN_PROGRESS: Người vận hành nền tảng TikTok Shop đang xử lý phân xử. Nền tảng có thể yêu cầu thêm thông tin từ seller. - SUPPORT_BUYER: Người vận hành nền tảng ủng hộ buyer.- SUPPORT_SELLER: Người vận hành nền tảng ủng hộ seller.- CLOSED: Phân xử đã đóng.
update_time_ge	int	Lọc returns để chỉ hiển thị những returns được cập nhật vào hoặc sau ngày và giờ được chỉ định. Unix timestamp.Lưu ý:update_time_ge và update_time_le cùng nhau xác định điều kiện lọc theo thời gian cập nhật.- Nếu update_time_ge được điền nhưng update_time_le để trống, update_time_le sẽ mặc định là thời gian hiện tại.- Nếu update_time_lt được điền nhưng update_time_ge để trống, update_time_ge sẽ mặc định là thời gian sớm nhất của shop.
update_time_lt	int	Lọc returns để chỉ hiển thị những returns được tạo trước ngày và giờ được chỉ định. Unix timestamp.Tham khảo các lưu ý trong create_time_ge để biết thêm thông tin sử dụng.
locale	string	Các mã locale BCP-47 để hiển thị returns, phân cách bằng dấu phẩy. Mặc định: enTham khảo Locale codes để biết danh sách các mã locale được hỗ trợ.
create_time_lt	int	Lọc returns để chỉ hiển thị những returns được tạo trước ngày và giờ được chỉ định. Unix timestamp.Tham khảo các lưu ý trong create_time_ge để biết thêm thông tin sử dụng.

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 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 message.
request_id	string	Nhật ký yêu cầu
data	object	Thông tin return cụ thể

Example

JSONEnable word wrap

Error Code

View common error codes

| 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ó đúng (các) kiểu và định dạng tham số. | | 25020005 | Không có quyền xử lý order này | | 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. |

Is this content helpful?Helpful

Not Helpful

PreviousNext