未分类

【新增出库通知单】接口

一、说明

主要用于第三方系统将其相关出库的申请单，通过调用AI-WMS PLUS的【新增出库通知单】接口，从而生成AI-WMS PLUS系统的【出库通知单】。

注：如果同一张来源申请单表身货品的仓库不同，则须按仓库分开产生多张【出库通知单】，即分多次调【新增出库通知单】接口。

二、参数说明

1、请求方式

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

2、header参数

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

3、请求参数

  字段 字段名 字段类型 长度 必填 说明
表头delivery_order
oth_task_id 第三方任务 ID String 10 是 唯一ID
ref_id 第三方系统标识 String 20 是 自定义一个系统标识，如T8
delivery_order_date 通知单日期 Datatime 是 单据日期，精确到日
request_id 申请单 ID String 10 申请单单据别，如无，则可不填；
request_code 申请单号 String 100 是 即ERP申请单号
warehouse_code 仓库编码 String 30 是 仓库代号
owner_code 货主编码 String 30 是 未启用货主编码时，则固定传入OWNER；
order_type 业务类型 String 10 是 提供类型：
01=销货出库,02=进货退回出库,03=暂估退回出库,04=托工退回出库,05=生产领料出库,06=生产补料出库,07=托工领料出库,08=托工补料出库,09=原料调拨出库,10=库存调拨出库,11=非生产领料出库,12=报废出库,13=其他出库,14=配送出库,15=配送退回出库,16=客户调货出库
schedule_date 要求出库时间 Datatime 是 即预交日期，精确到日
department 部门 String 30 是
bill_type 单据类别 String 10
cus_no 客户代号 String 30 客户代号
cus_name 客户名称 String 100 客户名称
operator_code 制单人 String 30 是 制单人
operate_time 制单时间 Datatime 是 制单时间，精确到秒
last_modified_date 最近修改时间 Datatime
waiting_notice 需等待发货通知 String 1 1. 无需等等，仓库可备好货后可直接发货；
2. 需等待通知，即仓库备好货后，需等待第三方发出确认发货的通知信息，才能发货出库；
允许为空
area_sh 收货点 String 60
est_dh_dd 预计到货时间 Datatime
logistics_code 物流公司编码 String 30
logistics_name 物流公司名称 String 100
name 收货人姓名 String 40
zip_code 邮编 String 10
mobile 手机 String 40
country_code 国家 int
area 省市区代号 int
detail_address 详细地址 String 1000
remark 备注 String
total_order_lines 单据总行数 int
extend_props 扩展属性
owner_code 货主编码 string 30 是 不启用货主功能时，默认为OWNER，启用货主后，根据实际的货主编码传值
表身order_lines
item_code 货品代号 String 50 是 货品代号
item_name 货品名称 String 160 是 货品名称
sku_property 特征 String 255 货品特征值
batch_code 批号 String 40 批号
qty 数量 FLOAT 是 数量
qty1 数量(副) FLOAT 数量(副)
rem 备注 String
request_id 申请单 ID String 10 是 即ERP来源单号ID
request_code 申请单号 String 100 是 即ERP申请单号
request_itm 申请单项次 String 100 是 即ERP申请单的转单唯一项次；
source_bilid 业务单 ID String 10 即申请单的来源单ID
source_bilno 业务单号 String 100 即申请单的来源单号；
source_bilitm 业务单项次 String 100 即申请单对应来源单的项次
extendprops 扩展属性

4、返回参数

  字段 字段名 字段类型 长度 说明
code 成功标识 string 10 返回0则表示成功，其他则为失败
message 返回信息 string 200
oth_task_id 第三方任务ID string 100
request_id 来源申请ID string 10
request_code 来源申请单号 string 100
warehouse_code 来源单仓库代号 string 30
delivery_order_code WMS出库通知单号 string 100

三、请求JSON范例

{
    "delivery_order":
    {
        "oth_task_id":"{{$guid}}",    //必填，第三方任务单号
        "ref_id":"SUNLIKE ERP",     //必填，第三方系统标识
        "delivery_order_date":"2023-03-01",     //必填，通知单日期
        "request_id":"CK",        //申请单 ID
        "request_code":"CK33010001",        //必填，申请单号
        "warehouse_code":"A",      //必填，仓库编码
        "owner_code":"OWNER",      //必填，货主编码，未启用，现默认传OWNER
        "order_type":"01",       //必填，业务类型
        "schedule_date":"2023-03-11",       //必填，要求出库时间,即预交日期，精确到日 
        "department":"00000000",       //必填，部门
        "bill_type":"",       //单据类别
        "cus_no":"C001",       //客户代号
        "cus_name":"客户C001",       //客户名称
        "operate_time":"2023-03-01 08:00:00",       //操作时间
        "operator_code":"ADMIN",       //操作员编码
        "last_modified_date":"2023-03-01 09:00:00",       //最近修改时间
        "waiting_notice":"",      //需等待发货通知，允许为空
        "area_sh":"A区",      //收货点
        "est_dh_dd":"2023-03-11",      //预计到货时间
        "logistics_code":"0000001",      //物流公司编码
        "logistics_name":"天心物流公司",      //物流公司名称
        "name":"张三",      //收货人姓名
        "zip_code":"123456",      //邮编
        "mobile":"13012345678",      //手机
        "country_code":"86",      //国家
        "area":"440000",      //省市区代号
        "detail_address":"广东省珠海市香洲区吉大水湾大厦",      //详细地址
        "remark":"水果",       //备注
        "totalorder_lines":1,      //单据总行数
        "extend_props":{}       //扩展属性
}, 
"order_lines":
[
    {
    "item_code":"P001",        //必填，货品代号
    "item_name":"P001码货品P",        //必填，货品名称
    "sku_property":"",        //货品特征值
    "batch_code":"230301001",        //批号
    "qty":100,        //必填，数量
    "qty1":0,        //数量（副）
    "rem":"",        //备注
    "request_id":"CK",        //必填，申请单ID
    "request_code":"CK33010001",        //必填，申请单号
    "request_itm":"1",        //必填，申请单项次
    "source_bilid":"SO",        //业务单ID
    "source_bilno":"SO33010001",        //业务单号
    "source_bilitm":"1",        //业务单项次
    "extend_props":{}        //扩展属性
     }
]
}

四、返回JSON范例

{
"code": 0,
"message": "新增成功",
"oth_task_id": "f53a4a19-39fd-438f-9ef9-6becdd0462b6",
"request_id": "CK",
"request_code": "CK33010001",
"warehouse_code": "A",
"delivery_order_code": "UP230301000001"
}

分类目录