Quản lý mua hàngGiá mua nhà cung cấp
Tạo giá mua NCC
Tạo mới một bản ghi giá mua cho nhà cung cấp theo biến thể sản phẩm
Endpoint
POST /v1/purchasesupplierprices
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) |
Request Body
| 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 tạo |
supplier_id | int | Có | ID nhà cung cấp |
product_id | int | Không | ID sản phẩm |
product_variant_id | int | Có | ID biến thể sản phẩm |
source | int | Không | Nguồn tạo: 1 (Manual), 2 (Import), 3 (API). Mặc định: 1 |
source_name | string | Không | Tên nguồn (chỉ có ý nghĩa khi source = 2 hoặc 3) |
uom_id | int | Có | ID đơn vị tính (>= 0) |
buy_price | int | Có | Giá mua (>= 0, đơn vị nhỏ nhất VD: VND) |
currency | string | Không | Đơn vị tiền tệ. Mặc định: VND |
lead_time | int | Không | Thời gian giao hàng (ngày). Mặc định: 0 |
min_quantity | int | Không | Số lượng tối thiểu. Mặc định: 0 |
moq | int | Không | Minimum Order Quantity. Mặc định: 0 |
is_preferred | int | Không | NCC ưu tiên: 0 (Không), 1 (Có). Mặc định: 0 |
note | string | Không | Ghi chú |
status | int | Không | Trạng thái: 0 (Ngưng), 1 (Hoạt động). Mặc định: 1 |
date_last_imported | int | Không | Timestamp lần import cuối. Mặc định: 0 |
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ể (chỉ 1 NCC ưu tiên cho mỗi variant).
Ví dụ JSON
{
"company_id": 1,
"creator_id": 10,
"supplier_id": 36,
"product_id": 100,
"product_variant_id": 456,
"source": 1,
"uom_id": 0,
"buy_price": 120000,
"currency": "VND",
"lead_time": 7,
"min_quantity": 10,
"moq": 50,
"is_preferred": 1,
"note": "Giá mua hàng tuần",
"status": 1
}Response Schema
HTTP 201 - Created
Trả về Supplier Price Object vừa tạo.
Error Codes
Lỗi dữ liệu đầu vào trả về HTTP 422 kèm 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_permission_denied | Tài khoản thiếu quyền product.viewcost hoặc product.manage |
error_supplier_required | Chưa chọn nhà cung cấp |
error_supplier_invalid | Nhà cung cấp không hợp lệ hoặc không thuộc công ty |
error_product_variant_required | Chưa chọn biến thể sản phẩm |
error_product_variant_invalid | Biến thể sản phẩm không hợp lệ hoặc không thuộc công ty |
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_uom_id_required | Đơn vị tính 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 |