Tồn kho theo sản phẩm

Lấy tồn kho cộng gộp tất cả biến thể của danh sách sản phẩm, chia theo kho

Endpoint

GET /v1/inventorystocks/product

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. Mỗi item trả về có product_variant_id = 0, và các phần tử trong stocks chỉ gồm warehouse_id, onhand, allocated, available, incoming (không có các trường date_last_*).

Query Parameters

Tên	Kiểu	Bắt buộc	Mô tả
`ids`	string	Có	Danh sách ID sản phẩm, phân cách bằng dấu phẩy. Tối đa 100 IDs, các ID vượt quá sẽ bị bỏ qua. (VD: `456,457`)

Response Schema

HTTP 200 - JSON Object

Trường	Kiểu	Mô tả
`total`	int	Số sản phẩm trả về
`limit`	int	Số ID hợp lệ đã gửi lên (tối đa 100)
`currentpage`	int	Trang hiện tại (luôn = 1)
`items`	array	Mảng InventoryStock Object theo sản phẩm

Ví dụ Response

{
  "total": 1,
  "limit": 1,
  "currentpage": 1,
  "items": [
    {
      "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`
500	`error_inventory_search_failed`	Lỗi truy vấn dữ liệu tồn kho (VD: dữ liệu tồn kho của công ty chưa được khởi tạo)

Tồn kho theo sản phẩm

EndpointCopy Anchor Link

Query ParametersCopy Anchor Link

Response SchemaCopy Anchor Link

HTTP 200 - JSON ObjectCopy Anchor Link

Ví dụ ResponseCopy Anchor Link