箱条码拆分接口
一、说明
主要用于第三方系统想要通过此接口将AI-WMS PLUS的箱条码信息进行拆分，即原【箱条码拆分作业】功能，则可调此接口对箱条码进行拆分。
二、参数说明
1、请求方式
| 请求方式 | POST | |||||
| 接口地址 | http://服务器IP或机器名或域名/WMS/API/SYS/BreakUpBox | |||||
| 格式 | JSON | |||||
| 编码类型 | UTF-8 | |||||
2、header参数
| KEY | VALUE | |||||
| Content-Type | application/json | |||||
| Authorization | token值 | 说明：授权接口所获取的值 | ||||
3、请求参数
|
字段 |
字段名 |
字段类型 |
长度 |
必填 |
说明 |
|
ref_id |
第三方系统标识 |
String |
20 |
是 |
自定义一个系统标识，如MES |
|
oth_task_id |
第三方任务单号 |
String |
10 |
是 |
任务唯一ID |
|
box_code |
旧箱码 |
String |
200 |
是 |
旧箱码 |
|
qty |
旧箱码数量 |
Float |
|
是 |
即旧箱码拆分前数量 |
|
box_count |
拆分箱数 |
Float |
|
是 |
即一箱拆成N箱，值必须为大于1的正整数 |
|
process_mode |
旧箱码处理 |
String |
1 |
是 |
1旧箱码继续使用，2旧箱码停用 |
|
operate_time |
制单时间 |
Datatime |
|
是 |
制单时间，精确到秒 |
|
data<拆分明细> |
|||||
|
box_code |
条码 |
String |
80 |
是 |
即箱条码，可去掉前缀@BB开头，也可不去掉 |
|
qty |
数量 |
Float |
|
是 |
数量 |
|
qty1 |
数量(副) |
Float |
|
|
数量(副) |
4、返回参数
|
字段 |
字段名 |
说明 |
|
code |
处理结果 |
0视为成功，其他视为失败 |
|
message |
处理说明 |
|
|
oth_task_id |
第三方任务 ID |
三、请求JSON范例
{
"ref_id": "MES", //第三方系统标识，必填
"oth_task_id": "{{$guid}}", //第三方任务单号，唯一值，必填
"box_code": "00082401260002001", //旧箱码
"qty": "10", //旧箱条码拆分前数量
"box_count": "2", //即一箱拆成N箱，值必须为大于1的正整数
"process_mode": "1", //1表示旧箱码继续使用，2表示旧箱码停用
"operate_time": "2023-01-25 10:00:00", //制单时间，必填
"data": [ //拆分后箱码明细
{
"box_code": "00082401260002001", //旧箱码
"qty":6, //当旧箱码继续使用时，则旧箱码也需要在LIST里面体现，数量为拆分后剩余数量；
"qty1":12 //数量（副）；
},
{
"box_code": "00082401260002002", //新箱码
"qty":4, //新箱码数量
"qty1":8 //数量（副）；
}
]
}
四、返回JSON范例
{
"code": 0,
"message": "箱条码拆分成功",
"oth_task_id": "e22a3bc0-9682-48c4-a9a7-48d974dd2441"
}