大巴助手

1. 概述

1.1. 术语

1.2. 需求背景

      大巴票务行业商家,买家购买大巴车票商品后,旅客收到取票码,在取票机或柜台进行取票

1.3. 选题目标

      1. 接入大巴车场景的外部专业开发能力。

2. 用例分析

2.1 用例拆解

    image.png

   绿色部分为有赞云已有能力;橘黄色部分依赖于有赞的开放接口或扩展点;灰色部分为分销员 app 自有能力。

2.2 业务流程

      image.png
null

2.3 案例

      买家端      

      image.pngimage.png

3. 业务流程分析

3.1 车票管理——有赞商家

      image.png

      配置车次时,确定起点站、终点站,已经路途中经过的站点、里程数、价格计算依据、车位数量;同时确认发售的时间点和日期范围。根据设定的提前发售时间,由定时任务完成车票的上下架。某个确定日期、确定时间的车次作为一个商品。

3.2 车票查询页——买家

      image.png

      查询页面由 app 提供,商家在购买 app 后将该页面配置到店铺模版中。

3.2 商品详情——买家

      image.png

      由车票查询页跳转过来,携带车次、时间、启动、终点、价格信息;商品价格显示为起点到终点的价格。实际商品价格不显示。

3.3 下单确认页——买家

      image.png

      大把车商品预算设置成足够大,实际预算由 app 管控。在下单过程中,根据起点站、终点站控制好座位预算。下单后需要更新交易价格成实际里程价格。

3.4 订单详情——买家

      image.png

4. 开放接口与扩展点

4.1 对外开放接口

接口内容 提供方 开放接口地址
open-api-1 商品创建接口 商品中心 https://doc.youzanyun.com/doc#/content/API/1-299/detail/api/0/71
open-api-2 商品规格更新接口 商品中心 https://doc.youzanyun.com/doc#/content/API/1-299/detail/api/0/49
open-api-3 商品列表查询 商品中心 https://doc.youzanyun.com/doc#/content/API/1-299/detail/api/0/61
open-api-4 修改价格 交易中心 https://doc.youzanyun.com/doc#/content/API/1-305/detail/api/0/347

4.2 扩展点

扩展点 提供方 地址
extension-1 后端: 支付成功消息 交易中心 https://doc.youzanyun.com/doc#/content/EXT/1-1/detail/ext/42
extension-2 后端: 退款状态更新消息 交易中心 https://doc.youzanyun.com/doc#/content/EXT/1-1/detail/ext/60
extension-3 后端:下单失败消息 交易中心 https://doc.youzanyun.com/doc#/content/EXT/1-1/detail/ext/48
extension-4 前端:商品详情扩展页面 前端 查看 diy 定制页面
extension-5 前端:下单确认页面 前端 查看 diy 定制页面
extension-6 前端:订单详情页面 前端 查看 diy 定制页面