POST Get Order List

Lấy Danh Sách Đơn Hàng Shop Scope yêu cầu: seller.order.info Trả về danh sách các đơn hàng được tạo hoặc cập nhật trong khoảng thời gian được chỉ định bởi các tham số đã cho. Bạn cũng có thể áp dụng một loạt các tiêu chí lọc để thu hẹp danh sách đơn hàng trả về, chẳng hạn như trạng thái đơn hàng, loại tùy chọn giao hàng và buyer user ID. Phiên bản 202309

POST/order/202309/orders/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ị seller access_token từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy seller access_token.

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 diện 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 giá trị này để chuyển đổi sang thời gian địa phương.
page_size Required	int	Số lượng kết quả trả về trên mỗi trang. Mặc định: 20. Phạm vi hợp lệ: [1-100].
sort_order	string	Thứ tự sắp xếp cho tham số sort_field. Mặc định: DESCCác giá trị có thể có:- ASC: Thứ tự tăng dần- DESC: Thứ tự giảm dần
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.
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.
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ề phản hồi không chính xác. Lấy bằng API Get Authorization Shop

Body

Properties	Type	Description
order_status	string	Trạng thái đơn hàng cụ thể.Các giá trị khả dụng:- UNPAID: Đơn hàng đã được đặt, nhưng thanh toán chưa hoàn tất.- ON_HOLD: Đơn hàng đã được chấp nhận và đang chờ thực hiện. Người mua vẫn có thể hủy mà không cần sự chấp thuận của người bán. Nếu order_type=PRE_ORDER, sản phẩm vẫn đang chờ phát hành nên thanh toán sẽ chỉ được ủy quyền 1 ngày trước khi phát hành, nhưng người bán nên bắt đầu chuẩn bị cho việc phát hành.- AWAITING_SHIPMENT: Đơn hàng sẵn sàng để giao, nhưng chưa có mặt hàng nào được giao.- PARTIALLY_SHIPPING: Một số mặt hàng trong đơn hàng đã được giao, nhưng không phải tất cả.- AWAITING_COLLECTION: Việc giao hàng đã được sắp xếp, nhưng gói hàng đang chờ được đơn vị vận chuyển lấy đi.- IN_TRANSIT: Gói hàng đã được đơn vị vận chuyển lấy đi và đang trong quá trình giao hàng.- DELIVERED: Gói hàng đã được giao đến người mua.- COMPLETED: Đơn hàng đã hoàn tất, và không cho phép trả hàng hoặc hoàn tiền thêm nữa.- CANCELLED: Đơn hàng đã bị hủy.
create_time_ge	int	Lọc đơn hàng để chỉ hiển thị những đơn được tạo vào hoặc sau ngày giờ được chỉ định. Unix timestamp.Lưu ý:create_time_ge và create_time_lt 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_lt để trống, create_time_lt 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.
create_time_lt	int	Lọc đơn hàng để chỉ hiển thị những đơn được tạo trước ngày 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.
update_time_ge	int	Lọc đơn hàng để chỉ hiển thị những đơn được cập nhật vào hoặc sau ngày giờ được chỉ định. Unix timestamp.Lưu ý:update_time_ge và update_time_lt 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_lt để trống, update_time_lt 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.Thời gian cập nhật có thể vượt quá phạm vi tìm kiếm đã chọn do quá trình làm mới dữ liệu đang diễn ra trong quá trình tìm kiếm.
update_time_lt	int	Lọc đơn hàng để chỉ hiển thị những đơn được cập nhật trước ngày giờ được chỉ định. Unix timestamp.Tham khảo các lưu ý trong update_time_ge để biết thêm thông tin sử dụng.Thời gian cập nhật có thể vượt quá phạm vi tìm kiếm đã chọn do quá trình làm mới dữ liệu đang diễn ra trong quá trình tìm kiếm.
shipping_type	string	Phương thức giao hàng.- TIKTOK: Dịch vụ vận chuyển do TikTok cung cấp. Người bán nên lấy nhãn vận chuyển từ TikTok.- SELLER: Người bán tự cung cấp vận chuyển, bao gồm thông qua các nhà cung cấp dịch vụ thực hiện đơn hàng bên thứ 3 thay mặt cho người bán. - TIKTOK_DIGITAL: TikTok giao hàng hóa ảo trực tiếp đến người mua. Không cần thực hiện hành động nào.
buyer_user_id	string	Buyer user ID.
is_buyer_request_cancel	bool	Liệu người mua đã khởi tạo một yêu cầu hủy đơn hàng hay chưa.
warehouse_ids	[]string	Lọc đơn hàng theo ID kho lấy hàng/kho bán hàng.Chỉ áp dụng nếu tính năng đa kho được bật.Số lượng tối đa: 100

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	Các 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 thông báo.
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 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. |

Nội dung này có hữu ích không?Hữu ích

Không hữu ích

PreviousNext