AI-WMS PLUS 标准API平台

【新增收货单】接口

一、说明

  • 原在PDA操作新增【收货单】时，是要调用第三方接口获取来源单信息的，以及保存单据时，要调用第三方接口将【收货单】信息推送给第三方。
  • 现使用本接口时，生成单据时：

当【生成单据方式】=【1.按货品信息生成】时，是以“模拟扫描”的方式，即根据请求参数的货品信息，按PDA【收货单】-【单据属性设定】“单据操作模式”=“转单模式”的处理，模拟扫描，触发保存，生成单据；单据生成后，再调用第三方接口，推送【收货单】信息给第三方。

  • 版本：2026年7月2日之后的AI-WMS PLUS 5.0版本

二、参数说明

1、请求方式

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

2、HEADER参数

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

3、请求参数

  字段 字段名 字段类型 长度 必填 说明
receipt_order<表头>
ref_id 第三方系统标识 string 20 是 自定义一个系统标识，如T8
oth_task_id 第三方任务单号 string 100 是 唯一单号
generate_mode 生成单据方式 string 10 是 1.按货品信息生成、2.模拟条码扫码生成
owner_code 货主编码 string 30 是 未启用货主编码时，则固定传入OWNER
receipt_order_date 收货日期 datatime   是 单据日期，精确到日
order_type 业务类型 string 10 是 提供类型如下：
01=进货入库，02=暂估入库，03=销货退回入库，04=自制产品入库，05=托外加工入库，06=生产退料入库，07=托工退料入库，08=库存调拨入库，09=非生产退料入库，10=报废入库，11=其他入库；
transfer_bilid 转入单据别 string 10   允许为空
transfer_bilno 转入单号 string 100   当“生成单据方式”=1.按货品信息生成时，则可不传；
反之，则为必传；
warehouse_code 仓库编码 string 30 是 仓库代号，即入库仓库
department 部门 string 30 是  
supplier_code 供应商代号 string 30   厂商代号
supplier_name 供应商名称 string 100   厂商名称
operate_time 操作时间 datatime   是 制单时间，精确到秒
operator_code 操作员编码 string 30 是 制单人
last_modified_date 最近修改时间 datatime      
remark 备注 string      
extend_props 扩展属性       自定义字段
<单据属性propertys>
no_push 单据不推送给第三方 string 1   表示单据不推送给第三方：T为不推送，F或空或不传为推送
<表身明细：order_lines，当“生成单据方式”=1按货品信息生成，则按下面参数赋值>
item_code 货品代号 string 50 是 货品代号
item_name 货品名称 string 160 是 货品名称
sku_property 特征 string 255   货品特征值
batch_code 批号 string 40   批号
qty 数量 float   是 数量
qty1 数量(副) float     数量(副)，没有副数量则不传该参数、或给0值
transfer_bilid 转入单据别 string 10   允许为空
transfer_bilno 转入单号 string 100   当“生成单据方式”=按货品信息生成时，则可不传；
反之，则为必传；
transfer_bilitm 转入单项次 integer     “转入单号”有值时，则必须赋值；反之，则为空；
remark 备注 string      
extend_props 扩展属性       自定义字段

4、返回参数

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

三、请求JSON范例

{
"receipt_order": {
"ref_id": "SCM", //第三方系统标识，必填
"oth_task_id": "{{$guid}}", //第三方任务单号，唯一值，必填
"generate_mode": "1", //生成方式:1.按货品信息生成、2.模拟条码扫码生成
"owner_code": "OWNER", //货主编码
"receipt_order_date": "2026-07-08 00:00:00.000", //入库单日期，必填
"order_type": "01", //业务类型，必填，提供：01=进货入库，05=托外加工入库，默认为01
"transfer_bilid": "HLTI", //转入单据别
"transfer_bilno": "HLTI20260708113046", //转入单号，转入单号一般是业务单号
"warehouse_code": "CTU1", //仓库编码，必填
"department": "00000000", //部门，必填
"supplier_code": "G001", //厂商代号
"supplier_name": "G001供应商", //厂商名称
"operator_code": "1002", //制单人，必填
"operate_time": "2026-07-02 11:30:51.000", //制单时间，必填
"last_modified_date": "",
"remark": "rem-第三方收货", //备注
"extend_props": {} //扩展属性
},
"order_lines": [
{
"item_code": "13001", //货品代号，必填
"item_name": "货品-13001", //货品名称，必填
"sku_property": "0101", //货品特征
"batch_code": "P20260708095128", //批号
"qty": 20, //数量，必填
"qty1": 40, //数量(副)
"transfer_bilid": "HLTI", //转入单据别
"transfer_bilno": "HLTI20260708095128", //转入单号，转入单号一般是业务单号
"transfer_bilitm": "1", //转入单项次
"remark": "testAAA", //备注
"extend_props": {} //扩展属性
},
{
"item_code": "13001", //货品代号，必填
"item_name": "货品-13001", //货品名称，必填
"sku_property": "0101", //货品特征
"batch_code": "P20260708095128", //批号
"qty": 40, //数量，必填
"qty1": 80, //数量(副)
"transfer_bilid": "HLTI", //转入单据别
"transfer_bilno": "HLTI20260708095128", //转入单号，转入单号一般是业务单号
"transfer_bilitm": "2", //转入单项次
"remark": "testBBB", //备注
"extend_props": {} //扩展属性
}
]
}

四、返回JSON范例

{
"entry_confirm_code": "SH260708000001",
"code": 0,
"message": "新增成功",
"oth_task_id": "d33a53f9-4ce3-4d18-9749-50121ef09988"
}

五、接口处理

WMS根据以上接口自动产生了【收货单】，如下图所示：