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
  • Request
  • Response
  • Inventory
  • Website info
  • Attributes

Was this helpful?

  1. Product

Chi tiết sản phẩm

PreviousThêm sản phẩmNextDanh mục sản phẩm

Last updated 1 month ago

Was this helpful?

  • /api/product/detail: Tính năng này dùng để lấy thông tin chi tiết của sản phẩm. Nếu sản phẩm được đồng bộ từ Nhanh.vn sang website của bạn, đôi khi bạn sẽ muốn lấy thêm thông tin chi tiết của sản phẩm đó.

Request

  • Xem các

  • The search param: data = productId (int) - ID sản phẩm trên Nhanh.vn

Response

JSON decode the response to get the structure:

Key
Type
Description

code

int

1 = success or 0 = failed

messages

array

is an array of error messages if code = 0

data

array

is an array of the parent and all child products (if the requested has child products)

data = [
    [
        // all properties are listed in the table below
    ],
    ...
]
Key
Type
Description

idNhanh

bigint(20)

ID sản phẩm trên Nhanh.vn

merchantCategoryId

int

ID danh mục sản phẩm trên các site tích hợp (tính năng này hiện chỉ phục vụ cho các sàn TMĐT)

merchantProductId

int

ID sản phẩm phi độc quyền (tính năng này chỉ phục vụ cho các sàn TMĐT)

categoryId

int

ID danh mục sản phẩm trên Nhanh.vn

brandId

int

ID thương hiệu trên Nhanh.vn

brandName

brand

Tên thương hiệu trên Nhanh.vn

parentId

bigint(20)

-1 = Sản phẩm độc lập, -2 = Sản phẩm cha

code

string(255)

Mã sản phẩm

barcode

string(255)

Mã vạch sản phẩm

name

string(255)

Tên sản phẩm

otherName

string(255)

Tên khác của sản phẩm

importPrice

double

Giá nhập

oldPrice

double

Giá cũ

price

double

Giá bán lẻ

wholesalePrice

double

Giá bán buôn

vat

int

% thuế giá trị gia tăng (VD: 10)

image

string(255)

Đường dẫn tuyệt đối của ảnh đại diện

images

array

Đường dẫn tuyệt đối của các ảnh khách của sản phẩm

status

string

Trạng thái của sản phẩm: Active | Inactive | OutOfStock

previewLink

string

Link chi tiết của sản phẩm trên website (if status is Active)

description

string

Mô tả ngắn của sản phẩm

highlight

array

Đặc điểm nội bật của sản phẩm

content

string

Bài viết chi tiết của sản phẩm

showHot

int

(Giá trị 0 | 1) Sản phẩm được đánh dấu là sản phẩm hot

showNew

int

(Giá trị 0 | 1) Sản phẩm được đánh dấu là sản phẩm mới

showHome

int

(Giá trị 0 | 1) Sản phẩm được đánh dấu hiển thị ở trang chủ

width

int

in cm

height

int

in cm

warrantyAddress

string

Địa chỉ bảo hành

warrantyPhone

string

Số điện thoại bảo hành

warranty

int

Số tháng bảo hành

warrantyContent

string

Nội dung bảo hành

length

int

in cm

shippingWeight

int

in gram

createdDateTime

datetime

Định dạng: yyyy-mm-dd hh:mm:ss

inventory

array

Thông tin tồn kho: xem ở bảng Inventory bên dưới

attributes

array

websiteInfo

array

Thông tin websiteInfo: xem ở bảng website info bên dưới

typeId

int

ID loại sản phẩm

typeName

string

Loại sản phẩm

Inventory

[
    // Tổng tồn trong tất cả các kho
    "remain" => int, // số lượng tồn kho
    "shipping" => int, // số lượng đang giao hàng
    "holding" => int, // số lượng đang tạm giữ
    "damage" => int, // số lượng lỗi
    "available" => int, // số lượng có thể bán (sử dụng để hiển thị trên website,chặn đặt hàng khi hết số tồn hoặc vượt quá số tồn).
    // Tồn tại từng kho
    "depots" => [
        "depotId1" => [
            "remain" => int, // số lượng tồn kho
            "shipping" => int, //  số lượng đang giao hàng
            "holding" => int, // số lượng đang tạm giữ
            "damage" => int, //  số lượng lỗi
            "available" => int, // số lượng có thể bán (sử dụng để hiển thị trên website, chặn đặt hàng khi hết số tồn hoặc vượt quá số tồn).
            "transfering" => int, // Số lượng đang chuyển kho
        ],
        "depotId2" => [
            ...
        ],
        ...
    ]
]

Website info

[
    "metaTitle" => string, // metaTitle content
    "metaDescription" => string, // metaDescription content
    "metaKeywords" => string, // metaKeywords content
    "highlights" => array, // Đặc điểm nổi bật sản phẩm ( ['đặc điểm 1', 'Đặc điểm 2', ...] )
    "tags" => array, // tags sản phẩm ( ['tag 1', 'tag 2', ...] )
    "videos" => array // videos sản phẩm
]

Attributes

  • Thuộc tính sản phẩm:

[
	{
		"id_thuoc_tinh" => {
			"attributeName" => string,
			"id" => int,
			"name" => string,
			"order" => int
		},
		"id_thuoc_tinh" => {
			"attributeName" => string,
			"id" => int,
			"name" => string,
			"order" => int
			"parent" => { // parent attribute
				"id" => int,
				"name" => string
			}
		}
	}
]

Xem bảng bên dưới

Attributes
common request params
API chi tiết sản phẩm