新增条码接口
一、说明
1、主要用于第三方系统想要通过此接口新增AI-WMS PLUS的相关条码信息，如货品条码、箱条码、序列号，目前该接口支持此三种条码的新增。
2、在调用此接口时，会根据登录接口的授权用户，以及当前接口的type_id（条码类型），到【单据属性设定】中读取对应单据的属性信息，当属性的“打印设定”=生成标签并打印时，在新增条码时会同时产生条码打印任务。
- 当“type_id”=@BC，则读取【WEB管理】->【仓储管理】->【打印管理(Web)】->【货品条码标签打印】的属性；
- 当“type_id”=@BB，则读取【WEB管理】->【仓储管理】->【打印管理(Web)】->【箱条码标签打印】的属性；
- 当“type_id”=@BR，则读取【WEB管理】->【仓储管理】->【打印管理(Web)】->【序列号标签打印】的属性。
二、参数说明
1、请求方式
| 请求方式 | POST | |||||
| 接口地址 | http://服务器IP或机器名或域名/WMS/API/SYS/AddBarcodes | |||||
| 格式 | 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 |
|
operate_time |
制单时间 |
Datatime |
|
是 |
制单时间，精确到秒 |
|
extend_props |
扩展属性 |
|
|
|
|
|
barcollect<条码明细> |
|||||
|
type_id |
条码类型 |
String |
10 |
是 |
条码前缀： @BB为箱条码、@BC为货品条码、@BR为序列号 |
|
barcode |
条码 |
String |
80 |
是 |
即条码，可去掉前缀开头，也可不去掉 |
|
warehouse_code |
仓库 |
String |
30 |
|
当条码已入库，则赋对应的仓库代号，如未入库，则该参数为空 |
|
item_code |
货品代号 |
String |
50 |
是 |
货品代号 |
|
sku_property |
特征 |
String |
255 |
|
货品特征值 |
|
batch_code |
批号 |
String |
40 |
|
批号 |
|
qty |
数量 |
Float |
|
是 |
数量 |
|
qty1 |
数量(副) |
Float |
|
|
数量(副) |
|
bil_id |
来源单据别 |
String |
10 |
|
来源单据别 |
|
bil_no |
来源单号 |
String |
100 |
|
来源单号 |
|
bil_itm |
来源单项次 |
int |
|
|
来源单项次 |
|
valid_date |
有效日期 |
Datatime |
|
|
|
|
sc_date |
生产日期 |
Datatime |
|
|
|
|
extend_props |
扩展属性 |
|
|
|
|
4、返回参数
|
字段 |
字段名 |
字段类型 |
必填 |
说明 |
|
|
code |
处理结果 |
|
|
0视为成功，其他视为失败 |
|
|
message |
处理说明 |
|
|
|
|
|
oth_task_id |
第三方任务 ID |
String |
|
|
|
|
data<条码明细> |
|||||
|
type_id |
条码类型 |
是 |
条码前缀： @BB为箱条码、@BC为货品条码、@BR为序列号 |
||
|
barcode |
条码 |
是 |
即条码 |
||
|
warehouse_code |
仓库 |
|
当条码已入库，则赋对应的仓库代号，如未入库，则该参数为空 |
||
|
item_code |
货品代号 |
是 |
货品代号 |
||
|
sku_property |
特征 |
|
货品特征值 |
||
|
batch_code |
批号 |
|
批号 |
||
|
qty |
数量 |
是 |
数量 |
||
|
qty1 |
数量(副) |
|
数量(副) |
||
|
bil_id |
来源单据别 |
|
来源单据别 |
||
|
bil_no |
来源单号 |
|
来源单号 |
||
|
bil_itm |
来源单项次 |
|
来源单项次 |
||
| valid_date |
有效日期 |
|
|
||
| sc_date |
生产日期 |
|
|
||
三、请求JSON范例
{
"taskinfobar": {
"ref_id": "MES", //第三方系统标识，必填
"oth_task_id": "{{$guid}}", //第三方任务单号，唯一值，必填
"operate_time": "2024-01-26 09:16:00", //操作时间，必填
"extend_props": {} //扩展属性
},
"barcollect": [
{
"type_id": "@BC", //支持序列号、箱条码、条码，即@BR、@BB、@BC
"barcode": "00082401260001", //即扫描的条码，必填
"warehouse_code": "", //即当前工位仓库代号,必填
"item_code": "0008", //即货品代号，必填
"sku_property": "", //空
"batch_code": "2401260001", //即批号
"qty":10, //即数量，必填
"qty1":20, //即数量(副）
"bil_id": "PO", //即来源单据别
"bil_no": "PO20250501001", //即来源单号
"bil_itm":1,
"extend_props": {} //扩展属性
}
]
}
四、返回JSON范例
{
"barcollect": [
{
"owner_code": "OWNER",
"type_id": "@BC",
"barcode": "00082401260001",
"warehouse_code": "",
"item_code": "0008",
"sku_property": "",
"batch_code": "2401260001",
"qty": 10.0,
"qty1": 20.0，
"bil_id": "PO", //即来源单据别
"bil_no": "PO20250501001" //即来源单号
"bil_itm":1
}
],
"code": 0,
"message": "新增成功",
"oth_task_id": "645f76bf-b3e9-4871-9bdf-d6c3f4787008"
}