API文档

operational_stock_detail_query.php（运营仓库存明细查询）

1.接口说明

1.1 接口描述：查询erp系统，运营仓库存明细数据。即仓储->运营仓管理->运营仓库存明细数据。

1.2 适用版本：网页版

1.3 增量获取：按照运营仓库存明细数据最后修改时间增量获取数据，请求时输入start_time和end_time作为时间跨度的筛选条件。

1.4 时间跨度：start_time和end_time最大跨度为30天，开始时间和结束时间取值范围为闭区间取值，例如2018-11-01 00:00:00至2018-11-30 23:59:59，建议根据获取数据量的多少适当减小时间跨度。

2.调用场景

2.1 举例说明： SAP、线下ERP、SRM、SCM等系统对接

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	https://openapi.ali.huice.cc/openapi/operational_stock_detail_query.php
正式环境	https://openapi.huice.com/openapi/operational_stock_detail_query.php

3.2 公共请求参数

名称	字段	类型	必须	描述
卖家账号	sid	String	是	购买ERP时由旺店通分配给ERP购买方，请从ERP购买方获取。
接口账号	appkey	String	是	本开放平台“自助对接”功能模块内自助申请，申请流程单击这里
时间戳	timestamp	int	是	北京时间1970-01-01 08:00:00起至现在的总秒数，10位int值,旺店通企业版API服务端允许请求最大时间误差为5min，date.timezone = Asia/Shanghai。
签名	sign	String	是	API输入参数签名结果，签名算法介绍单击这里

3.3 业务请求参数

名称	字段	类型	必须	描述
开始时间	start_time	datetime	否	按最后修改时间增量获取数据,start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
结束时间	end_time	datetime	否	按最后修改时间增量获取数据,start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
分页大小	page_size	int	否	每页返回条数，不传默认40
页号	page_no	int	否	不传值默认从0页开始
仓库id	warehouse_id	varchar	否	代表仓库所有属性的唯一id，用于仓库区分，在旺店通ERP【仓库信息维护】界面查看
商家编码	spec_no	varchar	否	代表单品(sku)所有属性的编码

4.响应参数

4.1 公共响应参数

名称	字段	类型	长度	必须	描述
错误码	code	int	11	是	状态码:0表示成功,其他表示失败
错误描述	message	varchar	255	是	错误描述
库存明细详情列表	data	data[]		是	响应参数的1级数据节点，包含库存详细数据列表，节点下数据字段详见下述"data"

4.2 业务响应参数

stocks

名称	字段	类型	长度	必须	描述
运营仓名称	op_warehouse_name	string		是	运营仓名称
商品id	sku_id	long		是	商品id ，代表仓库所有属性的唯一id，用于仓库区分，在旺店通ERP【仓库信息维护】界面查看
货品简称	spu_short_name	string		是	货品简称
商家编码	sku_no	string		是	商家编码
库存量	original_lock_num	decimal	(19, 4)	是	库存量
待发货量	wait_send_num	decimal	(19, 4)	是	待发货量
可用库存	checkable_lock_num	decimal	(19, 4)	是	可用库存
公共可用库存	available_stock_num	decimal	(19, 4)	是	公共可用库存
采购在途	purchase_in_transit_num	decimal	(19, 4)	是	采购在途

5.请求示例

PHP	<?php require_once ('../WdtClient.php'); $c = new WdtClient(); $c->sid =''; $c->appkey =''; $c->appsecret =""; $c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/stock_full_query.php'; // $c->putApiParam('start_time', '2026-01-01 00:00:00'); //$c->putApiParam('end_time', '2026-01-30 23:59:59'); $c->putApiParam('page_no', '0'); $c->putApiParam('page_size', '100'); $c->putApiParam('warehouse_id', '3'); // $c->putApiParam('spec_no', ''); $json = $c->wdtOpenApi(); var_dump($json); ?>
JAVA
C#
python

6.响应示例

6.1 正常响应示例

JSON

{
	"code": 0,
	"message": "",
	"total_count": 1,
	"data": [{
		"sku_id": "2710470137982484501",
		"sku_no": "jszc2-test3-12",
		"spu_short_name": "包材-初茶花月茶包绑绳款盖纸包装纸-21g-茉莉绿茶套\/-25C",
		"op_warehouse_name": "测试运营仓1",
		"original_lock_num": "1",
		"wait_send_num": "0",
		"checkable_lock_num": "1",
		"available_stock_num": "311",
		"purchase_in_transit_num": "0"
	}]
}

6.2 异常响应示例

JSON	{ "code": 2180, "message": "xxxxxxxx" }