me.chanjar.weixin.cp.api

接口 WxCpOaService

所有已知实现类:

WxCpOaServiceImpl

public interface WxCpOaService

企业微信OA相关接口.

作者:

Element & Wang_Wong created on 2019-04-06 10:52

方法概要

限定符和类型	方法和说明
void	addCheckInUserFace(String userId, String userFace) 录入打卡人员人脸信息 企业可通过打卡应用Secret调用本接口，为企业打卡人员录入人脸信息，人脸信息仅用于人脸打卡。
String	apply(WxCpOaApplyEventRequest request) 提交审批申请 调试工具 企业可通过审批应用或自建应用Secret调用本接口，代应用可见范围内员工在企业微信“审批应用”内提交指定类型的审批申请。
String	createOaApprovalTemplate(WxCpOaApprovalTemplate cpTemplate) 创建审批模板 可以调用此接口创建审批模板。
WxCpGetApprovalData	getApprovalData(@NonNull Long startTime, @NonNull Long endTime, Long nextSpNum) 获取审批数据（旧） 提示：推荐使用新接口“批量获取审批单号”及“获取审批申请详情”，此接口后续将不再维护、逐步下线。
WxCpApprovalDetailResult	getApprovalDetail(@NonNull String spNo) 获取审批申请详情 企业可通过审批应用或自建应用Secret调用本接口，根据审批单号查询企业微信“审批应用”的审批申请详情。
WxCpApprovalInfo	getApprovalInfo(@NonNull Date startTime, @NonNull Date endTime) 已过时。
WxCpApprovalInfo	getApprovalInfo(@NonNull Date startTime, @NonNull Date endTime, Integer cursor, Integer size, List<WxCpApprovalInfoQueryFilter> filters) 已过时。
WxCpApprovalInfo	getApprovalInfo(@NonNull Date startTime, @NonNull Date endTime, String newCursor, Integer size, List<WxCpApprovalInfoQueryFilter> filters) 批量获取审批单号 审批应用及有权限的自建应用，可通过Secret调用本接口，以获取企业一段时间内企业微信“审批应用”单据的审批编号，支持按模板类型、申请人、部门、申请单审批状态等条件筛选。
List<WxCpCheckinData>	getCheckinData(Integer openCheckinDataType, Date startTime, Date endTime, List<String> userIdList) 获取打卡数据 API doc : https://work.weixin.qq.com/api/doc#90000/90135/90262
List<WxCpCheckinDayData>	getCheckinDayData(Date startTime, Date endTime, List<String> userIdList) 获取打卡日报数据
List<WxCpCheckinMonthData>	getCheckinMonthData(Date startTime, Date endTime, List<String> userIdList) 获取打卡月报数据
List<WxCpCheckinOption>	getCheckinOption(Date datetime, List<String> userIdList) 获取打卡规则 API doc : https://work.weixin.qq.com/api/doc#90000/90135/90263
List<WxCpCheckinSchedule>	getCheckinScheduleList(Date startTime, Date endTime, List<String> userIdList) 获取打卡人员排班信息
WxCpCorpConfInfo	getCorpConf() 获取企业假期管理配置 企业可通过审批应用或自建应用Secret调用本接口，获取可见范围内员工的“假期管理”配置，包括：各个假期的id、名称、请假单位、时长计算方式、发放规则等。
List<WxCpCropCheckinOption>	getCropCheckinOption() 获取企业所有打卡规则 API doc : https://work.weixin.qq.com/api/doc/90000/90135/93384
List<WxCpDialRecord>	getDialRecord(Date startTime, Date endTime, Integer offset, Integer limit) 获取公费电话拨打记录
WxCpOaApprovalTemplateResult	getTemplateDetail(@NonNull String templateId) 获取审批模板详情
WxCpUserVacationQuota	getUserVacationQuota(@NonNull String userId) 获取成员假期余额 企业可通过审批应用或自建应用Secret调用本接口，获取可见范围内各个员工的假期余额数据。
void	setCheckinScheduleList(WxCpSetCheckinSchedule wxCpSetCheckinSchedule) 为打卡人员排班
WxCpBaseResp	setOneUserQuota(@NonNull String userId, @NonNull Integer vacationId, @NonNull Integer leftDuration, @NonNull Integer timeAttr, String remarks) 修改成员假期余额 企业可通过审批应用或自建应用Secret调用本接口，修改可见范围内员工的“假期余额”。
void	updateOaApprovalTemplate(WxCpOaApprovalTemplate wxCpTemplate) 更新审批模板 可调用本接口更新审批模板。

方法详细资料

apply

String apply(WxCpOaApplyEventRequest request)
      throws WxErrorException

提交审批申请
 调试工具
 企业可通过审批应用或自建应用Secret调用本接口，代应用可见范围内员工在企业微信“审批应用”内提交指定类型的审批申请。

 请求方式：POST（HTTPS）
 请求地址： https://qyapi.weixin.qq.com/cgi-bin/oa/applyevent?access_token=ACCESS_TOKEN
 文档地址：https://work.weixin.qq.com/api/doc/90000/90135/91853
 

参数:

request - 请求

返回:

表单提交成功后 ，返回的表单编号

抛出:

WxErrorException - .

getCheckinData

List<WxCpCheckinData> getCheckinData(Integer openCheckinDataType,
                                     Date startTime,
                                     Date endTime,
                                     List<String> userIdList)
                              throws WxErrorException

  获取打卡数据
  API doc : https://work.weixin.qq.com/api/doc#90000/90135/90262
 

参数:

openCheckinDataType - 打卡类型。1：上下班打卡；2：外出打卡；3：全部打卡

startTime - 获取打卡记录的开始时间

endTime - 获取打卡记录的结束时间

userIdList - 需要获取打卡记录的用户列表

返回:

打卡数据列表 checkin data

抛出:

WxErrorException - 异常

getCheckinOption

List<WxCpCheckinOption> getCheckinOption(Date datetime,
                                         List<String> userIdList)
                                  throws WxErrorException

   获取打卡规则
   API doc : https://work.weixin.qq.com/api/doc#90000/90135/90263
 

参数:

datetime - 需要获取规则的当天日期

userIdList - 需要获取打卡规则的用户列表

返回:

打卡规则列表 checkin option

抛出:

WxErrorException - .

getCropCheckinOption

List<WxCpCropCheckinOption> getCropCheckinOption()
                                          throws WxErrorException

   获取企业所有打卡规则
   API doc : https://work.weixin.qq.com/api/doc/90000/90135/93384
 

返回:

打卡规则列表 crop checkin option

抛出:

WxErrorException - the wx error exception

getApprovalInfo

@Deprecated
WxCpApprovalInfo getApprovalInfo(@NonNull
                                             @NonNull Date startTime,
                                             @NonNull
                                             @NonNull Date endTime,
                                             Integer cursor,
                                             Integer size,
                                             List<WxCpApprovalInfoQueryFilter> filters)
                                      throws WxErrorException

已过时。

 批量获取审批单号

 审批应用及有权限的自建应用，可通过Secret调用本接口，以获取企业一段时间内企业微信“审批应用”单据的审批编号，支持按模板类型、申请人、部门、申请单审批状态等条件筛选。
 自建应用调用此接口，需在“管理后台-应用管理-审批-API-审批数据权限”中，授权应用允许提交审批单据。

 一次拉取调用最多拉取100个审批记录，可以通过多次拉取的方式来满足需求，但调用频率不可超过600次/分。

 API doc : https://work.weixin.qq.com/api/doc/90000/90135/91816
 

参数:

startTime - 开始时间

endTime - 结束时间

cursor - 分页查询游标，默认为0，后续使用返回的next_cursor进行分页拉取

size - 一次请求拉取审批单数量，默认值为100，上限值为100

filters - 筛选条件，可对批量拉取的审批申请设置约束条件，支持设置多个条件,nullable

返回:

WxCpApprovalInfo approval info

抛出:

WxErrorException - .

getApprovalInfo

@Deprecated
WxCpApprovalInfo getApprovalInfo(@NonNull
                                             @NonNull Date startTime,
                                             @NonNull
                                             @NonNull Date endTime)
                                      throws WxErrorException

已过时。

short method

参数:

startTime - 开始时间

endTime - 结束时间

返回:

WxCpApprovalInfo approval info

抛出:

WxErrorException - .

另请参阅:

me.chanjar.weixin.cp.api .WxCpOaService#getApprovalInfome.chanjar.weixin.cp.api.WxCpOaService#getApprovalInfo

getApprovalInfo

WxCpApprovalInfo getApprovalInfo(@NonNull
                                 @NonNull Date startTime,
                                 @NonNull
                                 @NonNull Date endTime,
                                 String newCursor,
                                 Integer size,
                                 List<WxCpApprovalInfoQueryFilter> filters)
                          throws WxErrorException

 批量获取审批单号

 审批应用及有权限的自建应用，可通过Secret调用本接口，以获取企业一段时间内企业微信“审批应用”单据的审批编号，支持按模板类型、申请人、部门、申请单审批状态等条件筛选。
 自建应用调用此接口，需在“管理后台-应用管理-审批-API-审批数据权限”中，授权应用允许提交审批单据。

 一次拉取调用最多拉取100个审批记录，可以通过多次拉取的方式来满足需求，但调用频率不可超过600次/分。

 API doc : https://work.weixin.qq.com/api/doc/90000/90135/91816

 1 接口频率限制 600次/分钟
 2 请求的参数endtime需要大于startime， 起始时间跨度不能超过31天；
 3 老的分页游标字段cursor和next_cursor待废弃，请开发者使用新字段new_cursor和new_next_cursor。
 

参数:

startTime - 开始时间

endTime - 结束时间

newCursor - 分页查询游标，默认为0，后续使用返回的next_cursor进行分页拉取

size - 一次请求拉取审批单数量，默认值为100，上限值为100

filters - 筛选条件，可对批量拉取的审批申请设置约束条件，支持设置多个条件,nullable

返回:

WxCpApprovalInfo approval info

抛出:

WxErrorException - .

getApprovalDetail

WxCpApprovalDetailResult getApprovalDetail(@NonNull
                                           @NonNull String spNo)
                                    throws WxErrorException

   获取审批申请详情

   企业可通过审批应用或自建应用Secret调用本接口，根据审批单号查询企业微信“审批应用”的审批申请详情。

   API Doc : https://work.weixin.qq.com/api/doc/90000/90135/91983
 

参数:

spNo - 审批单编号。

返回:

WxCpApprovaldetail approval detail

抛出:

WxErrorException - .

getCorpConf

WxCpCorpConfInfo getCorpConf()
                      throws WxErrorException

获取企业假期管理配置 企业可通过审批应用或自建应用Secret调用本接口，获取可见范围内员工的“假期管理”配置，包括：各个假期的id、名称、请假单位、时长计算方式、发放规则等。 第三方应用可获取应用可见范围内员工的“假期管理”配置，包括：各个假期的id、名称、请假单位、时长计算方式、发放规则等。

请求方式：GET(HTTPS) 请求地址：https://qyapi.weixin.qq.com/cgi-bin/oa/vacation/getcorpconf?access_token=ACCESS_TOKEN

返回:

corp conf

抛出:

WxErrorException - the wx error exception

getUserVacationQuota

WxCpUserVacationQuota getUserVacationQuota(@NonNull
                                           @NonNull String userId)
                                    throws WxErrorException

获取成员假期余额 企业可通过审批应用或自建应用Secret调用本接口，获取可见范围内各个员工的假期余额数据。 第三方应用可获取应用可见范围内各个员工的假期余额数据。

请求方式：POST(HTTPS) 请求地址：https://qyapi.weixin.qq.com/cgi-bin/oa/vacation/getuservacationquota?access_token=ACCESS_TOKEN

参数:

userId - 需要获取假期余额的成员的userid

返回:

user vacation quota

抛出:

WxErrorException - the wx error exception

getApprovalData

WxCpGetApprovalData getApprovalData(@NonNull
                                    @NonNull Long startTime,
                                    @NonNull
                                    @NonNull Long endTime,
                                    Long nextSpNum)
                             throws WxErrorException

获取审批数据（旧） 提示：推荐使用新接口“批量获取审批单号”及“获取审批申请详情”，此接口后续将不再维护、逐步下线。 通过本接口来获取公司一段时间内的审批记录。一次拉取调用最多拉取100个审批记录，可以通过多次拉取的方式来满足需求，但调用频率不可超过600次/分。

请求方式：POST（HTTPS） 请求地址：https://qyapi.weixin.qq.com/cgi-bin/corp/getapprovaldata?access_token=ACCESS_TOKEN

参数:

startTime - 获取审批记录的开始时间。Unix时间戳

endTime - 获取审批记录的结束时间。Unix时间戳

nextSpNum - 第一个拉取的审批单号，不填从该时间段的第一个审批单拉取

返回:

approval data

抛出:

WxErrorException - the wx error exception

setOneUserQuota

WxCpBaseResp setOneUserQuota(@NonNull
                             @NonNull String userId,
                             @NonNull
                             @NonNull Integer vacationId,
                             @NonNull
                             @NonNull Integer leftDuration,
                             @NonNull
                             @NonNull Integer timeAttr,
                             String remarks)
                      throws WxErrorException

修改成员假期余额 企业可通过审批应用或自建应用Secret调用本接口，修改可见范围内员工的“假期余额”。 第三方应用可通过应本接口修改应用可见范围内指定员工的“假期余额”。

请求方式：POST(HTTPS) 请求地址：https://qyapi.weixin.qq.com/cgi-bin/oa/vacation/setoneuserquota?access_token=ACCESS_TOKEN

参数:

userId - 需要修改假期余额的成员的userid

vacationId - 假期id

leftDuration - 设置的假期余额，单位为秒，不能大于1000天或24000小时，当假期时间刻度为按小时请假时，必须为360整倍数，即0.1小时整倍数，按天请假时，必须为8640整倍数，即0.1天整倍数

timeAttr - 假期时间刻度：0-按天请假；1-按小时请假

remarks - 修改备注，用于显示在假期余额的修改记录当中，可对修改行为作说明，不超过200字符

返回:

one user quota

抛出:

WxErrorException - the wx error exception

getDialRecord

List<WxCpDialRecord> getDialRecord(Date startTime,
                                   Date endTime,
                                   Integer offset,
                                   Integer limit)
                            throws WxErrorException

获取公费电话拨打记录

参数:

startTime - 查询的起始时间戳

endTime - 查询的结束时间戳

offset - 分页查询的偏移量

limit - 分页查询的每页大小,默认为100条，如该参数大于100则按100处理

返回:

. dial record

抛出:

WxErrorException - .

getTemplateDetail

WxCpOaApprovalTemplateResult getTemplateDetail(@NonNull
                                               @NonNull String templateId)
                                        throws WxErrorException

获取审批模板详情

参数:

templateId - 模板ID

返回:

. template detail

抛出:

WxErrorException - .

createOaApprovalTemplate

String createOaApprovalTemplate(WxCpOaApprovalTemplate cpTemplate)
                         throws WxErrorException

创建审批模板
可以调用此接口创建审批模板。创建新模板后，管理后台及审批应用内将生成对应模板，并生效默认流程和规则配置。

  文档地址: https://developer.work.weixin.qq.com/document/path/97437
  权限说明
 • 仅『审批』系统应用、自建应用和代开发自建应用可调用。
 

参数:

cpTemplate - cpTemplate

返回:

templateId

抛出:

WxErrorException - .

updateOaApprovalTemplate

void updateOaApprovalTemplate(WxCpOaApprovalTemplate wxCpTemplate)
                       throws WxErrorException

更新审批模板
可调用本接口更新审批模板。更新模板后，管理后台及审批应用内将更新原模板的内容，已配置的审批流程和规则不变。

  文档地址: https://developer.work.weixin.qq.com/document/path/97438
  权限说明
 • 仅『审批』系统应用，自建应用和代开发自建应用可调用
 • 所有应用都可以通过本接口更新自己的模板
 • 『审批』系统应用可以修改管理员手动创建的模板
 • 自建应用和代开发自建应用不可通过本接口更新其他应用创建的模板
 

参数:

wxCpTemplate - wxCpTemplate

抛出:

WxErrorException - .

getCheckinDayData

List<WxCpCheckinDayData> getCheckinDayData(Date startTime,
                                           Date endTime,
                                           List<String> userIdList)
                                    throws WxErrorException

获取打卡日报数据

参数:

startTime - 获取日报的开始时间

endTime - 获取日报的结束时间

userIdList - 获取日报的userid列表

返回:

日报数据列表 checkin day data

抛出:

WxErrorException - the wx error exception

getCheckinMonthData

List<WxCpCheckinMonthData> getCheckinMonthData(Date startTime,
                                               Date endTime,
                                               List<String> userIdList)
                                        throws WxErrorException

获取打卡月报数据

参数:

startTime - 获取月报的开始时间

endTime - 获取月报的结束时间

userIdList - 获取月报的userid列表

返回:

月报数据列表 checkin month data

抛出:

WxErrorException - the wx error exception

getCheckinScheduleList

List<WxCpCheckinSchedule> getCheckinScheduleList(Date startTime,
                                                 Date endTime,
                                                 List<String> userIdList)
                                          throws WxErrorException

获取打卡人员排班信息

参数:

startTime - 获取排班信息的开始时间。Unix时间戳

endTime - 获取排班信息的结束时间。Unix时间戳（与starttime跨度不超过一个月）

userIdList - 需要获取排班信息的用户列表（不超过100个）

返回:

排班表信息 checkin schedule list

抛出:

WxErrorException - the wx error exception

setCheckinScheduleList

void setCheckinScheduleList(WxCpSetCheckinSchedule wxCpSetCheckinSchedule)
                     throws WxErrorException

为打卡人员排班

参数:

wxCpSetCheckinSchedule - the wx cp set checkin schedule

抛出:

WxErrorException - the wx error exception

addCheckInUserFace

void addCheckInUserFace(String userId,
                        String userFace)
                 throws WxErrorException

 录入打卡人员人脸信息
 企业可通过打卡应用Secret调用本接口，为企业打卡人员录入人脸信息，人脸信息仅用于人脸打卡。
 上传图片大小限制:图片数据不超过1M
 请求方式：POST(HTTPS)
 请求地址：
 https://qyapi.weixin.qq.com/cgi-bin/checkin/addcheckinuserface?access_token=ACCESS_TOKEN
 文档地址：
 https://developer.work.weixin.qq.com/document/path/93378
 

参数:

userId - 需要录入的用户id

userFace - 需要录入的人脸图片数据，需要将图片数据base64处理后填入，对已录入的人脸会进行更新处理

抛出:

WxErrorException - the wx error exception