【新增车间领补料出库】接口
一、说明
主要用于第三方系统将其相关的车间领、补料信息，通过调用AI-WMS PLUS的【新增车间领补料出库】接口，从而生成AI-WMS PLUS系统的【出库单】。
二、参数说明
1、请求方式
| 请求方式 | POST | |||||
| 接口地址 | http://服务器IP或机器名或域名/WMS/API/SYS/CreateMaterialOutbound | |||||
| 格式 | JSON | |||||
| 编码类型 | UTF-8 | |||||
2、header参数
| KEY | VALUE | |||||
| Content-Type | application/json | |||||
| Authorization | token值 | 说明：授权接口所获取的值 | ||||
3、请求参数
|
字段 |
字段名 |
字段类型 |
长度 |
必填 |
说明 |
|
<表头：material_outbound> |
|||||
|
ref_id |
第三方系统标识 |
String |
20 |
是 |
自定义一个系统标识，如MES |
|
oth_task_id |
第三方任务单号 |
String |
100 |
是 |
任务唯一ID，如MES系统的领料单号、补料单号 |
|
generate_mode |
生成单据方式 |
String |
10 |
是 |
1.按货品信息生成、2.模拟条码扫码生成 |
|
delivery_order_date |
出库单日期 |
Datatime |
|
是 |
单据日期，精确到日 |
|
manufacture_code |
制令单号 |
String |
100 |
是 |
制令单号 |
|
process_code |
工序代号 |
String |
10 |
|
制程代号 |
|
production_notice_code |
生产通知单号 |
String |
100 |
|
通知单号 |
|
warehouse_code |
仓库编码 |
String |
30 |
是 |
仓库代号 |
|
owner_code |
货主编码 |
string |
30 |
|
未启用货主编码时，默认为空或OWNER； 启用多货主编码时，则需传货主编码； |
|
order_type |
业务类型 |
String |
10 |
是 |
提供类型： |
|
department |
部门 |
String |
30 |
是 |
|
|
bill_type |
单据类别 |
String |
10 |
|
|
|
operator_code |
制单人 |
String |
30 |
是 |
制单人 |
|
operate_time |
制单时间 |
Datatime |
|
是 |
制单时间，精确到秒 |
|
last_modified_date |
最近修改时间 |
Datatime |
|
|
|
|
remark |
备注 |
String |
|
|
|
|
total_order_lines |
单据总行数 |
int |
|
|
|
|
extend_props |
扩展属性 |
|
|
|
|
|
<表身明细：order_lines，当“生成单据方式”=1按货品信息生成，则按下面参数赋值> |
|||||
|
item_code |
货品代号 |
String |
50 |
是 |
货品代号 |
|
item_name |
货品名称 |
String |
160 |
是 |
货品名称 |
|
sku_property |
特征 |
String |
255 |
|
货品特征值 |
|
batch_code |
批号 |
String |
40 |
|
批号 |
|
storage_code |
储位代号 |
String |
60 |
|
|
|
qty |
数量 |
Float |
|
是 |
数量 |
|
qty1 |
数量(副) |
Float |
|
|
数量(副) |
|
remark |
备注 |
String |
|
|
|
|
extend_props |
扩展属性 |
|
|
|
|
|
<表身明细：order_lines，当“生成单据方式”=2模拟条码扫码生成，则按下面参数赋值> |
|||||
|
barcode |
条码 |
String |
80 |
是 |
即带前缀的条码，如@BB、@BC、@BR、@RQ开头的条码 |
| storage_code |
储位代号 |
String |
60 |
|
|
|
break_up_flag |
散出标记 |
String |
1 |
|
当为箱码时，则栏位必须赋值，T为散出，F为整出； |
|
qty |
数量 |
Float |
|
是 |
当为箱码时，散出标记=T，则数量为散出数量；当散出标记=F时，则数量默认为1； |
|
valid_date |
有效日期 |
Datatime |
|
|
|
|
sc_date |
生产日期 |
Datatime |
|
|
|
4、返回参数
|
字段 |
字段名 |
字段类型 |
长度 |
必填 |
说明 |
|
code |
处理结果 |
|
|
|
0视为成功，其他视为失败 |
|
message |
处理说明 |
|
|
|
|
|
oth_task_id |
第三方任务 ID |
String |
100 |
|
|
|
delivery_order_code |
WMS出库单号 |
String |
100 |
|
三、请求JSON范例
1、按货品信息生成方式
{
"material_outbound": {
"ref_id": "MES", //第三方系统标识，必填
"oth_task_id": "{{$guid}}", //第三方任务单号，唯一值，必填
"generate_mode": "1", //生成单据方式
"delivery_order_date": "2024-01-26", //单据日期，必填
"manufacture_code": "MO41240001", //制令单号，必填
"process_code": "", //工序代号
"production_notice_code": "", //生产通知单号
"owner_code": "OWNER", //货主编码
"warehouse_code": "A1", //仓库编码，必填
"department": "00000000", //部门，必填
"bill_type": "", //单据类别
"order_type": "05", //业务类型，05=生产领料出库、06=生产补料出库
"operator_code": "1001", //制单人，必填
"operate_time": "2024-01-26 10:22:51", //制单时间，必填
"last_modified_date": "", //最近修改时间
"remark": "rem-MO41240001", //备注
"total_order_lines": "2", //单据总行数
"extend_props": {} //扩展属性
},
"order_lines": [
{
"item_code": "0008", //货品代号，必填
"item_name": "批号货品0008", //货品名称，必填
"storage_code":"", //储位代号
"sku_property": "", //货品特征
"batch_code": "240126CA", //批号
"qty": 10, //数量，必填
"qty1": 20, //数量(副)
"remark": "test", //备注
"extend_props": {} //扩展属性
}
]
}
2、模拟条码扫描生成方式
{
"material_outbound": {
"ref_id": "MES", //第三方系统标识，必填
"oth_task_id": "{{$guid}}", //第三方任务单号，唯一值，必填
"generate_mode": "2", //生成单据方式
"delivery_order_date": "2024-01-26", //单据日期，必填
"manufacture_code": "MO41240001", //制令单号，必填
"process_code": "", //工序代号
"production_notice_code": "", //生产通知单号
"owner_code": "OWNER", //货主编码
"warehouse_code": "A1", //仓库编码，必填
"department": "00000000", //部门，必填
"bill_type": "", //单据类别
"order_type": "05", //业务类型，05=生产领料出库、06=生产补料出库
"operator_code": "1001", //制单人，必填
"operate_time": "2024-01-26 10:22:51", //制单时间，必填
"last_modified_date": "", //最近修改时间
"remark": "rem-领料出库", //备注
"total_order_lines": "1", //单据总行数
"extend_props": {} //扩展属性
},
"order_lines": [
{
"barcode": "@BC000824012605", //前缀为@BB为箱码
"storage_code":"", //储位代号
"valid_date":"", //有效日期
"sc_date":"", //生产日期
"break_up_flag": "F", //当为箱码时，则栏位必须赋值，T为散出，F为整出;
"qty": "10" //扫描数量默认为1；
}
]
}
四、返回JSON范例
{
"delivery_order_code": "CK240126000004",
"code": 0,
"message": "新增成功",
"oth_task_id": "e7995af1-4e73-4283-8111-d27960b05947"
}