GET Lấy chi tiết đơn hàng
Lấy chi tiết đơn hàng Shop Required scope: seller.order.info Lấy thông tin đơn hàng chi tiết của một đơn hàng, bao gồm các thuộc tính quan trọng như trạng thái đơn hàng, địa chỉ giao hàng, chi tiết thanh toán, thông tin giá và thuế, và thông tin kiện hàng. Version 202507
GET/order/202507/orders
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 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ể 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 cái này để chuyển đổi sang giờ địa phương. |
| ids Required | []string | Danh sách các giá trị order ID của TikTok Shop.Số lượng tối đa: 50 |
| 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 |
Example
CurlGoNode.jsJavaEnable word wrap
1234curl-XGET 'https://open-api.tiktokglobalshop.com/order/202507/orders?app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c×tamp=1623812664&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3&ids=57668123555,57668123555' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json'
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 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
{"code":0,"data":{"orders":[{"id":"576461413038785752","cancellation_initiator":"SELLER","shipping_provider":"TT Virtual express","shipping_provider_id":"6617675021119438849","user_id":"7021436810468230477","status":"UNPAID","rts_time":1619611563,"payment":{"currency":"IDR","sub_total":"5000","shipping_fee":"5000","seller_discount":"5000","platform_discount":"5000","payment_platform_discount":"10","payment_discount_service_fee":"10","total_amount":"5000","original_total_product_price":"5000","original_shipping_fee":"5000",
Error Code
Xem các mã lỗi phổ biến
| Code | Message | | --- | --- | | 10002014 | Không lấy được đơn hàng, nếu đã thử lại nhiều lần mà vẫn thất bại, vui lòng liên hệ nền tảng để được hỗ trợ | | 10002015 | Không lấy được đơn hàng, nếu đã thử lại nhiều lần mà vẫn thất bại, vui lòng liên hệ nền tảng để được hỗ trợ | | 10006402 | 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. | | 10037002 | Không lấy được đơn hàng, nếu đã thử lại nhiều lần mà vẫn thất bại, vui lòng liên hệ nền tảng để được hỗ trợ | | 10037003 | Không lấy được đơn hàng, nếu đã thử lại nhiều lần mà vẫn thất bại, vui lòng liên hệ nền tảng để được hỗ trợ | | 10037004 | Không lấy được đơn hàng, nếu đã thử lại nhiều lần mà vẫn thất bại, vui lòng liên hệ nền tảng để được hỗ trợ | | 21008111 | Đơn hàng hoặc kiện hàng không thuộc về người bán hiện tại. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext