当前位置: API文档

wms.stockout.SalesPick.pickListOverviewForApi(分拣单全览)  

¥标准

1.接口说明

1.1 接口描述:获取ERP内分拣波次信息
1.2 适用版本:客户端V1.3.1.2及以上版本
1.3 增量获取:
1.4 时间跨度:

1.5注意事项:

2.调用场景

2.1 举例说明:

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境http://47.92.239.46/openapi
正式环境http://wdt.wangdian.cn/openapi

   3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
卖家账号, 由旺店通分配
接口账号keyString
由旺店通分配appkey, 在发送的数据中对应 key 字段
saltString
由旺店通分配appsecret,是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt.
接口名称methodString
调用的接口名称
版本号vString
1.0
秒级时间戳timestampint
秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。
签名signString
签名
分页大小page_sizeint
分页大小,分页查询必传
分页编号page_noint
分页编号,分页查询必传,标准接口page_no从0开始
是否计算查询结果的总条数calc_totalint
是否计算查询结果的总条数, 需要计算则1, 否则填0         

   3.3 业务请求参数

名称字段类型长度
必须描述
波次单编号pick_noString

波次单编号

4.响应参数

名称字段类型长度
必须描述
状态码statusInt
Y

状态码,0表示正常

分货信息data

Map<String, Object>


Y分货信息

data

名称字段类型长度
必须描述
拣货区通道长度
aisle_no_len
byte

N

拣货区通道长度

物流公司主键logistics_id
Int
N

物流公司主键

物流公司名称logistics_nameString

N物流公司名称
订单数量order_countInt

Y
订单数量
拣货分组主键pick_group_id
Int

N拣货分组主键
分拣单号主键
pick_id
Int

Y分拣单号主键
分拣波次号
pick_no
String

Y分拣波次号
拣货方式pick_type
byte

N拣货方式
打印类型
print_typebyte

N打印类型
扫描方式
scan_type
byte

N
扫描方式
是否进入分货
is_sort
boolean

N
是否进入分货
分货模式sort_mode
byte
N分货模式
分货方式
sort_type
byte

分货方式
货区idzone_id
Int

货区id
货品列表pick_goods_data_list
List<Map<String, Object>>
货品列表

pick_goods_data_list

名称字段类型长度
必须描述
辅助单位名称

aux_name

String

Y辅助单位名称
条码

barcode

String
Y条码
批次id

batch_id

Int

批次id
正残品

defect

boolean

Y

正残品

0:正品

1:残次品

货品名称

goods_name

String 

Y货品名称
货品编号

goods_no

String
Y货品编号
图片url

img_url

String

Y图片url
货品数量

num

Int
Y货品数量
库存货位

possible_position

String
Y
库存货位
货品简称

short_name

String
Y货品简称
序列号类型 

sn_type

byte
Y

序列号类型

0:未开启序列号

1:强序列号

2:弱序列号

规格码

spec_code

String
Y规格码
规格id

spec_id

Int
Y规格id
规格名称

spec_name

String 
Y规格名称
商家编码

spec_no

String
Y商家编码
基本单位名称

unit_name

String
基本单位名称
辅助单位与基本单位之间的换算关系

unit_ratio

BigDecimal
Y辅助单位与基本单位之间的换算关系
保质期

validity_days

Int

保质期
批次编号

batch_no

String

N
批次编号
有效期

expire_date

date

N有效期
货品所在货位的信息

position_data

Map<String, Object>
Y
货品所在货位的信息
货品其余货位的信息

position_list

List<Map<String, Object>>

Y
货品其余货位的信息
货品所在出库单的信息

stockout_list

List<Map<String, Object>>
Y货品所在出库单的信息

position_data

名称字段类型长度
必须描述
货位id

position_id

Int

货位id

货位编号

position_no

String 

货位编号

货位排序编号

sort_no

String

Y

货位排序编号

货位库存明细

stock_detail_list

List<Map<String, Object>>
Y

货位库存明细

position_list

名称字段类型长度
必须描述
货位id

position_id

Int

货位id

货位编号

position_no

String 

货位编号

货位排序编号

sort_no

String

Y

货位排序编号

货位库存明细

stock_detail_list

List<Map<String, Object>>
Y

货位库存明细

stockout_list

名称字段类型长度
必须描述
分拣序号index
Int
Y
分拣序号
货品数量
num
Int

Y货品数量
已分货数量sort_num
Int

Y已分货数量
出库单id
stockout_id
Int


出库单id
物流单号
logistics_noString

Y物流单号
出库单号
stockout_noString
Y出库单号

stock_detail_list

名称字段类型长度
必须描述
批次idbatch_id
Int

Y
批次id
批次编号batch_no
String

Y批次编号
有效期
expire_date
date

Y有效期
库存数量stock_num
Int

Y
库存数量  

5.请求示例

Json格式请求报文
["FJ2104220004"]
PHP

<?php
header("Content-Type: text/html; charset=UTF-8");
date_default_timezone_set("Asia/Shanghai");
require_once('wdtsdk.php');
  
$client = new WdtErpClient("url", "wdtapi3", "appkey", "secret"); 
$pickNo = "FJ2104220004";
 
$data = $client->call("wms.stockout.SalesPick.pickListOverviewForApi", $ pickNo);
?>

6.响应示

   6.1 正常响应示例 

JSON

{
    "status":0,
    "data":
{
        "aisle_no_len":0,
        "logistics_id":0,
        "order_count":1,
"pick_group_id":0,
        "pick_id":3430,
        "pick_no":"FJ2104220004",
        "pick_type":0,
        "print_type":2,
        "scan_type":0,
        "sort":false,
        "sort_mode":0,
        "sort_type":0,
        "zone_id":0,
        "pick_goods_data_list":
[
            {
                "aux_name":"10瓶",
                "barcode":"xht_test_02",
                "batch_id":0,
                "defect":false,
                "goods_name":"测试货品1",
                "goods_no":"xht_001",
                "img_url":"cos://IMG565.jpg",
                "num":200,
                "possible_position":"",
                "short_name":"测试1",
                "sn_type":0,
                "spec_code":"xht_test_02",
                "spec_id":434190,
                "spec_name":"02",
                "spec_no":"xht_test_02",
"unit_name":"瓶",
                "unit_ratio":10,
                "validity_days":0,
"position_data":
{
                    "position_id":14094,
                    "position_no":"J_xht_A",
                    "sort_no":"J_xht_A",
                    "stock_detail_list":
[
                        {
                            "batch_id":52,
                            "batch_no":"djdjdjdjmdndndndj",
                            "expire_date":1618329600000,
                            "stock_num":30
                        }
                    ]
                },
                "position_list":
[
                    {
                        "position_id":14090,
                        "position_no":"J_xht_E",
                        "sort_no":"J_xht_E",
                        "stock_detail_list":
[
                            {
                                "batch_id":42,
                                "batch_no":"只求我能暴富",
                                "expire_date":1617724800000,
                                "stock_num":119
                            }
                        ]
                    }
                ],
                "stockout_list":
[
                    {
                        "index":1,
                        "logistics_no":"202104221659001",
                        "num":200,
                        "sort_num":0,
                        "stockout_id":21975,
                        "stockout_no":"CK2021042239"
                    }
                ]
            }
        ]
    }
}

   6.2 异常响应示例

JSON

{"status":100,"message":"分拣单不存在"}





常用工具