POST Tìm kiếm đơn hàng theo tham chiếu đơn hàng bên ngoài
Tìm kiếm đơn hàng theo tham chiếu đơn hàng bên ngoài Shop Scope bắt buộc: seller.order.ext_ref.read Nếu bạn đã sử dụng Add External Order References API để đồng bộ thông tin từ hệ thống quản lý đơn hàng (OMS) bên ngoài của bạn sang các đơn hàng tương ứng trong TikTok Shop, bạn có thể gọi API này để tìm kiếm thông tin đơn hàng trong TikTok Shop dựa trên thông tin trong OMS của bạn. Phiên bản 202406
POST/order/202406/orders/external_order_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 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 nó để chuyển đổi sang giờ địa phương. |
| platform Required | string | Bí danh của hệ thống quản lý đơn hàng (OMS) bên ngoài của bạn.Các giá trị có thể có:- SHOPIFY- WOOCOMMERCE- BIGCOMMERCE- MAGENTO- SALESFORCE_COMMERCE_CLOUD- CHANNEL_ADVISOR- AMAZON- ORDER_MANAGEMENT_SYSTEM- WAREHOUSE_MANAGEMENT_SYSTEM- ERP_SYSTEM |
| external_order_id Required | string | ID đơn hàng trong OMS của bạn. |
| shop_cipher Required | string | Sử dụng thuộc tính 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 |
Example
CurlGoNode.jsJavaEnable word wrap
12345curl-X POST 'https://open-api.tiktokglobalshop.com/order/202406/orders/external_order_search?external_order_id=676461413038785752&app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c×tamp=1623812664&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3&platform=SHOPIFY' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json' -d '{}'
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","external_order":{"id":"676461413038785752","platform":"SHOPIFY","line_items":[{"id":"577086512123755123","origin_id":"677086512123755123"}]}}]},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}
Error Code
Xem các mã lỗi phổ biến
| Code | Message | | --- | --- | | Trống. Không có mã lỗi logic nghiệp vụ. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext