新增容器条码接口 – AI-WMS PLUS 标准API平台

一、说明

二、参数说明

三、请求JSON范例

四、返回JSON范例

1、请求方式

2、header参数

3、请求参数

4、返回参数

主要用于第三方系统通过调用AI-WMS PLUS的【新增容器条码】接口，从而生成AI-WMS PLUS系统的【物流容器条码标签】。

支持各种条码类型（货品条码、箱条码、外箱条码、序列号、箱序列号）；
支持未入库装箱、已入库未上架装箱，但不支持补货入库装箱、不支持备货装箱、不支持已入库上架装箱。

版本说明：适合2025年03月11月之后的5.0版本

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

字段	字段名	字段类型	长度	必填	说明
taskinfo
ref_id	第三方系统标识	string	20	是	第三方系统标识，如MES
oth_task_id	第三方任务单号	string	100	是	第三方任务代号，必须唯一；
owner_code	货主编码	string	30		当启用多货主管理时，则为必填；
contain_code	容器条码	string	100	是	容器条码，可带@RQ，也可不带
warehouse_code	仓库代号	string	30		空视为未入库；非空则视为已入库；
auto_create_contain	自动产生容器条码	string	1		当容器条码不在WMS系统中产生时使用；需要自动产生，则赋值为T，反之则为F，空视为F，注意，为F时容器条码在WMS系统必须存在。
contain_type	容器类型	string	30		当“自动产生容器条码”=T时，则栏位如未赋值，则默认产生的容器条码为托盘；如需要区分，则需赋值；
operate_time	操作时间	Datatime		是	精确到秒；（即制单时间）
barcollect
barcode_type	条码类型	string	1	是	即容器内条码类型：0.序列号 1.箱序列号 2.条码 3.箱条码；
barcode	条码	string	200	是	1、支持无前缀与有前缀； 2、条码必须存在于系统中。
qty	数量	float		是	当条码类型=0.序列号 1.箱序列号 3.箱条码时，默认为1；
rk_no	入库业务单号	string	100		有值则以该值写入容器表身，否则根据用户的属性【入库业务单取条码来源单号写入】来处理

字段代号	字段名称	字段类型	长度	必填	说明
code	成功标记	String	10	是	返回0则表示成功，其他则为失败
message	返回信息	String	200
oth_task_id	第三方任务代号	String	100

{
"taskinfo": {
"ref_id": "MES", //第三方系统标识，如MES
"oth_task_id": "{{$guid}}", //第三方任务代号，必须唯一
"owner_code": "", //货主编码
"contain_code": "@RQTP000001", //容器条码，可带@RQ，也可不带；
"warehouse_code": "", //仓库，已入库则赋值仓库代号、未入库则为空；
"auto_create_contain": "T", //当容器条码不在WMS系统需要自动产生，则该值为T，反之为F，当为F时容器条码在WMS系统必须存在；
"contain_type": "01", //当“自动产生容器条码”=T时，若不传值，则默认取系统“托盘”类型；如需要区分，则需赋值；
"operate_time": "2025-03-11 13:51:53.557"
},
"barcollect": [
{
"barcode_type": "2", //即容器内条码类型：0.序列号 1.箱序列号 2.条码 3.箱条码 ；
"barcode": "@BC1001250311007", //条码必须在系统存在
"qty":10, //当条码类型=0.序列号 1.箱序列号 3.箱条码时，默认为1；
"rk_no": "MO53110007" //入库业务单号；当参数不为空时，以此值写入容器表身，否则根据属性的【入库业务单取条码来源单号写入】来处理；
}
]
}

http://服务器IP或机器名或域名/WMS/API/SYS/AddContainRequest

{
"code": 0,
"message": "新增成功",
"oth_task_id": "43cc7803-f1b8-46c6-bdf8-17ab5857311d"
}