Chuyển tới nội dung chính

Tạo Sản Phẩm

1. Tạo Sản Phẩm Mới

Endpoint

POST /api/v6.1/product

Headers

{
"Content-Type": "application/json",
"X-API-KEY": "{your_api_key}"
}

Request Body

TrườngBắt buộcKiểu dữ liệuMô tả
product_nameStringTên sản phẩm
product_codeStringMã sản phẩm (SKU)
unit_nameStringĐơn vị tính
category_nameStringDanh mục sản phẩm
origin_nameStringNguồn gốc sản phẩm
manufacturer_nameStringNhà sản xuất
short_descriptionKhôngStringMô tả ngắn
descriptionKhôngStringMô tả chi tiết
cover_priceFloatGiá niêm yết
price_wholesaleKhôngFloatGiá bán sỉ
discountKhôngFloatMức giảm giá (%)
discount_wholesaleKhôngFloatMức giảm giá bán sỉ (%)
price_onlineKhôngFloatGiá bán trực tuyến
discount_onlineKhôngFloatMức giảm giá trực tuyến (%)
price_average_inKhôngFloatGiá nhập trung bình
discount_inKhôngFloatMức giảm giá nhập vào (%)
saleoff_priceKhôngFloatGiá khuyến mãi
product_vatKhôngFloatThuế VAT (%)
barcodeKhôngStringMã vạch sản phẩm
weightKhôngFloatTrọng lượng
custom_fieldsKhôngObjectCác trường tùy chỉnh
variant_attribute_valuesKhôngArrayDanh sách thuộc tính biến thể

Ví dụ Request Body

{
"product_name": "Sản phẩm API Test",
"product_code": "SP.TEST.001",
"unit_name": "Hộp",
"category_name": "Thiết bị",
"origin_name": "Việt Nam",
"manufacturer_name": "Công ty ABC",
"short_description": "Sản phẩm dùng thử",
"description": "<p>Mô tả chi tiết sản phẩm</p>",
"cover_price": 20000,
"price_wholesale": 18000,
"discount": 10,
"discount_wholesale": 15,
"price_online": 19000,
"discount_online": 5,
"price_average_in": 15000,
"discount_in": 8,
"saleoff_price": 12,
"product_vat": 5,
"barcode": "BAR123456",
"weight": 500,
"custom_fields": {
"ngay_nhap": 1742317200,
"so_luong": 100,
"gia_ban": "20000"
},
"variant_attribute_values": [
{
"attribute_name": "Màu sắc",
"value_name": "Đỏ",
"additional_price": 2000
},
{
"attribute_name": "Kích thước",
"value_name": "Lớn",
"additional_price": 5000
}
]
}

2. Response Example & Description

Response Fields

TrườngKiểu dữ liệuMô tả
messageStringThông báo kết quả
dataObjectThông tin sản phẩm vừa tạo
product_idIntegerID sản phẩm mới
product_codeStringMã sản phẩm vừa tạo

Response Example (Success)

{
"message": "Thêm mới thành công",
"data": {
"product_id": 1001,
"product_code": "SP.TEST.001"
}
}