箱条码变更接口
一、说明
- 第三方可通过调用该接口来变更箱条码的信息；
- 目前可支持变更：仓库、来源单据ID、来源单号、来源单项次、数量、数量（副）、自定义字段；
- 支持更新箱条码的停用状态。
二、参数说明
1、请求方式
| 请求方式 | POST | |||||
| 接口地址 | http://服务器IP或机器名或域名/WMS/API/SYS/ChangeBarcodeBox | |||||
| 格式 | 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 |
|
是 |
|
|
barcodelist[ ]变更箱明细 |
|||||
|
owner_code |
货主编码 |
String |
30 |
是 |
未启用多货主时，固定为OWNER |
|
box_no |
箱条码 |
String |
200 |
是 |
可包含前缀，如@BB，也可无前缀 |
|
type_id |
变更方式 |
int |
|
是 |
1表示变更，2表示停用 |
|
warehouse_code |
仓库代号 |
String |
30 |
|
当不变更该参数时，则传null(小写），反之，则视为变更该参数值 |
|
bil_id |
来源单ID |
String |
10 |
|
当不变更该参数时，则传null(小写），反之，则视为变更该参数值 |
| bil_no |
来源单号 |
String |
100 |
|
当不变更该参数时，则传null(小写），反之，则视为变更该参数值 |
|
bil_itm |
来源单项次 |
int |
|
|
当不变更该参数时，则传null(小写），反之，则视为变更该参数值 |
|
qty |
数量 |
Float |
|
|
当不变更该参数时，则传null(小写），反之，则视为变更该参数值 |
|
qty1 |
数量（副） |
Float |
|
|
当不变更该参数时，则传null(小写），反之，则视为变更该参数值 |
|
extend_props |
扩展属性 |
|
|
|
自定义栏位等 |
4、返回参数
| 字段 | 字段名 | 字段类型 | 长度 | 说明 |
| code | 成功标识 | string | 10 | 返回0则表示成功，其他则为失败 |
| message | 返回信息 | string | 200 | |
| oth_task_id | 第三方任务ID | string | 100 |
三、请求JSON范例
{
"ref_id": "MES", //第三方系统标识，必填
"oth_task_id": "{{$guid}}", //第三方任务单号，唯一值，必填
"operate_time": "{{DATA}}", //制单时间，必填
"barcodelist": [ //变更箱明细
{
"owner_code": "OWNER", //必填，货主编码，未启用多货主时，则默认为OWNER，反之，则传货主编码
"box_no": "1001100125071101003", //必填，箱条码
"type_id": "1", //必填，变更方式:1变更，2停用
"warehouse_code":null, //当不变更该参数时，则传null(小写），反之，则视为变更该参数值；
"bil_id":"AA", //当不变更该参数时，则传null(小写），反之，则视为变更该参数值
"bil_no":"AAAAAA", //当不变更该参数时，则传null(小写），反之，则视为变更该参数值
"bil_itm":"1", //当不变更该参数时，则传null(小写），反之，则视为变更该参数值
"qty": 32, //当不变更该参数时，则传null(小写），反之，则视为变更该参数值
"qty1": 0, //当不变更该参数时，则传null(小写），反之，则视为变更该参数值
"extend_props": {
"a1": "01", //自定义字段
"a2": "02" //自定义字段
}
}
]
}
四、返回JSON范例
{
"code": 0,
"message": "箱条码变更成功",
"oth_task_id": "e22a3bc0-9682-48c4-a9a7-48d974dd2441"
}