POST Tìm kiếm tồn kho FBT
Tìm kiếm tồn kho FBT Shop Scope yêu cầu: seller.fbt.info API này được dùng để truy xuất thông tin tồn kho chi tiết của hàng hóa và các SKU được khớp, bao gồm tồn kho có thể bán, tồn kho được giữ trước, tồn kho không thể bán và tồn kho đang vận chuyển ở cấp độ kho hàng. Phiên bản 202408
POST/fbt/202408/inventory/search
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 seller lấy 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 |
|---|---|---|
| page_size Required | int | Số lượng kết quả trả về trên mỗi trang. Khoảng giá trị hợp lệ: [1-100]. |
| page_token | string | Token phân trang. Token này nên để trống cho trang đầu tiên. |
| 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 gửi các yêu cầu 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 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. |
| shop_cipher Required | string | 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ề response không chính xác. Lấy qua API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| goods_ids | []string | Các định danh cho hàng hóa được tạo bởi hệ thống Fulfilled by TikTok, độ dài tối đa 100. Nếu được chỉ định, nó sẽ chỉ hiển thị thông tin tồn kho thuộc về các hàng hóa đó, nếu không, tất cả hàng hóa có tồn kho khác không sẽ được trả về.Lưu ý: API này chỉ cho phép dùng goods_ids hoặc sku_ids, và trả về các kết quả thỏa mãn tất cả tiêu chí được chỉ định. |
| fbt_warehouse_ids | []string | Các định danh cho kho hàng được tạo bởi hệ thống Fulfilled by TikTok. Nếu được chỉ định, nó sẽ chỉ hiển thị các bản ghi tồn kho thuộc về các kho hàng đó, nếu không, tất cả kho hàng được người bán đăng ký sẽ được trả về. |
| sku_ids | []string | Danh sách các định danh cho Stock Keeping Units(SKUs) được tạo bởi TikTok Shop, độ dài tối đa 100. Lọc thông tin tồn kho để chỉ hiển thị những thông tin thuộc về hàng hóa khớp với các SKU được chỉ định. Tham khảo lưu ý trong goods_ids để biết thêm thông tin sử dụng. |
Example
CurlGoNode.jsJavaEnable word wrap
12345678910111213141516curl-X POST 'https://open-api.tiktokglobalshop.com/fbt/202408/inventory/search?sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c×tamp=1623812664&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3&page_size=50&page_token=cGFnZV9udW1iZXI9Mg==&app_key=38abcd' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json' -d '{ "goods_ids": [ "256080616234", "2231616264" ], "fbt_warehouse_ids": [ "7232382932030232" ], "sku_ids": [ "256080616234" ]}'
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 | Các 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 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":{"next_page_token":"cGFnZV9udW1iZXI9Mg==","total_count":22113,"inventory":[{"goods":{"id":"12345","reference_code":"water01","name":"100ml water","skus":[{"id":"73243612345","on_hand_detail":{"total_quantity":20,"available_quantity":5,"reserved_quantity":15}}]},"fbt_warehouse_id":"7232382932030232",
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