审批中心接口

1 我的审批列表查询接口

1.1 接入说明

1. 基本能力：企业侧调用此接口，获取员工的审批任务清单，支持单次查询多个员工。
2. 适用场景：主要适用于“员工主动打开企业系统中的审批列表”等场景。美团企业版为客户提供了事前申请（下单预订前提交申请，通过后可下单）、事中审批（预订下单后需提交审批，审批通过后可支付）、事后报备（订单支付消费后需进行报备审批）等功能，如果企业客户希望在美团企业版系统完成审批流程控制和审批详情的查阅，同时支持员工在企业侧系统的待办中心等统一查看审批列表，则可以通过本文档进行接口对接。
3. 应用示意图：

1.2 接口说明

名称	描述
功能	查询审批列表
HTTP方法	POST
请求方	第三方渠道
响应方	美团企业版平台
uri	/audit/task/list/query
method	audit.task.list.query

1.3 公共参数

详见：公共参数说明-公共请求参数

1.4 业务请求参数

名称	类型	是否非空	说明
entId	Long	是	企业ID
staffIdList	List	否	查询员工的列表，staffId含义为美团侧存储的员工唯一标识，staffIdList和staffIdentifierList必传其一，都不为空时，只处理staffIdList
staffIdentifierList	List	否	查询员工的列表，staffIdentifier含义为企业的唯一标识（手机号或者工号或者邮箱，可和客户经理确认），staffIdList和staffIdentifierList必传其一，都不为空时，只处理staffIdList
searchType	Integer	是	审批任务搜索类型(1-待审批、2-已审批、3-抄送、4-已发起)
auditBizTypeList	List	是	审批业务类型(2002-出差申请、2007-用车申请、2009-酒店预订申请、2010-火车票预订申请、2011-新版事后报备、2013-机票预定申请)
startTime	Long	是	提交审批开始时间，13位时间戳
endTime	Long	是	提交审批结束时间，13位时间戳
pageNum	Integer	是	页码
pageSize	Integer	是	页大小，最大限制为100

1.5 业务响应

名称	类型	是否非空	说明
status	Integer	是	请求响应码
msg	String	是	请求响应信息
data	String	是	请求响应数据，内部是Json格式数据

Json格式数据说明

名称	类型	是否非空	说明
pageNum	int	是	当前页码
pageSize	int	是	当前页大小
totalCount	long	是	结果集数据总量
result	List<AuditTaskInfo>	否	行程数据列表

AuditTaskInfo 字段说明

名称	类型	是否必填	示例	说明
entId	Long	是	1001	企业ID
processInstanceId	Long	是	460242	审批流程实例ID
processName	String	是	审批流程	审批流程模板名称
processCode	String	是	sqtAudit151135213551218597986	审批流程模板编码
auditBizType	Integer	是	2009	审批业务类型
auditBizNo	String	是	1683647437501132849	审批业务编号
submitStaff	UserInfo	是		发起人
assigneeStaffList	List<UserInfo>	是		已审批人列表
candidateStaffList	List<UserInfo>	是		待审批人列表
carbonCopyStaffList	List<UserInfo>	是		抄送人列表

UserInfo 字段说明

名称	类型	是否非空	示例	说明
staffIdentifier	String	是	zhangsan@meituan.com	审批人在美团系统中的员工唯一标识(根据企业配置唯一标识，获取邮箱、电话、工号)
staffEntIdentifier	String	否		审批人在客户企业系统中的唯一标识

1.6 示例

业务请求参数

{
    "method":"audit.task.list.query",
    "ts":1695371519003,
    "entId":1001,
    "searchType": 4,
    "staffIdentifierList":["zhangsan@meituan.com"],
    "auditBizTypeList":[2009],
    "startTime":"1690371519003",
    "endTime":"1695371519003",
    "pageNum": 1,
    "pageSize": 10
}

业务响应

{
    "msg": null,
    "data": {
        "pageNum": 1,
        "pageSize": 10,
        "totalCount": 2,
        "result": [
            {
                "entId": 1001,
                "processInstanceId": 460242,
                "processName": "审批流程",
                "processCode": "sqtAudit151135213551218597986",
                "auditBizType": 2009,
                "auditBizNo": "1683647437501132849",
                "submitStaff": {
                    "staffIdentifier": "zhangsan@meituan.com",
                    "staffEntIdentifier": null
                },
                "assigneeStaffList": [
                    {
                        "staffIdentifier": "zhangsan@meituan.com",
                        "staffEntIdentifier": null
                    }
                ],
                "candidateStaffList": [],
                "carbonCopyStaffList": []
            },
            {
                "entId": 1001,
                "processInstanceId": 460359,
                "processName": "审批流程",
                "processCode": "sqtAudit153533213551218597986",
                "auditBizType": 2009,
                "auditBizNo": "1684009746438320171",
                "submitStaff": {
                    "staffIdentifier": "zhangsan@meituan.com",
                    "staffEntIdentifier": null
                },
                "assigneeStaffList": [
                    {
                        "staffIdentifier": "zhangsan@meituan.com",
                        "staffEntIdentifier": null
                    }
                ],
                "candidateStaffList": [],
                "carbonCopyStaffList": []
            }
        ]
    },
    "status": 0
}