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

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)

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

sort

Value
Description
Sort

id

ID sản phẩm

desc: giảm dần, asc: tăng dần

Response

Failed response

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