审批对接¶

获取审批模板详情¶

---

使用场景： 企业可调用此接口，获取2号审批内指定审批模板的详情。

请求方式： GET（HTTPS）

请求地址： https://openapi.2haohr.com/api/approvals/{id}/template_detail/?access_token=ACCESS_TOKEN

参数说明：

参数	类型	是否必须	说明
access_token	String	是	调用接口凭证
id	String	是	模板id

接口说明：

• 该接口暂不支持人事、考勤、薪酬类型的审批模板

• 只支持自定义、行政、其他类型的审批模板对接第三方系统。

• 模板id可在2号审批的"审批表单模板-高级设置-API接入"获得。

• 审批表单的人事套件字段需要请求开放平台中员工相关接口。

权限说明

返回结果：

{
    "data":{ 
    "items": [ 
        { 
            "code": "text", 
            "is_required": false, 
            "id": "cc2b8c1cd********53efe4c1a69ead1", 
            "title": "客户名称",
            "desc":""
        },
        {
            "code": "multiple_choice",
            "option":[
            "选项一",
            "选项二",
            "选项三"
            ],
            "title": "多项选择",
            "default_index":[0],
            "is_required": false,
            "id": "cb8ad15f12****5bcacaaa2ca58",
            "desc": "请选择"
            },
        { 
            "code": "detail", 
            "is_required": true, 
            "config": [ 
                { 
                    "code": "money", 
                    "is_required": true, 
                    "id": "0b6d0*********410834dfa24333f0941", 
                    "title": "金额" ,
                     "desc":""
                }
            ], 
            "id": "4c77e6a*********89692de75f8fb6221", 
            "title": "明细" ,
            "desc":""
        } 
    ], 
    "desc": "对接易博营销", 
    "type": 1078, 
    "id": "61a7ede50********4ea3f249fb71518", 
    "title": "修改客户名称" 
},
    "errcode": 0,
    "errmsg": ""
    }

参数说明：

参数	类型	说明
id	String	模板的id
type	Int	模板类型
title	String	模板标题
desc	String	模板描述
items	Array	模板控件列表
└id	String	控件id
└code	String	控件标识
└title	String	控件标题
└desc	String	控件描述
└is_required	Boolean	控件内容是否必填
└option	Array	单多选控件选项列表
└default_index	Array	单多选控件默认选项列表
└config	Array	明细控件配置列表
└└id	String	控件id
└└code	String	控件标识
└└title	String	控件标题
└└desc	String	控件描述
└└is_required	Boolean	控件内容是否必填
└└option	Array	单多选控件选项列表
└└default_index	Array	单多选控件默认选项列表

错误说明：

错误码	说明
19400	模板id错误
19401	审批模板不存在
19402	审批模板已删除
19403	审批模板未启用
19413	只有指定的模板类型才能对接开放平台
19420	企业不匹配
19421	您没有对接2号审批的权限，请先在"审批表单模板-高级设置"中开启API接入

控件附录:

	title	code
基础字段
	单行文字	text
	多行文字	multi_text
	单项选择	option
	多项选择	multiple_choice
	日期	date
	日期时间	datetime_to_minute
	数字	number
	金额	money
	明细	detail
	填表说明	desc
	上传文件	attachment
	关联审批单	related_approval
	地理位置（暂不支持）	address
	身份证号码	credentials_no
	员工	select_user
	部门	select_dep
人事套件字段
	申请人	name
	申请人工号	emp_no_readonly
	申请人所在部门	deptpartment_readonly
	申请人岗位	job_title_name_readonly
	申请人岗位职级	job_level_name_readonly
	申请人入职日期	joining_date_readonly
	申请人合同公司	contract_company_name_readonly
	申请人工作城市	work_city_name_readonly
	申请人汇报上级	report_superior_readonly
	申请人职务	position_name_readonly
	申请人工作地点	work_place_name_readonly
	申请人工作性质	work_type_readonly
	申请人年龄	age_readonly
	申请人司龄	company_year_month_readonly
	申请人工龄	work_year_month_readonly
	申请人性别	sex_readonly
	申请人国籍	citizenship_readonly
	申请人民族	nation_readonly
	申请人籍贯	hometown_readonly
	申请人生日	birthday_readonly
	申请人婚姻状况	marriage_readonly
	申请人户口性质	account_nature_readonly
	申请人毕业院校	graduated_school_readonly
	申请人毕业专业	graduated_major_readonly
	申请人最高学历	top_education_readonly
	申请人毕业时间	graduation_time_readonly
	申请人证件类型	credentials_type_readonly
	申请人证件号	credentials_no_readonly
	申请人工资卡开户行	bank_readonly
	申请人工资卡卡号	wage_card_no_readonly
	申请人备注	remark_readonly

审批模板	类别	类型
录用	人事审批	1
转正	人事审批	2
离职	人事审批	3
调岗	人事审批	4
转全职	人事审批	5
调薪	人事审批	8
重新入职	人事审批	26
劳动合同签订	人事审批	27
招聘需求	人事审批	28
调班	考勤审批	30
请假	考勤审批	9
外出	考勤审批	10
出差	考勤审批	11
加班	考勤审批	12
补卡	考勤审批	13
销请假	考勤审批	32
销外出	考勤审批	33
销出差	考勤审批	34
入职定薪	薪酬审批	100
薪资调整	薪酬审批	101
离职停薪	薪酬审批	102
薪资发放	薪酬审批	103
入职定薪（智能薪酬）	薪酬审批	200
薪资调整（智能薪酬）	薪酬审批	201
薪资发放（智能薪酬）	薪酬审批	202
业务提报（智能薪酬）	薪酬审批	203
用车申请	行政审批	14
用印申请	行政审批	15
物品领用	行政审批	16
物品维修	行政审批	17
会议室预定	行政审批	18
报销	行政审批	19
费用	行政审批	20
付款申请	行政审批	21
采购	行政审批	22
证明	其他	6
通用审批	其他	7
立项申请	其他	23
资质使用	其他	24
合同审批	其他	25
自定义审批模板	其他	>=1000

提交审批申请¶

---

使用场景： 企业可调用此接口，在第三方系统内代员工提交指定类型的审批申请。

请求方式： POST（HTTPS）

请求地址： https://openapi.2haohr.com/api/approvals/submit_create/?access_token=ACCESS_TOKEN

接口说明：

• 该接口暂不支持人事、考勤、薪酬类型的审批提交

• 指定审批人：

调用此接口时，通过rules和ccs参数指定审批人和抄送人，审批节点支持普通、会签、或签、依次审批的方式。不支持审批模板的高级设置，比如"手写签名、修改权限、审批所在部门"无法使用。

• 不指定审批人：

调用此接口时，如果rules和ccs参数为空，复用2号审批HR端审批模板设置的审批流程，不支持"发起人自选"节点，条件审批流程暂不支持明细字段。

请求包结构体：

{ 
    "items": [ 
        { 
            "code": "text", 
            "id": "cc2b8c1cd2****fe4c1a69ead1", 
            "title": "客户名称", 
            "value": "" 
        },
        {
            "code": "multiple_choice",
            "title": "多项选择",
            "id": "cb8ad15f12a8*****cacaaa2ca58",
            "value": "选项三；选项一"
            },
        {
          "code": "attachment",
          "title": "上传文件",
          "id": "93ac9374a147****542a1b64a3",
          "file_list": [{"url": "", "filename": ""}]
        },
        { 
            "code": "detail", 
            "id": "4c77e6a4a03****e75f8fb6221", 
            "title": "明细",
            "group": [ 
                { 
                    "fields": [ 
                        { 
                            "code": "money", 
                            "id": "0b6d0*****4dfa24333f0941", 
                            "title": "金额", 
                            "value": 22 
                        }, 
                        { 
                            "code": "number", 
                            "id": "90e87a0dd7d6****6f3d872ce2", 
                            "title": "数字", 
                            "value": 223 
                        } 
                    ] 
                }
            ] 
        } 
    ], 
    "template_id": "61a7ede501a***4ea3f249fb71518", 
    "target_id": "309ab220-55dd***e667c264d1ae5c", 
    "emp_id": "309ab220****ee667c264d1ae5c", 
    "target_name": "**", 
    "emp_name": "**", 
    "rules": [ 
        { 
            "persons": [ 
                {
                    "emp_id": "1e18cb1d****b7b92f460ae7", 
                    "emp_name": "小米"
                }, 
                { 
                    "emp_id": "309ab220-55dd-****7c264d1ae5c", 
                    "emp_name": "小王"
                } 
            ], 
            "rule_type": 3, 
            "rule_title": "审批" 
        } 
    ], 
    "ccs": [ 
        { 
            "emp_id": "1e1****84b0-b7b92f460ae7", 
            "emp_name": "小李"
        } 
    ] 
}

参数说明：

参数	类型	是否必须	说明
access_token	String	是	调用接口凭证
template_id	String	是	模板id
target_id	String	是	申请人id
target_name	String	是	申请人姓名
emp_id	String	是	提交人id
emp_name	String	是	提交人姓名
items	Arrary	是	审批表单控件列表
└id	String	是	审批模板控件id
└title	String	是	审批表单控件标题
└code	String	是	审批表单控件标识
└value	String	否	审批表单控件填写的值
└value_id	String	否	部门,员工控件的id
└file_list	Arrary	否	附件上传
└└url	String	是	文件url
└└filename	String	否	文件名
└group	Arrary	否	审批表单明细控件配置组
└└fields	Arrary	否	审批表单明细控件配置
└└└id	String	是	审批模板控件id
└└└title	String	是	审批表单控件标题
└└└code	String	是	审批表单控件标识
└└└value	String	否	审批表单控件填写的值
└└└value_id	String	否	部门,员工控件的id
└└└file_list	Arrary	否	附件上传
└└└└url	String	是	文件url
└└└└filename	String	否	文件名
rules	Arrary	否	审批节点列表
└persons	Arrary	是	审批节点的审批人
└└emp_id	String	是	审批人id
└└emp_name	String	是	审批人姓名
└rule_type	Number	是	审批节点的类型：0普通，1会签，2或签，3依次
└rule_title	String	否	审批节点的标题
ccs	Arrary	否	抄送节点列表
└emp_id	String	是	抄送人id
└emp_name	String	是	抄送人姓名

注意：

• 附件上传最多15个文件，格式只支持jpg,jpeg,png,doc,docx,pdf,xls,xlsx,ppt,pptx,zip,rar,7z类型，单个文件不能大于25M。
• 附件的url的head请求，响应信息必须包含Content-Length和Content-Type。
• 附件如果不指定文件名则系统会随机生成一个文件名。
• 多项选择的选项以中文"；"作为分隔符，列如："选项三；选项一"。
• 多个关联审批单、员工、部门以英文"；"作为分隔符，列如："e93e1824**6ed49f091f87;1d811ca2****f98e0d5d7967"。

权限说明

返回结果：

{ 
    "target_name": "小王",
    "id": "82c01394bbd***58bd4e",
    "no": "2020111318***23",
    "template": "9ff647881b***3b81abce6660", 
    "emp_id": "309ab22055d****d1ae5c", 
    "status": 1, 
    "approver": "小李",
    "target_id": "309ab2***dd4aee667c264d1ae5c", 
    "emp_name": "小王", 
    "history_approver": "--", 
    "desc": "", 
    "update_dt": "2020-11-13T18:13:24", 
    "type": 1077, 
    "is_delete": false, 
    "title": "小王的通用审批", 
    "rule_id": "c35e184ec4d***6facf5dfbb4e65f", 
    "submit_dep_name": "***", 
    "submit_dep_id": "c35e184***896facf5dfbb4e65f" 
}

参数说明：

参数	类型	说明
id	String	审批单的id
template	String	审批单对应的模板id
type	Number	审批单对应的模板类型
title	String	审批单标题
desc	String	审批单描述
no	String	审批单的单号
status	Number	审批单状态：1进行中，2审批通过，3审批拒绝，4审批撤销
is_delete	Boolean	审批单是否被删除
approver	String	当前审批人id
history_approver	String	历史审批人姓名
target_id	String	申请人id
target_name	String	申请人姓名
emp_id	String	提交人id
emp_name	String	提交人姓名
submit_dep_id	String	审批单所在部门id
submit_dep_name	String	审批单所在部门名称
rule_id	String	当前审批节点
update_dt	Datetime	审批单最新修改时间

错误说明：

错误码	说明
19408	请求参数错误
19404	创建审批单失败
19406	抄送人不能超过100个
19407	审批节点不能超过20个
19410	审批节点不能为空
19411	审批节点的审批人不能超过100个
19412	不指定审批人和抄送人，且审批模板的审批流程有"发起人自选"节点导致审批单创建失败
19413	只有指定的模板类型才能对接开放平台
19414	普通审批节点审批人只能有1个人
19420	企业不匹配
19401	审批模板不存在
19415	上传附件的url有问题
19416	上传附件大小不能超过25M
19417	只支持jpg,jpeg,png,doc,docx,pdf,xls,xlsx,ppt,pptx,zip,rar,7z类型的文件上传
19418	上传附件的headers信息不满足要求
19419	附件的文件名不能大于150个字
19421	您没有对接2号审批的权限，请先在"审批表单模板-高级设置"中开启API接入
19423	您不在模板的可见范围
19424	您无权限代「申请人姓名」发起审批，请联系管理员调整表单发起设置
19425	提交的关联审批单【id1;id2...】不存在

获取审批模板列表¶

---

使用场景： 企业可调用此接口，获取2号审批内的审批模板列表(不包含删除)。

请求方式： POST（HTTPS）

请求地址： https://openapi.2haohr.com/api/approvals/template_list/?access_token=ACCESS_TOKEN

接口说明：

• 支持获取所有审批单模版列表

• 支持使用 模板标题(title)、模板类型(type_list)作为搜索条件，模板标题支持模糊搜索。

请求包结构体：

{
    "title": "内部",
    "type_list": [9, 10],
    "p": 1,
    "limit": 10
}

参数说明:

参数	类型	是否必须	说明
access_token	String	是	调用接口凭证
title	String	否	模板标题
type_list	Arrary[int]	否	模板类型列表
p	int	否	当前页数
limit	int	否	每页条数

权限说明

返回结果：

 {
        "p": 1,
        "limit": 10,
        "offset": 0,
        "total_count": 2,
        "totalpage": 1,
        "objects": [
            {
                "desc": "若因个人原因无法出勤，可提交如事假、短期病假等审批",
                "is_enable": true,
                "type": 9,
                "id": "06d3cec************b089b369796c",
                "title": "内部请假"
            },
            {
                "desc": "若外出拜访客户，无法到公司打卡考勤，可提交外出审批",
                "is_enable": true,
                "type": 10,
                "id": "128d6dd1************53906e754",
                "title": "内部出差"
            }
        ]
    }

参数说明:

参数	类型	说明
p	int	当前页数
limit	int	每页条数
offset	int	偏移量
total_count	int	总条数
totalpage	int	总页数
objects	Arrary	模板列表
└id	String	模板id
└is_enable	Boolean	模板状态， false停用， true启用
└type	int	模板类型（详细参考模板详情附录）
└title	String	模板标题
└desc	String	模板描述

错误说明：

错误码	说明
19421	您没有对接2号审批的权限，请先在"审批表单模板-高级设置"中开启API接入

获取审批记录详情¶

---

使用场景： 企业可调用此接口，通过审批单号获取2号审批的审批记录详情。

请求方式： GET（HTTPS）

请求地址： https://openapi.2haohr.com/api/approvals/{id}/submit_detail/?access_token=ACCESS_TOKEN

接口说明：

• 支持查询所有审批单类型的审批记录详情

参数说明：

参数	类型	是否必须	说明
access_token	String	是	调用接口凭证
id	String	是	审批单id

权限说明

返回结果：

{ 
    "objs": [ 
        { 
            "comment": {
                "id": "92326c2fba*****a525e9fd",
                "comment": "434343",
                "at_emps": [
                    {
                        "at_emp_id": "15da454aa20f****5dbe663",
                        "at_emp_name": "huar**g",
                        "at_emp_avatar": null,
                        "sort": 1
                    }
                ],
                "attachment": [
                    {
                        "mimeType": "image/jpeg",
                        "file_suffix": "jpg",
                        "frameNumber": "",
                        "hash": "Fn3LP_RnfB15Nt8po_z0hhNwQ2Fx",
                        "colorModel": "ycbcr",
                        "format": "jpeg",
                        "url": "https://approval-cdn-dev.2haohr.com/89b3207a***bb6a2a28144e3f5b5?attname=v2-673a3bfa0353047c132e175a5699bb88_720w.jpg&e=1610424405&token=kHQPThzbVJmJKaDo5HupfecLjZQcm5BOxUjlENLs:eLp2Syh0cDh4W1M4aLAYYa4Ree8=",
                        "filename": "v2-673a3bfa0353047c132e175a5699bb88_720w.jpg",
                        "width": "260",
                        "thumbnails_url": "https://approval-cdn-dev.2haohr.com/89b**7a8a72462bb6a2a28144e3f5b5-medium?e=1610424405&token=kHQPThzbVJmJKaDo5HupfecLjZQcm5BOxUjlENLs:53WcvTdrL7npJNstpkJjSPK1GSQ=",
                        "filesize": "7750",
                        "key": "89b3207a8a7**a28144e3f5b5",
                        "height": "162",
                        "putTime": 16104208052037352
                    }
                ],
                "emp_avatar": "https://pub-cdn-dev.2haohr.com/1e1f7064ea78***853500e61049",
                "emp_id": "309ab22055dd***e667c264d1ae5c",
                "emp_name": "1234",
                "emp_type": 0,
                "status": 1,
                "add_dt": 1610420807000
            },
            "attachment": null,
            "at_emps": null, 
            "sign_pic_url": null,  
            "sign_key": null, 
            "add_dt": 1606392832000, 
            "emp_name": "小飞", 
            "to_emp_name": null, 
            "agent_person_name": "309ab2205****67c264d1ae5c",
            "emp_id": "309ab2205****67c264d1ae5c",
            "to_emp_id": null, 
            "type": 0, 
            "desc": ""
        } 
    ], 
    "target_name": "小飞", 
    "type_name": "通用审批", 
    "id": "63bd6026b***82dbaf373fe7711", 
    "update_dt": 1606392832000, 
    "company_id": "b6d9aa2b****31c34f3fd7e30d0", 
    "submit_dep_name": "11", 
    "add_dt": 1606392832000, 
    "template": "61a7ede***ea3f249fb71518", 
    "emp_id": "309ab2205****67c264d1ae5c", 
    "type": 1078, 
    "status": 1, 
    "rules": [ 
        {   
            "id": "94ad268ec***a24f2fe754ab5b73",
            "status": 2, 
            "rule_type": 3,
            "rule_title": "审批", 
            "sort": 1, 
            "proc_dt": null, 
            "persons": [ 
                { 
                    "emp_id": "1e18cb1d8c****4b0b7b92f460ae7", 
                    "status": 1, 
                    "desc": "", 
                    "is_agent": false, 
                    "principal_person_id": null, 
                    "emp_name": "小里", 
                    "proc_dt": null,
                    "sort": 1
                }
            ]
        } 
    ], 
    "approver": "小米", 
    "target_id": "309ab22****ee667c264d1ae5c", 
    "is_delete": false, 
    "emp_name": "小米", 
    "history_approver": "--", 
    "desc": "对接易博营销", 
    "items": [ 
        { 
            "code": "text", 
            "value": "客户名称", 
            "title": "客户名称" 
        }, 
        { 
            "config": [ 
                { 
                    "code": "money", 
                    "id": "0b6d099449ee4***4dfa24333f0941", 
                    "title": "金额" 
                }, 
                { 
                    "code": "number", 
                    "id": "90e87a0dd7****56f3d872ce2", 
                    "title": "数字" 
                } 
            ], 
            "title": "明细",
            "value": "**", 
            "code": "detail", 
            "group": [ 
                { 
                    "fields": [ 
                        { 
                            "code": "money", 
                            "config": "", 
                            "value": "客户名称", 
                            "title": "金额" 
                        }, 
                        { 
                            "code": "number", 
                            "config": "", 
                            "value": "客户名称", 
                            "title": "数字" 
                        } 
                    ] 
              }   
            ]
        } 
    ], 
    "no": "202011***2243487", 
    "ccs": [ 
        { 
            "emp_id": "1e18cb1d8***4b0b7b92f460ae7", 
            "add_dt": 1606392832000, 
            "emp_name": "**" 
        } 
    ], 
    "title": "**的修改客户名称", 
    "rule_id": "94ad268ec1***2fe754ab5b73", 
    "submit_dep_id": "1e4c19558***c001ad047626d4" 
}

建议：第三方系统的数据库最好存取一些必要的字段，例如：审批单id、审批编号、审批单状态、申请人等。

参数说明：

参数	类型	说明
template	String	模板id
type	String	模板类型
type_name	String	模板标题
no	String	审批单号
title	String	审批单标题
target_id	String	申请人id
target_name	String	申请人姓名
emp_id	String	提交人id
emp_name	String	提交人姓名
submit_dep_id	String	审批单所在部门id
submit_dep_name	String	审批单所在部门名称
company_id	String	公司id
rule_id	String	当前审批节点id
history_approver	String	历史审批人姓名
is_group	Boolean	是否是集团审批单
approver	String	当前审批人姓名
status	Number	审批单状态：1进行中，2审批通过，3审批拒绝，4审批撤销
is_delete	Boolean	审批单是否被删除
add_dt	Datetime	审批单创建时间
update_dt	Datetime	审批单更新时间
items	Arrary	审批表单控件列表
└title	String	审批表单控件标题
└desc	String	审批模板控件描述
└code	String	审批表单控件标识
└value	String	审批表单控件填写的值
└value_id	String	部门,员工控件的id
└└desc	String	控件描述
└group	Arrary	审批单填写的明细控件组
└└fileds	Arrary	审批单填写的明细控件
└└└code	String	控件标识
└└└value	String	控件内容
└└└desc	String	控件描述
└└└title	String	控件标题
└└└value_id	String	部门,员工控件的id
rules	Arrary	审批节点列表
└id	String	审批节点id
└rule_type	Number	审批节点的类型：0普通，1会签，2或签，3依次
└rule_title	String	审批节点的标题
└sort	Number	审批节点顺序
└status	Number	审批节点状态：1新建，2进行中，3通过，4转交
└persons	Arrary	审批节点具体的人
└└emp_id	String	审批人id
└└emp_name	String	审批人姓名
└└proc_dt	Datetime	审批时间
└└desc	String	审批意见
└└status	Number	审批人的状态：1新建，2通过，3拒绝，4转交，5依次审批还未开始
└└sort	Number	审批人顺序
└└is_agent	Boolean	是否是代理审批人
└└principal_person_id	String	被代理人id
ccs	Arrary	抄送节点列表
└emp_id	String	抄送人id
└emp_name	String	抄送人姓名
└submit_copied	Boolean	是否已抄送
objs	Arrary	时间线列表
└comment	Arrary	时间线评论
└sign_pic_url	String	时间线签名链接
└sign_key	String	时间线签名key
└add_dt	String	时间线添加时间
└emp_id	String	时间线操作人id
└emp_name	String	时间线操作人姓名
└agent_person_name	String	时间线代理人姓名
└to_emp_id	String	时间线被操作人id
└to_emp_name	String	时间线被操作人姓名
└type	Number	时间线类型：0发起，1通过，2拒绝，3撤销，4评论，5转交，6加签
└desc	String	时间线描述

错误说明：

错误码	说明
19409	审批单id错误
19405	访问的审批单不存在
19420	企业不匹配
19421	您没有对接2号审批的权限，请先在"审批表单模板-高级设置"中开启API接入

获取审批记录列表¶

---

使用场景： 企业可调用此接口，获取2号审批的审批记录列表(不包含删除)。

请求方式： POST（HTTPS）

请求地址： https://openapi.2haohr.com/api/approvals/submit_list/?access_token=ACCESS_TOKEN

接口说明：

• 支持查询所有审批单类型的审批记录

• 审批记录列表接口支持使用内容、单号、标题、发起人姓名、发起人编号、申请人姓名、申请人编号、模板列表、类型列表、状态、创建时间、更新时间等参数作为搜索条件, 其中内容、标题、发起人姓名、申请人姓名支持模糊搜索

• 创建时间必填且范围必须小于6个月

• 一次最多查询100条审批单

请求包结构体：

{
    "content": "收入证明",
    "no": "20210628160243311444",
    "title": "小明",
    "emp_name": "小明",
    "emp_id": "309ab220********7c264d1ae5c",
    "target_id": "309ab220********7c264d1ae5c",
    "target_name": "小明",
    "template_list":["11516ab3*****2fbbd71e"],
    "type_list": [6],
    "status": 1,
    "add_dt_max": "2021-07-06",
    "add_dt_min": "2021-05-06",
    "update_dt_max": "2021-07-06",
    "update_dt_min": "2021-05-06",
    "p": 1,
    "limit": 10
  }

参数说明:

参数	类型	是否必须	说明
access_token	String	是	调用接口凭证
content	String	否	审批单内容
no	String	否	审批单单号
title	String	否	审批单标题
emp_name	String	否	发起人姓名
emp_id	String	否	发起人id
target_id	String	否	申请人id
target_name	String	否	申请人姓名
template_list	Arrary[String]	否	模板id列表
type_list	Arrary[int]	否	模板类型列表
status	int	否	审批单状态 1进行中，2审批通过，3审批拒绝，4审批撤销
add_dt_max	Datetime	是	审批单最大创建时间
add_dt_min	Datetime	是	审批单最小创建时间
update_dt_max	Datetime	否	审批单最大更新时间
update_dt_min	Datetime	否	审批单最小更新时间
p	int	否	当前页数
limit	int	否	每页条数

权限说明

返回结果：

{
    "p": 1,
    "limit": 10,
    "offset": 0,
    "total_count": 1,
    "totalpage": 1,
    "objects": [
        {
            "id": "11516ab3*****2fbbd71e",
            "abstract": [
                {
                    "value": "小明",
                    "title": "申请人"
                },
                {
                    "value": "运营部",
                    "title": "申请人所在部门"
                },
                {
                    "value": "收入证明",
                    "title": "证明类型"
                }
            ],
            "company_id": "b6d9aa2******4f3fd7e30d0",
            "dep_id": "f88e0982*****ecb8a712aca1",
            "dep_name": "运营部",
            "type": 6,
            "type_name": "证明审批",
            "no": "20210628160243311444",
            "title": "小明的证明审批",
            "desc": "适用于员工申请开具证明，包括收入证明、工作证明、离职证明",
            "add_dt": 1624867363000,
            "emp_id": "309ab220********7c264d1ae5c",
            "emp_name": "小明",
            "target_id": "309a*******ee6-67c264d1ae5c",
            "target_name": "小明",
            "status": 1,
            "update_dt": 1624867363000,
            "rule_id": "46637e46********d83ad2d94d64",
            "approver": "小天",
            "history_approver": "小丽、小吴",
            "from_type": 2,
            "submit_dep_id": "f88e0982*****ecb8a712aca1",
            "submit_dep_name": "运营部",
            "is_delete": false,
            "is_copied": false,
            "is_group": false,
            "template": "223c242e******610a2b53608"
            }
        ]
    }

参数说明:

参数	类型	说明
p	int	当前页数
limit	int	每页条数
offset	int	偏移量
total_count	int	总条数
totalpage	int	总页数
objects	Arrary	审批单列表
└id	String	审批单id
└abstract	Arrary	审批单摘要
└└value	String	审批单内容值
└└title	String	审批单内容标题
└company_id	String	公司id
└dep_id	String	申请人部门id
└dep_name	String	申请人部门名
└type	int	模板类型
└type_name	String	模板标题
└no	String	审批单单号
└title	String	审批单标题
└desc	String	模板描述
└add_dt	timestamp	审批单创建时间
└emp_id	String	发起人id
└emp_name	String	发起人姓名
└target_id	String	申请人id
└target_name	String	申请人姓名
└status	int	审批单状态1进行中，2审批通过，3审批拒绝，4审批撤销
└update_dt	timestamp	审批单更新时间
└rule_id	String	当前审批节点id
└approver	String	当前审批人姓名
└history_approver	String	历史审批人姓名
└from_type	int	审批单来源 1pc、2小程序、3第三方系统
└submit_dep_id	String	审批单所在部门id
└submit_dep_name	String	审批单所在部门姓名
└is_delete	Boolean	审批单是否删除
└is_copied	Boolean	审批单是否已抄送抄送人
└is_group	Boolean	是否是集团审批单
└template	String	模板id

错误说明：

错误码	说明
19421	您没有对接2号审批的权限，请先在"审批表单模板-高级设置"中开启API接入
19503	时间区间最多6个月
19504	一次最多查询100条审批单