当前位置： 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


物流公司主键

订单数量order_countInt

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

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

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

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

N

拣货方式

0：边拣边分

1：先拣后分

2：电子分拣单

3：通道拣货

4：多货区拣货（拣+分）

5：按单放框

6：多货区拣货（拣->分）

打印类型
print_typebyte

N

打印类型

0：不打印

1：领取波次后立即打印

2：波次拣货后打印

扫描方式
scan_type
byte

N

扫描方式

0：自由/默认

1：逐个扫描

是否进入分货
sort
boolean

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

分货模式

-1：默认

0：非动态

1：动态

分货方式
sort_type
byte

N 

分货方式

0：任意分货

1：一单多货分货

货区idzone_id
Int

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

pick_goods_data_list

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




aux_name

String

Y辅助单位名称
条码




barcode

String
Y条码
批次id




batch_id

Int

Y 批次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
Y 基本单位名称
辅助单位与基本单位之间的换算关系




unit_ratio

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




validity_days

Int

Y 保质期
批次编号




batch_no

String

N
批次编号
有效期




expire_date

date

N有效期
保质期计算方式




validity_type

Int

Y

保质期计算方式

0：按天

1：按月

默认为0

拣货分组id




pick_group_id

Int

Y拣货分组id
货品所在货位的信息




position_data

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




position_list

List<Map<String, Object>>

Y

货品其余货位的信息

注：货位分配模式为默认货位模式时不返回position_list

货品所在出库单的信息




stockout_list

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

position_data

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




position_id

Int

Y 

货位id

货位编号




position_no

String 
Y 

货位编号

货位排序编号




sort_no

String

Y

货位排序编号

货区id




zone_id

Int

Y

货区id

货区编号




zone_no

String

Y

货区编号

货位库存明细




stock_detail_list

List<Map<String, Object>>
Y

货位库存明细

position_list

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




position_id

Int

Y 

货位id

货位编号




position_no

String 
Y 

货位编号

货位排序编号




sort_no

String

Y

货位排序编号

货区id




zone_id

Int

Y

货区id

货区编号




zone_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

Y 
出库单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": {
        "data": {
            "aisle_no_len": 0,
            "can_hang_up": false,
            "is_one_type_in_order": false,
            "logistics_id": 0,
            "order_count": 1,
            "pick_goods_data_list": [
                {
                    "aux_name": "盒（10）",
                    "barcode": "11111111",
                    "batch_id": 0,
                    "contain_num": 1,
                    "defect": false,
                    "goods_name": "货品名称",
                    "goods_no": "wangdiantong",
                    "img_url": "",
                    "num": 2,
                    "pick_group_id": 0,
                    "position_data": {
                        "position_id": 64229,
                        "position_no": "B01-01",
                        "sort_no": "B01-01",
                        "stock_detail_list": [
                            {
                                "batch_id": 1724,
                                "batch_no": "PC2303270004",
                                "expire_date": 1722009600000,
                                "stock_num": 1189
                            }
                        ],
                        "zone_id": 663,
                        "zone_no": "J"
                    },
                    "position_list": [
                        {
                            "position_id": 64231,
                            "position_no": "B01-02",
                            "sort_no": "B01-02",
                            "stock_detail_list": [
                                {
                                    "batch_id": 1722,
                                    "batch_no": "PC2303270002",
                                    "stock_num": 40
                                }
                            ],
                            "zone_id": 663,
                            "zone_no": "J"
                        }
                    ],
                    "possible_position": "",
                    "short_name": "",
                    "sn_type": 0,
                    "spec_code": "wangdiantong",
                    "spec_id": 1,
                    "spec_name": "测试产品",
                    "spec_no": "wangdiantong",
                    "stockout_list": [
                        {
                            "index": 1,
                            "logistics_no": "14454584112210",
                            "num": 2,
                            "sort_num": 0,
                            "stockout_id": 520062,
                            "stockout_no": "CK202303274"
                        }
                    ],
                    "unit_name": "只",
                    "unit_ratio": 10.0000,
                    "validity_days": 0,
                    "validity_type": 0
                }
            ],
            "pick_group_id": 0,
            "pick_id": 4023,
            "pick_no": "FJ2303270001",
            "pick_type": 0,
            "print_type": 2,
            "scan_type": 0,
            "sort": false,
            "sort_mode": 0,
            "sort_type": 0,
            "zone_id": 0
        },
        "status": 0
    }
}

   6.2 异常响应示例

JSON

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





常用工具