WMS - InventoryTồn kho
Tồn kho của một sản phẩm
Lấy tồn kho cộng gộp tất cả biến thể của một sản phẩm, chia theo kho
Endpoint
GET /v1/inventorystocks/product/:id
Quyền:
inventory.number
Lưu ý: Kết quả trả về được lọc theo warehouse scope của người dùng. Dòng tổng hợp (
warehouse_id = 0) chỉ có khi người dùng được xem toàn bộ kho.
Số lượng của mỗi kho là tổng số lượng của tất cả biến thể thuộc sản phẩm. Kết quả có product_variant_id = 0, các phần tử trong stocks chỉ gồm warehouse_id, onhand, allocated, available, incoming.
Path Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
id | int | Có | ID sản phẩm |
Response Schema
HTTP 200 - JSON Object
Xem InventoryStock Object Schema (dạng gộp theo sản phẩm như mô tả ở trên).
{
"product_variant_id": 0,
"product_id": 456,
"stocks": [
{ "warehouse_id": 0, "onhand": 150, "allocated": 15, "available": 135, "incoming": 30 },
{ "warehouse_id": 1, "onhand": 100, "allocated": 10, "available": 90, "incoming": 20 }
]
}Error Codes
| HTTP | Code | Mô tả |
|---|---|---|
| 403 | error_role_not_available | Người dùng không có quyền inventory.number |
| 404 | error_product_id_not_found | Sản phẩm không tồn tại hoặc không thuộc công ty |
| 500 | error_inventory_search_failed | Lỗi truy vấn dữ liệu tồn kho |