Product list
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": {},
"paginator": {
"size": 50,
"sort": {"id": "desc"},
"next": 100
}
}'Filters
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
status
string
Trạng thái sản phẩm New = Mới Active = Hoạt động Inactive = Không hoạt động OutOfStock = Hết hàng
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
size
int
Số lượng bản ghi trên 1 trang. Tối đa không quá 50
next
array
Mảng dữ liệu next (được trả về từ trang trước đó - nếu có)
sort
array
Mảng dữ liệu các tiêu chí sort. Xem bảng bên dưới
Thông tin 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",
"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"
},
"vat": "(int) VAT",
"images": {
"avatar": "(string) Đường dẫn tới file ảnh",
"others": [
"(string) Đường dẫn tới file ảnh"
]
},
"previewLink": "(string) Đường dẫn tới sản phẩm",
"shows": {
"home": "(int) 1: Hiển thị ở trang chủ, 0: Không hiển thị",
"hot": "(int) 1: Hiển thị sản phẩm hot, 0: Không hiển thị",
"new": "(int) 1: Hiển thị sản phẩm mới, 0: Không hiển thị"
},
"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": [
{
"attributeName": "(string) Tên thuộc tính",
"id": "(int) ID giá trị thuộc tính",
"name": "(string) Tên giá trị thuộc tính",
"value": "(string) Giá trị thuộc tính",
"order": "(int) Thứ tự"
}
],
"updatedAt": "(int) Thời gian cập nhật",
"createdAt": "(int) Thời gian tạo"
}
]
}Last updated