Quản lý nhóm sản phẩmDanh mục sản phẩm
Tạo danh mục
Tạo mới một danh mục sản phẩm
Endpoint
POST /v1/productcategories
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 |
name | string | Có | Tên danh mục (duy nhất trong cùng cấp cha) |
parent_id | int | Không | ID danh mục cha (Mặc định: 0) |
name_short | string | Không | Tên viết tắt |
description | string | Không | Mô tả HTML |
display_order | float | Không | Thứ tự hiển thị |
external_id | string | Không | ID tham chiếu ngoài |
prepayment_percentage | float | Không | Tỷ lệ trả trước |
tax_ratio | float | Không | Thuế suất |
attribute_category_id | int | Không | ID bộ thuộc tính |
avatar_file_id_list | array | Không | Danh sách ID ảnh đại diện |
status | int | Có | 1 (Active), 3 (Disabled) |
keyword_important_score | float | Không | Điểm từ khóa |
seo_url | string | Không | URL SEO (tự sinh từ name nếu trống) |
seo_title | string | Không | Title SEO |
seo_meta_description | string | Không | Meta Description |
seo_meta_keyword | string | Không | Meta Keyword |
seo_graph_file_id | int | Không | Ảnh SEO Graph |
seo_canonical | string | Không | Canonical URL |
seo_options | object | Không | Các tùy chọn SEO JSON |
Ví dụ JSON
{
"company_id": 1,
"creator_id": 10,
"name": "Áo sơ mi nam",
"parent_id": 100,
"name_short": "ASMN",
"description": "<p>Mô tả danh mục áo sơ mi nam</p>",
"display_order": 1.0,
"external_id": "CAT-001",
"prepayment_percentage": 0,
"tax_ratio": 10.0,
"attribute_category_id": 5,
"avatar_file_id_list": [101, 102],
"status": 1,
"keyword_important_score": 0,
"seo_url": "ao-so-mi-nam",
"seo_title": "Áo Sơ Mi Nam - Thời Trang Nam",
"seo_meta_description": "Bộ sưu tập áo sơ mi nam cao cấp",
"seo_meta_keyword": "áo sơ mi, thời trang nam",
"seo_graph_file_id": 200,
"seo_canonical": "",
"seo_options": {}
}Response Schema
HTTP 201 - Created
Trả về ProductCategory 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_name_require | Tên danh mục không được để trống |
error_name_existed | Tên danh mục đã tồn tại |
error_parent_not_found | Danh mục cha không tìm thấy hoặc thuộc công ty khác |
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 |