当前位置： API文档

pick_trade_query.php（查询分拣单订单）

¥标准

1.接口说明

1.1 接口描述：获取租户系统内分拣单的订单信息
1.2 适用版本：网页版

2.调用场景

2.1 对接分拣机系统

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境https://openapi.ali.huice.cc/openapi/pick_trade_query.php
正式环境https://openapi.huice.com/openapi/pick_trade_query.php

   3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
是购买ERP时由旺店通分配给ERP购买方，请从ERP购买方获取。
接口账号appkeyString
是本开放平台“自助对接”功能模块内自助申请，获取方式点击这里
时间戳timestampint
是北京时间1970-01-01 08:00:00起至现在的总秒数，10位int值,旺店通企业版API服务端允许请求最大时间误差为5min，date.timezone = Asia/Shanghai。
签名signString
是API输入参数签名结果，签名算法介绍单击这里

   3.3 业务请求参数

名称字段类型长度必须描述
开始时间start_timedate
是按创建时间增量获取数据,start_time作为开始时间，格式： yyyy-MM-dd HH:mm:ss
结束时间end_timedate
是按创建时间增量获取数据,end_time作为结束时间，格式： yyyy-MM-dd HH:mm:ss

仓库id

warehouse_no

varchar


是

代表仓库所有属性的唯一id，用于仓库区分，在旺店通ERP【仓库信息维护】界面查看

页号page_noint
否需要查询第page_no页的数据，不传值默认从第0页开始
分页大小page_sizeint
否每页返回的数据条数，输入值范围1~100，不传本参数输入值默认为40

4.响应参数

   4.1 公共响应参数

名称字段类型长度必须描述
错误码codeint11是状态码:0表示成功,其他表示失败
错误描述messagevarchar255是错误描述
4.2 业务响应参数




数据条数total_countint11否符合条件的数据条数
订单列表节点pick_listdata[]
否响应参数的1级数据节点，包含获取分拣单和货品信息的数据节点,节点下数据字段详见下述“pick_list”和" trade_info_list"

4.2 业务响应参数

   pick_list

名称字段类型长度必须描述
分拣单号pick_novarchar

分拣单号
仓库id
warehouse_novarchar

代表仓库所有属性的唯一id，用于仓库区分，在旺店通ERP【仓库信息维护】界面查看
仓库名称warehouse_namevarchar

仓库名称
分拣单状态statusint

5 已取消 10 待拣货 20 拣货中 30 拣货完成 35 分货中 40 分拣完成 50 完成
分拣单类型pick_typeint

1 一单一货 2 一单多货 3 爆款
订单列表trade_info_listdata[]

分拣单的订单列表

trade_info_list

名称字段类型长度必须描述
订单编号trade_novarchar

系统订单编号，JY单号
订单状态trade_statusint

系统订单状态
物流名称logistics_namevarchar

物流名称

5.请求示例

PHP
<?php
	require_once '../WdtClient.php';
	$c = new WdtClient();
	$c->sid = '';
	$c->appkey = '';
	$c->appsecret = ''; 
	$c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/pick_trade_query.php';

	$c->putApiParam('start_time', '2026-03-01 16:00:40');
	$c->putApiParam('end_time', '2026-03-19 16:00:40');
	$c->putApiParam('warehouse_no', '38');
	$c->putApiParam('page_no', '0');
	$c->putApiParam('page_size', '1');

	$json = $c->wdtOpenApi();
	var_dump($json);
?>
JAVA
C#
python

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 0,
    "message": "",
    "total_count": 1,
    "pick_list": [
        {
            "pick_no": "PB260313000005",
            "status": 5,
            "pick_type": 2,
            "warehouse_no": "38",
            "warehouse_name": "滑雪场器材仓库1",
            "trade_info_list": [

            ]
        }
    ]
}

   6.2 异常响应示例

JSON
{
    "code": 11000000,
    "message": "建单时间不正确",
    "total_count": null,
    "pick_list": null
}







常用工具