查询库存明细（支持分页或全量）

POST

/api/v1/stock/detail/queries

Stock

按货主、仓库、SKU、入库批次和上架时间聚合，平铺返回当前正库存明细，不含库位维度。可用数量 = max(0, 总库存 - 锁定数量 - 不良品数量)，与管理端“我的库存”明细维度一致。仅返回调用方租户、货主及仓库权限内的数据；所有过滤条件组合生效。 page 默认为 1；pageSize 不传、为 null 或为 0 时查询全部并忽略合法的 page。 pageSize 大于 0 时分页，total 为聚合后明细总数；page 小于 1 或 pageSize 小于 0 时返回 400。上架时间入参和明细响应的 putawayDate 均使用 yyyy-MM-dd HH:mm:ss，固定按 Asia/Shanghai 上海时区解析及返回，无需提供时区后缀。

请求参数

Authorization

Body 参数application/json

示例

{
    "warehouseCode": "WH001",
    "sku": [
        "string"
    ],
    "gsku": [
        "string"
    ],
    "inboundNo": "string",
    "putawayDateStart": "2026-10-01 00:00:00",
    "putawayDateEnd": "2026-10-19 23:59:59",
    "page": 1,
    "pageSize": 0
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://gwms.jmalltech.com/api-gateway/api/v1/stock/detail/queries' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "warehouseCode": "WH001",
    "sku": [
        "string"
    ],
    "gsku": [
        "string"
    ],
    "inboundNo": "string",
    "putawayDateStart": "2026-10-01 00:00:00",
    "putawayDateEnd": "2026-10-19 23:59:59",
    "page": 1,
    "pageSize": 0
}'

返回响应

🟢200成功

application/json

库存明细；空结果返回 data=[]、total=0

Bodyapplication/json

示例

{
    "success": true,
    "message": "操作成功",
    "code": "200",
    "timestamp": "2024-01-01T00:00:00Z",
    "data": [
        {
            "warehouseCode": "string",
            "sku": "string",
            "gsku": "string",
            "inboundNo": "string",
            "putawayDate": "2026-10-09 16:00:00",
            "ageInDays": 0,
            "quantity": 0,
            "lockQuantity": 0,
            "defectiveQuantity": 0,
            "availableQuantity": 0
        }
    ],
    "pagination": {
        "total": 0,
        "page": 1,
        "pageSize": 0
    }
}

🟠400请求有误

🟠401没有权限

🔴500服务器错误

修改于 2026-10-20 09:13:57

物流费试算 (按长宽高)

库存日志查询