API文档

stock_goods_sn_query.php（序列号管理查询接口）

1.接口说明

1.1 接口描述：获取序列号管理界面上的序列号信息

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，建议根据获取数据量的多少适当减小时间跨度。

1.5注意事项：如传序列号和商家编码时可以不传时间参数

2.调用场景

2.1 财务系统、SAP、数据分析等系统的对接

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	https://openapi.ali.huice.cc/openapi/stock_goods_sn_query.php
正式环境	https://openapi.huice.com/openapi/stock_goods_sn_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 业务请求参数

名称	字段	类型	长度	必须	描述
序列号	sn	String	20	否	序列号
商家编码	spec_no	String	40	否	商家编码
序列号状态	statu	int	11	否	序列号状态：0已取消,5未启用,10初始录入,15二次录入,20已入库,30已占用,40已出库
开始时间	start_time	datetime		是	按最后修改时间增量获取数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
结束时间	end_time	datetime		是	按最后修改时间增量获取数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
分页大小	page_size	int		否	每页返回的数据条数，输入值范围1~100，不传本参数，输入值默认为40，使用举例单击这里
页号	page_no	int		否	页号默认从0开始

4.响应参数

4.1 公共响应参数

名称	字段	类型	必须	描述
错误码	code	int	是	错误码，0成功
错误描述	message	varchar	是	错误描述
数据总条数	total_count	int	是	符合条件的数据总条数，当page_no=0时返回，用来分页
序列号节点	goods_lis	data[]	是	响应参数的1级数据节点，包含序列号数据节点,节点下数据字段详见下述“stockout_list”," stockin_list"

4.2 业务响应参数

goods_list

名称	字段	类型	长度	必须	描述
序列号唯一码	id	int	11	是	序列号唯一码
序列号	sn	varchar	40	是	序列号
辅助序列号	second_s	varchar	40	是	辅助序列号
创建编号	sn_number	varchar	40
仓库id	warehouse_id	int	10	是	仓库id
仓库名称	warehouse_name	varchar	40	是	仓库名称
序列号状态	status	int	11	是	序列号状态：5未启用,10待入库,15已入库,20已占用,30已出
货品编码	spu_no	varchar	40	是	货品编码
货品名称	spu_nam	varchar	40	是	货品名称
商家编码	sku_no	varchar	40	是	商家编码
规格码	sku_cod	varchar	40	是	规格码
规格名称	sku_name	varchar	40	是	规格名称
序列号创建时间	create_date	datetime		是	序列号创建时间，格式：yyyy-MM-dd HH:mm:ss
序列号最后更新时间	modify_date	datetime		是	序列号最后更新时间，格式：yyyy-MM-dd HH:mm:ss
入库单据明细节点	stockin_list	data[]		是	入库单据明细节点，字段详细见stockin_list表
出库单据明细节点	stockout_list	data[]		是	出库单据明细节点，字段详细见stockout_list表

stockin_list

名称	字段	类型	长度	必须	描述
入库类型	inout_type_tex	varchar	40	是	入库类型
入库单编号	stock_inout_no	varchar	40	是	入库单编
源单号	src_order_no	varchar	40	是	入库单源单号
入库单状态	consign_statu	int	10	是	入库单状态
操作人	operator_name	varchar	40	是	操作人
出入库时间	create_dat	datetime		是	出入库时间

stockout_list

名称	字段	类型	长度	必须	描述
出库类型	inout_type_tex	varchar	40	是	出库类型
出库单编号	stock_inout_no	varchar	40	是	出库单编
源单号	src_order_no	varchar	40	是	出库单源单号
出库单状态	consign_statu	int	10	是	出库单状态
操作人	operator_name	varchar	40	是	操作人
出入库时间	create_dat	datetime		是	出入库时间

5.响应示例

5.1 正常响应示例

JSON

{
	"code": 0,
	"message": "",
	"total_count": 1,
	"goods_list": [{
		"id": "2767076881390895129",
		"sn": "2767076881390895129",
		"secondSn": "",
		"skuNo": null,
		"skuCode": null,
		"spuNo": null,
		"spuName": null,
		"skuName": null,
		"warehouseId": "127",
		"warehouseName": "小哈电池售卖仓",
		"status": 30,
		"statusText": "已出库",
		"snNumber": "",
		"skuId": "99999",
		"modifyDate": "2025-11-27T16:15:43",
		"createDate": "2025-11-27T16:15:38",
		"stockInList": [],
		"stockOutList": [{
			"stockInoutOrderId": "2767076538858864665",
			"stockInoutNo": "JY2511274071",
			"inoutType": -1,
			"inoutTypeText": "销售订单",
			"srcOrderNo": null,
			"operatorId": 3947,
			"operatorName": "xh001-test",
			"createDate": "2025-11-27T16:15:38",
			"consignStatus": 95,
			"snId": "2767076881390895129"
		}]
	}]
}

5.2 异常响应示例

JSON	{ "code": 2180, "message": "start_time与end_time时间跨度不能超过最大范围30天" }