API文档

suites_query.php（查询组合装）

奇门接口url wdt.suites.query

¥标准

1.接口说明

1.1 接口描述：获取旺店通ERP中组合装界面的组合装资料

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

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

1.4 注意事项：本接口如果不传start_time、end_time，则suite_no必须要传，如果start_time、end_time和suite_no都传了，则按照时间和商家编码的查询同时生效。

2.调用场景

2.1 举例说明： 数据分析系统等系统的对接

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	https://openapi.ali.huice.cc/openapi/suites_query.php
正式环境	https://openapi.huice.com/openapi/suites_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
组合装商家编码	suite_no	varchar	40	否	代表组合装商品所有属性的唯一编码，用于系统组合装商品数据的获取，如果按照组合装商家编码查询，可以不传送开始时间和结束时间
分页大小	page_size	int		否	每页返回的数据条数，输入值范围1~1000，不传本参数，输入值默认为40，使用举例单击这里
页号	page_no	int		否	不传值默认从0页开始
组合装名称	suite_name	varchar	255	否	组合装名称
主条码	barcode	varchar	50	否	主条码

4.响应参数

4.1公共响应参数

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

4.2业务响应参数

suites
名称	字段	类型	长度	必须	描述
组合装主键	suite_id	int	11	是	erp组合装表的主键
组合装商家编码	suite_no	varchar	40	是	代表组合装商品所有属性的唯一编码，用于系统组合装商品的区分
组合装名称	suite_name	varchar	255	是	组合装名称
简称	short_name	varchar	255	是	组合装简称
分类名称	class_name	varchar	255	是	分类名称
品牌名称	brand_name	varchar	255	是	品牌名称
零售价	retail_price	decimal	19,4	是	零售价
批发价	wholesale_price	decimal	19,4	是	批发价
组合装成本价	ref_cost_price	decimal	19,4	否	组合装成本价为0 表示没有组合装成本价
重量	weight	decimal	19,4	是	重量
删除状态	deleted	varchar	11	是	删除状态未删除=0 已删除＞0
创建时间	created	datetime		是	创建时间时间格式：yyyy-MM-dd HH:mm:ss
最后修改时间	modified	datetime		是	最后修改时间时间格式：yyyy-MM-dd HH:mm:ss
组合装图片	img_url	varchar		是	组合装图片
货品分类id	goods_category_id	int		否
货品分类名称	category_name	varchar		否	为空时null
品牌id	brand_id	varchare		否	品牌id
自定义属性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
单品节点	specs_list	data[]		是	响应参数的2级数据节点，包含sku所有属性信息的数据节点,节点下数据字段详见下述"specs_list"
specs_list
名称	字段	类型	长度	必须	描述
单品商家编码	spec_no	varchar	40	是	代表所单品（sku）所有属性的编码，SPU和SKU概念介绍，单击这里
单品名称	spec_name	varchar	100	是	单品名称
条码	barcode	varchar	50	是	单品条形码
规格码	spec_code	varchar	40	是	规格码
货品名称	goods_name	varchar	255	是	货品名称
货品编号	goods_no	varchar	40	是	代表SPU所有属性的编号，SPU和SKU概念介绍，单击这里
数量	num	decimal	19,4	是	单品数量
单品主键id	rec_id	varchar	11	是	单品主键id
规格id	spec_id	varchar	11	是	规格id
基本单位	unit	varchar	11	是	基本单位
删除状态	deleted	tinyint	4	是	删除状态,删除状态未删除=0 已删除＞0
使用固定售价	is_fixed_price	tinyint	1	是	是否使用固定售价 0:否/1:是（固定售价是手动填写的金额，非固定售价按金额占比分摊）
固定金额	fixed_price	decimal	19,4	是	组合装中单品的单价金额
金额占比	ratio	decimal	5,4	是	单品占组合装总价格的百分比
最后修改时间	modified	datetime		是	时间格式：yyyy-MM-dd HH:mm:ss
创建时间	created	datetime		是	时间格式：yyyy-MM-dd HH:mm:ss
组合装单品图片	img_url	varchar		是
规格自定义属性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

5.请求示例

PHP	<?php require_once("../WdtClient.php"); $c = new WdtClient; $c->sid = ''; $c->appkey = ''; $c->appsecret = ''; $c->gatewayUrl = 'https://openapitest.huice.com/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,
    "suites": [
        {
            "suite_id": "2625298302945460230",
            "suite_no": "商家编码 (新)",
            "barcode": "",
            "spec_name": "旺店通测试商品",
            "suite_name": "旺店通测试商品",
            "retail_price": "0.04000000",
            "wholesale_price": "0",
            "member_price": "0.0000",
            "market_price": "0.0000",
            "weight": "0",
            "unit": "0",
            "aux_unit": 0,
            "deleted": 0,
            "modified": "2025-05-26 11:03:34",
            "img_url": "",
            "ref_cost_price": "0",
            "goods_category_id": "0",
            "category_name": null,
            "brand_id": "2680073525653406725",
            "brand_name": "牛叨小市",
            "prop1": "",
            "prop2": "",
            "prop3": "",
            "prop4": "",
            "prop5": "",
            "prop6": "",
            "specs_list": [
                {
                    "rec_id": "2699956590978531342",
                    "spec_no": "32727931",
                    "barcode": "",
                    "spec_code": "",
                    "spec_name": "颜色白色",
                    "goods_name": "用于测试删除",
                    "goods_no": "241030001",
                    "num": "1.0000",
                    "is_fixed_price": 0,
                    "fixed_price": null,
                    "ratio": "0.5000",
                    "spec_id": "2624640147219547140",
                    "unit": 0,
                    "deleted": 0,
                    "modified": "2025-05-26 11:03:34",
                    "img_url": "",
                    "prop1": null,
                    "prop2": null,
                    "prop3": null,
                    "prop4": null,
                    "prop5": null,
                    "prop6": null
                },
                {
                    "rec_id": "2699956591142109198",
                    "spec_no": "123456",
                    "barcode": "",
                    "spec_code": "",
                    "spec_name": "颜色蓝白",
                    "goods_name": "旺店通测试商品",
                    "goods_no": "zzz00001",
                    "num": "1.0000",
                    "is_fixed_price": 0,
                    "fixed_price": null,
                    "ratio": "0.5000",
                    "spec_id": "2624642187178017796",
                    "unit": 0,
                    "deleted": 0,
                    "modified": "2025-05-26 11:03:34",
                    "img_url": "https://img.huice.com/123456.jpg",
                    "prop1": null,
                    "prop2": null,
                    "prop3": null,
                    "prop4": null,
                    "prop5": null,
                    "prop6": null
                }
            ]
        }
    ]
}

6.2 异常响应示例

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