Lô hạn sử dụng

Endpoint

GET/shops/{SHOP_ID}/lotsDanh sách lô hạn sử dụng

Danh sách lô hạn sử dụng

GET/shops/{SHOP_ID}/lots

Lấy danh sách lô hạn sử dụng của sản phẩm (sản phẩm có loại LOT). Mỗi lô có mã lô (custom_id), ngày sản xuất, hạn sử dụng và được gắn với một hoặc nhiều mẫu mã của sản phẩm qua lot_variations.

Các giá trị thời gian (expire_date, manufacturing_date, ...) theo múi giờ UTC.

Tham số đường dẫn

SHOP_IDintegerbắt buộc

Mã shop

Ví dụ: 20

Tham số truy vấn

pageinteger

Số trang

Mặc định: 1 · Ví dụ: 1

page_sizeinteger

Kích thước trang

Mặc định: 30 · Ví dụ: 30

searchstring

Tìm theo mã lô, mã sản phẩm/ID hiển thị sản phẩm hoặc mã mẫu mã/ID hiển thị mẫu mã

Ví dụ: "LO-XA"

warehouse_ids[]array<string>

Lọc các lô có bản ghi tồn tại các kho này (lô chưa có bản ghi tồn ở kho nào vẫn được trả về)

remain_quantitystring

Lọc theo số lượng có thể bán của lô, JSON gồm:

type: greaterOrEqual | smallerOrEqual | between
value: số lượng (dùng với greaterOrEqual / smallerOrEqual)
minValue, maxValue: khoảng số lượng (dùng với between)
warehouseId: mã kho, all cho tất cả kho
isFilterTotal: true để so sánh tổng các kho, ngược lại so sánh từng bản ghi tồn theo kho

Ví dụ: "{\"type\":\"greaterOrEqual\",\"value\":1,\"warehouseId\":\"all\",\"isFilterTotal\":true}"

actual_remain_quantitystring

Lọc theo tồn kho (số lượng thực tế trong kho) của lô, JSON cùng định dạng với remain_quantity

Ví dụ: "{\"type\":\"between\",\"minValue\":1,\"maxValue\":100,\"warehouseId\":\"all\",\"isFilterTotal\":true}"

min_retail_priceinteger

Lọc các lô có mẫu mã được gắn với giá bán lớn hơn hoặc bằng giá trị này

Ví dụ: 100000

max_retail_priceinteger

Lọc các lô có mẫu mã được gắn với giá bán nhỏ hơn hoặc bằng giá trị này

Ví dụ: 500000

expiry_datestring

Lọc theo hạn sử dụng, chỉ trả về các lô còn số lượng có thể bán (remain_quantity > 0) ở ít nhất một kho:

in_date: còn hạn
out_of_date: hết hạn
JSON {"start_date": <unix>, "end_date": <unix>}: hạn sử dụng nằm trong khoảng (unix timestamp tính bằng giây)

Ví dụ: "in_date"

rangestring

Lọc theo khoảng thời gian, JSON {"key": ..., "since": <unix>, "until": <unix>} (unix timestamp tính bằng giây, until mặc định là hiện tại). key:

inserted_at: theo thời gian tạo (mặc định)
manufacturing: theo ngày sản xuất
expire: theo hạn sử dụng

Ví dụ: "{\"key\":\"expire\",\"since\":1759276800,\"until\":1767225599}"

sort_fieldstring

Sắp xếp, JSON {"field": ..., "order": "ascend" | "descend"}. field: mfg (ngày sản xuất), exp (hạn sử dụng), inserted_at (thời gian tạo), updated_at (thời gian cập nhật). Mặc định: hạn sử dụng giảm dần, sau đó thời gian tạo giảm dần

Ví dụ: "{\"field\":\"exp\",\"order\":\"ascend\"}"

Phản hồi

object

dataarray<LotProduct>

Danh sách lô hạn sử dụng

page_numberinteger

Số trang

page_sizeinteger

Kích thước trang

successboolean

Trạng thái thành công

total_entriesinteger

Tổng số bản ghi

total_pagesinteger

Tổng số trang

Yêu cầu

curl "https://pos.pages.fm/api/v1/shops/{SHOP_ID}/lots?api_key=API_KEY"

Phản hồi 200

{
  "success": true,
  "data": [
    {
      "id": "d0e4a4b0-0c6d-4dc1-8252-447bba021b3e",
      "custom_id": "LO-XA",
      "expire_date": "2027-10-11T17:00:00",
      "manufacturing_date": "2026-10-11T17:00:00",
      "inserted_at": "2026-10-12T07:35:10.000000",
      "updated_at": "2026-10-12T07:35:10.000000",
      "product": {
        "id": "da9b9e28-af65-4456-916e-ac8f8eb00334",
        "name": "TEST6972#2",
        "type": "LOT",
        "image": null,
        "tags": [],
        "custom_id": "SP-L",
        "display_id": 13721,
        "bonus_products": [],
        "brand_id": null,
        "creator_id": "84616be7-7a6b-4f58-af37-2c64d9ee04a9",
        "inserted_at": "2026-10-12T07:29:45",
        "is_published": true,
        "is_sell_negative": null,
        "limit_quantity_to_warn": 0,
        "limit_quantity_to_warn_by_warehouse": null,
        "manipulation_warehouses": [],
        "materials": [],
        "measure_group_id": null,
        "note": null,
        "note_product": "",
        "product_attributes": [],
        "supplier_product_ids": [],
        "warning_by_variation": false,
        "categories": []
      },
      "lot_variations": [
        {
          "id": "a560ac18-8d5b-46ef-82f6-bf1474ad1c8f",
          "variation_id": "daf62728-ae6f-4354-94e4-4a12855c4293",
          "inserted_at": "2026-10-12T07:35:10.000000",
          "updated_at": "2026-10-12T07:35:10.000000"
        }
      ]
    }
  ],
  "page_number": 1,
  "page_size": 30,
  "total_entries": 1,
  "total_pages": 1
}

Lô hạn sử dụng

#Danh sách lô hạn sử dụng

Tham số đường dẫn

Tham số truy vấn

Phản hồi

Danh sách lô hạn sử dụng