Danh sách sản phẩm

• /api/product/search: 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.

• Nếu bạn hay thường xuyên cần gọi toàn bộ danh sách 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à updatedDateTimeFrom và updatedDateTimeTo để 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ộ khách cũ không có thay đổi gì.

  • Chú ý: updatedDateTime 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 các common request params

• Các key của mảng data array dùng để tạo data json string:

Key	Type	Description
page	int	Phân trang, mặc định: 1.
icpp	int	Số lượng sản phẩm trên 1 trang, mặc định: 100, tối đa: 100.
sort	array	Sắp xếp kết quả, dữ liệu gửi lên là 1 mảng kiểu [Tiêu chí sắp xếp => cách sắp xếp (asc: tăng dần hoặc desc giảm dần)] Giá trị mặc định sẽ là [id => desc].Các tiêu chí có thể là: id: id sản phẩm, price: giá sản phẩm, name: tên sản phẩm, inventory: tồn kho có thể bán
name	string	Tìm sản phẩm theo tên, mã, mã vạch
parentId	int	Tìm theo ID sản phẩm cha. -1 = Sản phẩm độc lập, -2 = Sản phẩm cha
categoryId	int	Tìm sản phẩm theo id danh mục sản phẩm, nếu danh mục này có các danh mục con, hệ thống sẽ tìm sản phẩm của toàn bộ danh mục con.
status	string	Tìm theo trạng thái sản phẩm. Xem bảng mô tả trạng thái sản phẩm
priceFrom	double	Tìm theo giá >=
priceTo	double	Tìm theo giá <=
brandId	int	Tìm theo thương hiệu
imei	string	Tìm theo IMEI
showHot	int	Tìm theo sản phẩm được đánh dấu là sản phẩm hot (Giá trị truyền lên: 1 hoặc 0)
showNew	int	Tìm theo sản phẩm được đánh dấu là sản phẩm mới (Giá trị truyền lên: 1 hoặc 0)
showHome	int	Tìm theo sản phẩm được đánh dấu là sản phẩm trên trang chủ (Giá trị truyền lên: 1 hoặc 0)
updatedDateTimeFrom	string	Định dạng: Y-m-d H:i:s, Vd: 2022-05-25 00:00:00 Ngày cập nhật sản phẩm từ ngày
updatedDateTimeTo	string	Định dạng: Y-m-d H:i:s, Vd: 2022-05-30 23:59:00 Ngày cập nhật sản phẩm đến ngày

Response

• JSON decode the response to get the structure:

Key	Type	Description
code	int	1 = success or 0 = failed
messages	array	is an array of error messages if code = 0
data	array	is an array of product list

[
    "totalPages": 30, // int
    "products": {
        {}, // each product item, all properties are listed in the table below
        ...
    }
]

Key	Type	Description
idNhanh	bigint(20)	ID sản phẩm trên Nhanh.vn
categoryId	int	ID danh mục sản phẩm trên Nhanh.vn
internalCategoryId	int	ID danh mục nội bộ trên Nhanh.vn
parentId	bigint(20)	-1 = Sản phẩm độc lập, hoặc -2 = Sản phẩm cha, hoặc -10 = Tất cả sản phẩm con
code	string(255)	Mã sản phẩm
name	string(255)	Tên sản phẩm
otherName	string(255)	Tên khác của sản phẩm
importPrice	doulbe	Giá nhập
oldPrice	double	Giá cũ
price	double	Giá bán lẻ
wholesalePrice	double	Giá bán buôn
vat	int	% thuế giá trị gia tăng (VD: 10)
image	string(255)	Đường dẫn tuyệt đối của ảnh đại diện
images	array	Đường dẫn tuyệt đối của các ảnh khác của sản phẩm
status	string	Xem bảng mô tả trạng thái sản phẩm
previewLink	string	Link chi tiết của sản phẩm trên website (if status is Active)
showHot	int	(Giá trị 0 or 1) Sản phẩm được đánh dấu là sản phẩm hot
showNew	int	(Giá trị 0 or 1) Sản phẩm được đánh dấu là sản phẩm mới
showHome	int	(Giá trị 0 or 1) Sản phẩm được đánh dấu hiển thị ở trang chủ
width	int	in cm
height	int	in cm
warrantyAddress	string	Địa chỉ bảo hành
warrantyPhone	string	Số điện thoại bảo hành
warranty	int	Số tháng bảo hành
length	int	in cm
shippingWeight	int	in gram
createdDateTime	datetime	định dạng yyyy-mm-dd hh:mm:ss
brandId	int	ID thương hiệu
brandName	string	Tên thương hiệu
typeId	int	ID loại sản phẩm
typeName	string	Loại sản phẩm
avgCost	double	Giá vốn sản phẩm
countryName	string	Xuất xứ
unit	string	Đơn vị tính
importType	int	ID Kiểu nhập kho
importTypeLabel	string	Tên kiểu nhập kho
inventory	array	Xem bảng Inventory bên dưới
attributes	array	Xem bảng Attributes bên dưới
units	array	Xem bảng Units bên dưới
updatedAt	int	Ngày cập nhật sản phẩm (định dạng timestamp)

Inventory

• Tồn kho:

[
    // Tổng tồn trong tất cả các kho
    "remain" => int, // số lượng tồn kho
    "shipping" => int, // số lượng đang giao hàng
    "holding" => int, // số lượng đang tạm giữ
    "damage" => int, // số lượng lỗi
    "available" => int, // số lượng có thể bán (sử dụng để hiển thị trên website, chặn đặt hàng khi hết số tồn hoặc vượt quá số tồn).
    "warranty" => int, // số lượng bảo hành
    "warrantyHolding" => int, // Số lượng đang bảo hành
    "depots" => { // Tồn tại từng kho
        "depotId" => {
            "remain" => int, // số lượng tồn kho
            "shipping" => int, //  số lượng đang giao hàng
            "holding" => int, // số lượng đang tạm giữ
            "damage" => int, //  số lượng lỗi
            "available" => int, // số lượng có thể bán (sử dụng để hiển thị trên website, chặn đặt hàng khi hết số tồn hoặcvượt quá số tồn).
            "warranty" => int, // số lượng bảo hành
            "warrantyHolding" => int, // Số lượng đang bảo hành
			"transfering" => int, // Số lượng đang chuyển kho
        },
        "depotId" => {
            // ...
        },
    }
]

Attributes

• Thuộc tính sản phẩm:

[
	{
		"id_thuoc_tinh" => {
			"attributeName" => string,
			"id" => int,
			"name" => string,
			"order" => int
		},
		"id_thuoc_tinh" => {
			"attributeName" => string,
			"id" => int,
			"name" => string,
			"order" => int
			"parent" => { // parent attribute
				"id" => int,
				"name" => string
			}
		}
	}
]

Units

• Đơn vị tính

[
    {
        "id" => int, // ID đơn vị tính
        "name" => string // Tên đơn vị tính
        "quantity" => int // Số lượng quy đổi
        "importPrice" => double // Giá nhập
        "price" => double // Giá lẻ
        "wholesalePrice" => double // Giá buôn
    },
    {
        ...
    }
]