库存日志查询

POST /api/v1/stock/history/queries

请求头为 Authorization: Bearer <token> 和 Content-Type: application/json。
查询当前账号权限范围内的库存变化日志。每行是一条库存变化记录，不合并相同 SKU/单号的记录。

操作类型枚举

值	含义
IN_ORDER	入库
OUT_ORDER	出库
RETURN	退货上架
CHECK	盘点
IMPORT	库存导入
INVENTORY_ADJUST	手动调整

请求 operationType 使用上述枚举，可省略。
响应 operationType 为字符串，可为 null；客户端应兼容后续新增的操作类型。

请求参数与上海时间

所有参数位于可选 JSON 请求体，省略与 {} 等价；各条件按 AND 组合。

参数	说明
warehouseCode	仓库编码，精确匹配；受调用方权限限制
sku / gsku	编码数组，精确匹配；同时提供取交集
inboundNo / orderNo	入库批次 / 业务单号，精确匹配
operationType	上述六种操作类型之一
operatorTimeStart / operatorTimeEnd	操作时间起止，均含边界
putawayDateStart / putawayDateEnd	上架时间起止，均含边界
page	默认1，必须大于等于1
pageSize	默认100，必须在1–1000之间，不提供全量模式

四个业务时间入参以及响应 operatorTime/putawayDate 均使用 yyyy-MM-dd HH:mm:ss，时区为 Asia/Shanghai。
例如 2026-10-26 09:00:00 对应 UTC 2026-10-26T01:00:00Z。
只填日期、ISO带Z格式、空字符串、非法日期或起点晚于终点均返回400。
公共响应 timestamp 保持标准 ISO 时间格式，使用上海偏移 +08:00。

{
  "warehouseCode": "WH001",
  "sku": ["SKU001"],
  "operationType": "IN_ORDER",
  "operatorTimeStart": "2026-10-01 00:00:00",
  "operatorTimeEnd": "2026-10-26 23:59:59",
  "page": 1,
  "pageSize": 100
}

返回与分页

按操作时间、日志ID倒序。超出末页返回空数组，保留匹配总数和请求页码。
返回库存与待出库数量的变更前后值，缺失值可为 null。
ID 使用字符串返回，避免上游 JavaScript 丢失长整数精度。

{
  "success": true,
  "code": "200",
  "message": "查询成功",
  "timestamp": "2026-10-26T10:00:00+08:00",
  "data": [{
    "id": "2026102601000000001",
    "warehouseCode": "WH001",
    "sku": "SKU001",
    "gsku": "GSKU001",
    "customSkuCode": "REF001",
    "inboundNo": "IN001",
    "orderNo": "IN001",
    "operationType": "IN_ORDER",
    "oldQuantity": 10,
    "newQuantity": 30,
    "changeQuantity": 20,
    "oldLockQuantity": 0,
    "lockQuantity": 0,
    "ageInDays": 0,
    "operatorTime": "2026-10-26 09:00:00",
    "putawayDate": "2026-10-26 09:00:00",
    "remark": "Stock added by putaway"
  }],
  "pagination": {"total": 1, "page": 1, "pageSize": 100}
}

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

Authorization: ********************

Body 参数application/json

示例

{
    "warehouseCode": "WH001",
    "sku": [
        "SKU001"
    ],
    "gsku": [
        "GSKU001"
    ],
    "inboundNo": "IN001",
    "orderNo": "IN001",
    "operationType": "IN_ORDER",
    "operatorTimeStart": "2026-10-01 00:00:00",
    "operatorTimeEnd": "2026-10-26 23:59:59",
    "page": 1,
    "pageSize": 100
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

库存日志分页；无匹配记录时data为空数组

Bodyapplication/json

示例

{
    "success": true,
    "code": "200",
    "message": "查询成功",
    "timestamp": "2026-10-26T10:00:00+08:00",
    "data": [
        {
            "id": "2026102601000000001",
            "warehouseCode": "WH001",
            "sku": "SKU001",
            "gsku": "GSKU001",
            "customSkuCode": "REF001",
            "inboundNo": "IN001",
            "orderNo": "IN001",
            "operationType": "IN_ORDER",
            "oldQuantity": 10,
            "newQuantity": 30,
            "changeQuantity": 20,
            "oldLockQuantity": 0,
            "lockQuantity": 0,
            "ageInDays": 0,
            "operatorTime": "2026-10-26 09:00:00",
            "putawayDate": "2026-10-26 09:00:00",
            "remark": "Stock added by putaway"
        }
    ],
    "pagination": {
        "total": 1,
        "page": 1,
        "pageSize": 100
    }
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🔴500服务器错误

操作类型枚举#