VASMS
基础接口
5.0报单
安装时间预测
本文档使用 MrDoc 发布
-
+
首页
5.0报单
**1、提交报单** POST /business/car_loan/v5/createOrder 请求: | 字段 | 描述 | 必填 | 类型 | | -- | -- | -- | -- | | externalVehicleId | 车辆ID | true | String | | externalCustNum | 客户编号 | true | String | | corpId | 报单公司ID | true | Integer | | oaAccout | OA账号 | true | String | | externalSystem | 业务系统标识 | true | String | | externalId | 项目ID | true | String | | contactName | 现场联系人姓名 | | String | | contactMobile | 现场联系人手机号码 | | String | | declarereMark | 报单备注 | | String | | impapplyDate | 申请施工时间 | | String | | impAddress | 施工地址 | | String | | vehicleType | 车辆类型:1=新能源汽车(渐变绿),2=大型新能源汽车(黄绿双拼),3=小型汽车、轻便摩托车(蓝色),4=大型汽车、挂车、教练汽车、普通摩托车、教练摩托车、低速车(黄色),5=领使馆汽车/摩托车、港澳入出境车(黑色) | | Integer | | vehicleCategory | 车辆分类(1=新车,2=二手车,3=资管追回) | | Integer | | model | 车型 | | | | vin | 车架号 | | String | | licenseplateNum | 车牌 | | String | | engineNum | 发动机号 | | String | | price | 车价(元) | | String | | ownerName | 车主姓名 | true | String | | idCard | 身份证 | true | String | | mobile | 电话 | true | String | | addressHome | 家庭住址 | | String | | declareFrom | 报单来源:CARLOAN5.0 | true | String | | platformName | 放款平台 | true | String | | platformId | 放款平台ID | true | String | | loanAmount | 贷款金额 | | String | | wired | 有线设备数量 | true | Integer | | wireless | 无线设备数量 | true | Integer | | notifyUrl | 回调地址:状态通知,POST,无拦截验证 | true | String | | ==custType== | 客户类型:1=畅享客户,优先安装防水无线设备 | false | String | | ==serviceYear== | 服务期限(贷款期限) | true | String | 响应示例 ``` { "externalCustNum": "861015", "externalId": "1787698142251720706", "externalVehicleId": "2874760768088517898", "impVin": "LGBH52E03RY636699", "orderId": "617471", //vasId "orderNo": "NBZH20240508427611",//VAS订单号 "orderStatus": "1",//待派单 "packName": "有线1台+3年服务期",//安装套餐 "wired": 1,//有线设备数量 "wireless": 0,//无线设备数量 "worker": {//安装人信息 "name": "郭鹤军", "phone": "1510000000" }, "clerk": {//派单文员 "name": "派单文员", "phone": "13111111111" }, "onDutyPhone":"4009908228" //24小时值班电话 } ``` **2、自行安装** POST /business/car_loan/v5/customerCreateOrder 请求参数 | 字段 | 描述 | 必填 | 类型 | | -- | -- | -- | -- | | externalVehicleId | 车辆ID | true | String | | externalCustNum | 客户编号 | true | String | | corpId | 报单公司ID | true | Integer | | oaAccout | OA账号 | true | String | | externalSystem | 业务系统标识 | true | String | | externalId | 项目ID | true | String | | contactName | 现场联系人姓名 | | String | | contactMobile | 现场联系人手机号码 | | String | | declarereMark | 报单备注 | | String | | impapplyDate | 申请施工时间 | | String | | impAddress | 施工地址 | | String | | vehicleType | 车辆类型:1=新能源汽车(渐变绿),2=大型新能源汽车(黄绿双拼),3=小型汽车、轻便摩托车(蓝色),4=大型汽车、挂车、教练汽车、普通摩托车、教练摩托车、低速车(黄色),5=领使馆汽车/摩托车、港澳入出境车(黑色) | | Integer | | vehicleCategory | 车辆分类(1=新车,2=二手车,3=资管追回) | | Integer | | model | 车型 | | | | vin | 车架号 | true | String | | licenseplateNum | 车牌 | | String | | engineNum | 发动机号 | | String | | price | 车价(元) | | String | | ownerName | 车主姓名 | true | String | | idCard | 身份证 | true | String | | mobile | 电话 | true | String | | addressHome | 家庭住址 | | String | | declareFrom | 报单来源:CARLOAN5.0 | true | String | | platformName | 放款平台 | true | String | | platformId | 放款平台ID | true | String | | loanAmount | 贷款金额 | | String | | wired | 有线设备数量 | true | Integer | | wireless | 无线设备数量 | true | Integer | | notifyUrl | 回调地址:状态通知,POST,无拦截验证 | true | String | | busiPictures | 车辆照片 | true | List | | -piclink | 照片地址 | true | String | | busiImpdetails | 施工信息 | true | List | | - | 安装位置 | true | String | | -prodnum | 设备号 | true | String | | - | 施工图片(图片一般为2张,一张安装位置图片,一张设备名牌+车架号图片) | true | List | | - | 图片地址 | true | String | | - | 安装位置代码 | true | String | 请求示例: ``` { "busiPictures": [ { "piclink": "VAS3/20240509/T-a054986c-1e99-4cd9-914e-7d8ef18e0381.png" } ], "busiImpdetails": [ { "installpositioncode": "20", "prodnum": "14184028935", "busiPictures": [ { "piclink": "VAS3/20240509/T-626e4506-6480-4674-9f70-03a406594f12.png", "piccode": "19" }, { "piclink": "VAS3/20240509/T-c6b6aa78-9186-44cc-b8a7-9cfe6ba5b0d6.png", "piccode": "20" } ] } ], "externalVehicleId": "1", "externalCustNum": "1", "corpId": 2, "oaAccout": "ww0232", "externalSystem": "CARLOAN5.0", "externalId": "1", "contactName": "叶子航", "contactMobile": "19124606961", "declarereMark": "", "impAddress": "湖南省长沙市长沙县星沙街道天华北路长沙县城市管理局", "vehicleType": 0, "vehicleCategory": 0, "model": "领克 领克03 领克03 2021款 2.0T 自动 劲Plus", "vin": "LVHCV663XL5009663", "licenseplateNum": "川A11223", "engineNum": "", "price": "80000", "ownerName": "刘朝林", "idCard": "622801198301171019", "mobile": "15352108161", "addressHome": "", "declareFrom": "CARLOAN5.0", "platformName": "国银", "platformId": "1", "loanAmount": "1", "notifyUrl": "" } ``` 回调通知: ``` { "externalCustNum": "861015", "externalId": "1787698142251720706", "externalVehicleId": "2874760768088517898", "impDiffe": true, "impVin": "LGBH52E03RY636699", "orderId": "617471", //vasId "orderNo": "NBZH20240508427611",//VAS订单号 "orderStatus": "6",//安装状态 "packName": "有线1台+3年服务期",//安装套餐 "wired": 1,//有线设备数量 "wireless": 0,//无线设备数量 "worker": {//安装人信息 "name": "郭鹤军", "phone": "1510000000" }, "impProducts": [ //安装设备,当orderStatus状态为6 时 才有数据 { "prodnum": "12345678", //设备号 "simnum": "14745678123", //卡号 "modelname": "GT740", //设备型号 "modelspecname": "有线" //设备类型 }, { "prodnum": "8765432198", "simnum": "147258396123", "modelname": "T98-4G(防水)", "modelspecname": "无线" } ], "clerk": {//派单文员 "name": "派单文员", "phone": "13111111111" }, "onDutyPhone":"4009908228" //24小时值班电话 } ``` ### 上传图片 **POST /admin/atta/upload/picture** [http://dev.wwvas.com:10000/image+返回地址](http://dev.wwvas.com:10000/image+返回地址) ``` {"msg":"success","code":0,"data":"VAS3/20210323/7523e04d-36b2-4084-b13a-23a5c97ed3b8.png"} ``` ### 查询订单和GPS状态 ### GET /business/car_loan/v5/getOrderStatus?platform=CARLOAN5.0&projectId=1829448682168610817 ``` { "msg": "success", "code": 0, "data": { "installStatus": "已完成", //待派单,待接单,待施工,施工中,已完成 "installNum": 2,//安装数量 "installDateTime": "2024-07-10T19:10:34.000+0800", 安装完成时间 "gpsStatus": [ { "gpsNo": "14092650166",//设备号 "gpsManufacturer": "万网鑫成", "gpsModelNo": "YG-T84(5年服务/4G)",//设备型号 "gpsModelSpec": "P2",//设备类型 "gpsModelSpecName": "无线",//设备类型时间 "gpsCardNo": "1442060284909",//卡号 "gpsLocationDate": "2024-10-15",//定位时间 "gpsLocationRes": "在线",//定位状态 "gpsLocationAddr": "海南省海口市美兰区人民路街道丽文路恒大·美丽沙",//定位地址 "activation": "1" } ] } } ``` 客户ID和车架号查询安装状态 GET /business/car_loan/v5/query/install/status?vin=&externalcustnum= ``` { "msg": "", "code": 0, "data": { "status": "6",//订单状态,1待派单、2待接单、3待施工、4施工中、6安装完成 "externalid": "业务系统ID", "model": "车型", "vin": "申请车架号", "installVin": "实际安装车架号",//仅status==6时,才有值 "ownerName": "车主", "idCard": "身份证", "mobile": "手机号", "installer":"安装人" "installerPhone":"安装人电话" } } { "msg": "未查询到GPS安装订单", "code": 1, "data": null } ``` 根据车架号获取定位图片 GET /business/car_loan/v5/getVehicleOnlineImg?vin= ``` { "msg": "", "code": 0, "data": "base64 图片" } ```
zhangyang
2025年12月26日 15:28
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档(打印)
分享
链接
类型
密码
更新密码