Nhanh.vn Open API
Trang chủHướng dẫn sử dụngApps
v2
v2
  • Giới thiệu
  • Change log
  • Product
    • Danh sách sản phẩm
    • Thêm sản phẩm
    • Chi tiết sản phẩm
    • Danh mục sản phẩm
    • Danh mục nội bộ
    • Quà tặng sản phẩm
    • Danh sách IMEI
    • Tra cứu IMEI bán ra theo ngày
    • Lịch sử IMEI
    • Hạn sử dụng sản phẩm
    • Thêm ảnh sản phẩm
  • Order
    • Danh sách đơn hàng
    • Thêm đơn hàng
    • Cập nhật đơn hàng
    • Gửi khiếu nại đơn hàng
    • Lịch sử đơn hàng
    • Nguồn đơn hàng
  • Shipping
    • Hãng vận chuyển
    • Thành phố, quận huyện
    • Tính phí vận chuyển
  • Bill
    • Phiếu xuất nhập kho
    • Sản phẩm xuất nhập kho
    • Sản phẩm xuất nhập kho nháp
  • Customer
    • Danh sách khách hàng
    • Thêm khách hàng
  • Website
    • Tin tức
    • Danh mục tin tức
    • Thêm subscriber
    • Thêm liên hệ
  • Supplier
    • Nhà cung cấp
  • Promotion
    • Danh sách coupon
  • Store
    • Kho hàng
    • Nhân viên
  • Accounting
    • Bút toán
    • Công nợ khách hàng
  • Zalo
    • Gửi tin Zalo ZNS
  • Ecommerce
    • Danh sách gian hàng
  • Webhooks
    • Giới thiệu
    • Đơn hàng
    • Sản phẩm
    • Tồn kho
Powered by GitBook
On this page
  • Thêm mới sản phẩm
  • Attributes
  • Sửa sản phẩm
  • Xóa sản phẩm
  • Inventory

Was this helpful?

  1. Webhooks

Sản phẩm

PreviousĐơn hàngNextTồn kho

Last updated 7 months ago

Was this helpful?

  • Khi thông tin sản phẩm trên Nhanh.vn có thay đổi, Nhanh.vn sẽ bắn webhooks về cho hệ thống của bạn.

  • Xem cách .

  • 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

Thêm mới sản phẩm

{
    "event": "productAdd",
    "businessId": int, // ID doanh nghiệp trên Nhanh.vn
    "webhooksVerifyToken": string, // Key xác minh khi nhận dữ liệu, tương ứng với webhooks verify token trong app của bạn
    "data": {
        "productId": int, // ID sản phẩm trên Nhanh.vn
        "shopProductId": string, // shop product ID nếu sản phẩm được bắn từ các hệ thống khác sang Nhanh.vn
        "categoryId": int, // ID danh mục sản phẩm
        "brandId": int, // ID thương hiệu sản phẩm
        "parentId": int, // -1 = Sản phẩm độc lập, -2 = Sản phẩm cha, hoặc > 0 = Sản phẩm con
        "code": string, // mã sản phẩm
        "barcode": string, // mã vạch sản phẩm
        "name": string, // tên sản phẩm
        "vat": int, // % thuế giá trị gia tăng
        "image": string, // Đường dẫn tuyệt đối của ảnh đại diện sản phẩm
        "images": array, // Một mảng các đường dẫn tuyệt đối các ảnh khác của sản phẩm
        "status": string, // Trạng thái của sản phẩm
        "description": string, // Mô tả của sản phẩm
        "content": string, // Bài viết chi tiết sản phẩm
        "length": float, // Chiều dài sản phẩm (tính bằng cm)
        "width": float, // Chiều rộng sản phẩm (tính bằng cm)
        "height": float, // Chiều cao sản phẩm (tính bằng cm)
        "createdDateTime": string, // Ngày tạo sản phẩm định dạng: Y-m-d, VD: 2021-09-25
        "inventory": array, // Xem bảng Inventory bên dưới
        "attributes": array // Xem bảng Attributes bên dưới
        "createdById": int // ID user tạo sản phẩm
    }
}

Attributes

[
    {
        "attributeName": string // Tên thuộc tính, VD: Size, Color,...
        "id": int, // id giá trị thuộc tính
        "name": string, // Tên giá trị thuộc tính, VD: S,M,L, Màu đỏ, Màu xanh,...
        "content": string, // content giá trị thuộc tính
    },
    {
        ...
    },
    ...
]

Sửa sản phẩm

{
    "event": "productUpdate",
    "businessId": int, // ID doanh nghiệp trên Nhanh.vn
    "webhooksVerifyToken": string, // Key xác minh khi nhận dữ liệu, tương ứng với webhooks verify token trong app của bạn
    "data": {
        "productId": int, // ID sản phẩm trên Nhanh.vn
        "shopProductId": string, // shop product ID nếu sản phẩm được bắn từ các hệ thống khác sang Nhanh.vn
        "categoryId": int, // ID danh mục sản phẩm
        "brandId": int, // ID thương hiệu sản phẩm
        "parentId": int, // -1 = Sản phẩm độc lập, hoặc -2 = Sản phẩm cha, hoặc > 0 = Sản phẩm con
        "code": string, // mã sản phẩm
        "barcode": string, // mã vạch sản phẩm
        "name": string, // tên sản phẩm
        "vat": int, // % thuế giá trị gia tăng
        "image": string, // Đường dẫn tuyệt đối của ảnh đại diện sản phẩm
        "images": array, // Một mảng các đường dẫn tuyệt đối các ảnh khác của sản phẩm
        "status": string, // Trạng thái của sản phẩm
        "description": string, // Mô tả của sản phẩm
        "content": string, // Bài viết chi tiết sản phẩm
        "length": float, // Chiều dài sản phẩm (tính bằng cm)
        "width": float, // Chiều rộng sản phẩm (tính bằng cm)
        "height": float, // Chiều cao sản phẩm (tính bằng cm)
        "createdDateTime": string, // Ngày tạo sản phẩm định dạng: Y-m-d, VD: 2021-09-25
        "inventory": array, // Xem bảng Inventory bên dưới
        "attributes": array // Xem bảng Attributes bên trên
    }
}

Xóa sản phẩm

{
    "event": "productDelete",
    "businessId": int, // ID doanh nghiệp trên Nhanh.vn
    "webhooksVerifyToken": string, //Key xác minh khi nhận dữ liệu, tương ứng với webhooksVerifyToken trong app
    "data": [
        "productId1", // ID sản phẩm trên Nhanh
        "productId2", // ID sản phẩm trên Nhanh
        ...
    ]
}

Inventory

Một mảng thông tin tồn kho của sản phẩm:

{
    // Số tổng tồn trên tất cả các kho đang hoạt động
    "remain": int // số lượng tồn
    "shipping": int // số lượng đang giao hàng
    "holding": int // số lượng tạm giữ
    "damage": int // số lượng hàng lỗi
    "available": int // số lượng có thể bán, sử dụng số này để hiển thị số tồn trên website hoặc chặn việc đặt các sản phẩm hết hàng.
    "depots": { // số tồn chi tiết trong từng kho
        depotId1: {
            "remain": int // số lượng tồn
            "shipping": int // số lượng đang giao hàng
            "holding": int // số lượng tạm giữ
            "damage": int // số lượng hàng lỗi
            "available": int // số lượng có thể bán, sử dụng số này để hiển thị số tồn trên website hoặc chặn việc đặt các sản phẩm hết hàng.
        },
        depotId2: {
            ...
        }
    }
}
đăng kí nhận và xử lý webhooks
Danh sách sản phẩm