普通计价-即时/预约下单

接口说明

调用下单接口前请先调用车费预估接口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	渠道名称，由首汽提供
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传入特惠/特快时必填)-特惠/特快场景新增

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":"重复下单."
}

即时预约单

普通计价-即时/预约下单

接口说明

接口地址

请求方式

请求参数

passingPoints请求参数

返回数据

返回示例

results matching ""

No results matching ""