一、办签进度功能说明

马蜂窝办签进度流程，主要针对于马蜂窝签证品类订单，当商家在后台针对于产品配置办签流程类型和出行信息模版之后，产品对应的订单将走细化的办签进度流程完成订单状态变更，用户页可以在前台页面第一时间的获取到不同办理人的办签进度信息。

这里的办签进度是针对于订单下的办理人而言，而非签证订单，一个签证订单对应一个办理流程类型，但是可对应一个或者多个办理人；

马蜂窝签证订单办签进度分为：贴纸签、电子签、面试\指纹签三种类型，不同办签类型状态流转旅游差异，以下将分别进行介绍。

二、办签进度状态流转

      不同签证类型办理流程不尽相同，商家在通过开放平台接口进行调用时，需要严格按照对应的办签流程变更办理人的办签进度信息；

1、贴纸签

2、电子签

3、面试\指纹签

三、开放平台办签进度支持接口说明

      此次开放平台主要像商家开放了以下接口作为功能支撑：

1. 获取办理人信息

        action：sales.visa.applicants.list.get

      链接：http://open.mafengwo.cn/docs/api/182.html

        该接口主要用于商家以订单为维度拉取订单办签进度流转类型订单下办理人当前办理进度状态，以及下一步可变更状态，为办理人办签进度状态变更提供指引；

 

2. 签证办理进度更新

      action：sales.visa.status.update

      链接：http://open.mafengwo.cn/docs/api/186.html

办理人办签进度状态变更一般接口，除状态：“8-已收到签证结果”与“9-已预约(需采集指纹/面试签)”外，其余办签进度状态均可通过此状态进行变更；

注：如果用户申请退款或者办签流程终止，商家可调用此接口，将办签进度置为“11-暂停办理”

 

3. 办签材料上传

      action：sales.visa.file.upload

      链接：http://open.mafengwo.cn/docs/api/178.html

        商家在变更状态：“8-已收到签证结果”与“9-已预约(需采集指纹/面试签)”之前，需要完成对应状态变更时签证材料文件的上传，商家上传文件之后，马蜂窝将向用户返回：file_unique_key字段，作为后续状态变更时的材料信息唯一标识；

 

4. 办签结果更新

      action：sales.visa.result.update

      链接：http://open.mafengwo.cn/docs/api/190.html

        商家在变更办理人状态到“8-已收到签证结果”唯一接口，调用此接口时，需附带签证材料上传文件返回的file_unique_key来完成接口的调用；

5. 提交预约信息

      action：sales.visa.appointment.update

      链接：http://open.mafengwo.cn/docs/api/194.html

        商家在变更办理人状态到“9-已预约(需采集指纹/面试签)”唯一接口，调用此接口时，需附带签证材料上传文件返回的file_unique_key来完成接口的调用；

 

6. 获取办签状态流转日志

     action：sales.visa.log.get

     链接：http://open.mafengwo.cn/docs/api/198.html

       商家通过办理人ID，订单号请求具体办理人的办签状态的日志记录；