代步车业务接口

想用车和中升GO对接接口文档


获取用户当前订单

<h4>说明</h4> <p>获取当前用户正在进行中的借车订单, 进入代步车功能时, 应先调用此接口尝试获取, 若能获取到订单, 则不允许用户创建新订单.</p> <h4>接口名称(Endpoint)</h4> <p><code>/bos/scooter/goapi/order/activing</code></p> <h4>公共参数</h4> <ul> <li>openid</li> </ul> <h4>请求参数说明</h4> <p>无</p> <h4>成功-响应说明</h4> <table> <thead> <tr> <th style="text-align: left;">参数名&lt;div style=&quot;width: 100pt&quot;&gt;</th> <th style="text-align: left;">必填</th> <th style="text-align: left;">类型</th> <th>字段描述&lt;div style=&quot;width: 200pt&quot;&gt;</th> <th>备注&lt;div style=&quot;width: 180pt&quot;&gt;</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>订单id</td> <td></td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>订单状态</td> <td></td> </tr> <tr> <td style="text-align: left;">statusText</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>订单状态(文本)</td> <td></td> </tr> <tr> <td style="text-align: left;">returnable</td> <td style="text-align: left;">是</td> <td style="text-align: left;">boolean</td> <td>用户是否已申请还车</td> <td></td> </tr> <tr> <td style="text-align: left;">cancelStatus</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>取消前状态</td> <td>若订单为取消, 此字段有值</td> </tr> <tr> <td style="text-align: left;">cancelStatusText</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>取消前状态(文本)</td> <td>若订单为取消, 此字段有值</td> </tr> <tr> <td style="text-align: left;">easCode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>施工单号</td> <td></td> </tr> <tr> <td style="text-align: left;"><strong>经销店信息</strong></td> <td style="text-align: left;"></td> <td style="text-align: left;"></td> <td></td> <td></td> </tr> <tr> <td style="text-align: left;">shopCode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>经销店编号</td> <td></td> </tr> <tr> <td style="text-align: left;">address</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>经销店地址</td> <td></td> </tr> <tr> <td style="text-align: left;">shopName</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>经销店名称</td> <td></td> </tr> <tr> <td style="text-align: left;">shopPhone</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>经销店联系电话</td> <td></td> </tr> <tr> <td style="text-align: left;"><strong>车辆信息</strong></td> <td style="text-align: left;"></td> <td style="text-align: left;"></td> <td></td> <td></td> </tr> <tr> <td style="text-align: left;">carBrand</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>所借车辆品牌</td> <td></td> </tr> <tr> <td style="text-align: left;">carType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>所借车辆车型</td> <td></td> </tr> <tr> <td style="text-align: left;">carPlateNum</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>所借车辆车牌号</td> <td></td> </tr> <tr> <td style="text-align: left;"><strong>用户预约信息</strong></td> <td style="text-align: left;"></td> <td style="text-align: left;"></td> <td></td> <td></td> </tr> <tr> <td style="text-align: left;">userName</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>借车用户姓名</td> <td></td> </tr> <tr> <td style="text-align: left;">userPhone</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>借车用户联系电话</td> <td></td> </tr> <tr> <td style="text-align: left;">name</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>预约姓名or实名(实名之后)</td> <td>根据订单状态, 自行判断返回预约姓名(实名之前) 或是 实名(实名之后)</td> </tr> <tr> <td style="text-align: left;">phone</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>预约手机or手机(实名之后)</td> <td>根据订单状态, 自行判断返回预约手机(实名之前) 或是 手机(实名之后)</td> </tr> <tr> <td style="text-align: left;">userBrand</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>用户自有车辆品牌</td> <td></td> </tr> <tr> <td style="text-align: left;">userCarType</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>用户自有车辆型号</td> <td></td> </tr> <tr> <td style="text-align: left;">userPlateNum</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>用户自有车辆号牌</td> <td></td> </tr> <tr> <td style="text-align: left;">useCause</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>用车原因</td> <td></td> </tr> <tr> <td style="text-align: left;">preOutTime</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>预约借出时间</td> <td></td> </tr> <tr> <td style="text-align: left;">preInTime</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>预约归还时间</td> <td></td> </tr> <tr> <td style="text-align: left;">preDay</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>预期使用天数</td> <td></td> </tr> <tr> <td style="text-align: left;"><strong>用户实名信息</strong></td> <td style="text-align: left;"></td> <td style="text-align: left;"></td> <td></td> <td>用户填报实名之后有值</td> </tr> <tr> <td style="text-align: left;">realname</td> <td style="text-align: left;">是</td> <td style="text-align: left;">boolean</td> <td>用户是否已填报实名</td> <td></td> </tr> <tr> <td style="text-align: left;">realUserName</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>用户实名</td> <td>用户填报实名之后, 此字段有值</td> </tr> <tr> <td style="text-align: left;">realUserPhone</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>用户实名手机号</td> <td>用户填报实名之后, 此字段有值</td> </tr> <tr> <td style="text-align: left;">realUserCardType</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>用户实名证件类型</td> <td>用户填报实名之后, 此字段有值</td> </tr> <tr> <td style="text-align: left;">realUserCardID</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>用户实名证件编号</td> <td>用户填报实名之后, 此字段有值</td> </tr> <tr> <td style="text-align: left;"><strong>订单费用信息</strong></td> <td style="text-align: left;"></td> <td style="text-align: left;"></td> <td></td> <td></td> </tr> <tr> <td style="text-align: left;">unitPrice</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>车辆日租金, 单位: 分.</td> <td></td> </tr> <tr> <td style="text-align: left;">totalPrice</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>预订租金总额, 单位: 分.</td> <td></td> </tr> <tr> <td style="text-align: left;">rent</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>租金实付金额, 单位: 分.</td> <td></td> </tr> <tr> <td style="text-align: left;">makeup</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>租金需补, 单位: 分.</td> <td>延迟还车时, 应补交租金上限, 由系统自动计算. 计算规则: <code>车辆日租金小时单价 * (迟还小时数[向上取整]-豁免小时数)</code>. 无则为0</td> </tr> <tr> <td style="text-align: left;">realMakeup</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>租金应补, 单位: 分.</td> <td>延迟还车时, 经销店设置的实际应补租金金额, 不超过预算上限. 无则为0</td> </tr> <tr> <td style="text-align: left;">rentRefund</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>租金退款, 单位: 分.</td> <td>若取消/拒绝: 实付租金全额; 若提前还车: <code>租金实付小时单价 * (提前小时数[向下取整]-豁免小时数)</code>; 无则为0</td> </tr> <tr> <td style="text-align: left;">deposit</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>押金, 单位: 分.</td> <td>由经销店手动设置, 无则为0</td> </tr> <tr> <td style="text-align: left;">depositCut</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>已扣押金, 单位: 分.</td> <td>由应补租金优先扣除, 若有余值, 供违章阶段执行扣除, 无则为0</td> </tr> <tr> <td style="text-align: left;">refund</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>押金实退, 单位: 分.</td> <td>若有此值, 发送退还押金请求,若取消, 此值应为押金原值, 无则为0</td> </tr> <tr> <td style="text-align: left;"><strong>订单借还信息</strong></td> <td style="text-align: left;"></td> <td style="text-align: left;"></td> <td></td> <td></td> </tr> <tr> <td style="text-align: left;">passTime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>审核通过时间</td> <td>审核后有值</td> </tr> <tr> <td style="text-align: left;">authTime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>实名认证时间</td> <td>实名认证通过后有值</td> </tr> <tr> <td style="text-align: left;">outTime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>准确借出时间</td> <td>借出后有值</td> </tr> <tr> <td style="text-align: left;">inTime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>准确还车时间</td> <td>还车后有值</td> </tr> <tr> <td style="text-align: left;">useHours</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>实际使用时长(小时)</td> <td>还车后有值</td> </tr> <tr> <td style="text-align: left;">violationRemark</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>违章备注</td> <td>完成后有值</td> </tr> </tbody> </table> <h4>成功-响应示例</h4> <pre><code>{ &amp;quot;id&amp;quot;: &amp;quot;1754475811132868&amp;quot;, // 订单id &amp;quot;status&amp;quot;: &amp;quot;waitRent&amp;quot;, // 订单状态 &amp;quot;statusText&amp;quot;: &amp;quot;待付租金&amp;quot;, // 订单状态(文本) &amp;quot;returnable&amp;quot;: false, // 用户是否已申请还车 &amp;quot;shopCode&amp;quot;: &amp;quot;012&amp;quot;, // 经销店编号 &amp;quot;address&amp;quot;: &amp;quot;辽宁省 大连市 甘井子区 华北路761号&amp;quot;, // 经销店地址 &amp;quot;shopName&amp;quot;: &amp;quot;大连中升汇迪汽车销售服务有限公司&amp;quot;, // 经销店名称 &amp;quot;shopPhone&amp;quot;: &amp;quot;13912345678&amp;quot;, // 经销店联系电话 &amp;quot;carBrand&amp;quot;: &amp;quot;奥迪&amp;quot;, // 所借车辆品牌 &amp;quot;carType&amp;quot;: &amp;quot;Q3&amp;quot;, // 所借车辆车型 &amp;quot;carPlateNum&amp;quot;: &amp;quot;辽B108SN&amp;quot;, // 所借车辆车牌号 &amp;quot;userName&amp;quot;: &amp;quot;张三&amp;quot;, // 借车用户姓名 &amp;quot;userPhone&amp;quot;: &amp;quot;13912345678&amp;quot;, // 借车用户联系电话 &amp;quot;name&amp;quot;: &amp;quot;张三&amp;quot;, // 预约姓名or实名(实名之后) &amp;quot;phone&amp;quot;: &amp;quot;13912345678&amp;quot;, // 预约联系电话or实名(实名之后) &amp;quot;userBrand&amp;quot;: &amp;quot;宝马&amp;quot;, // 用户自有车辆品牌 &amp;quot;userCarType&amp;quot;: &amp;quot;X5&amp;quot;, // 用户自有车辆型号 &amp;quot;userPlateNum&amp;quot;: &amp;quot;辽B20197&amp;quot;, // 用户自有车辆号牌 &amp;quot;useCause&amp;quot;: &amp;quot;保养&amp;quot;, // 用车原因 &amp;quot;preOutTime&amp;quot;: &amp;quot;2025-08-06 11:00:00&amp;quot;, // 预计借出时间 &amp;quot;preInTime&amp;quot;: &amp;quot;2025-08-07 11:00:00&amp;quot;, // 预计归还时间 &amp;quot;preDay&amp;quot;: 1, // 预计使用天数 &amp;quot;realname&amp;quot;: false, // 用户是否已填报实名 &amp;quot;realUserName&amp;quot;: &amp;quot;&amp;quot;, // 用户实名 &amp;quot;realUserPhone&amp;quot;: &amp;quot;&amp;quot;, // 用户实名手机号 &amp;quot;realUserCardID&amp;quot;: &amp;quot;&amp;quot;, // 用户实名证件编号 &amp;quot;unitPrice&amp;quot;: 10000, // 车辆日租金,单位:分. &amp;quot;totalPrice&amp;quot;: 10000, // 预订租金总额,单位: 分. &amp;quot;rent&amp;quot;: 0, // 租金实付金额,单位: 分. &amp;quot;makeup&amp;quot;: 0, // 租金需补,单位: 分. &amp;quot;realMakeup&amp;quot;: 0, // 租金应补,单位: 分. &amp;quot;rentRefund&amp;quot;: 0, // 租金退款,单位: 分. &amp;quot;deposit&amp;quot;: 0, // 押金,单位:分. &amp;quot;depositCut&amp;quot;: 0, // 已扣押金,单位: 分, &amp;quot;refund&amp;quot;: 0, // 押金实退, 单位: 分 &amp;quot;outTime&amp;quot;: &amp;quot;&amp;quot;, // 准确借出时间 &amp;quot;inTime&amp;quot;: &amp;quot;&amp;quot;, // 准确还车时间 &amp;quot;violationRemark&amp;quot;: &amp;quot;&amp;quot;, // 违章备注 &amp;quot;cancelStatus&amp;quot;: &amp;quot;&amp;quot;, // 取消前状态. 若订单为取消,此字段有值 &amp;quot;cancelStatusText&amp;quot;: &amp;quot;&amp;quot;, // 取消前状态(文本). 若订单为取消,此字段有值 &amp;quot;realUserCardType&amp;quot;: &amp;quot;&amp;quot;, // 用户实名证件类型. 用户填报实名之后, 此字段有值 &amp;quot;useHours&amp;quot;: 0 // 实际使用时长(小时). 还车后有值 }</code></pre> <h4>失败-响应说明</h4> <table> <thead> <tr> <th style="text-align: left;">code</th> <th>message</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">1</td> <td>无有效数据</td> </tr> <tr> <td style="text-align: left;">2</td> <td>前一订单被经销店拒绝接单, 此处将返回拒绝原因</td> </tr> </tbody> </table>

页面列表

ITEM_HTML