API文档

dz_pick_trade_query.php（查询分拣单管理）

¥标准

1.接口说明

1.1 接口描述：获取ERP分拣单对应的订单信息

1.2 适用版本：客户端 V2.6.8.6及以上版本

2.调用场景

2.1 分拣系统对接

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	https://sandbox.wangdian.cn/openapi2/dz_pick_trade_query.php
正式环境	https://api.wangdian.cn/openapi2/dz_pick_trade_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	date	是	按创建时间增量获取数据,start_time作为开始时间，格式： yyyy-MM-dd HH:mm:ss
结束时间	end_time	date	是	按创建时间增量获取数据,end_time作为结束时间，格式： yyyy-MM-dd HH:mm:ss
页号	page_no	int	否	需要查询第page_no页的数据，不传值默认从第0页开始
分页大小	page_size	int	否	每页返回的数据条数，输入值范围1~100，不传本参数输入值默认为40

4.响应参数

4.1 公共响应参数

名称	字段	类型	长度	必须	描述
错误码	code	int	11	是	状态码:0表示成功,其他表示失败
错误描述	message	varchar	255	是	错误描述
数据条数	total_count	int	11	否	数据条数
订单列表节点	pick_list	data[]		否	响应参数的1级数据节点，包含获取分拣单和货品信息的数据节点,节点下数据字段详见下述“pick_list”和" trade_info_list"

4.2 业务响应参数

pick_list

名称	字段	类型	长度	必须	描述
分拣单号	pick_no	varchar	40	是	分拣单号
分拣单状态	status	int	11	是	分拣单状态（10 待拣货 20 拣货中 30 拣货完成 40 分拣完成 50 完成）
批次	batch_no	varchar	40	是	批次
仓库编号	warehouse_no	varchar	40	是	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置）（根据编号可查询仓库名称）
分拣单类型	pick_type	int	11	是	分拣单类型（1 一单一货 2 一单多货 3 混合）
分拣员	picker_name	varchar	256	是	分拣员
打印备注	print_remark	varchar	255	是	打印备注

trade_info_list

名称	字段	类型	长度	必须	描述
物流名称	logistics_name	varchar	40	是	物流名称
分拣类型	pick_type	varchar	40	是	分拣类型 1 一单一货 2 一单多货 3混合
打印备注	print_remark	varchar	40	是	打印备注
分拣单状态	status	varchar	40	是	分拣单状态 10 待拣货 20 拣货中 30 拣货完成 40 分拣完成 50 完成
出库单号	stockout_no	varchar	40	是	出库单号
订单编号	trade_no	varchar	40	是	订单编号
订单状态	trade_status	varchar	40	是	订单状态

5.请求示例

PHP

<?php
    require_once("../WdtClient.php");
    $c = new WdtClient;
    $c->sid = '';
    $c->appkey = '';
    $c->appsecret = '';
    $c->gatewayUrl = 'http://sandbox.wangdian.cn/openapi2/dz_pick_trade_query.php';

    $c->putApiParam('start_time','');
    $c->putApiParam('end_time','');
    $json = $c->wdtOpenApi();
    var_dump($json);
    
?>

package com.wangdian.api.trade;

import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

import com.wangdian.api.WdtClient;

public class DzPickTradeQuery {

    public static void main(String[] args) {
        // TODO Auto-generated method stub
        WdtClient client = new WdtClient("传入sid", "传入appkey", "传入appsecret", "传入url");
        //测试环境sid、appkey、密钥请到旺店通开放平台-自助对接-申请测试环境内查看，测试环境url=https://sandbox.wangdian.cn/openapi2/
        //调用正式环境时请将sid、appkey、appsecret切换为实际参数，参数在旺店通开放平台-自助对接-应用管理内应用状态为已上线的应用中查看，调用正式环境注意切换正式环境url=https://api.wangdian.cn/openapi2/
        
        Map<String, String> params = new HashMap<String, String>();
        params.put("start_time", "");
        params.put("end_time", "");
        try {
            String response = client.execute("dz_pick_trade_query.php", params);
            System.out.println(response);
        } catch (IOException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }

}

6.响应示例

6.1 正常响应示例

JSON

{
    "code": 0,
    "pick_list": [{
        "batch_no": "",
        "pick_no": "",
        "pick_type": "1",
        "picker_name": "liuzh",
        "print_remark": "",
        "status": "50",
        "trade_info_list": [{
            "logistics_name": "zsy的物流",
            "pick_type": "1",
            "print_remark": "",
            "status": "50",
            "stockout_no": "",
            "trade_no": "",
            "trade_status": "55"
        }, {
            "logistics_name": "zsy的物流",
            "pick_type": "1",
            "print_remark": "",
            "status": "50",
            "stockout_no": "",
            "trade_no": "",
            "trade_status": "55"
        }, {
            "logistics_name": "zsy的物流",
            "pick_type": "1",
            "print_remark": "",
            "status": "50",
            "stockout_no": "",
            "trade_no": "",
            "trade_status": ""
        }],
        "warehouse_no": "zsy002"
    }],
    "total_count": 1,
    "message": "ok"
}

6.2 异常响应示例

JSON	{ "code": 2180, "message": "start_time与end_time时间跨度不能超过最大范围" }