文档中心 > 国际机票

1、业务介绍

1)飞猪辅营商品包括国内和国际两类场景。本文档范围是国际LCC廉航的辅营销售。

2)辅营商品包括:行李,餐食,值机。

     其中行李可以在填写页进行伴随机票的一次销售,也支持在订单详情页的二次销售。餐食,值机目前暂时支持一次销售。

3)行李对接支持商家报价和平台报价,餐食和值机只支持平台报价,商家接收订单的模式。

4)行李和餐食的回填发货用top接口,值机的回填发货用代理商后台。

 

购买辅营产品流程:

1) 飞猪为旅客展示平台辅营信息

2) 用户选择行李并下单

3) 飞猪在order(一次)、auxOrder(二次)接口中传输辅营报价来源及辅营报价信息

4) 代理人在order(一次)、auxOrder(二次)接口返回时确认该辅营是否预定成功

   (机票与辅营分别返回预定结果)

5) 若平台允许用户支付,且用户支付成功,行李信息可在国际代理商管理后台-lcc辅营订单中查看

     或通过tripvp辅营订单详情接口查看

6) 代理人为用户出机票及辅营,并分别回填辅营和机票出票凭证

 

 

2、页面展示(行李搭售场景):

 

1,填单页展示

l  订单填写页展示加价后的行李额信息,包括重量和价格

l  用户可选择不同行李重量,每位乘机人在每个航段下限购一件行李

l  用户选择后,即可下单并支付

l  一个机票订单可以关联多个辅营订单

 

 

2,订单详情页展示

l  订单详情页展示用户下订单时选择的行李重量和价格

 

 

3,机票代理商管理系统-LCC辅营订单列表

入口地址:https://ijipiao.alitrip.com/agent/ie_order_list.htm

image.png

l  飞猪的机票订单与辅营订单是两个订单

l  代理商可以在机票代理商管理系统中的lcc辅营订单列表模块看到辅营订单信息

l  辅营订单和机票订单中都会分别关联对方的信息

 

4,辅营商品代理商后台-订单管理

image.png

l  点击lcc订单管理后,进入辅营管理后台

l  商家可按时间段查询辅营订单详情

辅营订单与机票订单处理流程一致,需要商家回填辅营出货凭证;目前平台对辅营出货凭证不做验真

l  辅营出货前,请查看一下辅营订单的支付状态,确保为用户已支付状态。

辅营出货完毕后,飞猪会自动转账打款

辅营行李与餐食请使用TOP接口发货(具体查看文内表格)

 

 

3、流程对接:

通用流程:

1,下载API直连对接文档 和 对接TOP文档(辅营发货、查单),

直连文档下载地址:国际运价直连接口开发规范

    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直连的接口,该文档只描述辅营流程,请注意!

下列流程会区分类型,请注意查看正确的!】

 

一次辅营(搜索、下单页):

    使用平台辅营数据: 

        辅营行李(开发直连order生单接口,开发TOP接口):

        1,按照直连文档 完成 正常的渠道对接.

             直连文档下载地址:国际运价直连接口开发规范

        2,开发升级order接口支持辅营字段(PassengerAux Element):

        3,创建TOP应用,并完成TOP接口预开发:

            TOP对接文档:

                > TOP应用创建文档

                > 接口对接文档

                         > 查询辅营订单列表(alitrip.tripvp.agent.order.search)

                             功能说明:查询辅营订单列表。

                         > 廉航辅营正向订单查询详情接口(alitrip.tripvp.agent.order.get)

                            功能说明:廉航辅营正向订单查询详情接口。

                         > 廉航辅营正向订单出货接口(alitrip.tripvp.agent.order.issue)

                            功能说明:廉航辅营正向订单出货接口。

        l  每个接口会提供对应的SDK示例代码,在接口文档下方。

image.png

 

        4,按照业务类型,使用 自测工具 完成接口自测(确保多次,整体业务处理正常)

image.png

image.png         

        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, 完成(后续进行正常的履约流程)

 

 

        辅营餐食(开发直连order生单接口,开发TOP接口):

        l  流程与辅营行李基本相同,请按照上方方法对接。

        l  注意:餐食 productType = 7 

 

        辅营值机(开发直连order生单接口,代理商后台发货):

        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

image.png

 

        4,按照业务类型,使用 自测工具 完成接口自测。

             > 返回的航司是廉价航司。

             > 航班已经打包上了行李的价格,返回的票价 直接是 已经加上行李的价格。

        5,联系运营同学,完成上线。

        6,线上测试搜索、下单等流程是否正常。

        7,完成(后续进行正常的履约)

       注意:

       l  行李打包坑位,不会单独生成一个辅营订单,全程相当于一个带行李价格的机票。

       l  由商家告知商家运营计划在行李打包坑位销售的航司列表(限廉航),运营加入对应渠道航司白名单中。

       l  廉价航空默认没有行李额,商家在search 运价接口返回 打包好行李的 机票价格。

 

 

        辅营行李搭售(订单填写页辅营购买):

        1,按照直连文档 完成 正常的渠道对接.

             直连文档下载地址:国际运价直连接口开发规范

        2,开发AuxSearch(辅营搜索)接口,升级order接口支持辅营字段(PassengerAux Element

image.png

        order 接口 PassengerAux Element 字段:

        

 

        3,创建TOP应用,并完成TOP接口预开发:

             TOP对接文档:

                    > TOP应用创建文档

                    > 接口对接文档

                         > 查询辅营订单列表(alitrip.tripvp.agent.order.search)

                             功能说明:查询辅营订单列表。

                         > 廉航辅营正向订单查询详情接口(alitrip.tripvp.agent.order.get)

                            功能说明:廉航辅营正向订单查询详情接口。

                         > 廉航辅营正向订单出货接口(alitrip.tripvp.agent.order.issue)

                            功能说明:廉航辅营正向订单出货接口。

            l  每个接口会提供对应的SDK示例代码,在接口文档下方。

image.png

            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, 完成(后续进行正常的履约流程)

 

        辅营餐食:

        暂不支持使用商家的餐食数据,如果想要使用平台的餐食数据,请查看上方文档。

 

        辅营值机:

        暂不支持使用商家的餐食数据,如果想要使用平台的餐食数据,请查看上方文档。

 

 

 

二次辅营(订单详情页二次购买):

    使用平台辅营数据:

        辅营行李(开发直连order生单接口,开发TOP接口):

        1,按照直连文档 完成 正常的渠道对接.

             直连文档下载地址:国际运价直连接口开发规范

        2,开发Auxorder(二次辅营生单接口)接口

image.png 

        3,创建TOP应用,并完成TOP接口预开发:

             TOP对接文档:

                    > TOP应用创建文档

                    > 接口对接文档

                         > 查询辅营订单列表(alitrip.tripvp.agent.order.search)

                             功能说明:查询辅营订单列表。

                         > 廉航辅营正向订单查询详情接口(alitrip.tripvp.agent.order.get)

                            功能说明:廉航辅营正向订单查询详情接口。

                         > 廉航辅营正向订单出货接口(alitrip.tripvp.agent.order.issue)

                            功能说明:廉航辅营正向订单出货接口。

            l  每个接口会提供对应的SDK示例代码,在接口文档下方。

image.png

            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 商家后台回填
大卖家接口自测查询

https://iebonus.fliggy.com/iebonus/agentApiSelfHelper.htm

出货方式 接口名称或地址
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的订单入口?

    image.png

A:需要完成TOP接口和直连接口的上线 才会有这个菜单入口。

 

 

FAQ

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