Quản lý mua hàngGiá mua nhà cung cấp
Cập nhật giá mua NCC
Cập nhật thông tin giá mua nhà cung cấp
Endpoint
PUT /v1/purchasesupplierprices/:id
Quyền:
product.viewcost+product.manage
Headers
| Tên | Bắt buộc | Mô tả |
|---|---|---|
Authorization | Có | <JWT> của người dùng có quyền xem giá vốn (product.viewcost) và quản lý sản phẩm (product.manage) |
Path Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
id | int | Có | ID bản ghi giá mua cần cập nhật |
Request Body
Chỉ cần gửi các trường muốn cập nhật (partial update).
| 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 (người dùng của phiên đăng nhập) |
supplier_id | int | Không | ID nhà cung cấp (thay đổi NCC; bị bỏ qua nếu NCC không thuộc công ty) |
source | int | Không | Nguồn tạo: 1 (Manual), 2 (Import), 3 (API) |
source_name | string | Không | Tên nguồn |
uom_id | int | Không | ID đơn vị tính |
buy_price | int | Không | Giá mua (>= 0) |
currency | string | Không | Đơn vị tiền tệ |
lead_time | int | Không | Thời gian giao hàng (ngày) |
min_quantity | int | Không | Số lượng tối thiểu |
moq | int | Không | Minimum Order Quantity |
is_preferred | int | Không | NCC ưu tiên: 0 (Không), 1 (Có) |
last_modifier | int | Không | ID người sửa |
note | string | Không | Ghi chú |
status | int | Không | Trạng thái: 0 (Ngưng), 1 (Hoạt động) |
date_last_imported | int | Không | Timestamp lần import cuối |
Lưu ý: Khi set
is_preferred = 1, hệ thống sẽ tự động unset preferred cho tất cả record giá mua khác của cùng biến thể.
Ví dụ JSON
{
"company_id": 1,
"creator_id": 10,
"buy_price": 135000,
"lead_time": 5,
"is_preferred": 1,
"note": "Giá đã thương lượng lại"
}Response Schema
HTTP 200 - OK
Trả về Supplier Price 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_role_not_available | (HTTP 403) Tài khoản không có quyền product.viewcost |
error_not_found | (HTTP 404) Đối tượng không tồn tại hoặc không thuộc quyền truy cập của bạn |
error_permission_denied | Tài khoản thiếu quyền product.viewcost hoặc product.manage |
error_source_invalid | Nguồn tạo không hợp lệ |
error_status_invalid | Trạng thái không hợp lệ |
error_buy_price_invalid | Giá mua không hợp lệ (phải >= 0) |
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 |
error_edit | (HTTP 500) Lỗi khi lưu dữ liệu |