1)飞猪辅营商品包括国内和国际两类场景。本文档范围是国际LCC廉航的辅营销售。
2)辅营商品包括:行李,餐食,值机。
其中行李可以在填写页进行伴随机票的一次销售,也支持在订单详情页的二次销售。餐食,值机目前暂时支持一次销售。
3)行李对接支持商家报价和平台报价,餐食和值机只支持平台报价,商家接收订单的模式。
4)行李和餐食的回填发货用top接口,值机的回填发货用代理商后台。
1) 飞猪为旅客展示平台辅营信息
2) 用户选择行李并下单
3) 飞猪在order(一次)、auxOrder(二次)接口中传输辅营报价来源及辅营报价信息
4) 代理人在order(一次)、auxOrder(二次)接口返回时确认该辅营是否预定成功
(机票与辅营分别返回预定结果)
5) 若平台允许用户支付,且用户支付成功,行李信息可在国际代理商管理后台-lcc辅营订单中查看
或通过tripvp辅营订单详情接口查看
6) 代理人为用户出机票及辅营,并分别回填辅营和机票出票凭证
l 订单填写页展示加价后的行李额信息,包括重量和价格
l 用户可选择不同行李重量,每位乘机人在每个航段下限购一件行李
l 用户选择后,即可下单并支付
l 一个机票订单可以关联多个辅营订单
l 订单详情页展示用户下订单时选择的行李重量和价格
入口地址:https://ijipiao.alitrip.com/agent/ie_order_list.htm
l 飞猪的机票订单与辅营订单是两个订单
l 代理商可以在机票代理商管理系统中的lcc辅营订单列表模块看到辅营订单信息
l 辅营订单和机票订单中都会分别关联对方的信息
l 点击lcc订单管理后,进入辅营管理后台
l 商家可按时间段查询辅营订单详情
l 辅营订单与机票订单处理流程一致,需要商家回填辅营出货凭证;目前平台对辅营出货凭证不做验真
l 辅营出货前,请查看一下辅营订单的支付状态,确保为用户已支付状态。
l 辅营出货完毕后,飞猪会自动转账打款
l 辅营行李与餐食请使用TOP接口发货(具体查看文内表格)
1,下载API直连对接文档 和 对接TOP文档(辅营发货、查单),
直连文档下载地址:国际运价直连接口开发规范
TOP对接文档:
> 接口对接文档
> 查询辅营订单列表(alitrip.tripvp.agent.order.search)
功能说明:查询辅营订单列表。
> 廉航辅营正向订单查询详情接口(alitrip.tripvp.agent.order.get)
功能说明:廉航辅营正向订单查询详情接口。
> 廉航辅营正向订单出货接口(alitrip.tripvp.agent.order.issue)
功能说明:廉航辅营正向订单出货接口。
2, 按照上述文档完成接口开发 和 TOP接口开发(TOP接口上面三个都需要,直连接口请查看文内的表格)
3, 按照业务类型,使用 自测工具 完成接口自测(确保多次,整体业务处理正常)
4, 联系对接运营同学 完成后台验收与配置
5, 运营同学告知,配置完成后,进行线上下单自测(确保流程全部正常)
6, 测试TOP接口,拉单,查看详情,发货功能(确保报文全部正常)
7, 完成(后续进行正常的履约流程)
【一般辅营对接前 都已经对接过 API直连的接口,该文档只描述辅营流程,请注意!
下列流程会区分类型,请注意查看正确的!】
1,按照直连文档 完成 正常的渠道对接.
直连文档下载地址:国际运价直连接口开发规范
2,开发升级order接口支持辅营字段(PassengerAux Element):
3,创建TOP应用,并完成TOP接口预开发:
TOP对接文档:
> 接口对接文档
> 查询辅营订单列表(alitrip.tripvp.agent.order.search)
功能说明:查询辅营订单列表。
> 廉航辅营正向订单查询详情接口(alitrip.tripvp.agent.order.get)
功能说明:廉航辅营正向订单查询详情接口。
> 廉航辅营正向订单出货接口(alitrip.tripvp.agent.order.issue)
功能说明:廉航辅营正向订单出货接口。
l 每个接口会提供对应的SDK示例代码,在接口文档下方。
4,按照业务类型,使用 自测工具 完成接口自测(确保多次,整体业务处理正常)
l 使用平台行李,勾选生单接口 order 中的 passengerAuxes 字段,进行多次测试。
1,商家系统业务正常解析处理。
2,返回业务处理后的规范报文。
5, 联系对接运营同学 完成后台验收与配置
6, 运营同学告知,配置完成后,进行线上下单自测(确保运营同学知晓,流程全部正常)
7, 测试TOP接口,拉单,查看详情,发货功能(确保报文全部正常)
l 发货接口(alitrip.tripvp.agent.order.issue)目前不会校验,
发货确认后需要商家保障用户辅营订单履约,并且 辅营产品只有发货后才会回款。
l 每个接口会提供对应的SDK示例代码,在接口文档下方。
l 注意:辅营生单,可能存在用户支付失败的情况, 发货前请使用TOP接口 alitrip.tripvp.agent.order.get
查询字段 order_status 或 LCC辅营后台 确认是否为已支付状态。
8, 完成(后续进行正常的履约流程)
l 流程与辅营行李基本相同,请按照上方方法对接。
l 注意:餐食 productType = 7
l 对接流程与辅营行李基本相同,履约流程存在差异,值机当前不支持TOP发货。
需要在代理商后台 辅营订单页面操作,查询,发货等操作。
辅营订单列表:https://ijipiao.alitrip.com/agent/ie_order_list.htm
l 注意:餐食 productType = 6
1,按照直连文档 完成 正常的渠道对接.
2,联系运营同学,确认你们有哪些廉价航司的数据,商家运营评估后,协助创建新的行李打包渠道。
3,在直连接口search结果直接提供带行李的廉价航空航班。
票价为已经加上行李价格的打包价格。
Baggage Element中pc为3、2、1、-2或weight为1-50
4,按照业务类型,使用 自测工具 完成接口自测。
> 返回的航司是廉价航司。
> 航班已经打包上了行李的价格,返回的票价 直接是 已经加上行李的价格。
5,联系运营同学,完成上线。
6,线上测试搜索、下单等流程是否正常。
7,完成(后续进行正常的履约)
注意:
l 行李打包坑位,不会单独生成一个辅营订单,全程相当于一个带行李价格的机票。
l 由商家告知商家运营计划在行李打包坑位销售的航司列表(限廉航),运营加入对应渠道航司白名单中。
l 廉价航空默认没有行李额,商家在search 运价接口返回 打包好行李的 机票价格。
1,按照直连文档 完成 正常的渠道对接.
直连文档下载地址:国际运价直连接口开发规范
2,开发AuxSearch(辅营搜索)接口,升级order接口支持辅营字段(PassengerAux Element)
order 接口 PassengerAux Element 字段:
3,创建TOP应用,并完成TOP接口预开发:
TOP对接文档:
> 接口对接文档
> 查询辅营订单列表(alitrip.tripvp.agent.order.search)
功能说明:查询辅营订单列表。
> 廉航辅营正向订单查询详情接口(alitrip.tripvp.agent.order.get)
功能说明:廉航辅营正向订单查询详情接口。
> 廉航辅营正向订单出货接口(alitrip.tripvp.agent.order.issue)
功能说明:廉航辅营正向订单出货接口。
l 每个接口会提供对应的SDK示例代码,在接口文档下方。
l 注意:辅营生单,可能存在用户支付失败的情况, 发货前请使用TOP接口alitrip.tripvp.agent.order.get
查询字段 order_status 是否为已支付状态。
4,按照业务类型,使用 自测工具 完成接口自测(AuxSearch、order)。
5, 联系对接运营同学 完成后台验收与配置
6, 运营同学告知,配置完成后,进行线上下单自测(确保流程全部正常)
7, 测试TOP接口,拉单,查看详情,发货功能(确保报文全部正常)
l 注意:辅营生单,可能存在用户支付失败的情况, 发货前请使用TOP接口alitrip.tripvp.agent.order.get
查询字段 order_status 或 LCC辅营后台 确认是否为已支付状态。
8, 完成(后续进行正常的履约流程)
暂不支持使用商家的餐食数据,如果想要使用平台的餐食数据,请查看上方文档。
辅营值机:
暂不支持使用商家的餐食数据,如果想要使用平台的餐食数据,请查看上方文档。
1,按照直连文档 完成 正常的渠道对接.
直连文档下载地址:国际运价直连接口开发规范
2,开发Auxorder(二次辅营生单接口)接口
3,创建TOP应用,并完成TOP接口预开发:
TOP对接文档:
> 接口对接文档
> 查询辅营订单列表(alitrip.tripvp.agent.order.search)
功能说明:查询辅营订单列表。
> 廉航辅营正向订单查询详情接口(alitrip.tripvp.agent.order.get)
功能说明:廉航辅营正向订单查询详情接口。
> 廉航辅营正向订单出货接口(alitrip.tripvp.agent.order.issue)
功能说明:廉航辅营正向订单出货接口。
l 每个接口会提供对应的SDK示例代码,在接口文档下方。
l 注意:辅营生单,可能存在用户支付失败的情况, 发货前请使用TOP接口 alitrip.tripvp.agent.order.get
查询字段 order_status 是否为已支付状态。
4,按照业务类型,使用 自测工具 完成接口自测(AuxOrder)
5, 联系对接运营同学 完成后台验收与配置
6, 运营同学告知,配置完成后,进行线上下单自测(确保流程全部正常)
7, 测试TOP接口,拉单,查看详情,发货功能(确保报文全部正常)
l 注意:辅营生单,可能存在用户支付失败的情况, 发货前请使用TOP接口 alitrip.tripvp.agent.order.get
查询字段 order_status 或 LCC辅营后台 确认是否为已支付状态。
8, 完成(后续进行正常的履约流程)
l 注意:二次辅营TOP接口暂时无法区分,可以通过二次生单接口(auxOrder)判断。
下列对商家对接辅营功能,需要开发的接口做了一下罗列:
打包行李运价 (商家数据) |
在直连接口search结果直接提供,Baggage Element中pc为3、2、1、-2或weight为1-50 | |||
单独收费辅营产品 | 一次辅营直连接口 | 二次辅营直连接口 | 直连接口产品类型 | 出货方式 |
行李 | (商家数据) auxSearch, order |
auxOrder | productType=4 | TOP回填 |
餐食 | order | auxOrder | productType=7 | TOP回填 |
值机 | order | auxOrder | productType=6 | 商家后台回填 |
大卖家接口自测查询 | ||||
出货方式 | 接口名称或地址 | |||
TOP回填 | 廉航辅营正向订单出货接口 : alitrip.tripvp.agent.order.issue |
|||
商家后台回填 | LCC订单列表:https://agent.fliggy.com/virproagent/tripvp_seller_order_list.htm |
1,调用TOP接口出现报错:错误信息 text:无权限,msgForSys:No_Power,msgForClient:无权限
A: 如果出现这个报错,
1)先检查一下调用的接口的授权用户(sessionkey)是否是需要操作的店铺。
2)检查一下 入参中的AgentID是否正确,不能使用默认值!,如果不确定请群里@运营同学核实。
2,调用TOP接口出现这个报错 :错误码 11 isv.permission-api-package-limit
A:如果出现这个报错, 优先检查一下应用是否有api权限包权限。
open.alitrip.com -- 管理中心 -- 点击应用 -- 点击概览 -- 在概览中 查看是否已经获取。
1)检查一下代码的入参 是否是正确的APPKEY 。
2)检查一下应用 是否有 国际机票-代理商 的权限组。
3,调用TOP接口 出现这个错误 :错误码 11 isv.permission-ip-whitelist-limit
A: 出现这个报错,优先检查一下 是否绑定了IP白名单,检查位置。
open.alitrip.com -- 管理中心 -- 点击应用--安全中心 --IP白名单 。
1)检查一下 是否使用了其他的Appkey(应用),在应用中没有绑定ip白名单。
2)到后台检查一下 IP白名单是否配置,与聚石塔ECS(云服务器)的IP地址是否匹配。
4,辅营接口对接和TOP接口都已经对接完成,但是在订单的页面还是看不到我的辅营产品。
接口测试工具:https://iebonus.fliggy.com/iebonus/agentApiSelfHelper.htm
A : 这个问题导致的原因很多,需要按照不同的案例先进行自处理。
1)打开订单页面,但是没有请求到你们的接口。
原因/解法:可能配置不生效或者未配置,联系运营同学,查看是否已经帮助配置开启。
2)打开订单页面,已经请求到了你们的服务接口。并且接口有正常的数据返回。
1# 检查一下 返回的时间,返回的日期,是否按照标准。
2# 检查一下你们返回的关键字段:earlistBuyTime 是否已经在可售的时间(一般是起飞时间减当前的时间)
3# 检查一下你们的返回字段 :earlistBuyTime 是否过大.
5,为什么我没有LCC的订单入口?
A:需要完成TOP接口和直连接口的上线 才会有这个菜单入口。