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.manage hoặc product.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ênKiểuBắt buộcMô tả
idintCó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ườngKiểuBắt buộcMô tả
company_idintCóID công ty
creator_idintCóID người thao tác

Nhóm trường cần quyền product.manage:

TrườngKiểuMô tả
visibilityintTrạng thái hiển thị
statusintTrạng thái sản phẩm
supplier_idarrayDanh sách ID nhà cung cấp
pricing_typeintLoại định giá
allow_preorderint1: Cho phép đặt hàng trước
session_requiredint1: Sản phẩm yêu cầu phiên (session) khi bán
need_customizeint1: Cần tùy biến trước khi bán
mockup_supportedint1: Hỗ trợ mockup
3dconfig_supportedint1: Hỗ trợ cấu hình 3D (cập nhật trường config3d_supported của sản phẩm)
material_typeintLoại vật liệu
lengthintChiều dài (mm)
widthintChiều rộng (mm)
heightintChiều cao (mm)
packing_priorityintĐộ ưu tiên đóng gói
default_warehouse_location_idintID vị trí kho mặc định
lead_timeintThời gian chuẩn bị hàng (ngày)
expiry_trackedint1: Theo dõi hạn sử dụng
attribute_detailarrayThông tin thuộc tính chi tiết

Nhóm trường cần quyền product.managecontent:

TrườngKiểuMô tả
info_promotionstringThông tin khuyến mãi
info_promotion_notestringGhi chú khuyến mãi
country_of_originstringXuất xứ
badgestringNhãn hiển thị
page_idintID 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ỗiHTTPMô tả
error_patch_list_empty422Không có trường hợp lệ nào để cập nhật
error_product_permission_not_found422Không có quyền product.manage hoặc product.managecontent
error_company_id_required422ID công ty không được để trống
error_company_id_notfound422ID công ty không tìm thấy
error_user1_id_required422ID người thao tác không được để trống
error_user_id_notfound422ID người thao tác không tìm thấy
error_not_found404Sản phẩm không tồn tại hoặc không thuộc công ty của bạn
error_patch500Lỗi hệ thống khi lưu dữ liệu

On this page