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

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

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