Sản phẩm

• 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 đăng kí nhận và xử lý webhooks.

• 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 Danh sách sản phẩm

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
        "price": double, // giá 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
        "weight": double // khối lượng 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
        "price": double, // giá 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,
        "weight": double // khối lượng sản phẩm
    }
}

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: {
            ...
        }
    }
}