【修改容器装箱作业】接口
一、说明
- 该接口主要给第三方调用,修改容器表身条码信息,即删除或追加容器表身条件信息;
- 不能修改容器表头内容;
- 该接口会读取授权用户的【单据属性设定】-PDA-【物流容器装箱作业(未入库)】属性、 【物流容器装箱作业(已入库)】属性的控制 ;
- 执行成功此接口,会同时变更【容器装箱作业历史表】;
- 执行此接口,可在AI-WMS PLUS系统查看接口记录, 如果执行成功,可在【第三方调用明细表】查看;如果执行失败,可在【第三方调用历史表】查看失败原因。
二、参数说明
1、请求方式
| 请求方式 | POST | |||||
| 接口地址 | http://服务器IP或机器名或域名/WMS/API/SYS/ChangeContainer | |||||
| 格式 | JSON | |||||
| 编码类型 | UTF-8 | |||||
2、header参数
| KEY | VALUE | |||||
| Content-Type | application/json | |||||
| Authorization | token值 | 说明:授权接口所获取的值 | ||||
3、请求参数
|
字段 |
字段名 |
字段类型 |
长度 |
必填 |
说明 |
|
表头信息taskinfo{…} |
|||||
|
ref_id |
第三方系统标识 |
String |
20 |
是 |
自定义一个系统标识,如MES |
|
oth_task_id |
第三方任务单号 |
String |
10 |
是 |
任务唯一ID |
| contain_code |
容器条码 |
String |
200 |
是 |
可带前缀,也可不带 |
|
operate_time |
制单时间 |
Datatime |
|
是 |
|
|
表身装箱条码信息barcollect[…] |
|||||
|
operate_type |
操作类型 |
String |
1 |
是 |
值有D或I,D删除条码、I追加条码 |
|
barcode |
条码 |
String |
200 |
是 |
可包含前缀,如@BB,也可无前缀 |
|
barcode_type |
容器内条码类型 |
String |
1 |
是 |
目前值包含有:0.序列号 1.箱序列号 2.条码 3.箱条码 |
|
rk_no |
入库业务单号 |
String |
100 |
|
当不为空且操作类型=追加条码时,则此值写入容器表身,否则根据属性[入库业务单取条码来源单号写入]来处理 |
|
qty |
容器条码数量 |
int |
10 |
是 |
必填,不能为空或NULL,必须为0或其他,当操作类型=追加条码时,则0.序列号 1.箱序列号 3.箱条码时,默认为1,2.条码时,为实际数量 |
4、返回参数
| 字段 | 字段名 | 字段类型 | 长度 | 说明 |
| code | 成功标识 | string | 10 | 返回0则表示成功,其他则为失败 |
| message | 返回信息 | string | 200 | |
| oth_task_id | 第三方任务ID | string | 100 |
三、请求JSON范例
{
"taskinfo": {
"ref_id": "MES", //第三方系统标识,如MES
"oth_task_id": "{{$guid}}", //第三方任务代号,必须唯一
"contain_code": "@RQT10030", //容器条码,可带@RQ,也可不带;
"operate_time": "{{DATA}}"
},
"barcollect": [
{
"operate_type": "I", //操作类型:D删除条码、I追加条码;
"barcode": "T300101CFX01SS26031000100001", //条码必须在系统存在,可带前缀,也可不带
"barcode_type": "3", //容器内条码类型,必填,目前值包含有:0.序列号 1.箱序列号 2.条码 3.箱条码
"rk_no": "", //入库业务单号;当不为空且操作类型=追加条码时,则此值写入容器表身,否则根据属性[入库业务单取条码来源单号写入]来处理;
"qty": 1 //容器条码数量,必填,不能为空或NULL,必须为0或其他,当操作类型=追加条码时,则0.序列号 1.箱序列号 3.箱条码时,默认为1,2.条码时,为实际数量;
}
]
}
四、返回JSON范例
{
"code": 0,
"message": "修改成功",
"oth_task_id": "e22a3bc0-9682-48c4-a9a7-48d974dd2441"
}