售前Q&A合集
服务：
Q:服务成本，结算模式（?结，预充值等），是否有余额监控预警？
A:没有余额监控，但是如果账户余额不足，支付的时候会有报错提示
Q：是否有测试环境？
A：新京杭没有测试环境，所以订单都需要真实订单，如要退改也需有真实需求进行退改。如有问题可随时反馈
Q：接口是否有qps及查定比限制？
A：目前接口没有查定比限制。
alitrip.flight.service.search 此接口QPS为30；
alitrip.flight.service.upload 此接口QPS为100；
其余接口没有QPS限制
api订单和c端订单是否同步？
A：商家在接口里面用哪个账号下单，哪个账号才能看到订单，用户登录自己的飞猪账号是看不到订单的
Q：线下服务协作方式确认，旺旺or钉钉群？
A：旺旺和电话两种。目前先以旺旺沟通为主，使用自己的采购账户的旺旺登录沟通就行。目前凌晨0点到8点之间旺旺不服务
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
Q：采购账户授权时返回 账号* is forbidden to login on *** according to app user-whiteList**
A：需要用申请appkey的账户登录open.taobao.com，在对应应用左侧菜单–应用设置-授权管理（或者叫授权报备）
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
1、Q：报错“请求参数错误”
A:需和运营确认是否分配渠道，若未分配则需分配之后才可调用。分配之后会在群公告中通知，使用通知的渠道名称才可正常调用，否则会报错
询价：
Q：报价不全（eg：没有自营店报价）
A：需要找运营进行配置，才可以获取到多种报价。如果是带婴儿询价，会有些报价因为不支持婴儿票被过滤，是正常现象
Q:飞猪自营和旗舰店资源的判断方法？具体是什么文字或字段？
A:有文字会告知你们是航司旗舰店还是自营（包含自营和自营派单），需要运营配置可以展示什么渠道的报价
Q：询价返回“远程调用服务超时”
A:建议使用指定航班询价，因为listing询价会比较慢，比较容易超时
Q:询价返回“搜索询价无报价”
A:需要检查几项入参，若检查后发现都无问题，则可研发小蜜反馈
1）需检查depcitycode是否入参的是城市码
2）需检查是否用listing询价类型查询指定航班（指定航班询价只能用ota指定航班询价，search_mode此字段入参为2）
Q：是否有一舱多价产品？中转、往返、多程是否均已支持？
A:目前只支持单程直飞
Q:alitrip.flight.service.search 接口文档显示必填，但是不填询价会报错是什么原因？
A:这里的flase是针对listing搜索的，如果使用的是指定航班询价，这些字段是必填的。后面备注里面有写
生单：
Q:创单后支付时限为多久？
A：正常是生单后需要10min之内支付
Q：生单或者支付时返回“远程调用服务超时”
A：这种是开放平台超时，开放平台默认超时时间只能5s，实际生单及支付要做一些列校验，可能会超时，后续会做优化，临时优化不了。这种情况需要调用订单详情接口查看订单状态，大概率是已经生单成功或者支付成功
Q：alitrip.flight.service.airbook生单预订adt_build_fee（成人机建费）是单人的机建费还是订单中所有成人的机建费？
adt_flight_item_price（成人的机票价格）这个是票面价还是销售价，是单成人的价格嘛？
A：机建费是单人的；机票价格是单人价格，销售价
Q:支付成功后轮询查票号，请问飞猪的平均出票时长是多少？
A:一般在支付后30分钟内出票
Q;从订单生单成功后直至出票，如果前后价格发生了变化，飞猪系统内部的处理是什么？直接出票失败？还是在某个价格范围内的变化直接出票？
A:按生单后支付价格出票。即使存在变价采购商也不会感知，我们内部解决
Q:订单详情中有b_pnr_list和c_pnr_list，这个是PNR嘛？两者有何分别？
A:两个pnr不一样，看cpnr就可以。bpnr是航空公司大编码，可能为空的。
Q:alitrip.flight.service.queryorderdetail?查询订单详情 order_status 返回的状态有什么？
A:order_status?会返回这几个状态:生单预订处理中/生单预订成功/订单已支付/订单成功/订单关闭。?订单成功相当于出票完成
改签：
Q：调用改签生单成功后（尚未调用改签单支付），此时调用取消改签单，是否能成功回到初始状态？
A：改签生单之后，支付之前，是可以调用取消接口的，此时可以取消改签单。如果是非自愿改签，无需支付的情况下，会直接走到待出票状态，此时不可取消
Q：看改签生单接口，没有选择自愿或者非自愿改签的选项
A：对的，没有自愿非自愿的字段，目前是系统自己判定是否可以非自愿改签
退票：
Q:除了病退需求传附件以外，其它类型是否也有需要传附件的，比如：非自愿疫情是否要附件？
A：一般如果退票渲染接口推荐提交疫情退，直接提交疫情退就可以了。如果航司没有出疫情政策，想要疫情退，需要提供附件，这种情况就提交航变退然后上传附件即可，我们会有审核。另外拒载也是需要提交附件的
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（退改所有手续费）需要传空过来
Q：调用alitrip.flight.refund.create（退票申请）接口返回“退票规则有更新，返回订单详情页后，请重新进行申请提交。”
A:需要检查refund_apply_type退票申请类型是哪个类型，如果航司并未出疫情政策但是申请类型传的是100（非自愿疫情），则会报错。若在航司没有疫情政策的情况下，需要提交疫情类型退票的话，需要提交2（航变类型退票）然后上传附件，我们这边会有审核
Q:退票流程中，原单退票是不是调了退票申请提交时，原单的PNR在这个接口中已经取消掉了？是否需要我们再额外调用取消PNR/订单的接口？
A:平台生单的退票提交成功，我们会自动取消pnr，不需要调用其他取消接口
Q:退改操作前是否已值机是在哪个接口能验证出来的呢?
A:值机我们没有接口旅客提交的时候系统会验，发现值机了没法提交
Q：提交退票时，飞猪内部的逻辑是怎样的？
A：一般情况下，提交退票满足退票类型就会自动取消编码，如果不符合的航司旗舰店或者自营会拒单不影响出行
Q：退票附件上传顺序，文档是先上传附件，然后再提交？
A：先上传附件，然后在调用提交退票接口的时候上传附件接口返回的url
Q:如果退票申请提交失败，哪些原因可以隔段时间再提交，哪些原因是可以告知用户无法提交的，哪些原因可以告知用户需要联系客服线下提交呢？
A:如线下发生过变动的客票，需要线下联系航司退票。其他情况都可以线上提交，如果有报错可随时反馈
Q:alitrip.flight.refund.create响应参数中apply_id_list退票单列表，这是个列表，那该接口是支持一次性批量提交多个退票单的对嘛？新京航系统中的退票单维度是以人为单位来拆分的还是以订单维度来拆分的？
A:提交退票时每个FlightRefundGroupParam对应一个退票单列表。以人航段为单位拆分，多人提退会返回多个退票单id
Q:alitrip.flight.refund.detail此接口的返回的status的退票单各个状态代表什么意思？
A:
7：已退款，代表退票成功，退款完成
1:待处理；代表还在等待
2:已同意；代表商家已经同意退票，需要确认退票费等信息
6：已受理；代表商家已经受理了退票申请，正在操做退票
3：已拒绝：代表退票被拒绝，失败
Q：飞猪是否有航变接口？
A：目前还没有，还在开发中；现在如果航班发生航变，会给订单内预留的联系人手机号发送航变短信
接口能否提供完整全量的错误码？
A：目前只有接口层面的错误码，没有业务层面的错误码
*询价错误码：
|[ILLEGAL_PARAM(“isv.ILLEGAL_PARAM”, “请求参数错误，请检查入参”)]|
|[SEARCH_ITEM_FAIL(“isp.SEARCH_ITEM_FAIL”, “搜索询价无报价”)]|
|[BLACK_FORBIDDEN_VISIT(“isp.BLACK_FORBIDDEN_VISIT”, “渠道或者账号进入黑名单，请联系小二”)]|
|[UNACTIVATED_ACCOUNT(“isp.UNACTIVATED_ACCOUNT”, “渠道或账号未启用，请联系区域经理”)]|
|[SYSTEM_EXCEPTION(“isp.SYSTEM_EXCEPTION”, “系统错误，请稍后重试”)]|
*正向错误码：
|[SYSTEM_ERROR(“isv.SYSTEM_ERROR”, “系统错误”)]|
|[PARAM_EXCEPTION(“isv.INPUT_PARAM_ERROR”, “参数非法”)]|
|[NO_INTERFACE_AUTH(“isv.NO_INTERFACE_AUTH”, “无该接口访问权限”)]|
|[CREATE_PROCESSING(“isv.CREATE_PROCESSING”, “处理中，请勿重复预定”)]|
|[CREATE_SUCCESS(“isv.CREATE_SUCCESS”, “生单成功，请勿重复预定”)]|
|[CREATE_SUCCESS_TRADE_PROCESSING(“isv.CREATE_SUCCESS_TRADE_PROCESSING”, “生单成功，交易处理中，请勿重复预定”)]|
|[TRADE_SUCCESS(“isv.TRADE_SUCCESS”, “交易已完成,请勿重复预定”)]|
|[ORDER_IS_CLOSED(“isv.ORDER_IS_CLOSED”, “生单失败”)]|
|[QUERY_ORDER_IS_NULL(“00003”, “订单不存在”)]|
|[AUTHENTICATION_FAIL(“isv.AUTHENTICATION_FAIL”, “鉴权失败”)]|
|[ORDER_STATUS_CAN_NOT_PAY(“00005”, “订单状态非法，不可支付”)]|
|[ORDER_ALREADY_PAY_SUCCESS(“00006”, “订单已支付成功，请勿重复支付”)]|
|[ORDER_CLOSED_PAY_FAIL(“00007”, “订单已关闭，支付失败”)]|
|[PAY_PROCESSING(“00008”, “支付处理中，请勿重复支付”)]|
|[BOOKING_FAIL(“isv.BOOK_FAIL”, “预定失败”)]|
|[CREATE_FAIL(“000010”, “生单失败”)]|
*改签错误码：
|[SYSTEM_ERROR(“isv.SYSTEM_ERROR”, “系统错误”)]|
|[PARAM_EXCEPTION(“isv.INPUT_PARAM_ERROR”, “参数非法”)]|
|[BUSINESS_ERROR(“isv.BUSINESS_ERROR”, “业务异常”)]|
|[NO_INTERFACE_AUTH(“isv.NO_INTERFACE_AUTH”, “无该接口访问权限”)]|
|[CHANGE_ORDER_QUERY_FAIL(“isv.CHANGE_ORDER_QUERY_FAIL”, “改签单查询失败”)]|
|[CHANGE_ORDER_NOT_FOUND(“isv.CHANGE_ORDER_NOT_FOUND”, “改签单不存在”)]|
|[STATUS_OPERATE_FAIL(“isv.STATUS_OPERATE_FAIL”, “当前改签单状态不支持此操作”)]|
|[CHANGE_ORDER_CREATE_RETRY(“isv.CHANGE_ORDER_CREATE_RETRY”, “您的申请已提交，请稍后重试”)]|
