【修改容器装箱作业】接口

一、说明

  • 该接口主要给第三方调用,修改容器表身条码信息,即删除或追加容器表身条件信息;
  • 不能修改容器表头内容;
  • 该接口会读取授权用户的【单据属性设定】-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"
}