Quản lý nhóm sản phẩmBiến thể sản phẩm
Cập nhật một phần biến thể
Cập nhật một số trường của biến thể sản phẩm
Endpoint
PATCH /v1/productvariants/:id
Quyền:
product.managehoặcproduct.managecontent. Mỗi nhóm trường chỉ được cập nhật khi có quyền tương ứng.
Path Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
id | int | Có | ID biến thể |
Request Body
Chỉ gửi các trường cần thay đổi (cùng với company_id, creator_id). Các trường không gửi lên sẽ giữ nguyên.
| 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 thao tác |
Nhóm trường cần quyền product.manage: sku, barcode, display_name, note, compare_price, min_stock, is_serial_tracked, length, width, height, weight, external_id, price, status (ý nghĩa xem ProductVariant Object).
Nhóm trường cần quyền product.managecontent: photo_gallery_file_id_list, option_values.
Lưu ý
PATCH không kiểm tra trùng SKU, trạng thái hợp lệ hay tồn kho như API Cập nhật biến thể; hãy đảm bảo dữ liệu gửi lên hợp lệ.
Ví dụ JSON
{
"company_id": 1,
"creator_id": 10,
"price": 245000,
"compare_price": 290000
}Response Schema
HTTP 200 - OK
Trả về ProductVariant Object sau khi cập nhật (bao gồm price_by_policy).
Error Codes
| Mã lỗi | HTTP | Mô tả |
|---|---|---|
error_patch_list_empty | 422 | Không có trường hợp lệ nào để cập nhật |
error_product_permission_not_found | 422 | Không có quyền product.manage hoặc product.managecontent |
error_company_id_required | 422 | ID công ty không được để trống |
error_company_id_notfound | 422 | ID công ty không tìm thấy |
error_user1_id_required | 422 | ID người thao tác không được để trống |
error_user_id_notfound | 422 | ID người thao tác không tìm thấy |
error_not_found | 404 | Biến thể không tồn tại hoặc không thuộc công ty của bạn |
error_patch | 500 | Lỗi hệ thống khi lưu dữ liệu |