Tạo biến thể

Endpoint

POST /v1/productvariants

Quyền: product.manage hoặc product.managecontent

Request Body

Trường	Kiểu	Bắt buộc	Mô tả
`company_id`	int	Có	ID công ty
`creator_id`	int	Có	ID người tạo
`product_id`	int	Có	ID sản phẩm cha
`sku`	string	Không	Mã SKU (duy nhất trong công ty, sẽ bị trim khoảng trắng)
`price`	int	Có	Giá bán
`status`	int	Có	Trạng thái (3: Active, 5: Archived)
`uuid`	string	Không	UUID biến thể
`option_values`	array	Không	Danh sách giá trị tùy chọn định danh biến thể
`barcode`	string	Không	Mã barcode
`display_name`	string	Không	Tên hiển thị riêng
`note`	string	Không	Ghi chú nội bộ
`compare_price`	int	Không	Giá so sánh (giá gốc)
`min_stock`	int	Không	Tồn kho tối thiểu
`is_serial_tracked`	int	Không	1: Theo dõi serial/IMEI
`is_bom_kit`	int	Không	1: Là BOM Kit (chỉ set khi tạo)
`length`	int	Không	Chiều dài (mm)
`width`	int	Không	Chiều rộng (mm)
`height`	int	Không	Chiều cao (mm)
`weight`	int	Không	Trọng lượng (gram)
`external_id`	string	Không	ID tham chiếu ngoài
`price_by_uom`	array	Không	Giá theo đơn vị tính
`photo_gallery_file_id_list`	array	Không	Danh sách ID ảnh gallery
`combo_data`	array	Không	Dữ liệu combo (nếu sản phẩm combo)
`bom`	array	Không	Bill of Materials
`display_order`	int	Không	Thứ tự hiển thị

Ví dụ JSON

{
    "company_id": 1,
    "creator_id": 10,
    "product_id": 123,
    "sku": "POLO-RED-M",
    "price": 250000,
    "status": 3,
    "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "option_values": [
        {
            "option_id": 10,
            "option_value_name": "Do"
        },
        {
            "option_id": 11,
            "option_value_name": "M"
        }
    ],
    "barcode": "8938502234534",
    "display_name": "",
    "note": "",
    "compare_price": 0,
    "min_stock": 0,
    "is_serial_tracked": 0,
    "is_bom_kit": 0,
    "length": 0,
    "width": 0,
    "height": 0,
    "weight": 0,
    "external_id": "",
    "price_by_uom": [],
    "photo_gallery_file_id_list": [],
    "combo_data": [],
    "bom": [],
    "display_order": 1001
}

Response Schema

HTTP 201 - Created

Trả về ProductVariant Object vừa tạo.

Error Codes

Lỗi dữ liệu đầu vào. Trả về mảng các mã lỗi:

Mã lỗi	Mô tả
`error_product_require`	ID sản phẩm không được để trống
`error_product_not_found`	Sản phẩm không tìm thấy
`error_sku_exist`	Mã SKU đã tồn tại
`error_status_not_exist`	Trạng thái không tồn tại
`error_product_permission_not_found`	Quyền hạn không đủ (cần `product.manage` hoặc `product.managecontent`)
`error_company_id_required`	ID công ty không được để trống
`error_company_id_notfound`	ID công ty không tìm thấy
`error_user1_id_required`	ID người tạo không được để trống
`error_user_id_notfound`	ID người tạo không tìm thấy

Tạo biến thể

Endpoint

Request Body

Ví dụ JSON

Response Schema

HTTP 201 - Created

Error Codes

On this page