【新增出库通知单】接口 – AI-WMS PLUS 标准API平台

一、说明

二、参数说明

三、请求JSON范例

四、返回JSON范例

1、请求方式

2、header参数

3、请求参数

4、返回参数

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

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

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

字段	字段名	字段类型	长度	必填	说明
表头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	是
shipping_order_code	发货单号	String	100
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
recei_area	收货区域	int			表示该通知单要指定到哪个收货区域
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	扩展属性
表身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	扩展属性

字段	字段名	字段类型	长度	说明
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

{
    "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区",      //收货点
        "recei_area":"14", //收货区域
        "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":{}        //扩展属性
     }
]
}

http://服务器IP或机器名或域名/WMS/API/SYS/CreateDeliveryOrder

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