Danh sách sản phẩm

• Tính năng này dùng để lấy danh sách 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

• Xem common request params.

• 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

Key	Type	Description
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)
categoryIds	array	List ID danh mục sản phẩm (Khi lọc danh mục cha sẽ tự lấy toàn bộ sản phẩm thuộc danh mục con)
status	array	Trạng thái sản phẩm
price	array	{"from": "Từ giá trị", "to": "Đến giá trị"}
brandIds	array	List ID thương hiệu (Khi lọc thương hiện cha sẽ tự lấy toàn bộ sản phẩm thuộc thương hiệu con)
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

Value	Description	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",
			"categoryId": "(int) ID danh mục",
			"internalCategoryId": "(int) ID 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"
			},
			"brandId": "(int) ID 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": "(double) Số lượng tồn kho tất cả các kho",
				"shipping": "(double) Số lượng đang giao hàng tất cả các kho",
				"damaged": "(double) Số lượng lỗi tất cả các kho",
				"holding": "(double) Số lượng tạm giữ tất cả các kho",
				"transfering": "(double) Số đang chuyển kho tất cả các kho",
				"available": "(double) Số lượng có thể bán tất cả các kho",
				"warranty": {
					"remain": "(double) Số lượng bảo hành tất cả các kho",
					"holding": "(double) Số lượng tạm giữ bảo hành tất cả các kho"
				},
				"depots": [
					{
						"id": "(int) ID kho hàng",
						"remain": "(double) Số lượng tồn kho",
						"shipping": "(double) Số lượng giao hàng",
						"damaged": "(double) Số lượng lỗi",
						"holding": "(double) Số lượng tạm giữ",
						"transfering": "(double) Số lượng đang chuyển kho",
						"available": "(double) Số lượng có thể bán",
						"warranty": {
							"remain": "(double) Số lượng bảo hành",
							"holding": "(double) 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",
					"nameOther": "(string) Tên khác thuộc tính",
					"value": "(string) Giá trị thuộc tính",
					"code": "(string) Mã thuộc tính",
					"codeOther": "(string) Mã khác thuộc tính"
				}
			],
			"updatedAt": "(int) Thời gian cập nhật",
			"createdAt": "(int) Thời gian tạo"
		}
	]
}