使用场景

仅适用于新版签证订单（贴纸签、电子签证、面签、另纸签）的申请人进度管理操作，包括商家代填/修改申请人信息、更新申请人办理进度等操作，功能与飞猪卖家后台一致。

如何判断是否是新版签证订单：使用alitrip.travel.trade.query接口获取订单详情，在返回结果中有个商品类目扩展信息字段（category_ext_infos），如果该字段中包含key=isNewVisa，并且isNewVisa的值为true则可以使用该页面描述的进度管理流程，否则需要使用旧版 签证订单进度管理

请务必排除掉非新版签证的订单，否则接口会报错，最终会影响商品的排序！！！

申请人进度推进 详细流程图如下（状态只能按照流水依次变更）：

对接流程

过滤无效订单

• 过滤非新版新版签证订单：具体如何判断是否为新版签证订单请参考上面的描述

• 过滤掉还未付款的订单：只有已经付款的订单才需要更新申请人办理进度（订单消息和订单详情接口都有状态标识，请查看相关接口）

• 过滤掉已经交易成功的订单：如果交易已经成功，表示所以申请人已经办理完成，此时不需要再更新申请人办理进度

同步订单状态

商家系统和飞猪系统之间很可能会有数据不一致的情况，所以在更新申请人办理进度的时候必须先同步状态，否则会导致一直更新不成功！！！
调用 订单详情接口获取此订单最新的状态，并根据返回结果决定是否调用更新申请人办理进度以及如何更新申请人办理进度，出现异常后，请不要一直重复，重复次数3次最为合适，如果三次不能解决，请人工处理，否则最后会影响商品的排序！！！

• 如果返回结果中holdStatus=1，表示此订单暂停办理，此时不应该继续更新申请人办理进度（暂停办理一般是由于买家发起退款导致，此时该订单必须人工处理）

• 如果返回结果中holdStatus=0，表示此订单可以更新申请人办理进度，但需要同步申请人的状态信息
  1.将每个申请人的办理进度同步到自己的系统中，并保存每个申请人允许跳转的下一个状态集合
  2.判断申请人的数量是否已经达到上限，如果达到上限，此时不能再增加新的申请人（如果此时还有申请人待添加，请人工检查原因）

更新申请人办理进度

• 办理进度更新以单个申请人为单位，即一笔订单如果包含多个申请人，则不同申请人分开操作，可以更新到各自不同的进度状态。
• 更新申请人签证进度前，可以先通过辅助接口：订单详情查询（alitrip.travel.trade.query），获取该申请人当前的签证进度，以及下一个允许跳转的进度集合。特别注意：每一个申请人都有一个办理状态的标识（holdStatus：1-暂定办理，0-正常办理），如果是处于暂定办理状态（如买家发起退款申请），此时商家不应该再推进该申请人进度。
• 当申请人的进度状态处于 已终止办理（1010）时（如买家发起退款申请且申请成功），对于贴纸签和面签，此时商家只能将申请人进度推进 已退回资料（1014）。特别注意：商家无法发起将申请人进度推进到 已终止办理（1010）状态，该状态由飞猪系统内部触发。
• 对于贴纸签和面试签，由于办理过程中存在买家寄送材料的过程，因此在状态 已填写申请人（1002）和 商家已收到资料（1003）之间存在一个由买家发起的中间状态 买家已寄送材料（1011。注：该状态由买家操作，商家不能主动更新到该状态）。当申请人处于1002或1011状态下，商家都可以将状态更新到1003。
• 物流公司编码：用于回寄签证结果给买家时，商家上传物流公司信息。特别注意：回寄签证结果时该接口支持 买家自取（即无需物流）的情况，需要填写特定的物流公司代码，详见链接中说明。买家自取（即无需物流）情况，物流单号可随意填写，其他情况必须填写真实有效物流单号！

其他辅助API接口

订单详情查询

• 签证订单详情信息 包括以下几个重要部分：通用订单基本信息，签证类目相关扩展信息（category_ext_infos：签证国家码，签证类型，是否新版签证订单），签证申请人信息（travellers字段及其扩展字段extend_attributes：姓名，护照，申请人id，办理状态等）。
  垂直业务扩展信息定义：https://open.alitrip.com/docs/doc.htm?docType=1&articleId=107548
  申请人扩展信息定义：https://open.alitrip.com/docs/doc.htm?docType=1&articleId=107550
• 签证国家码说明

FAQ