代步车业务接口

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


创建订单

<h4>说明</h4> <p>用户创建借车订单时, 通过此接口传递用户所填写的表单信息. 此接口将返回关键的订单信息.</p> <h4>接口名称(Endpoint)</h4> <p><code>/bos/scooter/goapi/order/create</code></p> <h4>公共参数</h4> <ul> <li>openid</li> </ul> <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;">shopCode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>经销店编码</td> <td>由用户所选经销店code信息获取</td> </tr> <tr> <td style="text-align: left;">carId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>所借车辆id</td> <td>由用户所选车辆id信息获取</td> </tr> <tr> <td style="text-align: left;">startTime</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>预约使用-起始时间</td> <td>例如: 2025-08-03 17:30:00</td> </tr> <tr> <td style="text-align: left;">endTime</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>预约使用-截止时间</td> <td>例如: 2025-08-05 18:40:00</td> </tr> <tr> <td style="text-align: left;">name</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;">phone</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;">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;">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;">preCost</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;shopCode&amp;quot;:&amp;quot;026&amp;quot;, // 经销店编码, 由用户所选经销店code信息获取 &amp;quot;carId&amp;quot;: &amp;quot;1753893245750190&amp;quot;, // 所借车辆id, 由用户所选车辆id信息获取 &amp;quot;startTime&amp;quot;: &amp;quot;2025-08-03 17:30&amp;quot;, // 支持格式 &amp;quot;yyyy-MM-dd HH:mm:ss&amp;quot;, &amp;quot;yyyy-MM-dd HH:mm&amp;quot;, &amp;quot;yyyy-MM-dd HH&amp;quot; &amp;quot;endTime&amp;quot;: &amp;quot;2025-08-05 18:40&amp;quot;, // 支持格式 &amp;quot;yyyy-MM-dd HH:mm:ss&amp;quot;, &amp;quot;yyyy-MM-dd HH:mm&amp;quot;, &amp;quot;yyyy-MM-dd HH&amp;quot; &amp;quot;name&amp;quot;:&amp;quot;张三&amp;quot;, &amp;quot;phone&amp;quot;:&amp;quot;13912345678&amp;quot;, &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;辽B12345&amp;quot;, &amp;quot;useCause&amp;quot;: &amp;quot;事故&amp;quot;, // 由用车原因接口返回数据中选择 &amp;quot;preCost&amp;quot;: &amp;quot;1万元以下&amp;quot; // 由预估维修金额接口返回数据中选择 }</code></pre> <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;">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;">days</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>租用天数, 单位: 天</td> <td>借还小时差/24, 向上取整</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> </tbody> </table> <h4>成功-响应示例</h4> <pre><code>{ &amp;quot;id&amp;quot;: &amp;quot;1853892345734190&amp;quot;, &amp;quot;unitPrice&amp;quot;: 10000, &amp;quot;days&amp;quot;: 5, &amp;quot;totalPrice&amp;quot;: 50000 }</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