功能概述

用户通过渠道app指定车辆供应商下单后,如该供应商无司机应答,那么渠道可以发起换舱功能。渠道可以向其他车辆供应商发起换舱下单(同普通的出租车及时下单的区别在于多了两个参数 "changeSPFlag" 和 "changeSPLockDuration", 具体含义请查看下单接口),当首汽出租车系统收到此类下单请求时(下单参数中有changeSPFLag标志和changeSPLockDuration时长且值有效),在成功派单给某个司机后,会锁定该司机一定时长(依据下单时传递的锁定时长参数),并通知渠道侧该司机的信息(此通知与正常订单状态变化通知可能会并行或者有重复,渠道需要视情况来处理)。渠道侧内部决策,如果觉得选用首汽的该司机,那么需要调用新的接口(渠道换舱派单决策通知接口)来通知。

注:此功能需要联系商务和产品进行开通

渠道换舱-派单决策通知接口

注:当订单为换舱订单且渠道决定选择首汽出租车时才需要调用此接口

1、接口路径

/v1/common/dispatched/notify

2、请求方式

http method: post

content-type: application/x-www-form-urlencoded

charset: utf8

3、参数

参数名称 参数类型 是否必传 参数说明
orderId 字符串 首汽订单号
channel 字符串 渠道号,请求来源标识
partnerOrderId 字符串 渠道订单号
notifyTime 字符串 渠道侧内部决策成功毫秒时间戳
sign 字符串 签名

4、响应

字段名称 字段类型 字段说明
result int 0-成功,1-失败
errmsg string 失败原因说明
data Object null
{
    "result": 0,
    "errmsg": "success !",
    "data": null
}
Copyright © 首约科技(北京)有限公司 2020 all right reserved,powered by Gitbook该文件修订时间: 2024-09-10 08:31:45

results matching ""

    No results matching ""