me.chanjar.weixin.cp.api.impl

类 WxCpOaServiceImpl

java.lang.Object

me.chanjar.weixin.cp.api.impl.WxCpOaServiceImpl

所有已实现的接口:

WxCpOaService

public class WxCpOaServiceImpl
extends Object
implements WxCpOaService

企业微信 OA 接口实现

作者:

Element created on 2019-04-06 11:20

构造器概要

构造器

构造器和说明
WxCpOaServiceImpl()

方法概要

限定符和类型	方法和说明
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) short method
WxCpApprovalInfo	getApprovalInfo(@NonNull Date startTime, @NonNull Date endTime, Integer cursor, Integer size, List<WxCpApprovalInfoQueryFilter> filters) 批量获取审批单号 审批应用及有权限的自建应用，可通过Secret调用本接口，以获取企业一段时间内企业微信“审批应用”单据的审批编号，支持按模板类型、申请人、部门、申请单审批状态等条件筛选。
WxCpApprovalInfo	getApprovalInfo(@NonNull Date startTime, @NonNull Date endTime, String newCursor, Integer size, List<WxCpApprovalInfoQueryFilter> filters) 批量获取审批单号 审批应用及有权限的自建应用，可通过Secret调用本接口，以获取企业一段时间内企业微信“审批应用”单据的审批编号，支持按模板类型、申请人、部门、申请单审批状态等条件筛选。
List<WxCpCheckinData>	getCheckinData(Integer openCheckinDataType, @NonNull Date startTime, @NonNull Date endTime, List<String> userIdList) 获取打卡数据 API doc : https://work.weixin.qq.com/api/doc#90000/90135/90262
List<WxCpCheckinDayData>	getCheckinDayData(@NonNull Date startTime, @NonNull Date endTime, List<String> userIdList) 获取打卡日报数据
List<WxCpCheckinMonthData>	getCheckinMonthData(@NonNull Date startTime, @NonNull Date endTime, List<String> userIdList) 获取打卡月报数据
List<WxCpCheckinOption>	getCheckinOption(@NonNull Date datetime, List<String> userIdList) 获取打卡规则 API doc : https://work.weixin.qq.com/api/doc#90000/90135/90263
List<WxCpCheckinSchedule>	getCheckinScheduleList(@NonNull Date startTime, @NonNull 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) 更新审批模板 可调用本接口更新审批模板。

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

WxCpOaServiceImpl

public WxCpOaServiceImpl()

方法详细资料

apply

public String apply(WxCpOaApplyEventRequest request)
             throws WxErrorException

从接口复制的说明: WxCpOaService

提交审批申请
 调试工具
 企业可通过审批应用或自建应用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
 

指定者:

apply 在接口中 WxCpOaService

参数:

request - 请求

返回:

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

抛出:

WxErrorException - .

getCheckinData

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

从接口复制的说明: WxCpOaService

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

指定者:

getCheckinData 在接口中 WxCpOaService

参数:

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

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

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

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

返回:

打卡数据列表 checkin data

抛出:

WxErrorException - 异常

getCheckinOption

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

从接口复制的说明: WxCpOaService

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

指定者:

getCheckinOption 在接口中 WxCpOaService

参数:

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

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

返回:

打卡规则列表 checkin option

抛出:

WxErrorException - .

getCropCheckinOption

public List<WxCpCropCheckinOption> getCropCheckinOption()
                                                 throws WxErrorException

从接口复制的说明: WxCpOaService

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

指定者:

getCropCheckinOption 在接口中 WxCpOaService

返回:

打卡规则列表 crop checkin option

抛出:

WxErrorException - the wx error exception

getApprovalInfo

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

从接口复制的说明: WxCpOaService

 批量获取审批单号

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

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

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

指定者:

getApprovalInfo 在接口中 WxCpOaService

参数:

startTime - 开始时间

endTime - 结束时间

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

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

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

返回:

WxCpApprovalInfo approval info

抛出:

WxErrorException - .

getApprovalInfo

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

从接口复制的说明: WxCpOaService

short method

指定者:

getApprovalInfo 在接口中 WxCpOaService

参数:

startTime - 开始时间

endTime - 结束时间

返回:

WxCpApprovalInfo approval info

抛出:

WxErrorException - .

另请参阅:

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

getApprovalInfo

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

从接口复制的说明: WxCpOaService

 批量获取审批单号

 审批应用及有权限的自建应用，可通过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。
 

指定者:

getApprovalInfo 在接口中 WxCpOaService

参数:

startTime - 开始时间

endTime - 结束时间

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

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

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

返回:

WxCpApprovalInfo approval info

抛出:

WxErrorException - .

getApprovalDetail

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

从接口复制的说明: WxCpOaService

   获取审批申请详情

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

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

指定者:

getApprovalDetail 在接口中 WxCpOaService

参数:

spNo - 审批单编号。

返回:

WxCpApprovaldetail approval detail

抛出:

WxErrorException - .

getCorpConf

public WxCpCorpConfInfo getCorpConf()
                             throws WxErrorException

从接口复制的说明: WxCpOaService

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

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

指定者:

getCorpConf 在接口中 WxCpOaService

返回:

corp conf

抛出:

WxErrorException - the wx error exception

getUserVacationQuota

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

从接口复制的说明: WxCpOaService

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

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

指定者:

getUserVacationQuota 在接口中 WxCpOaService

参数:

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

返回:

user vacation quota

抛出:

WxErrorException - the wx error exception

getApprovalData

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

从接口复制的说明: WxCpOaService

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

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

指定者:

getApprovalData 在接口中 WxCpOaService

参数:

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

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

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

返回:

approval data

抛出:

WxErrorException - the wx error exception

setOneUserQuota

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

从接口复制的说明: WxCpOaService

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

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

指定者:

setOneUserQuota 在接口中 WxCpOaService

参数:

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

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

从接口复制的说明: WxCpOaService

获取公费电话拨打记录

指定者:

getDialRecord 在接口中 WxCpOaService

参数:

startTime - 查询的起始时间戳

endTime - 查询的结束时间戳

offset - 分页查询的偏移量

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

返回:

. dial record

抛出:

WxErrorException - .

getTemplateDetail

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

从接口复制的说明: WxCpOaService

获取审批模板详情

指定者:

getTemplateDetail 在接口中 WxCpOaService

参数:

templateId - 模板ID

返回:

. template detail

抛出:

WxErrorException - .

createOaApprovalTemplate

public String createOaApprovalTemplate(WxCpOaApprovalTemplate cpTemplate)
                                throws WxErrorException

从接口复制的说明: WxCpOaService

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

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

指定者:

createOaApprovalTemplate 在接口中 WxCpOaService

参数:

cpTemplate - cpTemplate

返回:

templateId

抛出:

WxErrorException - .

updateOaApprovalTemplate

public void updateOaApprovalTemplate(WxCpOaApprovalTemplate wxCpTemplate)
                              throws WxErrorException

从接口复制的说明: WxCpOaService

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

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

指定者:

updateOaApprovalTemplate 在接口中 WxCpOaService

参数:

wxCpTemplate - wxCpTemplate

抛出:

WxErrorException - .

getCheckinDayData

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

从接口复制的说明: WxCpOaService

获取打卡日报数据

指定者:

getCheckinDayData 在接口中 WxCpOaService

参数:

startTime - 获取日报的开始时间

endTime - 获取日报的结束时间

userIdList - 获取日报的userid列表

返回:

日报数据列表 checkin day data

抛出:

WxErrorException - the wx error exception

getCheckinMonthData

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

从接口复制的说明: WxCpOaService

获取打卡月报数据

指定者:

getCheckinMonthData 在接口中 WxCpOaService

参数:

startTime - 获取月报的开始时间

endTime - 获取月报的结束时间

userIdList - 获取月报的userid列表

返回:

月报数据列表 checkin month data

抛出:

WxErrorException - the wx error exception

getCheckinScheduleList

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

从接口复制的说明: WxCpOaService

获取打卡人员排班信息

指定者:

getCheckinScheduleList 在接口中 WxCpOaService

参数:

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

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

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

返回:

排班表信息 checkin schedule list

抛出:

WxErrorException - the wx error exception

setCheckinScheduleList

public void setCheckinScheduleList(WxCpSetCheckinSchedule wxCpSetCheckinSchedule)
                            throws WxErrorException

从接口复制的说明: WxCpOaService

为打卡人员排班

指定者:

setCheckinScheduleList 在接口中 WxCpOaService

参数:

wxCpSetCheckinSchedule - the wx cp set checkin schedule

抛出:

WxErrorException - the wx error exception

addCheckInUserFace

public void addCheckInUserFace(String userId,
                               String userFace)
                        throws WxErrorException

从接口复制的说明: WxCpOaService

 录入打卡人员人脸信息
 企业可通过打卡应用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
 

指定者:

addCheckInUserFace 在接口中 WxCpOaService

参数:

userId - 需要录入的用户id

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

抛出:

WxErrorException - the wx error exception