API文档

goods_query.php（查询货品档案）

1.接口说明

1.1 接口描述：获取旺店通ERP的货品档案资料，“货品档案”其他系统称为“物料档案”“商品档案”等

1.2 适用版本：网页版

1.3 增量获取：按照旺店通ERP内货品档案最后修改时间增量获取数据，请求时输入start_time和end_time作为时间跨度的筛选条件，返回的结果不包含在旺店通ERP货品档案已停用的货品数据。

全量获取：支持不传start_time和end_time 时间查询，不传时间入参分页获取全量货品数据。

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

1.4 注意事项：本接口如果不传start_time和end_time，则spec_no和goods_no必须传一个；当请求参数传了spec_no和goods_no其中一个或者两个都传了的时候，start_time和end_time参数不生效。

2.调用场景

2.1 自研商城、SCM、SRM、财务系统、SAP等系统的对接

3.请求参数说明

3.1 请求地址

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

名称	字段	类型	长度	必须	描述
商家编码	spec_no	varchar	255	否	代表单品（SKU）所有属性的唯一编码，用于获取指定的系统单品的数据，SKU概念介绍，单击这里
货品编号	goods_no	varchar	40	否	代表货品(SPU)所有属性的唯一编号，用于指定获取系统货品的数据，SPU概念介绍，单击这里
条码	barcode	varchar	50	否	条码
品牌	brand_name	varchar	64	否	品牌名称
货品分类名称	category_name	varchar	40	否	货品分类名称
开始时间	start_time	timestamp		是	按最后修改时间增量查询数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
结束时间	end_time	timestamp		是	按最后修改时间增量查询数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
是否隐藏删除数据	hide_deleted	int		否	默认为0, 0：返回未删除和已删除货品1：只返回未删除货品
分页大小	page_size	int		否	每页返回的数据条数，输入值范围1~100，不传本参数，输入值默认为40，使用举例单击这里
页号	page_no	int		否	页号，不传默认从0页开始

4.响应参数

4.1 公共响应参数

名称	字段	类型	长度	必须	描述
错误码	code	int	11	是	状态码:0表示成功,其他表示失败
错误描述	message	varchar	255	是	错误描述
数据条数	total_count	int	11	是	符合条件的数据条数，用来分页当page_no = 0时返回
货品节点	goods_list	data[]		是	响应参数的1级数据节点，包含SPU所有属性信息的数据节点,节点下数据字段详见下述“goods_list”和"spec_list"

4.2 业务响应参数

名称	字段	类型	长度	必须	描述
货品ID	goods_id	int	11	是	货品表主键
货品编号	goods_no	varchar	255	是	代表SPU所有属性的唯一编号，用于系统货品的区分，SPU概念介绍，单击这里
货品名称	goods_name	varchar	255	是	货品名称
货品简称	short_name	varchar	255	是	货品简称
规格数	spec_count	int	11	是	规格数
品牌名称	brand_name	varchar	256	是	品牌名称
品牌编码	brand_code	varchar	128	是	品牌编码
最后修改时间	modified	timestamp		是	最后修改时间格式：yyyy-MM-dd HH:mm:ss
创建时间	created	timestamp		是	创建时间格式：yyyy-MM-dd HH:mm:ss
分类名称	class_name	varchar	40	否	分类名称
是否已删除	deleted	int		是	是否已删除： 0：未删除 >0代表已删除
货品状态	goods_status	int		是	0:启用 4:禁用
货品分类id	goods_category_id	bigint		否	货品分类id
货品分类名称	category_name	varchar	40	否	货品分类名称
货品类型	goods_type	tinyint			1成品、2半成品、3原料、4包装材料、5辅料、6资产。默认值为：成品
品牌id	brand_id	int	11	否	品牌id
备注	remark	varchar	512	是	备注
商品标签	goods_label_name	varchar	512	否	商品标签名称按英文逗号拼接的字符
自定义属性1	prop1	varchar	255	否	自定义属性1
自定义属性2	prop2	varchar	255	否	自定义属性2
自定义属性2	prop3	varchar	255	否	自定义属性3
自定义属性4	prop4	varchar	255	否	自定义属性4
自定义属性5	prop5	varchar	255	否	自定义属性5
自定义属性6	prop6	varchar	255	否	自定义属性6
自定义属性7	prop7	varchar	255	是	自定义属性7
自定义属性8	prop8	varchar	255	是	自定义属性8
自定义属性9	prop9	varchar	255	是	自定义属性9
自定义属性10	prop10	varchar	255	是	自定义属性10
单品节点	spec_list	data[]		是	响应参数的2级数据节点，包含sku所有属性信息的数据节点,节点下数据字段详见下述"spec_list"

spec_list

名称	字段	类型	长度	必须	描述
规格ID	spec_id	bigint		是	规格ID
商家编码	spec_no	varchar	255	是	代表单品（SKU）所有属性的唯一编号，用于系统单品的区分，SKU概念介绍，单击这里
规格名称	spec_name	varchar	255	是	规格名称
规格简称	short_name	varchar	255	是	规格简称
条码	barcode	varchar	50	是	条码
货品ID	goods_id	int	11	是	货品ID
零售价	retail_price	decimal	19，4	是	零售价
批发价	wholesale_price	decimal	19，4	是	批发价
重量	weight	decimal	19，4	是	重量
长	length	decimal	19，4	是	长(CM)
宽	width	decimal	19，4	是	宽(CM)
高	height	decimal	19，4	是	高(CM)
单位	unit	bigint		是	单位id
基本单位	unit_name	varchar	256	是	基本单位名称
辅助单位	aux_unit	bigint		是	辅助单位
最后修改时间	modified	timestamp		是	最后修改时间格式：yyyy-MM-dd HH:mm:ss
货品状态	goods_status	int		是	0:启用 4:禁用
创建时间	created	timestamp		是	创建时间格式：yyyy-MM-dd HH:mm:ss
是否已删除	deleted	int		是	是否已删除：0：未删除 >0代表已删除
图片	img_url	varchar	1024	是	规格图片
供应商编码	provider_no	varchar	64		供应商编码
供应商名称	provider_name	varchar	64		供应商名称
供应商id	provider_id	bigint			供应商id
成本价	ref_cost_price	decimal	19,4	否	固定成本价为0
规格的编号	spec_code	varchar	255		规格的编号，Y当前都为空
备注	remark	varchar	512	是	备注
规格自定义属性1	prop1	varchar	255	否	规格自定义属性1
规格自定义属性2	prop2	varchar	255	否	规格自定义属性2
规格自定义属性2	prop3	varchar	255	否	规格自定义属性3
规格自定义属性4	prop4	varchar	255	否	规格自定义属性4
规格自定义属性5	prop5	varchar	255	否	规格自定义属性5
规格自定义属性6	prop6	varchar	255	否	规格自定义属性6
税率	tax_rate	decimal	19,4	否	税率
默认采购价	sku_default_purchase_price	decimal	19,4	否	默认采购价
附件	file_url_list	data[]			附件，字符串格式返回
箱规	box_sku_num	int	11	否	箱规
商品标签	goods_label_name	varchar	512	否	商品标签名称按英文逗号拼接的字符

5.请求示例

PHP	<php require_once("../WdtClient.php"); $c = new WdtClient; $c->sid = ''; $c->appkey = ''; $c->appsecret = ''; $c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/goods_query.php'; //添加查询参数 $c->putApiParam('start_time','2018-08-01 00:00:00'); $c->putApiParam('end_time','2018-08-11 00:00:00'); $json = $c->wdtOpenApi(); var_dump($json); ?>
JAVA
C#
python

6.响应示例

6.1 正常响应示例

JSON

{
    "code": 0,
    "message": "",
    "total_count": 1,
    "goods_list": [
        {
            "goods_id": "2679745084445949979",
            "goods_no": "250331101",
            "goods_name": "牛大腿",
            "short_name": "牛大腿",
            "goods_type": 2,
            "brand_name": "牛大力",
            "brand_id": "2677200835238167570",
            "class_name": "",
            "spec_count": 1,
            "deleted": 0,
            "modified": "2026-04-23 10:01:31",
            "created": "2025-03-31 16:30:15",
            "goods_label_name": "",
            "goods_category_id": "2679744097362640923",
            "category_name": "牛大腿",
            "prop1": "规格类型",
            "prop2": "",
            "prop3": "",
            "prop4": "",
            "prop5": "",
            "prop6": "",
            "prop7": "",
            "prop8": "",
            "prop9": "",
            "prop10": "",
            "brand_code": "ndl",
            "remark": "货品备注",
            "goods_status": 0,
            "spec_list": [
                {
                    "spec_id": "2679745085251256347",
                    "goods_id": "2679745084445949979",
                    "spec_name": "牛大腿",
                    "spec_no": "1122019",
                    "spec_code": "",
                    "retail_price": "50.0000",
                    "wholesale_price": "45.0000",
                    "weight": "0.0000",
                    "length": "0.0000",
                    "width": "0.0000",
                    "height": "0.0000",
                    "unit": "2625293876239269893",
                    "unit_name": "件",
                    "aux_unit": 0,
                    "deleted": 0,
                    "img_url": "https:\/\/erpx-prod.oss-cn-zhangjiakou.aliyuncs.com\/goods\/68b724c4-be61-4668-832e-05ed02298183\/haijun_29aad7e341df417d9a5d352462cb1f4f.png",
                    "modified": "2026-04-23 10:01:32",
                    "created": "2025-03-31 16:30:15",
                    "goods_label_name": "",
                    "provider_id": "2819675054202159118",
                    "provider_no": "8508",
                    "provider_name": "386410152",
                    "ref_cost_price": "30.0000",
                    "prop1": "",
                    "prop2": "",
                    "prop3": "",
                    "prop4": "",
                    "prop5": "",
                    "prop6": "",
                    "file_url_list": [
                        "https:\/\/cdn.pixabay.com\/photo\/2017\/03\/12\/11\/30\/alishan-2136879_1280.jpg"
                    ],
                    "short_name": "",
                    "barcode": "69000",
                    "tax_rate": "0.0000",
                    "remark": "",
                    "box_sku_num": 0,
                    "goods_status": 0,
                    "sku_default_purchase_price": "0.0000"
                }
            ]
        }
    ]
}

6.2 异常响应示例

JSON	{ "code": "20", "message": "请求范围过宽，请增加请求参数条件过滤" }