Quản lý nhóm sản phẩmSản phẩm
Cập nhật một phần sản phẩm
Cập nhật một số trường của sản phẩm mà không cần gửi toàn bộ dữ liệu
Endpoint
PATCH /v1/products/: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 (xem bảng bên dưới).
Path Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
id | int | Có | ID sản phẩm |
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:
| Trường | Kiểu | Mô tả |
|---|---|---|
visibility | int | Trạng thái hiển thị |
status | int | Trạng thái sản phẩm |
supplier_id | array | Danh sách ID nhà cung cấp |
pricing_type | int | Loại định giá |
allow_preorder | int | 1: Cho phép đặt hàng trước |
session_required | int | 1: Sản phẩm yêu cầu phiên (session) khi bán |
need_customize | int | 1: Cần tùy biến trước khi bán |
mockup_supported | int | 1: Hỗ trợ mockup |
3dconfig_supported | int | 1: Hỗ trợ cấu hình 3D (cập nhật trường config3d_supported của sản phẩm) |
material_type | int | Loại vật liệu |
length | int | Chiều dài (mm) |
width | int | Chiều rộng (mm) |
height | int | Chiều cao (mm) |
packing_priority | int | Độ ưu tiên đóng gói |
default_warehouse_location_id | int | ID vị trí kho mặc định |
lead_time | int | Thời gian chuẩn bị hàng (ngày) |
expiry_tracked | int | 1: Theo dõi hạn sử dụng |
attribute_detail | array | Thông tin thuộc tính chi tiết |
Nhóm trường cần quyền product.managecontent:
| Trường | Kiểu | Mô tả |
|---|---|---|
info_promotion | string | Thông tin khuyến mãi |
info_promotion_note | string | Ghi chú khuyến mãi |
country_of_origin | string | Xuất xứ |
badge | string | Nhãn hiển thị |
page_id | int | ID trang nội dung liên kết |
Lưu ý
Trong PATCH, cờ cấu hình 3D được gửi với tên
3dconfig_supported (khác với tên config3d_supported trong Product Object).Ví dụ JSON
{
"company_id": 1,
"creator_id": 10,
"status": 3,
"visibility": 1,
"badge": "Hot"
}Response Schema
HTTP 200 - OK
Trả về Product Object sau khi cập nhật.
Error Codes
Lỗi trả về dạng mảng trong trường error:
| 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 | Sản phẩm 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 |