Dùng endpoint này để thay đổi sản phẩm, ví dụ cập nhật giá hoặc tồn kho sau khi cửa hàng của bạn thay đổi.
Luôn liệt kê các trường cần thay đổi
Thêm x-fields vào query string với danh sách các trường bạn gửi, phân tách bằng dấu phẩy:
POST https://api.subiz.com.vn/4.0/accounts/YOUR_ACCID/products/YOUR_PID?x-fields=price,stock
Chỉ các trường được liệt kê mới thay đổi.
Nếu không có x-fields, body sẽ thay thế toàn bộ sản phẩm. Mọi trường bạn bỏ trống sẽ bị xóa, kể cả ảnh và mô tả. Nếu buộc phải gửi sản phẩm đầy đủ, hãy đọc sản phẩm trước rồi gửi lại kèm thay đổi.
Luôn gửi name
Mọi body yêu cầu phải có name không rỗng, kể cả khi bạn không đổi tên. Thiếu name, yêu cầu sẽ thất bại. Nếu name không có trong x-fields, tên bạn gửi chỉ được kiểm tra chứ không được lưu.
Body yêu cầu
Gửi name và giá trị mới của các trường đã liệt kê trong x-fields:
{
"name": "Ceramic mug",
"price": 99000,
"stock": 40
}
Các thay đổi thường gặp:
| Trường | Ghi chú |
|---|---|
price, market_price |
Giá. |
stock |
Số lượng tồn kho. |
availability |
in_stock, out_of_stock, online_only, pre_order, pre_sale hoặc sold_out. Được kiểm tra kể cả khi không có trong x-fields. |
visibility |
published hoặc hidden. |
images |
Thay thế mọi ảnh. Subiz lưu bản sao riêng. Xem Hình ảnh. |
props |
Thay thế mọi thuộc tính. |
Subiz đặt updated và updated_by. Subiz giữ nguyên created và created_by. Giá trị bạn gửi cho các trường này bị bỏ qua.
Thay đổi lan sang biến thể
Một số trường dùng chung cho mọi biến thể trong nhóm. Khi bạn đổi name, description, url, handle, category, brand, note, condition, visibility, images, videos hoặc options, Subiz áp dụng thay đổi cho mọi sản phẩm khác có cùng product_group_id. Xem Biến thể.
Dùng ID sản phẩm đã có
Nếu không có sản phẩm nào mang ID trong đường dẫn, Subiz không trả lỗi không tìm thấy. Subiz tìm sản phẩm theo source_id (hoặc theo sku nếu không có source_id) trong body và cập nhật sản phẩm đó. Nếu không khớp sản phẩm nào, Subiz tạo một sản phẩm mới với ID mới.
Kiểm tra id trong phản hồi. Để chắc chắn sản phẩm tồn tại, hãy đọc sản phẩm trước.
Phản hồi
Yêu cầu thành công trả HTTP 200 cùng toàn bộ sản phẩm đã cập nhật. Một số trường:
{
"id": "product_example",
"name": "Ceramic mug",
"sku": "MUG-01",
"price": 99000,
"stock": 40,
"availability": "in_stock",
"updated": 1763193600000
}
Lỗi
| Vấn đề | Kết quả |
|---|---|
Thiếu hoặc rỗng name |
Lỗi dữ liệu không hợp lệ nêu tên name. |
category dài hơn 255 byte |
Lỗi dữ liệu không hợp lệ nêu tên category. |
availability, visibility hoặc condition có giá trị khác |
Lỗi trường không hợp lệ nêu tên trường. |
| Không tải được URL ảnh | Yêu cầu thất bại. |
| Thiếu quyền cập nhật sản phẩm | Lỗi phân quyền. |
Xem Xử lý lỗi.
Yêu cầu HTTP
Thay YOUR_ACCID, YOUR_PID và YOUR_ACCESS_TOKEN bằng giá trị của bạn.
POST https://api.subiz.com.vn/4.0/accounts/YOUR_ACCID/products/YOUR_PID?x-fields=price,stock
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json
{
"name": "Ceramic mug",
"price": 99000,
"stock": 40
}