接入前准备

1.需要运营提交aone流程

2.提交完aone流程之后，技术进行渠道分配（如果没有分配渠道，是无法调通接口的。在调用接口之前需检查是否分配渠道。可看群公告里面是否有通知，没有通知则为未分配）

3.渠道分配之后需要运营申请权限包

4.确认采购淘宝账户（不能是店铺账户），同时登陆www.taobao.com，查看账户绑定的支付宝账户

2.使用采购账号绑定的支付宝账户进行签约(一定使用淘宝账户绑定的支付宝进行签约）

注意事项：
支付宝账号必须是企业支付宝，采购账户不能是店铺账户
采购账户和渠道名称含义不同，渠道名称属于商家的一个标志，不做采购账号使用。采购账号是某一淘宝账号，这个淘宝账号不能是店铺账号，没有其他限制
2.1
CAE代扣签约
2.2
协议支付签约，可以先用付款账户登陆.taobao.com，然后再打开签约地址
或者使用通用签约链接进行签约

1、入驻开放平台流程(如使用系统商系统对接，以下步骤无需查看）:

https://fliggy.open.taobao.com/doc.htm?docId=121782&docType=1

2、创建应用，获得appkey

https://open.taobao.com/?spm=a219a.15212433.0.0.3617669abPKZJ7

3、给采购账户授权生成sessionkey

https://open.taobao.com/docV3.htm?docId=1&docType=17
注意事项：
3.1授权之前在appkey基础信息维护回调地址，同时appkey要发布上线状态
3.2授权生成的sessionkey有有效期（默认3-6个月，到期后需要重新授权）

4、接口需要在聚石塔内调用

聚石塔相关文档：https://open.alitrip.com/doc2/detail.htm?spm=a21tt.8223301.0.0.4826c486S0n9Zu&treeId=2&articleId=101130&docType=1

正向

需要接入的接口列表

接口	说明
alitrip.flight.service.search	京杭搜索航班询价
alitrip.flight.service.airbook	生单预定
alitrip.flight.service.close	机票关单
alitrip.flight.service.pay	机票支付
alitrip.flight.service.queryorderlist	查询订单列表
alitrip.flight.service.queryorderdetail	查询订单详情
alitrip_flight_TradeNotify	机票支付结果异步通知

正向接口交互模式

接口参数描述

京杭搜索航班询价（alitrip.flight.service.search）
* 功能说明：京杭搜索航班询价
* 新增字段：member_restrict，member_type，member_sub_type_list
* 新增字段功能描述：搜索接口结果用来表示该商品具有会员价限制，必须按照会员商品规则才能完成后续下单流程。
member_restrict： 会员价限制规则，如果该商品是会员价商品，则必须是会员才能享受该价格，那么该字段就不会为空。
member_type: 会员价商品类型，如果是乘机人是会员就能享受的，那就是乘机人会员，该值为0。 如果买家必须是会员才能享受的，那就是购买人会员，该值为1。
member_sub_type_list: 会员价商品子类型。如果要求是新会员（需要历史没注册过该航司会员）的（乘机人或购买人）才能享受的，该值为0， 如果要求是会员就能享受的，该值为1。 如果该用户没注册过该航司会员然后购买了含会员可享的商品，新京杭会帮其注册会员。
规则:
如果该商品是会员价商品，那么member_restrict，member_type和member_sub_type_list字段就一定不为空。这3个字段用来表示该商品是会员价商品。
* 接口输入输出参数
生单预定（alitrip.flight.service.airbook）
* 功能说明：机票生单预定
* 新增字段：allow_register_or_query_member，member_buyer
* 新增字段功能描述：allow_register_or_query_member : 允许新京杭为其注册或者查询会员。会员价商品该字段必须传，且必须传true
member_buyer: 购买人会员信息。 如果搜索的会员价类型，即member_type是1的话，那么这个字段及其里面的所有购买人信息字段就必须传。
* 接口输入输出参数
机票关单（alitrip.flight.service.close）
* 功能说明：未支付机票关单
* 接口输入输出参数
机票支付 （alitrip.flight.service.pay）
* 功能说明：机票支付接口
* 接口输入输出参数
查询订单列表 （alitrip.flight.service.queryorderlist）
* 功能说明：查询订单列表
* 接口输入输出参数
查询订单详情（alitrip.flight.service.queryorderdetail）
* 功能说明：查询订单详情
* 接口输入输出参数

逆向

退票需要接入的接口列表

接口	说明
alitrip.flight.refund.render	退票渲染
alitrip.flight.refund.create	退票申请提交
alitrip.flight.service.upload	附件上传
alitrip.flight.refund.detail	查询退票详情
alitrip.flight.refund.list	查询退票列表
alitrip_flight_RefundNotify	退票结果异步通知

退票接口交互模式

接口参数描述

退票渲染（alitrip.flight.refund.render）
* 功能说明：原票可退校验和退票费用预计算
* 接口输入输出参数
退票申请提交 （alitrip.flight.refund.create）
* 功能说明：创建退票单
* 接口输入输出参数
附件上传 （alitrip.flight.service.upload）
* 功能说明：特殊退票需上传附件(病退/拒载…）
* 接口输入输出参数
查询退票详情 （alitrip.flight.refund.detail）
* 功能说明：查询指定退票单的详细信息
* 接口输入输出参数
查询退票列表（alitrip.flight.refund.list）
* 功能说明：查询出票单下退票列表及概要信息
* 接口输入输出参数

改签需要接入的接口列表

接口	说明
alitrip.flight.change.order.create	改签生单
alitrip.flight.change.order.cancel	取消改签单
alitrip.flight.change.order.pay	改签单支付
alitrip.flight.change.order.query	改签单查询
alitrip_flight_ChangeStatusNotify	改签单状态变更通知

改签接口交互模式

接口参数描述

改签生单（alitrip.flight.change.order.create）
* 功能说明：1）原票可改校验(票&乘客信息) 2）确认改签费用信息 3）目的航班验舱、验价 4）占座
* 接口输入输出参数
取消改签单 （alitrip.flight.change.order.cancel）
* 功能说明：待支付改签单支持取消
* 接口输入输出参数
改签单支付 （alitrip.flight.change.order.pay）
* 功能说明：改签支付接口
* 接口输入输出参数
改签单查询 （alitrip.flight.change.order.query）
* 功能说明：1)查出票单关联改签单 2)查指定改签单详情
* 接口输入输出参数

消息通知

** 消息接入流程
机票支付结果异步通知（alitrip_flight_TradeNotify）
* 功能说明：支付成功消息、出票消息、关单消息通知
退票结果异步通知（alitrip_flight_RefundNotify）
* 功能说明：退票创建/拒绝/退款完成等节点通知
改签单状态变更通知（alitrip_flight_ChangeStatusNotify）
* 功能说明：改签单创建/待支付/待出票/出票成功/拒绝等状态通知

FAQ

1、Q：报错“请求参数错误”
A:需和运营确认是否分配渠道，若未分配则需分配之后才可调用

2、Q：商家反馈报错：{“error_response”:{“code”:26,“msg”:“Missing session”,“sub_msg”:“传入http参数中必需包含session字段”,“request_id”:“15rmr1v6v30w1”}}
A：需要授权获取session
步骤：https://open.taobao.com/doc.htm?docId=118395&docType=1
授权工具：https://open.taobao.com/docV3.htm?spm=a219a.15212433.0.0.3262669amtCS4s&docId=1&docType=17

3、Q：{“error_response”:{“code”:11,“msg”:“Insufficient isv permissions”,“sub_code”:“isv.permission-ip-whitelist-limit”,“sub_msg”:“The appkey 12345678 is only allowed to call from its ip white list, but the source ip 192.168.1.0 is not included”,“request_id”:“16mrtlto4sk4m”}}
A：需要登陆open.taobao.com，找到商家自己的应用，配置下ip白名单
https://console.open.taobao.com/?spm=a219a.7386653.1.3.3b89286cm364i0#/index

4、Q：报价不全（eg：没有自营店报价）
A：需要找运营进行配置，才可以获取到多种报价。如果是带婴儿询价，会有些报价因为不支持婴儿票被过滤，是正常现象

5、Q：询价返回“远程调用服务超时”
A:建议使用指定航班询价，因为listing询价会比较慢，比较容易超时

6、Q:询价返回“搜索询价无报价”
A:需要检查几项入参，若检查后发现都无问题，则可研发小蜜反馈
1）需检查depcitycode是否入参的是城市码
2）需检查是否用listing询价类型查询指定航班（指定航班询价只能用ota指定航班询价，search_mode此字段入参为2）

7、Q：生单或者支付时返回“远程调用服务超时”
A：这种是开放平台超时，开放平台默认超时时间只能5s，实际生单及支付要做一些列校验，可能会超时，后续会做优化，临时优化不了。这种情况需要调用订单详情接口查看订单状态，大概率是已经生单成功或者支付成功

8、Q:调用alitrip.flight.refund.create（退票申请）接口返回“退票手续费发生变化，请重试!”
A:分为两种情况：
1）需要检查ll_refund_fee字段传的手续费是否正确，如果与alitrip.flight.refund.render（退票渲染）此接口返回的预计算金额不一致，则会报错
2）如果alitrip.flight.refund.render（退票渲染）此接口calculate_success（预计算）字段返回flase，则为预计算失败，此时在调用退票申请接口时，all_refund_fee（退改所有手续费）需要传空过来

9、Q：调用alitrip.flight.refund.create（退票申请）接口返回“退票规则有更新，返回订单详情页后，请重新进行申请提交。”
A:需要检查refund_apply_type退票申请类型是哪个类型，如果航司并未出疫情政策但是申请类型传的是100（非自愿疫情），则会报错。若在航司没有疫情政策的情况下，需要提交疫情类型退票的话，需要提交2（航变类型退票）然后上传附件，我们这边会有审核

FAQ

关于此文档暂时还没有FAQ