普通计价-接机下单
接口说明
- 该接口适用于普通计费的接机下单
- 接机出发地、到达地三字码必传,用于航班订阅,部分航班存在多个航段,故需通过三字码判定乘客订阅的哪个航段
- 接机航班号和航班计划起飞时间用于航班订阅时查询是哪一天的航班
- bookingDate = airlineDate + laterMinute。airlineDate的取值需来自航班查询接口的arrDate,否则可能出现客诉异议
- 如果有航班计划到达时间,最好把参数一起传递
接口地址
https:// <SQYC_DOMAIN>/touch/partner/postPickUpOrder
请求方式
POST
请求参数
名称 | 类型 | 是否必选 | 说明 |
---|---|---|---|
bookingDate | string | yes | 预定日期时间,10位时间戳(秒数) |
riderPhone | string | yes | 乘车人手机号 |
callerPhone | String | no | 代叫人手机号 |
firstContactFlag | Integer | no | 优先联系人标志:1优先联系代叫人(callerPhone),为空默认优先联系乘车人 |
bookingStartAddr | string | yes | 上车地点 |
bookingEndAddr | string | yes | 下车地点 |
bookingStartPointLo | string | yes | 上车地点经度坐标 |
bookingStartPointLa | string | yes | 上车地点纬度坐标 |
bookingEndPointLo | string | yes | 下车地点经度坐标 |
bookingEndPointLa | string | yes | 下车地点纬度坐标 |
imei | string | no | 设备唯一标识码 |
cityId | string | yes | 城市ID |
groupIds | string | yes | 车型如34 |
estimatedAmount | string | yes | 预估金额,多车型时以最低价格为准 |
airlineNum | String | yes | 航班号 |
planDate | string | yes | 航班计划出发日期,格式(yyyy-MM-dd HH:mm:ss) |
airlineDate | string | no | 航班预计到达日期,格式(yyyy-MM-dd HH:mm:ss) (注:这里指的预计落地的时间,并非官网航班固定计划时间) |
depCode | string | yes | 出发地三字码 |
arrCode | string | yes | 目的地三字码 |
riderName | string | no | 乘车人姓名,URLEncode编码后的 |
verifyCode | string | no | 手机验证码,部分渠道为必填项。 |
payFlag | string | no | 是否渠道付款,0渠道付,1乘车人付 |
priceToken | string | yes | 价格标识。预估时返回,用户锁定订单创建是时的价格 |
partnerOrderNo | string | yes | 合作方订单号(最长64位) |
couponCode | string | no | 优惠券编码 |
laterMinute | String | yes | 航班到达N分钟后用车,单位:分钟。如无该数据可传递0。bookingDate=airlineDate+laterMinute |
phoneLastFour | String | no | 真实手机号后四位 |
cooperationUserId | String | no | 用户id |
sign | string | yes | 参见 sign生成算法 |
channel | string | yes | 渠道名称,由首汽提供 |
orderSceneType | Integer | no | 礼宾用车标识,1为礼宾用车(仅35、256车型且为预约、接送机类订单支持) |
返回数据
名称 | 类型 | 说明 |
---|---|---|
result | Integer | 0:成功;非0:失败原因编码 |
errmsg | string | 失败原因描述,若成功则值为空 |
data | OrderResultDTO | 下单结果,参见OrderResultDTO |
返回示例
{
"result": 0,
"errmsg": "SUCCESS",
"data": {
//可忽略该返回值,以订单号交互
"orderId": "198813025",
"orderNo": "B7518002632952624",
"returnCode": "0"
}
}