Product
Sự kiện liên quan tới sản phẩm.
Trên trang quản trị Nhanh.vn, bạn có thể vào trang chi tiết của 1 sản phẩm, tab API, để xem lịch sử webhooks của sản phẩm đó (cả webhooks thay đổi thông tin sản phẩm cũng như webhooks thay đổi tồn kho).
Để nhận được webhooks thêm, sửa, xóa sản phẩm, app phải có quyền lấy danh sách sản phẩm.
Thêm mới sản phẩm
Cấu trúc dữ liệu sẽ giống với thông tin 1 sản phẩm khi bạn gọi API lấy danh sách sản phẩm.
Key
Type
Description
event
string
event webhooks, giá trị: productAdd
businessId
int
ID doanh nghiệp trên Nhanh.vn
data
array
Mảng dữ liệu sản phẩm, xem data bên dưới
{
"event": "productAdd",
"businessId": int, // ID doanh nghiệp trên Nhanh.vn
"data": array // Xem data bên dưới
}Update sản phẩm
Cấu trúc dữ liệu sẽ giống với thông tin 1 sản phẩm khi bạn gọi API lấy danh sách sản phẩm.
Key
Type
Description
event
string
event webhooks, giá trị: productUpdate
businessId
int
ID doanh nghiệp trên Nhanh.vn
data
array
Mảng dữ liệu sản phẩm, xem data bên dưới
{
"event": "productUpdate",
"businessId": int, // ID doanh nghiệp trên Nhanh.vn
"data": array // Xem data bên dưới
}Xóa sản phẩm
Key
Type
Description
event
string
event webhooks, giá trị: productDelete
businessId
int
ID doanh nghiệp trên Nhanh.vn
data
array
Mảng ID sản phẩm đã xóa
{
"event": "productDelete",
"businessId": int, // ID doanh nghiệp trên Nhanh.vn
"data": [
"productId1",
"productId2",
...
]
}Data
Một mảng thông tin sản phẩm bao gồm:
{
"id": int, // ID sp trên Nhanh.vn
"parentId": int, // ID sp cha trên Nhanh.vn
"code": string, // Mã sản phẩm
"barcode": string, // Mã vạch sản phẩm
"name": string, // Tên sản phẩm
"otherName": string, // Tên khác của sản phẩm
"status": int, // trạng thái sản phẩm ( 1 = Mới, 2 = Đang bán, 3 = Ngừng bán, 4 = Hết hàng
"category": { // Danh mục sản phẩm
"id": int, // ID danh mục sản phẩm
"name": string, // Tên danh mục sản phẩm
"code": string // Mã danh mục sản phẩm
},
"internalCategory": { // Danh mục nội bộ
"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": { // Giá sản phẩm
"retail": int, // Giá bán lẻ sản phẩm
"import": int, // Giá nhập sản phẩm
"old": int, // Giá cũ sản phẩm
"wholesale": int, // Giá bán buôn
"avgCost": int // Giá vốn sản phẩm
},
"vat": int, // VAT sản phẩm
"images": { // Ảnh sản phẩm
"avatar": string, // Ảnh đại diện của sản phẩm
"others": array // Mảng các ảnh khác của sản phẩm
},
"order": int, // Thứ tự sắp sản phẩm
"previewLink": string, // Link hiển thị trên webiste của sản phẩm
"shows": { // Kiểu hiển thị của sản phẩm trên website
"home": int, // Sản phẩm trang chủ
"hot": int, // Sản phẩm hot
"new": int // Sản phẩm mới
},
"warranty": { // Bảo hành sản phẩm
"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": { // Thương hiệu
"id": int, // ID thương hiệu trên Nhanh.vn
"name": string // Tên thương hiệu
},
"type": 1, // Loại sản phẩm
"shipping": { // Kích thước sản phẩm
"width": int, // Chiều dài
"height": int, // Chiều cao
"length": int, // Chiều rộng
"weight": int // Cân nặng
},
"countryName": string, // Xuất xứ sản phẩm
"units": { // Đơn vị tính sản phẩm
"name": string, // Tên đơn vị tính
"list": [ // Danh sách đơ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
"price": {
"retail": int, // Giá bán
"import": int, // Giá nhập
"wholesale": int // Giá buôn
}
}
]
},
"combos": [ // Sản phẩm trong combo
{
"id": int, // ID sản phẩm trên Nhanh.vn
"quantity": int, // Số lượng sản phẩm
"code": string, // Mã sản phẩm
"name": string // Tên sản phẩm
}
],
"inventory": { // Tồn kho sản phẩm
"remain": int, // Số lượng tồn
"shipping": int, // Số lượng đang giao hàng
"damaged": int, // Số lượng lỗi
"holding": int, // Số lượng tạm giữ
"available": int, // Số lượng có thể bán
"warranty": { // Số lượng bảo hành
"remain": int, // Số đang bảo hành
"holding": int // Số đang tạm giữ
},
"depots": [
{
"id": int, // ID kho trên Nhanh
"remain": int, // Số lượng tồn theo kho
"shipping": int, // Số lượng đang giao hàng theo kho
"damaged": int, // Số lượng lỗi theo kho
"holding": int, // Số lượng tạm giữ theo kho
"available": int, // Số lượng có thể bán theo kho
"warranty": { // Số lượng bảo hành theo kho
"remain": int, // Số đang bảo hành
"holding": int // số đang tạm giữ
}
}
]
},
"attributes": [ // Thuộc tính sản phẩm
{
"attributeName": string, // Tên thuộc tính
"id": int, // ID giá trị thuộc tính trên Nhanh
"name": string, // Tên giá trị thuộc tính
"value": string, // Giá trị thuộc tính
"order": int // Thứ tự giá trị thuộc tính
}
],
"updatedAt": 1746859007, // Thời gian update sản phẩm (định dạng timestamp)
"createdAt": 1746520315 // Thời gian tạo sản phẩm (định dạng timestamp)
}Last updated