Cập nhật danh mục

Endpoint

PUT /v1/productcategories/:id

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
`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. 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
`error_parent_invalid`	Danh mục cha không hợp lệ (ví dụ: gán cha là chính nó)
`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