Quản lý nhóm sản phẩmDanh mục sản phẩm
Cập nhật danh mục
Cập nhật thông tin một danh mục sản phẩm
Endpoint
PUT /v1/productcategories/:id
Quyền:
product.managecategory
Path Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
id | int | Có | ID danh mục |
Request Body
Gửi tất cả các trường (tương tự API Tạo mới). API sử dụng chung logic gán dữ liệu.
| 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 (không được là chính nó) |
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 (phải thuộc cùng công ty) |
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 cao cấp",
"parent_id": 100,
"name_short": "ASMN",
"description": "<p>Mô tả danh mục áo sơ mi nam cao cấp</p>",
"display_order": 2.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-cao-cap",
"seo_title": "Áo Sơ Mi Nam Cao Cấp - 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 200 - OK
Trả về ProductCategory Object sau khi cập nhật.
Error Codes
Lỗi dữ liệu đầu vào (HTTP 422). Trả về mảng các mã lỗi trong trường error:
| 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_parent_invalid | Danh mục cha không hợp lệ (ví dụ: gán cha là chính nó) |
error_attribute_category_not_found | Bộ thuộc tính không tồn tại 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 |
error_not_found | Danh mục không tồn tại hoặc không thuộc công ty của bạn (HTTP 404) |
error_role_not_available | Không có quyền product.managecategory (HTTP 403) |
error_edit | Lỗi hệ thống khi lưu dữ liệu (HTTP 500) |