【新增入库通知单】接口 – 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值	说明：授权接口所获取的值

字段	字段名	字段类型	长度	必填	说明
表头
oth_task_id	第三方任务单号	string	100	是	唯一ID
ref_id	第三方系统标识	string	20	是	自定义一个系统标识，如T8
entry_order_date	通知单日期	datatime		是	单据日期，精确到日
request_id	申请单ID	string	10		申请单单据别，如无，则可不填；
request_code	申请单号	string	100	是	唯一单号
warehouse_code	仓库编码	string	30	是	仓库代号
owner_code	货主编码	string	30	是	未启用货主编码时，则固定传入OWNER；
order_type	业务类型	string	10	是	提供类型如下： 01=进货入库，02=暂估入库，03=销货退回入库，04=自制产品入库，05=托外加工入库，06=生产退料入库，07=托工退料入库，08=库存调拨入库，09=非生产退料入库，10=报废入库，11=其他入库；
expect_start_time	预期到货时间	datatime		是	即预交日期，精确到日
department	部门	string	30	是
bill_type	单据类别	string	10
supplier_code	供应商代号	string	30		厂商代号
supplier_name	供应商名称	string	100		厂商名称
operate_time	操作时间	datatime		是	制单时间，精确到秒
operator_code	操作员编码	string	30	是	制单人
last_modified_date	最近修改时间	datatime
remark	备注	string
totalorder_lines	单据总行数	int
extend_props	扩展属性
表身
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		即申请单对应来源单的项次
extend_props	扩展属性

字段	字段名	字段类型	长度	说明
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
entry_order_code	WMS入库通知单号	string	100

{
    "entry_order":
    {
        "oth_task_id":"{{$guid}}",    //必填，第三方任务单号
        "ref_id":"SUNLIKE ERP",     //必填，第三方系统标识
        "entry_order_date":"2023-03-01",     //必填，通知单日期
        "request_id":"TI",        //申请单 ID
        "request_code":"TI33010001",        //必填，申请单号
        "warehouse_code":"A",      //必填，仓库编码
        "owner_code":"OWNER",      //必填，货主编码
        "order_type":"01",       //必填，业务类型
        "expect_start_time":"2023-03-02",       //必填，预期到货时间
        "department":"00000000",       //必填，部门
        "bill_type":"",       //单据类别
        "supplier_code":"SUP01",       //供应商代号
        "supplier_name":"厂商SUP01",       //供应商名称
        "operate_time":"2023/03/01 15:45:32",       //操作时间
        "operator_code":"ADMIN",       //操作员编码
        "last_modified_date":"2023/03/01 15:45:32",       //最近修改时间
        "remark":"",       //备注
        "totalorder_lines":"",       //单据总行数
        "extend_props":{}       //扩展属性
}, 
"order_lines":
[
    {
    "item_code":"P001",        //必填，货品代号
    "item_name":"P001货品P",        //必填，货品名称
    "sku_property":"",        //货品特征值
    "batch_code":"23010101",        //批号
    "qty":100,        //必填，数量
    "qty1":0,        //数量（副）
    "rem":"",        //备注
    "request_id":"TI",        //必填，申请单ID
    "request_code":"TI33010001",        //必填，申请单号
    "request_itm":"1",        //必填，申请单项次
    "source_bilid":"PO",        //业务单ID
    "source_bilno":"PO33010001",        //业务单号
    "source_bilitm":"1",        //业务单项次
    "extend_props":{}        //扩展属性
     }
]
}

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

{
"code": 0,
"message": "新增成功",
"oth_task_id": "8042cc34-2243-4156-8bef-54252c9b89d6",
"request_id": "TI",
"request_code": "TI33010001",
"warehouse_code": "A",
"entry_order_code": "UO230301000001"
}