Danh sách tồn kho
Tính năng này dùng để lấy danh sách tồn kho. Chú ý:
Khi gọi API lấy danh sách sản phẩm cũng có trả về tồn kho rồi kèm theo toàn bộ thông tin chi tiết của sản phẩm.
Nếu bạn chỉ muốn cập nhật riêng tồn kho, thì nên dùng API này thay vì dùng API lấy danh sách sản phẩm. Ưu điểm:
Dữ liệu nhẹ hơn, tốc độ nhanh hơn.
Có hỗ trợ lọc theo thời gian thay đổi số tồn, để chỉ cần quét các sản phẩm có thay đổi tồn, thay vì quét toàn bộ sản phẩm.
Dữ liệu sẽ được phân trang, mỗi trang tối đa không quá 100 sản phẩm.
Bạn nên lưu giá trị thời gian lần cuối cùng quét toàn bộ, sau đó dùng 2 request params là updatedAtFrom và updatedAtTo để chỉ lấy về các sản phẩm có cập nhật mới, không cần gọi lại toàn bộ dữ liệu cũ không có thay đổi gì.
Chú ý: updatedAt sẽ chỉ bao gồm thông tin sản phẩm (tên, giá bán...) bị thay đổi, không bao gồm thông tin tồn kho của sản phẩm. Để cập nhật tồn kho, bạn nên đăng ký webhooks tồn kho
Request
curl --location --globoff 'https://pos.open.nhanh.vn/v3.0/product/inventory?appId={{appId}}&businessId={{businessId}}' \
--header 'Authorization: {{accessToken}}' \
--header 'Content-Type: application/json' \
--data '{
"filters": {
},
"paginator": {
"size": 50,
"next": {"id": 100}
}
}'Filters
ids
array
Mảng ID sản phẩm, tối đa 100
name
string
Tên, mã, mã vạch sản phẩm
depotIds
array
Id cửa hàng
categoryId
int
Id danh mục sản phẩm
brandIds
array
ID thương hiệu
updatedAtFrom
int
Cập nhật sản phẩm từ ngày (định dạng timestamp)
updatedAtTo
int
Cập nhật sản phẩm đến ngày (định dạng timestamp)
Paginator
Xem cấu trúc chung tại đây.
sort
productId
ID sản phẩm
desc: giảm dần (mặc định), asc: tăng dần
Response
Xem cấu trúc chung tại đây.
Failed response
Xem các mã lỗi chung tại đây.
Successful response
Last updated