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

Admin Products API

Tài liệu chi tiết về API quản lý sản phẩm dành cho Admin (Merchant). Hệ thống hỗ trợ CRUD sản phẩm, thiết lập giá bán và các tính năng import bất đồng bộ qua Excel.


HTTP Endpoints

Phương thứcĐường dẫnMô tả
POST/product/create_productTạo mới sản phẩm
GET/product/get_productLấy danh sách sản phẩm
PUT/product/update_productCập nhật thông tin sản phẩm
DELETE/product/delete_productXóa sản phẩm
POST/product/import_productImport danh sách sản phẩm từ file Excel
GET/product/check_importKiểm tra trạng thái tiến trình import

Schema Reference

Product Object Schema

Dưới đây là chi tiết các thuộc tính chính trong đối tượng Product:

Thuộc tínhKiểu dữ liệuYêu cầuMô tả
namestringBắt buộcTên sản phẩm.
product_codestringTùy chọnMã SKU/mã sản phẩm định danh.
pricenumberBắt buộcGiá bán lẻ của sản phẩm.
costnumberTùy chọnGiá vốn nhập hàng.
category_idstringTùy chọnID danh mục của sản phẩm.
descriptionstringTùy chọnMô tả chi tiết sản phẩm.
imagesarrayTùy chọnDanh sách hình ảnh của sản phẩm.

API Methods

Tạo sản phẩm

POST /product/create_product
Token-Business: <business_access_token>
Content-Type: application/json

Request Body Example

{
"name": "Áo thun Polo Nam",
"product_code": "AT-POLO-01",
"price": 250000,
"cost": 120000,
"category_id": "cat_1294812",
"description": "Chất liệu cotton thoáng mát, thấm hút mồ hôi tốt."
}