下单接口
方法名
uri |
请求方式 |
order/commit |
POST |
参数说明
参数 |
是否必须 |
说明 |
备注 |
phone |
是 |
主叫账户电话 |
|
contactPhone |
是 |
联系人电话(使用代驾) |
主叫电话不一致为代叫订单,还需cash_only、type为01014 |
address |
是 |
预约地址 |
如果driverId未传值则为一键下单流程,address为必填 |
channel |
否 |
渠道号 |
|
thirdOrderId |
否 |
合作方订单号唯一标识 |
标准订单状态回调会返回合作方 |
number |
是 |
预约人数 |
目前对外只支持传1,只能叫一名司机 |
longitude |
是 |
经度 |
|
latitude |
是 |
纬度 |
|
gpsType |
是 |
坐标类型 |
目前只支持 baidu |
token |
是 |
用户凭证 |
|
sendSms |
否 |
一键下单失败是否发送短信 |
默认false ,true 发送 |
carNo |
否 |
车牌号 |
|
cash_only |
否 |
支付方式 |
type为01014需要传, 0本人支付,1乘客现金支付,默认本人支付 |
type |
否 |
下单类型 |
默认 一键下单 01003,01007 远程叫单,01014代叫订单 ,01001扫码下单 |
bonus_sn |
否 |
优惠券码(多张优惠券用逗号分隔) |
|
isUseBonus |
否 |
是否使用优惠券(1:使用(默认)、0:不使用) |
|
customerLng |
否 |
叫车人的坐标(可能为他人代叫) |
|
customerLat |
否 |
叫车人的坐标(可能为他人代叫) |
|
dynamicFee |
否 |
当前动态调价金额,下单时会验证,价格不符时返回错误提示 |
|
dynamicRate |
否 |
当前动态调价倍数 ,下单时会验证,价格不符时返回错误提示 |
|
feeMax |
否 |
当前动态调价最高数 ,下单时会验证,价格不符时返回错误提示 |
|
strategyId |
否 |
权益订单策略id(e代驾生成后提供) |
|
strategyServiceSign |
否 |
权益订单来源签名(如传strategyId时该字段必传) |
|
strategyCompanyBranch |
否 |
权益订单分渠道等备注信息 |
|
destinationLat |
否 |
目的地纬度 |
|
destinationLng |
否 |
目的地经度 |
|
destinationAddress |
否 |
目的地名字 |
成功返回值说明
名称 |
类型 |
备注 |
code |
int |
返回状态码:0成功非0失败 |
message |
string |
message |
data |
Object |
成功时的返回数据 |
bookingId |
string |
预约id,polling接口会响应orderId |
bookingType |
string |
01003 一键下单,01014 代叫订单,01007 远程下单 |
orderTime |
long |
下单成功时间 |
timeout |
long |
派单时长,单位:秒 |
成功返回值
一键下单
{
"code": 0,
"data": {
"bookingId": "ba4750d9d071185a35b4e45feb58eab4",
"bookingType": "01013",
"orderTime": 1561912347,
"timeout": 300,
"matchId": ""
},
"message": ""
}
注意事项
code |
message |
说明 |
2 |
非常抱歉,您暂时无法使用APP下单,可拨打热线4008-103939下单! |
用户被客服拉黑 |
5 |
token无效 |
用户token验证失败 |
11 |
权益账户余额不足,下单失败 |
权益对应的账户余额不足,通知e代驾商务进行充值 |