WMS - InventoryPhiếu nhập/xuất kho
Cập nhật phiếu nhập/xuất
Cập nhật thông tin của một phiếu nhập/xuất kho
Endpoint
PUT /v1/productreceipts/:id
Quyền: Cần ít nhất 1 trong các quyền:
inventory.statusapprove,inventory.statuscheck,inventory.statuscomplete(scoped theo warehouse của phiếu).
Path Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
id | int | Có | ID của phiếu cần cập nhật |
Request Payload
JSON Object Payload:
{
"company_id": 1,
"creator_id": 101,
"quantity": 100,
"count_detail": 5,
"note": "Cập nhật ghi chú",
"tag": "update",
"file_id_list": [],
"status": 3,
"details": [
{
"id": 567,
"product_variant_id": 201,
"uom_quantity": 20,
"item_quantity": 20,
"uom_factor": 1
},
{
"id": 0,
"product_variant_id": 202,
"uom_id": 1,
"uom_name": "Cái",
"uom_factor": 1,
"uom_quantity": 5,
"item_quantity": 5
}
]
}Lưu ý: Khi phiếu ở trạng thái Hoàn thành (
status = 9) hoặc Huỷ (status = 11), không được thêm mới hoặc xóa dòng chi tiết — chỉ cập nhật số lượng. Trạng thái không được quay ngược (VD: từ 5 về 3). Không dùng API này để hủy phiếu — dùng API Cancel.
Response Schema
HTTP 200 - JSON Object
Xem ProductReceipt Object Schema
Error Codes
| HTTP | Code | Mô tả |
|---|---|---|
| 404 | (not found) | Không tìm thấy phiếu |
| 422 | error_company_id_required | ID công ty không được để trống |
| 422 | error_creator_id_required | ID người tạo không được để trống |
| 422 | error_not_permission | Không có quyền chỉnh sửa phiếu |
| 422 | error_status_invalid | Trạng thái không hợp lệ |
| 422 | error_status_backward_not_allow | Không được phép quay lại trạng thái trước đó |
| 422 | error_status_complete_not_allow | Không có quyền hoàn thành phiếu |
| 422 | error_this_api_not_allow_cancel | API này không cho phép hủy phiếu (Dùng API Cancel) |
| 422 | error_detail_required | Chi tiết phiếu là bắt buộc |
| 422 | error_detail_change_not_allow | Không được phép thêm/xóa chi tiết (khi phiếu ở trạng thái Hoàn thành hoặc Huỷ) |
| 422 | error_detail_item_required_imei | Sản phẩm yêu cầu IMEI nhưng thiếu số Serial |
| 422 | error_item_quantity_required | Số lượng sản phẩm không hợp lệ |
| 422 | error_product_variant_id_is_required | ID biến thể sản phẩm là bắt buộc |
| 422 | error_product_variant_id_invalid | ID biến thể sản phẩm không hợp lệ |
| 422 | error_product_not_found | Sản phẩm không tồn tại |
| 422 | error_edit | Lỗi khi cập nhật phiếu |