马蜂窝开放平台

获取办理人信息

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

调用频次

此接口调用频次上限默认为30次/分钟，如不能满足业务需要请添加马蜂窝开放平台交流群：201650204 申请调整。

请求URL

正式环境：https://openapi.mafengwo.cn/deals/rest

请求Action

action：sales.visa.applicants.list.get

请求参数

参数名称	参数类型	必填	示例	描述
order_id	string	是	2253329201801103938959	旅行商城业务订单号

响应参数

参数名称	参数类型	示例	描述
{}	object	0
└ visa_id	int	1200	办理人ID
└ order_id	string	2253329201801103938959	旅行商城业务订单号
└ name	string	张三	办理人姓名
└ status	int	1	当前办理人签证办理所处的状态具体说明请见办签进度状态说明
└ remark	string	邮件已经到了	供应商操作时写的描述
visa_data	array	[]	用户填写的预审材料
{}	object	0
└ title	string	身份证正面	模板字段名称
value	array	[]	签证材料信息
└ https://1.jpg	string	0	签证材料信息
└ type	int	1	0:非图片类型字段；1:图片类型字段
next_operate	array	[]	下一步可以操作的引导
{}	object	0
└ status	int	2	下一步可以操作的签证办理状态
└ status_name	string	待商家审核	关于下一步可操作签证状态的描述
└ visa_type	int	1	签证类型：1:贴纸签；2:电子签；3:面试／指纹签；4：另纸签
└ traveler_id	int	12315	出行人ID

响应示例

[
    {
        "visa_id":"1200",
        "order_id":"2253329201801103938959",
        "name":"张三",
        "status":"1",
        "remark":"邮件已经到了",
        "visa_data":[
            {
                "title":"身份证正面",
                "value":[
                    "https://1.jpg"
                ],
                "type":"1"
            }
        ],
        "next_operate":[
            {
                "status":"2",
                "status_name":"待商家审核"
            }
        ],
        "visa_type":"1",
        "traveler_id":"12315"
    }
]

异常错误码

异常码	异常信息
10070011	渠道账号未授权
10070010	订单渠道不匹配
10070003	签证ID异常
10070002	没有操作权限
10070001	订单号异常