SKU库存实时查询【国内】接口

提供国内SKU库存的实时查询能力，支持批量查询多个SKU的实际库存和在途库存信息，数据实时性高，适用于国内业务场景。

适用场景

实时查询国内SKU的实际库存数量

了解SKU的在途库存情况（已分配但未入库的库存）

批量核查国内多个SKU的库存状态

接口类型

POST

请求频率限制

默认频率：以平台配额为准

请求说明

请求URL

正式环境：https://www.westmonth.com/openapi/jst/actualSkuInventory
测试环境：https://testing.westmonth.com/openapi/jst/actualSkuInventory

请求参数

Header参数

参数名	类型	必填	示例值	说明
Authorization	string	是	authorization	身份验证Token
Content-Type	string	是	application/json	建议固定传此值

Body参数

根字段

参数名	类型	必填	默认值	可选值	说明
skus	array	是	-	-	查询的SKU列表，最多支持100个SKU

响应字段说明

成功响应（HTTP 200）

根字段

字段	类型	说明
code	integer	业务状态码（0表示成功）
msg	string	提示信息（成功时为空）
data	array	业务数据列表，包含各SKU的库存信息

data数组字段

字段	类型	说明
sku	string	SKU编码
qty	integer	实际库存（当前可售的库存数量）
allocate_qty	integer	在途库存（已分配但尚未入库的库存数量）

调用示例

URL请求

请求示例

{
    "skus": [
        "EEA09-A061-100-MX1",
        "SOA06-A019-5-BK1"
    ]
}

成功返回示例

{
    "code": 0,
    "msg": "",
    "data": [
        {
            "sku": "EEA09-A061-100-MX1",
            "qty": 1187,
            "allocate_qty": 144
        },
        {
            "sku": "SOA06-A019-5-BK1",
            "qty": 1029,
            "allocate_qty": 0
        }
    ]
}

失败返回示例

{
    "code": 3,
    "msg": "授权无效 authorization timestamp error",
    "data": []
}

错误处理

公共错误码

HTTP status code	错误码	错误信息	描述

注意事项

本接口仅支持查询国内业务相关的SKU库存，不包含跨境或海外仓库存

实际库存（qty）表示当前可直接销售的库存数量，在途库存（allocate_qty）表示已分配但未正式入库的库存，可供参考后续库存补充情况

单次查询SKU数量上限为100个，超过时会返回参数错误

常见问题

Q1：实际库存（qty）和在途库存（allocate_qty）的区别是什么？

A：qty是当前已入库可直接销售的库存；allocate_qty是已确认分配但尚未完成入库的库存，可作为后续库存补充的参考。

Q2：查询结果中没有某个SKU的信息，可能是什么原因？

A：可能原因：1. 该SKU不存在或未开通国内业务；2. SKU编码输入错误；3. 该SKU暂无库存（实际库存和在途库存均为0时可能不返回）。

Q3：如何提高查询效率？

A：建议每次查询控制在50个SKU以内，减少单次请求的数据量，提高响应速度。

版本历史

版本	日期	修改说明
v1.0	2025-06-01	初始版本，支持国内SKU库存实时查询

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "",
    "data": [
        {
            "sku": "EEA09-A061-100-MX1",
            "qty": 1187,
            "allocate_qty": 144
        },
        {
            "sku": "SOA06-A019-5-BK1",
            "qty": 1040,
            "allocate_qty": 0
        }
    ]
}

SKU实时库存【国内】

SKU库存实时查询【国内】接口#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

注意事项#

常见问题#

Q1：实际库存（qty）和在途库存（allocate_qty）的区别是什么？#

Q2：查询结果中没有某个SKU的信息，可能是什么原因？#

Q3：如何提高查询效率？#

版本历史#

请求参数

请求示例代码

返回响应

SKU库存实时查询【国内】接口

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

注意事项

常见问题

Q1：实际库存（qty）和在途库存（allocate_qty）的区别是什么？

Q2：查询结果中没有某个SKU的信息，可能是什么原因？

Q3：如何提高查询效率？

版本历史