API文档

unique_code_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 自研商城、SCM、SRM、财务系统、SAP等系统的对接

3.请求参数说明

3.1 请求地址

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

名称	字段	类型	长度	必须	描述
订单号列表	trade_nos	varchar		否	订单号列表 (传字符串, 英文逗号分割)
唯一码状态枚举列表	status	varchar		否	唯一码状态枚举列表 (传字符串, 英文逗号分割) (唯一码枚举 10:已失效 15:已退款 20:未拿货 37:已拿货 45:已到货 50:已分拣 60:已发货)
开始时间	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，不传本参数输入值默认为100
页号	page_no	int		否	页号，从0页开始

4.响应参数

4.1 公共响应参数

名称	字段	类型	长度	必须	描述
订单号列表	trade_nos	varchar		否	订单号列表 (传字符串, 英文逗号分割)
唯一码状态枚举列表	status	varchar		否	唯一码状态枚举列表 (传字符串, 英文逗号分割) (唯一码枚举 10:已失效 15:已退款 20:未拿货 37:已拿货 45:已到货 50:已分拣 60:已发货)
开始时间	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，不传本参数，输入值默认为100
页号	page_no	int		否	页号，从0页开始

4.2 业务响应参数

名称	字段	类型	长度	必须	描述
唯一码状态值	status	int	11	是	唯一码状态值
唯一码	unique_code	varchar	40	是	唯一码
分拣框分拣框号 A1-2-3 中的 A1	box_no	varchar	40	是	分拣框分拣框号 A1-2-3 中的 A1
分拣序列分拣框号 A1-2-3 中的 2	pick_seq	varchar	40		分拣序列分拣框号 A1-2-3 中的 2
修改时间	modify_date	datetime			修改时间
供应商编码	provider_no	varchar	64		供应商编码
供应商名称	provider_name	varchar	64		供应商名称
货品编码-spu	goods_no	varchar	255		货品编码-spu
商品名称	goods_name	varchar	255		商品名称
商家编码	spec_no	varchar	255		商家编码
规格名称	spec_name	varchar	255		规格名称
规格图片链接	sku_img_url	varchar	1024		规格图片链接
平台货品名称	api_goods_name	varchar	255		平台货品名称
平台规格名称	api_spec_name	varchar	255		平台规格名称
零售价	price	decimal	19,4		零售价
采购价	wholesale_price	decimal	19,4		采购价
订单编号	trade_no	varchar	255		订单编号
订单中下单时间	trade_time	datetime			订单中下单时间
付款时间	pay_time	datetime			付款时间
订单状态	trade_status	tinyint	4		订单状态 5 已取消 25 特殊单 29 预订单 30 待审核（已支付） 35 待财审 50 待发货 51 待推送 52 推送中 53 推送失败 55 已推送 95 已发货 110 已完成
订单中客服备注	cs_remark	varchar	1024		订单中客服备注
订单中货品总数	goods_count	int			订单中货品总数
订单中店铺id	shop_id	int			代表店铺所有属性的唯一id，用于店铺区分，在旺店通ERP【绑定店铺】界面查看
店铺名称	shop_name	varchar	128		店铺名称
快递公司名称	logistics_name	varchar	128		快递公司名称
物流单号	logistics_no	varchar	128		物流单号
仓库名称	warehouse_name	varchar			仓库名称
仓库id	warehouse_id	int			代表仓库所有属性的唯一id，用于仓库区分，在旺店通ERP【仓库信息维护】界面查看

5.请求示例

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

6.响应示例

6.1 正常响应示例

JSON

{
    "code": 0,
    "message": "",
    "total_count": 451,
    "unique_list": [
        {
            "uniqueCodeId": "2729046462829690910",
            "boxId": "0",
            "providerId": null,
            "tradeId": "2729046462590615582",
            "logisticsId": "2778951368499527691",
            "status": 60,
            "unique_code": "0000021763",
            "box_no": null,
            "pick_seq": "0",
            "modify_date": "2026-01-30T17:42:12",
            "provider_no": null,
            "provider_name": null,
            "goods_no": "133233522992",
            "goods_name": "测试测试22",
            "spec_no": "17773392251",
            "spec_name": "测试测试22",
            "sku_img_url": "",
            "api_goods_name": "测试测试22",
            "api_spec_name": "测试测试22",
            "price": "2099.0000",
            "wholesale_price": "0.0000",
            "trade_no": "JY2508140343",
            "trade_time": "2025-07-31T00:00:00",
            "pay_time": "2025-08-11T00:00:00",
            "cs_remark": "",
            "goods_count": 150,
            "shop_id": 332,
            "shop_name": "renmaolin-test",
            "trade_status": 95,
            "logistics_name": "极兔快递111",
            "logistics_no": "333333333333",
            "warehouse_id": "51",
            "warehouse_name": "发货仓"
        }
    ]
}

6.2 异常响应示例

JSON	{ "code": 2220, "message": "page_size为正整数，请检查page_size是否为有效值" }