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.

Key
Type
Description

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.

Key
Type
Description

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

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": [
      "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