AI-WMS PLUS 标准API平台

【新增拣货单】接口

一、说明

主要用于第三方系统通过调用AI-WMS PLUS的【新增拣货单】接口，从而生成AI-WMS PLUS系统的【拣货单】。

  • 必须有来源单；
  • 支持按货品信息生成，或模拟条码扫码生成。

二、参数说明

1、请求方式

请求方式 POST
接口地址 http://服务器IP或机器名或域名/WMS/API/SYS/CreatePickingOrder
格式 JSON
编码类型 UTF-8

2、header参数

KEY VALUE
Content-Type application/json
Authorization token值 说明：授权接口所获取的值

3、请求参数

  字段 字段名 字段类型 长度 必填 说明
picking_order<表头>
ref_id 第三方系统标识 string 20 是 自定义一个系统标识，如T8
oth_task_id 第三方任务单号 string 100 是 唯一单号
generate_mode 生成单据方式 string 10 是 1.按货品信息生成、2.模拟条码扫码生成
owner_code 货主编码 string 30 是 未启用货主编码时，则固定传入OWNER
picking_order_date 拣货日期 datatime   是 单据日期，精确到日
order_type 业务类型 string 10 是 提供类型：
01=销货出库,02=进货退回出库,03=暂估退回出库,04=托工退回出库,05=生产领料出库,06=生产补料出库,07=托工领料出库,08=托工补料出库,09=原料调拨出库,10=库存调拨出库,11=非生产领料出库,12=报废出库,13=其他出库,14=配送出库,15=配送退回出库,16=客户调货出库
transfer_bilid 转入单据别 string 10 是 当来源单为WMS出库通知单时，则赋值为UP
当来源单为WMS调拨通知单时，则赋值为TN
当来源单为WMS直接拣货任务单时，则赋值为XR
当来源单为WMS波次拣货任务单时，则赋值为JR
transfer_bilno 转入单号 string 100 是 来源单号
warehouse_code 仓库编码 string 30 是 仓库代号，即入库仓库
department 部门 string 30 是  
operate_time 操作时间 datatime   是 制单时间，精确到秒
operator_code 操作员编码 string 30 是 制单人
last_modified_date 最近修改时间 datatime      
remark 备注 string      
extend_props 扩展属性       自定义字段
<单据属性propertys>
auto_ck 同时产生出库/调拨单 string 1   T为产生，F为不产生；为空或不传视为F
<表身明细：order_lines，当“生成单据方式”=1按货品信息生成，则按下面参数赋值>
storage_code 储位代号 string 60    
item_code 货品代号 string 50 是 货品代号
item_name 货品名称 string 160 是 货品名称
sku_property 特征 string 255   货品特征值
batch_code 批号 string 40   批号
qty 数量 float   是 数量
qty1 数量(副) float     数量(副)
valid_date 有效日期 Datatime      
sc_date 生产日期 Datatime      
transfer_bilid 转入单据别 string 10 是 当来源单为WMS出库通知单时，则赋值为UP
当来源单为WMS调拨通知单时，则赋值为TN
当来源单为WMS直接拣货任务单时，则赋值为XR
当来源单为WMS波次拣货任务单时，则赋值为JR
transfer_bilno 转入单号 string 100 是 即来源单号
transfer_bilitm 转入单项次 integer     取来源单表身的“转单唯一项次”
remark 备注 string   是  
extend_props 扩展属性       自定义字段
<表身明细：order_lines，当“生成单据方式”=2模拟条码扫码生成，则按下面参数赋值>
barcode 条码 String 80 是

条码必须以前缀开头：

@BB为箱条码、@BC为货品条码、@BR为序列号
storage_code 储位代号 String 60  

 
break_up_flag 散出标记 String 1  

当为箱码时，则栏位必须赋值，T为散出，F为整出
qty 数量 Float   是

当为箱条码时，散出标记=T，则数量为散出数量；当散出标记=F时，则数量默认为1；

当为条码时，则数量为实际出库数量；

当为序列号时，则数量默认为1。
valid_date 有效日期 Datatime    

 
sc_date 生产日期 Datatime    

 

4、返回参数

  字段 字段名 字段类型 长度 说明
code 成功标识 string 10 返回0则表示成功，其他则为失败
message 返回信息 string 200  
oth_task_id 第三方任务单号 string 100  
picking_order_code WMS拣货单号 string 100  
delivery_confirm_code WMS出库单号 string 100  

三、请求JSON范例

范例一：按货品信息生成

{
    "picking_order": {
        "ref_id": "T8", //第三方系统标识，必填
        "oth_task_id": "{{$guid}}", //第三方任务单号，唯一值，必填
        "generate_mode": "1", //生成方式，1.按货品信息生成、2.模拟条码扫码生成
        "owner_code": "OWNER", //货主编码
        "picking_order_date": "2024-10-23", //拣货单日期，必填
        "order_type": "11", //业务类型，必填，01=销货出库,02=进货退回出库,03=暂估退回出库,04=托工退回出库,05=生产领料出库,06=生产补料出库,07=托工领料出库,08=托工补料出库,09=原料调拨出库,10=库存调拨出库,11=非生产领料出库,12=报废出库,13=其他出库,14=配送出库,15=配送退回出库,16=客户调货出库
        "transfer_bilid": "UP", //转入单据别，必填，当来源单为WMS出库通知单时，则赋值为UP；当来源单为WMS调拨通知单时，则赋值为TN；当来源单为WMS直接拣货任务单时，则赋值为XR；当来源单为WMS波次拣货任务单时，则赋值为JR别
        "transfer_bilno": "UP241023000002", //转入单号，必填
        "warehouse_code": "000", //仓库编码，必填
        "department": "00000000", //部门，必填
        "operator_code": "ADMIN", //制单人，必填
        "operate_time": "2024-10-23 10:22:51", //制单时间，必填
        "last_modified_date": "", //最近修改时间
        "remark": "", //备注
        "extend_props": {} //扩展属性
    },
    "propertys": {
        "auto_ck": "T" //同时产生出库/调拨单，T为产生，F为不产生；为空或不传视为F
    },
    "order_lines": [
        {
            "storage_code": "", //储位代号
            "item_code": "001", //货品代号，必填
            "item_name": "蓝牙耳机（A款）", //货品名称，必填
            "sku_property": "", //货品特征
            "batch_code": "", //批号
            "qty": 10, //数量，必填
            "qty1": , //数量(副)
            "valid_date": "", //有效日期
            "sc_date": "", //生产日期
            "transfer_bilid": "UP", //转入单据别，必填
            "transfer_bilno": "UP241023000002", //转入单号，必填
            "transfer_bilitm": "1", //转入单项次，必填
            "remark": "", //备注
            "extend_props": {} //扩展属性
        },
        {
            "storage_code": "", //储位代号
            "item_code": "002", //货品代号，必填
            "item_name": "蓝牙耳机（B款）", //货品名称，必填
            "sku_property": "", //货品特征
            "batch_code": "", //批号
            "qty": 11, //数量，必填
            "qty1": 110, //数量(副)
            "valid_date": "", //有效日期
            "sc_date": "", //生产日期
            "transfer_bilid": "UP", //转入单据别，必填
            "transfer_bilno": "UP241023000002", //转入单号，必填
            "transfer_bilitm": "2", //转入单项次，必填
            "remark": "", //备注
            "extend_props": {} //扩展属性
        }
    ]
}

范例二：模拟条码扫码生成

{
    "picking_order": {
        "ref_id": "T8", //第三方系统标识，必填
        "oth_task_id": "{{$guid}}", //第三方任务单号，唯一值，必填
        "generate_mode": "2", //生成方式，1.按货品信息生成、2.模拟条码扫码生成
        "owner_code": "OWNER", //货主编码
        "picking_order_date": "2024-10-23", //拣货单日期，必填
        "order_type": "11", //业务类型，必填，01=销货出库,02=进货退回出库,03=暂估退回出库,04=托工退回出库,05=生产领料出库,06=生产补料出库,07=托工领料出库,08=托工补料出库,09=原料调拨出库,10=库存调拨出库,11=非生产领料出库,12=报废出库,13=其他出库,14=配送出库,15=配送退回出库,16=客户调货出库
        "transfer_bilid": "UP", //转入单据别,必填，当来源单为WMS出库通知单时，则赋值为UP;当来源单为WMS调拨通知单时，则赋值为TN;当来源单为WMS直接拣货任务单时，则赋值为XR;当来源单为WMS波次拣货任务单时，则赋值为JR
        "transfer_bilno": "UP241023000002", //转入单号，必填
        "warehouse_code": "000", //仓库编码，必填
        "department": "00000000", //部门，必填
        "operator_code": "ADMIN", //制单人，必填
        "operate_time": "2024-10-23 10:22:51", //制单时间，必填
        "last_modified_date": "", //最近修改时间
        "remark": "", //备注
        "extend_props": {} //扩展属性
    },
    "propertys": {
        "auto_ck": "T" //同时产生出库/调拨单，T为产生，F为不产生；为空或不传视为F
    },
    "order_lines": [
        {
            "barcode": "@BC001", //必填，条码必须以前缀开头：@BB为箱条码、@BC为货品条码、@BR为序列号
            "storage_code": "", //储位代号
            "valid_date": "", //有效日期
            "sc_date": "", //生产日期
            "break_up_flag": "F", //当为箱码时，则栏位必须赋值，T为散出，F为整出; 
            "qty": "20" //当为箱码时，散出标记=T，则数量为散出数量；当散出标记=F时，则数量默认为1；
        }
    ]
}

四、返回JSON范例

{
    "picking_order_code": "PK241023000001",
    "delivery_confirm_code": "CK241023000001",
    "code": 0,
    "message": "新增成功",
    "oth_task_id": "6b864e5d-d813-4d3f-3a26-bfd343b2c628"
}