Danh sách sản phẩm
Tính năng này dùng để lấy danh sách sản phẩm ở trên Nhanh.vn. 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
Xem Postman sample.
curl --location --globoff 'https://pos.open.nhanh.vn/v3.0/product/list?appId={{appId}}&businessId={{businessId}}' \
--header 'Authorization: {{accessToken}}' \
--header 'Content-Type: application/json' \
--data '{
"filters": {
"ids": [100, 101],
"status": [1,2]
},
"paginator": {
"size": 50,
"sort": {"id": "desc"},
"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
parentId
int
ID sản phẩm cha (-1: Sản phẩm độc lập, -2: Sản phẩm cha)
categoryId
int
Id danh mục sản phẩm
price
array
{"from": "Từ giá trị", "to": "Đến giá trị"}
brandId
int
ID thương hiệu
imei
string
IMEI
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
id
ID sản phẩm
desc: giảm dần, 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
{
"code": 1,
"paginator": {
"next": "Dùng để lấy dũ liệu trang tiếp theo"
},
"data": [
{
"id": "(int) ID sản phẩm trên Nhanh.vn",
"parentId": "(int) ID sản phẩm cha",
"code": "(string) Mã",
"barcode": "(string) Mã vạch",
"name": "(string) Tên",
"otherName": "(string) Tên khác",
"status": "(int) Trạng thái",
"vat": "(int) VAT",
"category": {
"id": "(int) ID danh mục",
"name": "(string) Tên danh mục",
"code": "(string) Mã danh mục"
},
"internalCategory": {
"id": "(int) ID danh mục nội bộ",
"name": "(string) Tên danh mục nội bộ",
"code": "(string) Mã danh mục nội bộ"
},
"prices": {
"retail": "(double) Giá bán lẻ",
"import": "(double) Giá nhập",
"old": "(double) Giá bán cũ",
"wholesale": "(double) Giá bán sỉ",
"avgCost": "(double) Giá vốn"
},
"images": {
"avatar": "(string) Đường dẫn tới file ảnh",
"others": [
"(string) Đường dẫn tới file ảnh"
]
},
"warranty": {
"month": "(int) Số tháng bảo hành",
"phone": "(string) Số điện thoại bảo hành",
"address": "(string) Địa chỉ bảo hảnh"
},
"brand": {
"id": "(int) ID thương hiệu",
"name": "(string) Tên thương hiệu"
},
"type": "(int) Loại sản phẩm",
"shipping": {
"width": "(double) Chiều rộng",
"height": "(double) Chiểu cao",
"length": "(double) Chiều dài",
"weight": "(double) Khối lượng"
},
"countryName": "(string) Tên quốc gia",
"units": {
"name": "(string) Đơn vị tính",
"list": [
{
"id": "(int) ID đơn vị tính",
"name": "(string) Tên đơn vị tính",
"quantity": "(double) Số lượng",
"price": {
"retail": "(double) Giá bán lẻ",
"import": "(double) Giá nhập",
"wholesale": "(double) Giá bán sỉ"
}
}
]
},
"combos": [
{
"id": "(int) ID sản phẩm",
"code": "(string) Mã sản phẩm",
"name": "(string) Tên sản phẩm",
"quantity": "(int) Số lượng"
}
],
"inventory": {
"remain": "(int) Số lượng tồn kho",
"shipping": "(int) Số lượng đang chuyển",
"damaged": "(int) Số lượng hỏng",
"holding": "(int) Số lượng tạm giữ",
"available": "(int) Số lượng có thể bán",
"warranty": {
"remain": "(int) Số lượng bảo hành",
"holding": "(int) Số lượng tạm giữ bảo hành"
},
"depots": [
{
"id": "(int) ID kho hàng",
"remain": "(int) Số lượng tồn kho",
"shipping": "(int) Số lượng đang chuyển",
"damaged": "(int) Số lượng hỏng",
"holding": "(int) Số lượng tạm giữ",
"available": "(int) Số lượng có thể bán",
"warranty": {
"remain": "(int) Số lượng bảo hành",
"holding": "(int) Số lượng tạm giữ bảo hành"
}
}
]
},
"attributes": [
{
"id": "(int) ID giá trị thuộc tính",
"name": "(string) Tên thuộc tính",
"value": "(string) Giá trị thuộc tính"
}
],
"updatedAt": "(int) Thời gian cập nhật",
"createdAt": "(int) Thời gian tạo"
}
]
}
Last updated