普通计价-即时/预约下单
接口说明
- 调用下单接口前请先调用车费预估接口V1或V2接口
- 下单estimatedAmount传预估返回的原价disMoney，不影响结算的优惠价
- 幂等校验（合作方单号作为key校验）
1）正常情况：5min之内重复下单，返回之前成功单号
2）超时情况：第一次请求下单超时，第二次请求返回重复下单提示，渠道需要根据返回重复下单状态码，再次来下单
3）重试： 第N次重试时，如果前N-1次都还没有生成单号，那么返回重复下单，否则返回成功的订单号
4.下单时如果riderPhone为虚拟号, 则需要接入根据乘客真实手机号查询订单号, 以便乘客进线投诉快速找到首约订单号
说明：请保证合作方订单号partnerOrderNo的唯一性
接口地址
https:// <SQYC_DOMAIN>/touch/partner/postInstantOrder
请求方式
POST
请求参数
| 名称 | 类型 | 是否必选 | 说明 |
|---|---|---|---|
| bookingDate | string | yes | 预定日期时间，10位时间戳(秒数) |
| riderPhone | string | yes | 乘车人手机号 |
| customerVirtualPhone | string | no | 乘车人虚拟号(针对特定渠道，如有相同需求请先与首约产品沟通) |
| callerPhone | string | no | 代叫人手机号 |
| firstContactFlag | Integer | no | 优先联系人标志:1优先联系代叫人(callerPhone),为空默认优先联系乘车人 |
| bookingStartAddr | string | yes | 上车地点(URLEncode编码后的值) |
| bookingEndAddr | string | yes | 下车地点(URLEncode编码后的值) |
| bookingStartPointLo | string | yes | 上车地点经度坐标 |
| bookingStartPointLa | string | yes | 上车地点纬度坐标 |
| bookingEndPointLo | string | yes | 下车地点经度坐标 |
| bookingEndPointLa | string | yes | 下车地点纬度坐标 |
| imei | string | no | 设备唯一识别码 |
| cityId | string | yes | 城市id(测试环境请用44) |
| groupIds | string | yes | 下单车型，如“34” 多个车型逗号分开,如 "34,43",派单按照多个车型派单, 特快/特惠新增: 100001特惠一口价, 200001特快一口价, 传入特惠/特快时 buyoutPrice与buyoutPriceFactor 必传 |
| estimatedAmount | string | yes | 预估金额，传预估返回车型原价disMoney，多车型时以最低价格为准【下单前必须调用预估接口】【如果预估使用V2版，取预估接口中originalAmount】 |
| partnerOrderNo | string | yes | 合作方订单号(最长64位) |
| riderName | string | no | 乘车人姓名(URLEncode编码后的值) |
| verifyCode | string | no | 手机验证码 |
| couponCode | string | no | 优惠券编码 |
| fingerVerifyId | string | no | 指纹设备id(风控) |
| sign | string | yes | 参见sign生成算法 |
| channel | string | yes | 渠道名称，由首汽提供 |
| orderSceneType | Integer | no | 礼宾用车标识，1为礼宾用车(仅35、256车型且为预约、接送机类订单支持) |
| channelUserPhone | string | no | 预订人手机号 |
| channelPreparePayFlag | Integer | no | 渠道是否预支付，1已支付，2未支付 默认为2 未支付 |
| priceToken | string | yes | 价格标识。预估时返回，用户锁定订单创建是时的价格 |
| maxEda | string | no | 接驾距离(半径:米)，目前业务暂未使用 |
| maxEta | string | no | 接驾时长(秒)，目前业务暂未使用 |
| zoneCode | string | no | 国际号码区号，需要以'+'开头，包括'+'在内最大长度6位 |
| riskFlag | string | no | “true”:风控已由渠道自行处理，不在首汽方重复风控。坏账由渠道承担。 |
| interlinkOrderFlag | string | no | 是否使用连环绑单功能， 0：不使用连环绑单 1：使用连环绑单。默认0 |
| changeCabinTime | string | no | 换舱锁定司机时长(单位:秒) |
| phoneLastFour | string | no | 真实手机号后四位 |
| cooperationUserId | string | no | 用户id |
| passingPoints | List<Object> | no | 接入前联系研发配置 途经点:目前只支持两个途经点,约定按照顺序先后确定第一个途经点与第二个途经点,需要配置:List参数传递按照form形式:如下所示,第一个n=0,第二个途经点n=1, 如:passingPoints[0].bookingPassingLng |
| buyoutPrice | String | no | 渠道方一口价预估价(groupIds传入特惠/特快时必填)-特惠/特快场景新增 |
| buyoutPriceFactor | String | no | 渠道方一口价干预比例(buyoutPrice/预估价报价)(groupIds传入特惠/特快时必填)-特惠/特快场景新增 |
| rtaFactor | String | no | 折扣比例：平台算法定价时需传，多个用英文，间隔，例：0.88,0.77（仅作为参考） |
| rtaAmount | String | no | 平台算法优惠金额：单位：分，平台算法定价时需传,多个用英文,间隔（优惠金额预估时锁定，最后结算时候，按照此金额结算） |
| rtaTargetResult | String | no | 平台算法时需提供，1：达成；2：没达成,多个英文逗号分隔 |
| rtaRank | String | no | 平台算法时需提供,多个英文逗号分隔 |
passingPoints请求参数
| 名称 | 类型 | 是否必选 | 说明 |
|---|---|---|---|
| bookingPassingLng | String | yes | 途经点经度如:"118.59252" |
| bookingPassingLat | String | yes | 途经点纬度如:"24.800137" |
| bookingPassingPointAddr | String | yes | 途经点地址如:"晋江机场航站楼" |
| bookingPassingPointShortAddr | String | no | 途经点短地址:"晋江机场航站楼" |
返回数据
| 名称 | 类型 | 说明 |
|---|---|---|
| result | Integer | 0:成功；非0：失败原因编码 |
| errmsg | string | 失败原因描述，若成功则值为空 |
| data | OrderResultDTO | 订单结果，参见OrderResultDTO |
返回示例
正常返回
{
"result": 0,
"errmsg": "SUCCESS",
"data": {
"orderId": 198813025, //可忽略该返回值，以订单号交互
"orderNo": "B7518002632952624",
"partnerOrderNo": "渠道侧id",//新增字段，返回渠道订单id(只针对特定渠道返回)
"returnCode": "0"
}
}
重复下单返回
{
"result":1110,
"data":null,
"errmsg":"重复下单."
}