接送机用车状态同步

更新时间:2017/11/10 访问次数:8309

业务场景

该流程适用于接送机直连对接业务(飞猪平台调用外部商家接口服务以完成相应业务流程),提供一系列回调API接口,用于服务商实时更接送机订单的用车状态。接送机用车订单状态推进流程图如下(状态只能按照流程节点依次变更):

image

注:1、所有虚线框标识的流程节点均为可选节点,即可以跳过该节点,直接调用相应API接口进入下一状态。

该流程开放的API接口

1、服务商确认接单

  • 当用户拍下用车且付款后,飞猪平台会创建一笔用车订单,此时订单状态为等待服务商确认接单。服务商通过回调该API接口(taobao.alitrip.car.order.accept)来完成确认接单,如果半个小时内没有回调确认接单,那么该订单会触发超时自动关单(订单关闭,退款给买家)。
  • 该流程为可选流程,服务商可以直接通过“派司机”回调来间接触发确认接单动作。

2、派司机/改派司机

  • 在服务商确认接单后,该订单进入等待司机服务状态,此时服务商需要在实际用车时间半小时前,通过回调该API接口(taobao.alitrip.car.order.confirm)来回传司机信息,司机信息将在飞猪APP展示给用户。如果服务商在用车时间前需要变更司机信息也可以通过该API接口完成改派司机。
  • 该流程为必选流程(将触发飞猪平台订单的卖家发货流程!),如果此时订单还处于“等待商家接单”,那么该操作将自动触发“服务商确认接单”和“派司机”。

3、司机服务状态更新

  • 在用车实际开始后,服务商可以通过回调该API接口(taobao.alitrip.car.driver.status.update)来更新司机的服务状态,支持的状态有:司机已出发,司机已到达,司机已开始服务。服务状态将在飞猪APP上实时展示给用户。
  • 该流程为可选流程,服务商可以跳过该流程,将状态直接推进到“司机服务完成”。
  • 如果有服务商的免费取消政策与司机出发状态强相关,此时该流程会变成关键流程(涉及用户取消订单时是免费还是收费),请注意!

4、司机服务完成

  • 在用车服务完成后,服务商可以通过回调该API接口(taobao.alitrip.car.order.complete)来完成订单履行服务。
  • 该流程为必选流程,司机服务完成回调成功后,订单状态将进入等待买家确认,此时买家才能确认收货,触发资金打到商家账户。

其他辅助API接口

飞猪用车订单状态查询

  • 该API接口用于服务商查询当前时刻下飞猪平台上对应的订单状态,主要用于辅助服务商确认飞猪订单状态,以确认下一步需要触发哪一个回调动作。

FAQ

关于此文档暂时还没有FAQ
返回
顶部