Sản phẩm
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.
event
string
event webhooks, giá trị: productAdd
businessId
int
ID doanh nghiệp trên Nhanh.vn
data
object
Thông tin 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": {}
}
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.
event
string
event webhooks, giá trị: productUpdate
businessId
int
ID doanh nghiệp trên Nhanh.vn
data
object
Thông tin 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": {}
}
Xóa sản phẩm
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": [
"100",
"101"
]
}
Thông tin sản phẩm bao gồm:
{
"id": "(int) ID 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)",
"code": "(string) Mã sản phẩm",
"barcode": "(string) Mã vạch",
"name": "(string) Tên sản phẩm",
"otherName": "(string) Tên khác",
"status": "(string) Trạng thái sản phẩm",
"category": {
"id": "(int) ID danh mục",
"code": "(string) Mã danh mục",
"name": "(string) Tên danh mục"
},
"internalCategory": {
"id": "(int) ID danh mục nội bộ",
"code": "(string) Mã danh mục nội bộ",
"name": "(string) Tên 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"
]
},
"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": {
"id": "(int) ID loại sản phẩm",
"name": "(string) Tên loại sản phẩm"
},
"shipping": {
"length": "(int) Chiều dài",
"width": "(int) Chiều rộng",
"height": "(int) Chiều cao",
"weight": "(int) 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ố tồn kho tất cả các kho",
"shipping": "(int) Số đang chuyển tất cả các kho",
"damaged": "(int) Số lượng hỏng tất cả các kho",
"holding": "(int) Số tạm giữ tất cả các kho",
"warranty": "(int) Số bảo hành tất cả các kho",
"warrantyHolding": "(int) Số tạm giữ bảo hành tất cả các kho",
"holdingNew": "(int) Số tạm giữ (loại xuất S) tất cả các kho",
"shippingExport": "(int) Số đang chuyển (loại xuất S) tất cả các kho",
"available": "(int) Số có thể bán tất cả các kho",
"depots": [
{
"id": "(int) ID kho hàng",
"remain": "(int) Số tồn kho",
"shipping": "(int) Số đang chuyển",
"damaged": "(int) Số lượng hỏng",
"holding": "(int) Số tạm giữ",
"warranty": "(int) Số bảo hành",
"warrantyHolding": "(int) Số tạm giữ bảo hành",
"holdingNew": "(int) Số tạm giữ (loại xuất S)",
"shippingExport": "(int) Số đang chuyển (loại xuất S)",
"available": "(int) Số có thể bán"
}
]
},
"attributes": [
{
"id": "(int) ID thuộc tính",
"name": "(int) Tên thuộc tính",
"value": "(int) Giá trị"
}
],
"updatedAt": "(int) Thời gian cập nhật, định dạng timestamp",
"createdAt": "(int) Thời gian tạo, định dạng timestamp",
"description": "(string) Mô tả sản phẩm",
"content": "(string) Nội dung sản phẩm",
"suppliers": {
"id": "(int) ID nhà cung cấp",
"name": "(string) Tên nhà cung cấp",
"mobile": "(string) Số điện thoại"
},
"videos": [
{
"title": "(int) Tiêu đề",
"src": "(int) Link đường dẫn tới video"
}
],
"branchPrices": [
{
"branch": {
"id": "(int) ID chi nhánh",
"name": "(string) Tên chi nhánh"
},
"price": "(int) Giá bán lẻ",
"wholesalePrice": "(int) Giá bán sỉ"
}
],
"childs": "(array) Mảng thông tin sản phẩm con"
}
Last updated