Chuyển tới nội dung chính

Danh sách kho

1. Thông tin API

  • Endpoint: /api/v6/warehouses
  • Method: GET
  • Authentication: X-API-KEY
  • Mô tả: Danh sách kho hoạt động (valid = 1). Tham số chung: Thông tin cần thiết và domain Warehouse.

2. Tham số Request

2.1. Filtering

TrườngHỗ trợKiểuMô tả
ideq, inintegerID kho
validis, inintegerHiệu lực
storekeepereq, inintegerThủ kho
inventory_in_request_usereqintegerUser yêu cầu nhập
inventory_out_request_usereqintegerUser yêu cầu xuất
inventory_request_usereqintegerUser yêu cầu kho
product_ideqintegerSP (domain)
product_nameeq, containsstringTên SP
product_codeeq, containsstringMã SP
product_category_ideq, inintegerDanh mục SP
(các product_* + custom field SP)Theo domain
  • searchstore_name, store_code.

2.3. Sorting

TrườngHướng
idasc, desc

2.4. Fields (Public API v6)

Whitelist tối thiểu: id, store_name, total_quantity (CSV). Mặc định không gửi fields → chỉ id.

2.5. Pagination

limit, offset.


3. Response mẫu

{
"data": [
{
"id": 1,
"store_name": "Kho chính",
"total_quantity": 15240.5
}
],
"has_more": false,
"offset": 0,
"limited": 50,
"sorted": { "id": "DESC" }
}

4. Ghi chú

  • Chi tiết một kho v6.0: Chi tiết khoGET /api/v6/warehouses/{id}.
  • v6.1 hỗ trợ warehouse_id / warehouse_code trên một endpoint warehouse: Chi tiết kho v6.1.

Ví dụ curl

curl -g --location 'https://example.getflycrm.com/api/v6/warehouses?fields=id,store_name,total_quantity&limit=50' \
--header 'X-API-KEY: <your_api_key>'