山推ERP接口
## 山推ERP对接接口
```
请求地址:域名/api/index/
[临时地址](http://59.110.167.234:8888/api/index/)
```
### 公共请求参数
| 参数名 | 类型 | 说明 | 是否必填 |
|--------|-----|------|---------|
| _handle| string | 固定值(PushPage)| 是 |
### 新整机录入接口
|参数名|类型|说明|是否必填|
|------|----|----|-------|
|_method|string|固定值(BandVcl)|是|
|vclId|string|装备号|是|
|terminalId|string|终端号|否|
|versionCode|string|若车辆版本号不相同,则更新版本号|否|
|largeCode|string|装备类型编号|否|
|largeName|string|未使用|否|
|middleCode|string|装备型号|否|
|middleName|string|未使用|否|
|smallCode|string|未使用|否|
|smallName|string|未使用|否|
|operateDate|string|装机时间|否|
|autoTest|string|自动测试(0、1、2)|否|
|relationId|string|山推旧系统装备关系ID|否|
### 设备状态变更接口
|参数名|类型|说明|是否必填|
|------|----|----|-------|
|_method|string|固定值(ChangeDeviceStatus)|是|
|vehicleNo|string|装备号|是|
|terminalId|string|终端号|否|
|changeDate|string|变化时间|否|
|option|string|操作参数:|否|
|status|string|设备状态|否|
|transportWay|string|未使用|否|
|customerNo|string|客户编号|否|
|agentNo|string|代理商编号|否|
|agentAddress|string|未使用|否|
|endUserName|string|最终用户姓名|否|
|endUserPhone|string|最终用户电话|否|
### GPS终端更换信息接口
|参数名|类型|说明|是否必填|
|------|----|----|------|
|_method|string|固定值(UpdateTerminalInfo)|是|
|vehicleNo|string|装备号|是|
|updateDate|string|变更时间|否|
|terminalNo|string|终端号|是|
|simNo|string|卡号|否|
### 在保状态接口
|参数名|类型|说明|是否必填|
|------|-----|----|-----|
|_method|string|固定值(ChangeGuaranteeStatus)|是|
|vehicleNo|string|装备号|是|
|expireDate|string|出保时间|否|
|changeDate|string|变更时间|是|
|status|string|状态 0:出保;1:在保|否|
### 终端客户信息接口
|参数名|类型|说明|是否必填|
|------|-----|----|-----|
|_method|string|固定值(EndCustomer)|是|
|vehicleNo|string|装备号|是|
|customerNo|string|客户编号|是|
|customerName|string|客户名称|是|
|purchaseDate|string|购买时间|否|
|agentNo|string|代理商编号|是|
|mobile|string|客户手机号|否|
|phoneNo|string|电话号码|否|
|address|string|地址|否|
|postCode|string|邮编|否|
|idCard|string|身份证号|否|
|changeDate|string|变更时间|否|
### 保养记录接口
|参数名|类型|说明|是否必填|
|------|-----|----|-----|
|_method|string|固定值(MaintainRecord)|是|
|billNo|string|保养单号|否|
|vclNum|string|装备号|是|
|serviceAgentCode|string|代理商编号|否|
|serviceAgent|string|未使用|否|
|operName|string|操作人|是|
|operTime|string|保养时间|否|
|serviceType|string|服务类型|是|
|maintainItem|string|保养周期|是|
|maintainDesc|string|保养描述|否|
|operTotalWorkHours|string|保养工时|是|
### 服务代理公司变更接口
|参数名|类型|说明|是否必填|
|------|-----|----|-----|
|_method|string|固定值(ChangeServiceAgent)|是|
|vehicleNo|string|装备号|是|
|changeDate|string|更换时间|否|
|agentNo|string|代理商编号|否|
### 解锁车接口
|参数名|类型|说明|是否必填|
|------|-----|----|-----|
|_method|string|固定值(InstallTest)|是|
|xy_id|string|xy_sys_equipment_test 里面的xy_id|是|
|xy_option|string| lock是锁车 unlock 解锁|是|
### 删除装机测试接口
|参数名|类型|说明|是否必填|
|------|-----|----|-----|
|_method|string|固定值(RemoveInstallTest)|是|
|xy_id|string|装机测试列表里面的xy_id|是|
### 请求响应
``` json
{
"code":0,//0 接收失败 1接收成功
"msg":"",
"data":""
}
```
### 获取装机测试接口
|参数名|类型|说明|是否必填|
|------|-----|----|-----|
|_method|string|固定值(GetInstallTest)|是|
### 请求响应
``` json
{
"code":0,//0 失败 1成功
"msg":"错误信息",//
"data":[{
"xy_id":1000,//装备主键
"xy_equipment_code":"CHSRA26ALNC000263",//装备名称
"xy_client_code":"1150122010078",//终端名称
"xy_test_time":"2022-04-27 08:32:03.514",//装机测试时间
"xy_test_state":"等待开机",//装机测试状态
"xy_startup_msg":"0",//[开机信息] xy_startup_msg 0 代表测试未通过 1代表测试通过
"xy_startup_params":"0",//[开机参数] xy_startup_params 0 代表测试未通过 1代表测试通过
"xy_lock":"0",//[锁车报告] xy_lock 0 代表测试未通过 1代表测试通过
"xy_unlock":"1",//[解锁报告] xy_unlock 0 代表测试未通过 1代表测试通过
"xy_location":"1",//[位置报告] xy_location 0 代表测试未通过 1代表测试通过
"xy_alarm":"0",//[位置报告] xy_alarm 0 代表测试未通过 1代表测试通过
}]
}
```