下单 – 即时、预约

说明

该接口提供下即时、预约订单功能，下单成功后订单状态为10（预定中）。预定时间是30分钟以外的按预约单处理，只能预约3天内的订单。

地址URL

https://<SQYC_DOMAIN>/v1/common/postInstantOrder

HTTP请求方式

POST

访问授权限制

暂无

请求参数

名称	选项	类型及范围	说明
bookingDate	必选	String	预定日期时间（30分钟之后的按预约单处理，预约单不可超过3天）， 13位时间戳(毫秒数)
riderUserPhone	必选	String	乘车人手机号
bookingStartAddr	必选	String	上车地址(长地址，URLEncode编码后的值)
bookingStartName	必选	String	上车地点名称(短地址，URLEncode编码后的值)
bookingEndAddr	必选	String	下车地址(长地址，URLEncode编码后的值)
bookingEndName	必选	String	下车地点名称(短地址，URLEncode编码后的值)
bookingStartPointLo	必选	String	上车地点经度坐标（默认：mars）
bookingStartPointLa	必选	String	上车地点纬度坐标（默认：mars）
bookingEndPointLo	必选	String	下车地点经度坐标（默认：mars）
bookingEndPointLa	必选	String	下车地点纬度坐标（默认：mars）
cityId	必选	String	城市ID.(测试环境请使用44)
channel	必选	String	渠道名称，由首汽约车给定。
partnerOrderId	必选	String	合作方订单号
sign	必选	String	参见sign生成算法
deviceId	可选	String	设备指纹（暂不用）
imei	可选	String	设备唯一标识码
riderUserName	可选	String	乘车人姓名(URLEncode编码后的值)
dispatchCostAmount	可选	String	调度费或信息服务费
estimatedAmount	可选	String	预估费
estimatedDistance	可选	String	预估里程
dispatchCostType	可选	String	附加费类型，（0：未选择附加费1：调度费2：信息服务费）
payFlag	可选	String	支付类型，0线上1线下（不用）
customerVirtualPhone	可选	String	渠道虚拟号（不可用）
customerRealPhoneMask	可选	String	乘客真实手机号掩码，例如138****5678，渠道掩码开关开启时必填
changeSPFlag	可选	String	有效值为"1"，标识为当前下单为换舱订单(注意：仅当该参数有效且changeSPLockDuration有效的前提下，才需要参与验签)
changeSPLockDuration	可选	String	在changeSPFlag参数有效的前提下会校验此参数，其意义为首汽派单系统成功派单到某个司机后，锁定司机的时长，单位为秒，最小值为"1", 最大值为"60"（注意：仅当changeSPFlag参数有效且该参数也有效的前提下才会参与验签）

返回数据

名称	类型	说明
result	string	0:成功非0 :失败原因编号
errmsg	string	失败原因描述，若成功则值为success !
data	OrderResultDTO	OrderResultDTO实体类:订单结果（详见OrderResultDTO节点）

返回示例

{
    "result": 0,
    "errmsg": "success !",
    "data": {
        "orderId": "T20844709560070000080000132"
    }
}

注意事项

暂无

results matching ""

No results matching ""