一、说明
1、该接口主要应用于WMS请求设备亮灯或熄灯。
2、该接口由第三方提供及维护，供WMS系统调用。
二、参数说明
1.请求方式
| 请求方式 |
POST |
| 接口地址 |
http://第三方系统API/LightsUp |
| 格式 |
JSON |
| 编码类型 |
UTF-8 |
2.header参数
| Content-Type |
application/json |
3.请求参数
| 序号 |
字段 |
字段名 |
字段类型 |
长度 |
必填 |
说明 |
| 1 |
ref_id |
第三方系统标识 |
string |
10 |
是 |
自定义一个系统标识 |
| 2 |
task_id |
第三方任务单号 |
string |
100 |
是 |
任务唯一ID |
| [点亮/熄灯明细]datas |
| 1 |
device_id |
控制器ID |
string |
30 |
|
“控制器ID”与“IP地址”任意栏位必须有值 |
| 2 |
ip |
IP地址 |
string |
80 |
|
“控制器ID”与“IP地址”任意栏位必须有值 |
| 3 |
port |
端口号 |
int |
|
|
|
| 4 |
label |
电子标签id |
string |
60 |
是 |
电子标签id |
| 5 |
lights_color |
灯色 |
int |
|
是 |
灯色，值含义：0-灭灯，1-红，2-绿，3-蓝 |
| 6 |
qty1 |
数显区1 |
int |
|
|
|
| 7 |
qty2 |
数显区2 |
int |
|
|
|
| 8 |
relate_lighthouse |
关联灯塔 |
bool |
|
|
|
| [储位货品信息]details |
当灯色=1、2、3时才有值 |
| 1 |
warehouse_code |
仓库代号 |
String |
30 |
|
|
| 2 |
warehouse_name |
仓库名称 |
String |
200 |
|
|
| 3 |
storage_code |
储位代号 |
String |
60 |
|
|
| 4 |
storage_name |
储位名称 |
String |
100 |
|
|
| 5 |
item_code |
货品代号 |
String |
50 |
|
|
| 6 |
item_name |
货品名称 |
String |
160 |
|
|
| 7 |
short_name |
货品简称 |
String |
100 |
|
|
| 8 |
sku_property |
货品特征 |
String |
255 |
|
|
| 9 |
specifications |
货品规格 |
String |
0 |
|
|
| 10 |
english_name |
货品英文名称 |
String |
200 |
|
|
| 11 |
batch_code |
批号 |
String |
40 |
|
|
| 12 |
valid_date |
有效日期 |
datatime |
0 |
|
|
| 13 |
latest_entry_date |
最近入库日 |
datatime |
0 |
|
|
| 14 |
unit_name |
单位 |
string |
8 |
|
|
| 15 |
unit_name1 |
单位（ 副 ） |
string |
10 |
|
|
| 16 |
qty |
数量 |
float |
0 |
|
|
| 17 |
qty1 |
数量 （ 副 ） |
float |
0 |
|
|
| 18 |
bil_no |
来源单号 |
String |
100 |
|
|
| 19 |
request_code |
申请单号 |
String |
100 |
|
|
| 20 |
source_bilno |
业务单号 |
String |
100 |
|
|
4.返回参数
| 序号 |
字段 |
字段名 |
字段类型 |
说明 |
| 1 |
code |
执行状态 |
string |
0为成功，其他视为失败 |
| 2 |
message |
错误说明 |
string |
|
| 3 |
task_id |
第三方任务单号 |
string |
任务唯一ID |
| [处理明细]datas |
| 1 |
device_id |
控制器ID |
string |
|
| 2 |
ip |
IP地址 |
string |
|
| 3 |
port |
端口号 |
int |
|
| 4 |
label |
电子标签ID |
string |
电子标签id |
| 5 |
code |
执行状态 |
string |
0为成功，其他视为失败 |
| 6 |
message |
错误说明 |
string |
|
三、请求JSON示例
{
"ref_id": "AI-WMS PLUS",
"task_id": "95a24351-33ae-4c5c-9fbb-86accb6d4a33",
"datas": [
{
"device_id": "PTL02",
"ip": "192.168.2.66",
"port": "8010",
"label": "PTL1-01-01-01",
"lights_color": 2,
"qty1": null,
"qty2": null,
"relate_lighthouse": false,
"details": [
{
"warehouse_code": "PTL1",
"warehouse_name": "PTL1仓库",
"storage_code": "PTL1-01-01-01",
"storage_name": "PTL1-01-01-01",
"item_code": "001",
"item_name": "手机支架",
"short_name": "手机支架",
"sku_property": "",
"specifications": "30*50",
"english_name": "",
"batch_code": "",
"valid_date": null,
"latest_entry_date": "2024-03-10 00:00:00",
"unit_name": "个",
"unit_name1": "",
"qty": 100.000000000,
"qty1": 0.000000000,
"bil_no": "",
"request_code": "",
"source_bilno": ""
},
{
"warehouse_code": "PTL1",
"warehouse_name": "PTL1仓库",
"storage_code": "PTL1-01-01-01",
"storage_name": "PTL1-01-01-01",
"item_code": "002",
"item_name": "钢化膜",
"short_name": "钢化膜",
"sku_property": "",
"specifications": "",
"english_name": "",
"batch_code": "",
"valid_date": null,
"latest_entry_date": null,
"unit_name": "张",
"unit_name1": "",
"qty": 800.000000000,
"qty1": 0.000000000,
"bil_no": "",
"request_code": "",
"source_bilno": ""
}
]
}
]
}
四、返回结果示例
{
"code": 0,
"message": "",
"task_id": "95a24351-33ae-4c5c-9fbb-86accb6d4a33",
"datas": [
{
"device_id": "PTL02",
"ip": "192.168.2.66",
"port": 8010,
"label": "PTL1-01-01-01",
"code": 0,
"message": ""
}
]
}