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://openapitest.huice.com/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 业务响应参数