POST Tìm kiếm Bản ghi Tồn kho FBT
Tìm kiếm Bản ghi Tồn kho FBT Shop Scope bắt buộc: seller.fbt.info API này được dùng để truy xuất các bản ghi thay đổi tồn kho chi tiết của hàng hóa ở cấp độ kho. Phiên bản 202410
POST/fbt/202410/inventory_records/search
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại 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. Phạm vi hợp lệ: [1-100]. |
| page_token | string | Token phân trang. Phải để trống đối với trang đầu tiên. |
| 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 API request đến TTS, bạn phải ký chúng để TTS có thể nhận diện được người gửi. |
| timestamp Required | string | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên tất cả các API request. 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 | Sử dụng property 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 đối với 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 |
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, chỉ hiển thị các bản ghi tồn kho thuộc về những hàng hóa đó, nếu không, tất cả hàng hóa có tồn kho khác 0 sẽ được trả về. |
| fbt_warehouse_ids | []string | Các định danh cho kho được tạo bởi hệ thống Fulfilled by TikTok. Nếu được chỉ định, chỉ hiển thị các bản ghi tồn kho thuộc về những kho đó, nếu không, tất cả các kho mà nhà bán đăng ký sẽ được trả về. |
| create_time_ge | int | Lọc thời gian tạo bản ghi tồn kho để chỉ hiển thị những bản ghi được tạo vào hoặc sau ngày giờ được chỉ định. Unix timestamp tính bằng giây. create_time_ge mặc định là 0. |
| create_time_le | int | Lọc thời gian tạo bản ghi tồn kho để chỉ hiển thị những bản ghi được tạo vào hoặc trước ngày giờ được chỉ định. Unix timestamp tính bằng giây. create_time_le mặc định là thời gian hiện tại. |
Example
CurlGoNode.jsJavaEnable word wrap
123456789101112131415curl-X POST 'https://open-api.tiktokglobalshop.com/fbt/202410/inventory_records/search?timestamp=1623812664&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3&page_size=50&page_token=cGFnZV9udW1iZXI9Mg==&app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json' -d '{ "goods_ids": [ "256080616234", "2231616264" ], "fbt_warehouse_ids": [ "7232382932030232" ], "create_time_ge": 1293013251, "create_time_le": 1393013251}'
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 API response. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong API response. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Log của request |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
{"code":0,"data":{"inventory_records":[{"goods":{"id":"12324323","reference_code":"water01","name":"100ml water"},"fbt_warehouse_id":"7232392932323","order":{"id":"OBF8932302030203","type":"OUTBOUND_ORDER"},"create_time":1212139230,"inventory_goods_type":"NORMAL","initial_on_hand_quantity":10,"final_on_hand_quantity":12,"changed_quantity":2}],"next_page_token":"cGFnZV9udW1iZXI9Mg==",
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