公共接口 - 选择预约充电枪
<p><strong>简要描述：</strong></p>
<ul>
<li>生成预约订单</li>
</ul>
<p>*错误代码：**</p>
<table>
<thead>
<tr>
<th>错误代码</th>
<th>说明</th>
<th>添加时间</th>
<th>修改人</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>参数校验失败</td>
<td>2019-06-27 10:58:50 星期四</td>
<td>ckinghan</td>
</tr>
<tr>
<td>4023</td>
<td>预约订单创建失败</td>
<td></td>
<td>ckinghan</td>
</tr>
<tr>
<td>440005</td>
<td>服务器内部错误-内部服务调用错误</td>
<td></td>
<td>ckinghan</td>
</tr>
<tr>
<td>4024</td>
<td>检查用户未完成订单失败</td>
<td></td>
<td>ckinghan</td>
</tr>
<tr>
<td>4018</td>
<td>用户存在未结束订单</td>
<td></td>
<td>ckinghan</td>
</tr>
<tr>
<td>4019</td>
<td>未查询到桩信息</td>
<td></td>
<td>ckinghan</td>
</tr>
<tr>
<td>4022</td>
<td>充电桩不支持预约</td>
<td></td>
<td>ckinghan</td>
</tr>
<tr>
<td>4011</td>
<td>预约费信息不存在或已删除</td>
<td></td>
<td>ckinghan</td>
</tr>
<tr>
<td>4020</td>
<td>预约费通道已关闭</td>
<td></td>
<td>ckinghan</td>
</tr>
<tr>
<td>4021</td>
<td>用户余额不足</td>
<td></td>
<td>ckinghan</td>
</tr>
<tr>
<td>4023</td>
<td>枪信息不存在</td>
<td></td>
<td>ckinghan</td>
</tr>
<tr>
<td>2051</td>
<td>冻结金额失败</td>
<td></td>
<td>ckinghan</td>
</tr>
<tr>
<td>4025</td>
<td>请选择要预约的枪口号</td>
<td></td>
<td>ckinghan</td>
</tr>
<tr>
<td>440005</td>
<td>服务器内部错误</td>
<td></td>
<td>ckinghan</td>
</tr>
<tr>
<td>2156</td>
<td>存在尚未结算停车订单</td>
<td></td>
<td>ckinghan</td>
</tr>
<tr>
<td><font color="red">20000</font></td>
<td>预约订单启动中</td>
<td>须要调用查询订预约状态接口</td>
<td>ckinghan</td>
</tr>
</tbody>
</table>
<p><strong>请求URL：</strong></p>
<ul>
<li><code>{{url}}/app/app/order/startAppointment</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST</li>
</ul>
<p><strong>请求参数说明：</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">键</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
<th style="text-align: left;">备注</th>
<th style="text-align: left;">示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">pileId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">扫描的数据（通信编号14位+TCU编号2位+枪口号2位）</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">gunId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">扫描的数据（通信编号14位+TCU编号2位+枪口号2位）</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">time</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">预约时间</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">-</td>
</tr>
</tbody>
</table>
<p><strong>请求示例</strong></p>
<pre><code>{{url}}/app/app/order/startAppointment?gunId=17&time=5&pileId=7</code></pre>
<p><strong>返回参数说明</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">返回码</td>
<td style="text-align: left;">0 为成功</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">返回信息</td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">- data</td>
<td style="text-align: left;">Object</td>
<td style="text-align: left;">返回携带的数据</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">id</td>
<td style="text-align: left;">Long</td>
<td style="text-align: left;">id</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">uuid</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">uuid</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">orderNo</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">订单编号</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">isOver</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">订单是否完成：</td>
<td style="text-align: left;">0未完成、1已完成 、<font color=red>2超时结束、3手动取消(结束)、4设备启动中、5启动失败</td>
</tr>
<tr>
<td style="text-align: left;">orderName</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">订单名称</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">userId</td>
<td style="text-align: left;">Long</td>
<td style="text-align: left;">用户ID</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">userName</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">用户名</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">userType</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">用户帐户类型： 0APP_WX、1卡、2VIN、3、企业用户</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">运营商微信APPid</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">agentId</td>
<td style="text-align: left;">Long</td>
<td style="text-align: left;">代理商ID</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">agentName</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">代理商名称</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">enterpariseId</td>
<td style="text-align: left;">Long</td>
<td style="text-align: left;">enterpariseId</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">enterpariseName</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">企业名称</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">appotherEnterpariseNameId</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">第三方企业名称</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">orderType</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">订单类型： 0预约订单、1充电订单</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">orderFlag</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">订单标志： 0平台订单、1第三方平台订单</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">payStatus</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">支付状态： :0未支付、1已支付</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">startTime</td>
<td style="text-align: left;">Date</td>
<td style="text-align: left;">开始时间</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">endTime</td>
<td style="text-align: left;">Date</td>
<td style="text-align: left;">结束时间</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">startAmount</td>
<td style="text-align: left;">BigDecimal</td>
<td style="text-align: left;">起始余额 单位：元</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">endAmount</td>
<td style="text-align: left;">BigDecimal</td>
<td style="text-align: left;">结束余额 单位：元</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">appointmentFee</td>
<td style="text-align: left;">BigDecimal</td>
<td style="text-align: left;">预约费 单位：元</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">totalAmount</td>
<td style="text-align: left;">BigDecimal</td>
<td style="text-align: left;">总费用 单位：元</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">actualAmount</td>
<td style="text-align: left;">BigDecimal</td>
<td style="text-align: left;">实收费用： 单位：元</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">invoiceFlag</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">是否开发票： 0不开发票、1开具发票</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">pileId</td>
<td style="text-align: left;">Long</td>
<td style="text-align: left;">充电桩ID</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">pileSn</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">充电桩出厂编号</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">pileName</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">充电桩名称</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">communicationSn</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">通讯编号，默认14位</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">driveNo</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">充电桩设备编号</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">gunId</td>
<td style="text-align: left;">Long</td>
<td style="text-align: left;">充电枪ID</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">gunNo</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">充电枪编号</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">gunType</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">充电枪类型 0交流、1直流、2交直流一体</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">tcuSn</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">TCU编号</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">stationId</td>
<td style="text-align: left;">Long</td>
<td style="text-align: left;">充电桩归属电站ID</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">stationName</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">充电站名称</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">appointmentId</td>
<td style="text-align: left;">Long</td>
<td style="text-align: left;">预约费ID</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">appointmentName</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">预约费名称</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">appointmentTime</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">预约时长 ：分钟</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">appointmentUnitTime</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">预约时间计费单位 分钟</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">appointmentPrice</td>
<td style="text-align: left;">BigDecimal</td>
<td style="text-align: left;">预约时间计费单位单价 单位：元</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">stopReasion</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">结束原因</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">remark</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">备注</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">updateTime</td>
<td style="text-align: left;">Date</td>
<td style="text-align: left;">最后更新时间</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">orderTime</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">有效预约时长，单位 ：分钟</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">appointmentOrderTime</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">预约时长，单位 ：分钟</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">createTime</td>
<td style="text-align: left;">Date</td>
<td style="text-align: left;">创建时间</td>
<td style="text-align: left;">-</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>{
"code": 0,
"msg": "预约请求成功",
"data": {
"id": null,
"uuid": "4609faca-bb79-4268-b704-efe973d1a227",
"orderNo": "00003001564020691071",
"orderName": null,
"isOver": 0,
"userId": 3,
"userName": "18819506700",
"userType": 0,
"appId": "wx07e7e64417d90717",
"agentId": 3,
"agentName": null,
"enterpariseId": null,
"enterpariseName": null,
"otherEnterpariseName": null,
"orderFlag": 0,
"payStatus": 0,
"startTime": "2019-07-25 10:11:31",
"endTime": "2019-07-25 10:16:31",
"startAmount": null,
"endAmount": null,
"appointmentFee": null,
"totalAmount": null,
"actualAmount": null,
"invoiceFlag": 0,
"pileId": 1,
"pileSn": "1",
"pileName": "1",
"communicationSn": "10000000000000",
"driveNo": null,
"gunId": 2,
"gunNo": 2,
"tcuSn": 1,
"gunType": 1,
"stationId": 1,
"stationName": "南京南",
"appointmentId": 1,
"appointmentName": "预约费",
"appointmentTime": 15,
"appointmentUnitTime": 5,
"appointmentPrice": 3.14,
"stopReasion": null,
"delFlag": 0,
"remark": null,
"createBy": null,
"createTime": "2019-07-25 10:11:31",
"updateBy": null,
"updateTime": null,
"appointmentOrderTime": 5,
"orderTime": null,
"stationInfo": null
}
}</code></pre>
<p><font color=red>当响应状态为20000时，则响应以下数据</font></p>
<p><strong>返回参数说明</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">返回码</td>
<td style="text-align: left;">0 为成功</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">返回信息</td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">- data</td>
<td style="text-align: left;">Object</td>
<td style="text-align: left;">返回携带的数据</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">tcu</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">TCU编号</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">gunNo</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">枪口号</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">commSn</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">通讯编号</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">orderNo</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">订单编号</td>
<td style="text-align: left;">-</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>{
"code":20000,
"msg":"success",
"data":{
"orderNo":"24415000001790211131",
"commSn":"10000000000005",
"tcu":1,
"gunNo":3
}
}</code></pre>