Lô / Hạn sử dụng

Danh sách lô hàng theo hạn sử dụng và kho.

Xem Markdown

Trả về danh sách lô (batch) kèm tồn, ngày sản xuất/hết hạn, phục vụ quản lý HSD.

Endpoint

MethodEndpointMô tả
GET/api/v1/shops/{shop_id}/lotsDanh sách lô hàng

Tham số

Tham sốVị tríKiểuBắt buộcMô tả
shop_idđường dẫnstringCóID cửa hàng
pagetruy vấnintegerKhôngSố thứ tự trang
page_sizetruy vấnintegerKhôngSố bản ghi mỗi trang (tối đa 100)
searchtruy vấnstringKhôngTìm theo mã lô
warehouse_idstruy vấnstring[]KhôngLọc theo kho

Kiểm thử tại chỗ

GEThttps://pos.hitechcloud.vn/api/v1/shops/{shop_id}/lots

Nhập tham số và API Key rồi bấm Gửi thử. Key không được lưu lại.

Tham số đường dẫn
Query
cURL mẫu
curl -X GET "https://pos.hitechcloud.vn/api/v1/shops/shop_0a1b2c3d/lots?page=1&page_size=20&search=LOT2026&warehouse_ids=wh_main" \
  -H "Authorization: Bearer YOUR_API_KEY"
Phản hồi mẫu
{
  "status": "success",
  "data": [
    {
      "id": "lot_1",
      "custom_id": "LOT2026-01",
      "expire_date": "2027-01-01",
      "remain_quantity": 120
    }
  ],
  "meta": {
    "pagination": {
      "total": 42,
      "page_size": 20,
      "page_number": 1,
      "total_pages": 3,
      "has_more": true
    }
  }
}