GET Lấy Đơn Hàng Nhập Kho
Lấy Đơn Hàng Nhập Kho Shop Scope bắt buộc: seller.fbt.info API này được dùng để truy xuất chi tiết đơn hàng nhập kho bao gồm chi tiết nhập kho theo kế hoạch, chi tiết nhập kho thực tế và trạng thái nhập kho, v.v. Phiên bản 202602
GET/fbt/202602/inbound_orders
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu đượ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 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 request API tới 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 dùng trên tất cả các request API. Nhà phát triển có thể dùng nó để chuyển đổi sang giờ địa phương. |
| order_ids Required | []string | Danh sách các định danh số của các đơn hàng nhập kho cần lấy thông tin. Lưu ý: Chỉ cung cấp chuỗi số; không bao gồm tiền tố "IBR" (ví dụ, dùng 123456 thay vì IBR123456). Có giới hạn 10 đơn hàng được lấy trong mỗi request.Bạn có thể lấy giá trị tại data.inbound_order_id trong webhook Inbound FBT order status change hoặc tại data.inventory_records.order.id trong response của Search FBT Inventory Record. |
| include_carton_details | bool | Một cờ boolean xác định liệu response có nên bao gồm thông tin chi tiết cho từng carton riêng lẻ trong lô hàng hay không.Lưu ý: Khi đặt là true, response sẽ bao gồm trường carton_details. Nếu đặt là false hoặc bỏ qua, trường này sẽ bị loại khỏi payload response để tối ưu hiệu năng. |
| shop_cipher Required | string | Dùng property 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 |
Example
CurlGoNode.jsJavaEnable word wrap
1234curl-XGET 'https://open-api.tiktokglobalshop.com/fbt/202602/inbound_orders?include_carton_details=true×tamp=1623812664&app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3&order_ids=5766071177167344427,5766071177167344428' -H 'content-type: application/json' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k'
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 API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong response API. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Log request |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
{"code":0,"data":{"inbound_orders":[{"order_id":"5766071177167344427","order_id_string":"IBR5766071177167344427","order_plan_id":"5766071177167345050","merchant":{"id":"493493403043","name":"ExampleCompany"},"create_time":1773778751,"ship_time":1773778751,"expected_arrival_time":1773778751,"actual_arrival_time":1773778751,"warehouse":{"fbt_warehouse_id":"121219993203023","business_warehouse_ids":["121219993209983"],"name":"TikTok Warehouse","type":"FC"
Error Code
Xem các mã lỗi phổ biến
| Code | Message | | --- | --- | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 39001002 | Request or request parameters are empty. Please recheck the input parameters. | | 39015009 | SellerId input is invalid | | 39015010 | No inbound orders found for the merchant. | | 39015020 | Number of orders in request exceeds the configured limit. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext