API文档

stock_query.php（查询库存成本可用库存数据）

¥标准

1.接口说明

1.1 接口描述：获取旺店通ERP查询库存成本可用库存数据

1.2 适用版本：网页版

1.3 增量获取：按照ERP库存记录的最后修改时间增量获取数据，请求时输入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、数据分析等系统的对接

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	https://openapi.ali.huice.cc/openapi/stock_query.php
正式环境	https://openapi.huice.com/openapi/stock_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		是	按时间增量获取数据,end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
商家编码	spec_no	string		否	商家编码（新），商家编码和开始结束时间必传一项
商家编码列表	spec_no_list	string[]		否	商家编码（新）批量查询，示例："spec_no_list":"[\"spec1\", \"spec2\"]"，上限为200条商家编码，时间范围和商家编码在查询时必须要有一个不为空
是否残次品	defect	tinyint		否	0否 1是
分页大小	page_size	int		否	每页返回的数据条数，输入值范围1~1000，不传本参数，输入值默认为100，使用举例单击这里
页号	page_no	int		否	页号默认从0开始

4.响应参数

4.1公共响应参数

名称	字段	类型	长度	必须	描述
错误码	code	int	40	是	状态码:0表示成功,其他表示失败
错误描述	message	varchar	255	是	错误描述
数据条数	total_count	int	10	否	符合条件的数据条数，用来分页当page_no = 0时返回
入库单详情	stocks	data[]		否	库存节点数据

4.1业务响应参数

stocks

字段名称	字段	类型	是否必须	描述
单品主键id	spec_id	bigint(20)	是	单品主键
仓库主键id	warehouse_id	int(11)	是	仓库主键
ERP库存id	rec_id	bigint(20)	是	库存明细主键
货品编号	goods_no	string	是	货品编号
品牌编号	brand_no	string	是	品牌编号
品牌名称	brand_name	string	是	品牌名称
货品名称	goods_name	string	是	品牌名称
商家编码	spec_no	string	是	商家编码
规格名称	spec_name	string	是	规格名称
规格码	spec_code	string	是	规格码
条形码	barcode	string	是	条形码
库存量	stock_num	decimal(21, 6)	是	库存量
可用库存	available_num	decimal(21, 6)	是	可用库存
辅助单位	unit	string	是	辅助单位名称
备注	remark	string	是	备注
成本价	cost_price	decimal(21, 6)	是	商品档案的固定成本价
虚拟库存	virtual_num	decimal(21, 6)	是	虚拟库存
平均成本价	avg_cost_price	decimal(21, 6)	是	库存查询-成本价字段，支持不同成本价模式取值。加权平均和先进先出模式下，为平均成本价
是否残次品	defect	tinyint(4)	是	0否 1是
ERP创建时间	created	datetime	是	ERP创建时间
ERP更新时间	modified	datetime	是	ERP更新时间

5.请求示例

PHP	<?php require_once("../WdtClient.php"); $c = new WdtClient; //测试环境地址 //上线时需要换成线上的 $c->sid = ''; $c->appkey = ''; $c->appsecret = ''; //测试环境地址 //上线时需要换成线上的 $c->gatewayUrl = 'https://openapitest.huice.com/openapi/stock_query.php'; $c->putApiParam("page_no", "0"); $c->putApiParam("page_size", "100"); $c->putApiParam("spec_no_list", ["xxx"]); //$c->putApiParam("start_time", "2025-01-09 15:00:00"); //$c->putApiParam("end_time", "2025-01-11 15:00:00"); $json = $c->wdtOpenApi(); var_dump($json); ?>
JAVA
C#
python

6.响应示例

6.1 正常响应示例

JSON

{
    "code": 0,
    "message": "",
    "total_count": 1,
    "stocks": [
        {
            "spec_id": "2646773608436727836",
            "warehouse_id": "233",
            "rec_id": "2777490266540474390",
            "goods_no": "test1",
            "brand_no": "2744980845566624770",
            "brand_name": "测试品牌",
            "goods_name": "test1",
            "spec_no": "test1_1",
            "spec_name": "默认规格",
            "spec_code": "",
            "barcode": "",
            "stock_num": "50.0000",
            "available_num": "50.0000",
            "unit": "",
            "remark": "",
            "cost_price": "0.0000",
            "avg_cost_price": "0.0000",
            "defect": 0,
            "created": "2025-12-26 09:54:42",
            "modified": "2025-12-26 09:54:53",
            "virtual_num": "0.0000"
        }
    ]
}

6.2 异常响应示例

JSON	{ "code": 21000024, "message": "未查询到任何货品，请检查商家编码（新）是否正确！" }