mirror of
https://github.com/silenceper/wechat.git
synced 2026-02-04 12:52:27 +08:00
661 lines
22 KiB
Go
661 lines
22 KiB
Go
package checkin
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
"github.com/silenceper/wechat/v2/util"
|
|
)
|
|
|
|
const (
|
|
// getCheckinDataURL 获取打卡记录数据
|
|
getCheckinDataURL = "https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckindata?access_token=%s"
|
|
// getDayDataURL 获取打卡日报数据
|
|
getDayDataURL = "https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckin_daydata?access_token=%s"
|
|
// getMonthDataURL 获取打卡月报数据
|
|
getMonthDataURL = "https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckin_monthdata?access_token=%s"
|
|
// getCorpOptionURL 获取企业所有打卡规则
|
|
getCorpOptionURL = "https://qyapi.weixin.qq.com/cgi-bin/checkin/getcorpcheckinoption?access_token=%s"
|
|
// getOptionURL 获取员工打卡规则
|
|
getOptionURL = "https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckinoption?access_token=%s"
|
|
// getScheduleListURL 获取打卡人员排班信息
|
|
getScheduleListURL = "https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckinschedulist?access_token=%s"
|
|
// getHardwareDataURL 获取设备打卡数据
|
|
getHardwareDataURL = "https://qyapi.weixin.qq.com/cgi-bin/hardware/get_hardware_checkin_data?access_token=%s"
|
|
)
|
|
|
|
type (
|
|
// GetCheckinDataRequest 获取打卡记录数据请求
|
|
GetCheckinDataRequest struct {
|
|
OpenCheckinDataType int64 `json:"opencheckindatatype"`
|
|
StartTime int64 `json:"starttime"`
|
|
EndTime int64 `json:"endtime"`
|
|
UserIDList []string `json:"useridlist"`
|
|
}
|
|
// GetCheckinDataResponse 获取打卡记录数据响应
|
|
GetCheckinDataResponse struct {
|
|
util.CommonError
|
|
CheckinData []*GetCheckinDataItem `json:"checkindata"`
|
|
}
|
|
// GetCheckinDataItem 打卡记录数据
|
|
GetCheckinDataItem struct {
|
|
UserID string `json:"userid"`
|
|
GroupName string `json:"groupname"`
|
|
CheckinType string `json:"checkin_type"`
|
|
ExceptionType string `json:"exception_type"`
|
|
CheckinTime int64 `json:"checkin_time"`
|
|
LocationTitle string `json:"location_title"`
|
|
LocationDetail string `json:"location_detail"`
|
|
WifiName string `json:"wifiname"`
|
|
Notes string `json:"notes"`
|
|
WifiMac string `json:"wifimac"`
|
|
MediaIDs []string `json:"mediaids"`
|
|
SchCheckinTime int64 `json:"sch_checkin_time"`
|
|
GroupID int64 `json:"groupid"`
|
|
ScheduleID int64 `json:"schedule_id"`
|
|
TimelineID int64 `json:"timeline_id"`
|
|
Lat int64 `json:"lat,omitempty"`
|
|
Lng int64 `json:"lng,omitempty"`
|
|
DeviceID string `json:"deviceid,omitempty"`
|
|
}
|
|
)
|
|
|
|
// GetCheckinData 获取打卡记录数据
|
|
// @see https://developer.work.weixin.qq.com/document/path/90262
|
|
func (r *Client) GetCheckinData(req *GetCheckinDataRequest) (*GetCheckinDataResponse, error) {
|
|
var (
|
|
accessToken string
|
|
err error
|
|
)
|
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
|
return nil, err
|
|
}
|
|
var response []byte
|
|
if response, err = util.PostJSON(fmt.Sprintf(getCheckinDataURL, accessToken), req); err != nil {
|
|
return nil, err
|
|
}
|
|
result := &GetCheckinDataResponse{}
|
|
err = util.DecodeWithError(response, result, "GetCheckinData")
|
|
return result, err
|
|
}
|
|
|
|
type (
|
|
// GetDayDataResponse 获取打卡日报数据
|
|
GetDayDataResponse struct {
|
|
util.CommonError
|
|
Datas []DayDataItem `json:"datas"`
|
|
}
|
|
|
|
// DayDataItem 日报
|
|
DayDataItem struct {
|
|
BaseInfo DayBaseInfo `json:"base_info"`
|
|
SummaryInfo DaySummaryInfo `json:"summary_info"`
|
|
HolidayInfos []HolidayInfo `json:"holiday_infos"`
|
|
ExceptionInfos []ExceptionInfo `json:"exception_infos"`
|
|
OtInfo OtInfo `json:"ot_info"`
|
|
SpItems []SpItem `json:"sp_items"`
|
|
}
|
|
|
|
// DayBaseInfo 基础信息
|
|
DayBaseInfo struct {
|
|
Date int64 `json:"date"`
|
|
RecordType int64 `json:"record_type"`
|
|
Name string `json:"name"`
|
|
NameEx string `json:"name_ex"`
|
|
DepartsName string `json:"departs_name"`
|
|
AcctID string `json:"acctid"`
|
|
DayType int64 `json:"day_type"`
|
|
RuleInfo DayRuleInfo `json:"rule_info"`
|
|
}
|
|
|
|
// DayCheckInTime 当日打卡时间
|
|
DayCheckInTime struct {
|
|
WorkSec int64 `json:"work_sec"`
|
|
OffWorkSec int64 `json:"off_work_sec"`
|
|
}
|
|
|
|
// DayRuleInfo 打卡人员所属规则信息
|
|
DayRuleInfo struct {
|
|
GroupID int64 `json:"groupid"`
|
|
GroupName string `json:"groupname"`
|
|
ScheduleID int64 `json:"scheduleid"`
|
|
ScheduleName string `json:"schedulename"`
|
|
CheckInTimes []DayCheckInTime `json:"checkintime"`
|
|
}
|
|
|
|
// DaySummaryInfo 汇总信息
|
|
DaySummaryInfo struct {
|
|
CheckinCount int64 `json:"checkin_count"`
|
|
RegularWorkSec int64 `json:"regular_work_sec"`
|
|
StandardWorkSec int64 `json:"standard_work_sec"`
|
|
EarliestTime int64 `json:"earliest_time"`
|
|
LastestTime int64 `json:"lastest_time"`
|
|
}
|
|
|
|
// HolidayInfo 假勤相关信息
|
|
HolidayInfo struct {
|
|
SpNumber string `json:"sp_number"`
|
|
SpTitle SpTitle `json:"sp_title"`
|
|
SpDescription SpDescription `json:"sp_description"`
|
|
}
|
|
|
|
// SpTitle 假勤信息摘要 - 标题信息
|
|
SpTitle struct {
|
|
Data []SpData `json:"data"`
|
|
}
|
|
|
|
// SpDescription 假勤信息摘要 - 描述信息
|
|
SpDescription struct {
|
|
Data []SpData `json:"data"`
|
|
}
|
|
|
|
// SpData 假勤信息 (多种语言描述，目前只有中文一种)
|
|
SpData struct {
|
|
Lang string `json:"lang"`
|
|
Text string `json:"text"`
|
|
}
|
|
|
|
// SpItem 假勤统计信息
|
|
SpItem struct {
|
|
Count int64 `json:"count"`
|
|
Duration int64 `json:"duration"`
|
|
TimeType int64 `json:"time_type"`
|
|
Type int64 `json:"type"`
|
|
VacationID int64 `json:"vacation_id"`
|
|
Name string `json:"name"`
|
|
}
|
|
|
|
// ExceptionInfo 校准状态信息
|
|
ExceptionInfo struct {
|
|
Count int64 `json:"count"`
|
|
Duration int64 `json:"duration"`
|
|
Exception int64 `json:"exception"`
|
|
}
|
|
|
|
// OtInfo 加班信息
|
|
OtInfo struct {
|
|
OtStatus int64 `json:"ot_status"`
|
|
OtDuration int64 `json:"ot_duration"`
|
|
ExceptionDuration []uint64 `json:"exception_duration"`
|
|
}
|
|
)
|
|
|
|
// GetDayData 获取打卡日报数据
|
|
// @see https://developer.work.weixin.qq.com/document/path/96498
|
|
func (r *Client) GetDayData(req *GetCheckinDataRequest) (result *GetDayDataResponse, err error) {
|
|
var (
|
|
response []byte
|
|
accessToken string
|
|
)
|
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
|
return
|
|
}
|
|
if response, err = util.PostJSON(fmt.Sprintf(getDayDataURL, accessToken), req); err != nil {
|
|
return
|
|
}
|
|
|
|
result = new(GetDayDataResponse)
|
|
err = util.DecodeWithError(response, result, "GetDayData")
|
|
return
|
|
}
|
|
|
|
type (
|
|
// GetMonthDataResponse 获取打卡月报数据
|
|
GetMonthDataResponse struct {
|
|
util.CommonError
|
|
Datas []MonthDataItem `json:"datas"`
|
|
}
|
|
|
|
// MonthDataItem 月报数据
|
|
MonthDataItem struct {
|
|
BaseInfo MonthBaseInfo `json:"base_info"`
|
|
SummaryInfo MonthSummaryInfo `json:"summary_info"`
|
|
ExceptionInfos []ExceptionInfo `json:"exception_infos"`
|
|
SpItems []SpItem `json:"sp_items"`
|
|
OverWorkInfo OverWorkInfo `json:"overwork_info"`
|
|
}
|
|
|
|
// MonthBaseInfo 基础信息
|
|
MonthBaseInfo struct {
|
|
RecordType int64 `json:"record_type"`
|
|
Name string `json:"name"`
|
|
NameEx string `json:"name_ex"`
|
|
DepartsName string `json:"departs_name"`
|
|
AcctID string `json:"acctid"`
|
|
RuleInfo MonthRuleInfo `json:"rule_info"`
|
|
}
|
|
|
|
// MonthRuleInfo 打卡人员所属规则信息
|
|
MonthRuleInfo struct {
|
|
GroupID int64 `json:"groupid"`
|
|
GroupName string `json:"groupname"`
|
|
}
|
|
|
|
// MonthSummaryInfo 汇总信息
|
|
MonthSummaryInfo struct {
|
|
WorkDays int64 `json:"work_days"`
|
|
ExceptDays int64 `json:"except_days"`
|
|
RegularDays int64 `json:"regular_days"`
|
|
RegularWorkSec int64 `json:"regular_work_sec"`
|
|
StandardWorkSec int64 `json:"standard_work_sec"`
|
|
}
|
|
|
|
// OverWorkInfo 加班情况
|
|
OverWorkInfo struct {
|
|
WorkdayOverSec int64 `json:"workday_over_sec"`
|
|
HolidayOverSec int64 `json:"holidays_over_sec"`
|
|
RestDayOverSec int64 `json:"restdays_over_sec"`
|
|
}
|
|
)
|
|
|
|
// GetMonthData 获取打卡月报数据
|
|
// @see https://developer.work.weixin.qq.com/document/path/96499
|
|
func (r *Client) GetMonthData(req *GetCheckinDataRequest) (result *GetMonthDataResponse, err error) {
|
|
var (
|
|
response []byte
|
|
accessToken string
|
|
)
|
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
|
return
|
|
}
|
|
if response, err = util.PostJSON(fmt.Sprintf(getMonthDataURL, accessToken), req); err != nil {
|
|
return
|
|
}
|
|
|
|
result = new(GetMonthDataResponse)
|
|
err = util.DecodeWithError(response, result, "GetMonthData")
|
|
return
|
|
}
|
|
|
|
// GetCorpOptionResponse 获取企业所有打卡规则响应
|
|
type GetCorpOptionResponse struct {
|
|
util.CommonError
|
|
Group []CorpOptionGroup `json:"group"`
|
|
}
|
|
|
|
// CorpOptionGroup 企业规则信息列表
|
|
type CorpOptionGroup struct {
|
|
GroupType int64 `json:"grouptype"`
|
|
GroupID int64 `json:"groupid"`
|
|
GroupName string `json:"groupname"`
|
|
CheckinDate []GroupCheckinDate `json:"checkindate"`
|
|
SpeWorkdays []SpeWorkdays `json:"spe_workdays"`
|
|
SpeOffDays []SpeOffDays `json:"spe_offdays"`
|
|
SyncHolidays bool `json:"sync_holidays"`
|
|
NeedPhoto bool `json:"need_photo"`
|
|
NoteCanUseLocalPic bool `json:"note_can_use_local_pic"`
|
|
AllowCheckinOffWorkday bool `json:"allow_checkin_offworkday"`
|
|
AllowApplyOffWorkday bool `json:"allow_apply_offworkday"`
|
|
WifiMacInfos []WifiMacInfos `json:"wifimac_infos"`
|
|
LocInfos []LocInfos `json:"loc_infos"`
|
|
Range []Range `json:"range"`
|
|
CreateTime int64 `json:"create_time"`
|
|
WhiteUsers []string `json:"white_users"`
|
|
Type int64 `json:"type"`
|
|
ReporterInfo ReporterInfo `json:"reporterinfo"`
|
|
OtInfo GroupOtInfo `json:"ot_info"`
|
|
OtApplyInfo OtApplyInfo `json:"otapplyinfo"`
|
|
Uptime int64 `json:"uptime"`
|
|
AllowApplyBkCnt int64 `json:"allow_apply_bk_cnt"`
|
|
OptionOutRange int64 `json:"option_out_range"`
|
|
CreateUserID string `json:"create_userid"`
|
|
UseFaceDetect bool `json:"use_face_detect"`
|
|
AllowApplyBkDayLimit int64 `json:"allow_apply_bk_day_limit"`
|
|
UpdateUserID string `json:"update_userid"`
|
|
BukaRestriction int64 `json:"buka_restriction"`
|
|
ScheduleList []ScheduleList `json:"schedulelist"`
|
|
OffWorkIntervalTime int64 `json:"offwork_interval_time"`
|
|
}
|
|
|
|
// GroupCheckinDate 打卡时间，当规则类型为排班时没有意义
|
|
type GroupCheckinDate struct {
|
|
Workdays []int64 `json:"workdays"`
|
|
CheckinTime []GroupCheckinTime `json:"checkintime"`
|
|
NoNeedOffWork bool `json:"noneed_offwork"`
|
|
LimitAheadTime int64 `json:"limit_aheadtime"`
|
|
FlexOnDutyTime int64 `json:"flex_on_duty_time"`
|
|
FlexOffDutyTime int64 `json:"flex_off_duty_time"`
|
|
}
|
|
|
|
// GroupCheckinTime 工作日上下班打卡时间信息
|
|
type GroupCheckinTime struct {
|
|
WorkSec int64 `json:"work_sec"`
|
|
OffWorkSec int64 `json:"off_work_sec"`
|
|
RemindWorkSec int64 `json:"remind_work_sec"`
|
|
RemindOffWorkSec int64 `json:"remind_off_work_sec"`
|
|
}
|
|
|
|
// SpeWorkdays 特殊日期 - 必须打卡日期信息
|
|
type SpeWorkdays struct {
|
|
Timestamp int64 `json:"timestamp"`
|
|
Notes string `json:"notes"`
|
|
CheckinTime []GroupCheckinTime `json:"checkintime"`
|
|
}
|
|
|
|
// SpeOffDays 特殊日期 - 不用打卡日期信息
|
|
type SpeOffDays struct {
|
|
Timestamp int64 `json:"timestamp"`
|
|
Notes string `json:"notes"`
|
|
}
|
|
|
|
// WifiMacInfos 打卡地点-WiFi 打卡信息
|
|
type WifiMacInfos struct {
|
|
WifiName string `json:"wifiname"`
|
|
WifiMac string `json:"wifimac"`
|
|
}
|
|
|
|
// LocInfos 打卡地点 - 位置打卡信息
|
|
type LocInfos struct {
|
|
Lat int64 `json:"lat"`
|
|
Lng int64 `json:"lng"`
|
|
LocTitle string `json:"loc_title"`
|
|
LocDetail string `json:"loc_detail"`
|
|
Distance int64 `json:"distance"`
|
|
}
|
|
|
|
// Range 打卡人员信息
|
|
type Range struct {
|
|
PartyID []string `json:"partyid"`
|
|
UserID []string `json:"userid"`
|
|
TagID []int64 `json:"tagid"`
|
|
}
|
|
|
|
// ReporterInfo 汇报对象信息
|
|
type ReporterInfo struct {
|
|
Reporters []Reporters `json:"reporters"`
|
|
UpdateTime int64 `json:"updatetime"`
|
|
}
|
|
|
|
// Reporters 汇报对象，每个汇报人用 userid 表示
|
|
type Reporters struct {
|
|
UserID string `json:"userid"`
|
|
}
|
|
|
|
// GroupOtInfo 加班信息
|
|
type GroupOtInfo struct {
|
|
Type int64 `json:"type"`
|
|
AllowOtWorkingDay bool `json:"allow_ot_workingday"`
|
|
AllowOtNonWorkingDay bool `json:"allow_ot_nonworkingday"`
|
|
OtCheckInfo OtCheckInfo `json:"otcheckinfo"`
|
|
}
|
|
|
|
// OtCheckInfo 以打卡时间为准 - 加班时长计算规则信息
|
|
type OtCheckInfo struct {
|
|
OtWorkingDayTimeStart int64 `json:"ot_workingday_time_start"`
|
|
OtWorkingDayTimeMin int64 `json:"ot_workingday_time_min"`
|
|
OtWorkingDayTimeMax int64 `json:"ot_workingday_time_max"`
|
|
OtNonworkingDayTimeMin int64 `json:"ot_nonworkingday_time_min"`
|
|
OtNonworkingDayTimeMax int64 `json:"ot_nonworkingday_time_max"`
|
|
OtNonworkingDaySpanDayTime int64 `json:"ot_nonworkingday_spanday_time"`
|
|
OtWorkingDayRestInfo OtRestInfo `json:"ot_workingday_restinfo"`
|
|
OtNonWorkingDayRestInfo OtRestInfo `json:"ot_nonworkingday_restinfo"`
|
|
}
|
|
|
|
// OtRestInfo 加班 - 休息扣除配置信息
|
|
type OtRestInfo struct {
|
|
Type int64 `json:"type"`
|
|
FixTimeRule FixTimeRule `json:"fix_time_rule"`
|
|
CalOtTimeRule CalOtTimeRule `json:"cal_ottime_rule"`
|
|
}
|
|
|
|
// FixTimeRule 工作日加班 - 指定休息时间配置信息
|
|
type FixTimeRule struct {
|
|
FixTimeBeginSec int64 `json:"fix_time_begin_sec"`
|
|
FixTimeEndSec int64 `json:"fix_time_end_sec"`
|
|
}
|
|
|
|
// CalOtTimeRule 工作日加班 - 按加班时长扣除配置信息
|
|
type CalOtTimeRule struct {
|
|
Items []CalOtTimeRuleItem `json:"items"`
|
|
}
|
|
|
|
// CalOtTimeRuleItem 工作日加班 - 按加班时长扣除条件信息
|
|
type CalOtTimeRuleItem struct {
|
|
OtTime int64 `json:"ot_time"`
|
|
RestTime int64 `json:"rest_time"`
|
|
}
|
|
|
|
// OtApplyInfo 以加班申请核算打卡记录相关信息
|
|
type OtApplyInfo struct {
|
|
AllowOtWorkingDay bool `json:"allow_ot_workingday"`
|
|
AllowOtNonWorkingDay bool `json:"allow_ot_nonworkingday"`
|
|
Uiptime int64 `json:"uptime"`
|
|
OtNonworkingDaySpanDayTime int64 `json:"ot_nonworkingday_spanday_time"`
|
|
OtWorkingDayRestInfo OtRestInfo `json:"ot_workingday_restinfo"`
|
|
OtNonWorkingDayRestInfo OtRestInfo `json:"ot_nonworkingday_restinfo"`
|
|
}
|
|
|
|
// ScheduleList 排班信息列表
|
|
type ScheduleList struct {
|
|
ScheduleID int64 `json:"schedule_id"`
|
|
ScheduleName string `json:"schedule_name"`
|
|
TimeSection []TimeSection `json:"time_section"`
|
|
LimitAheadTime int64 `json:"limit_aheadtime"`
|
|
NoNeedOffWork bool `json:"noneed_offwork"`
|
|
LimitOffTime int64 `json:"limit_offtime"`
|
|
FlexOnDutyTime int64 `json:"flex_on_duty_time"`
|
|
FlexOffDutyTime int64 `json:"flex_off_duty_time"`
|
|
AllowFlex bool `json:"allow_flex"`
|
|
LateRule LateRule `json:"late_rule"`
|
|
MaxAllowArriveEarly int64 `json:"max_allow_arrive_early"`
|
|
MaxAllowArriveLate int64 `json:"max_allow_arrive_late"`
|
|
}
|
|
|
|
// TimeSection 班次上下班时段信息
|
|
type TimeSection struct {
|
|
TimeID int64 `json:"time_id"`
|
|
WorkSec int64 `json:"work_sec"`
|
|
OffWorkSec int64 `json:"off_work_sec"`
|
|
RemindWorkSec int64 `json:"remind_work_sec"`
|
|
RemindOffWorkSec int64 `json:"remind_off_work_sec"`
|
|
RestBeginTime int64 `json:"rest_begin_time"`
|
|
RestEndTime int64 `json:"rest_end_time"`
|
|
AllowRest bool `json:"allow_rest"`
|
|
}
|
|
|
|
// LateRule 晚走晚到时间规则信息
|
|
type LateRule struct {
|
|
AllowOffWorkAfterTime bool `json:"allow_offwork_after_time"`
|
|
TimeRules []TimeRule `json:"timerules"`
|
|
}
|
|
|
|
// TimeRule 迟到规则时间
|
|
type TimeRule struct {
|
|
OffWorkAfterTime int64 `json:"offwork_after_time"`
|
|
OnWorkFlexTime int64 `json:"onwork_flex_time"`
|
|
}
|
|
|
|
// GetCorpOption 获取企业所有打卡规则
|
|
// @see https://developer.work.weixin.qq.com/document/path/93384
|
|
func (r *Client) GetCorpOption() (*GetCorpOptionResponse, error) {
|
|
var (
|
|
accessToken string
|
|
err error
|
|
)
|
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
|
return nil, err
|
|
}
|
|
var response []byte
|
|
if response, err = util.HTTPPost(fmt.Sprintf(getCorpOptionURL, accessToken), ""); err != nil {
|
|
return nil, err
|
|
}
|
|
result := &GetCorpOptionResponse{}
|
|
err = util.DecodeWithError(response, result, "GetCorpOption")
|
|
return result, err
|
|
}
|
|
|
|
// GetOptionRequest 获取员工打卡规则请求
|
|
type GetOptionRequest struct {
|
|
Datetime int64 `json:"datetime"`
|
|
UserIDList []string `json:"useridlist"`
|
|
}
|
|
|
|
// GetOptionResponse 获取员工打卡规则响应
|
|
type GetOptionResponse struct {
|
|
util.CommonError
|
|
Info []OptionInfo `json:"info"`
|
|
}
|
|
|
|
// OptionInfo 打卡规则列表
|
|
type OptionInfo struct {
|
|
UserID string `json:"userid"`
|
|
Group OptionGroup `json:"group"`
|
|
}
|
|
|
|
// OptionGroup 打卡规则相关信息
|
|
type OptionGroup struct {
|
|
GroupType int64 `json:"grouptype"`
|
|
GroupID int64 `json:"groupid"`
|
|
GroupName string `json:"groupname"`
|
|
CheckinDate []OptionCheckinDate `json:"checkindate"`
|
|
SpeWorkdays []SpeWorkdays `json:"spe_workdays"`
|
|
SpeOffDays []SpeOffDays `json:"spe_offdays"`
|
|
SyncHolidays bool `json:"sync_holidays"`
|
|
NeedPhoto bool `json:"need_photo"`
|
|
WifiMacInfos []WifiMacInfos `json:"wifimac_infos"`
|
|
NoteCanUseLocalPic bool `json:"note_can_use_local_pic"`
|
|
AllowCheckinOffWorkday bool `json:"allow_checkin_offworkday"`
|
|
AllowApplyOffWorkday bool `json:"allow_apply_offworkday"`
|
|
LocInfos []LocInfos `json:"loc_infos"`
|
|
ScheduleList []ScheduleList `json:"schedulelist"`
|
|
BukaRestriction int64 `json:"buka_restriction"`
|
|
}
|
|
|
|
// OptionCheckinDate 打卡时间配置
|
|
type OptionCheckinDate struct {
|
|
Workdays []int64 `json:"workdays"`
|
|
CheckinTime []GroupCheckinTime `json:"checkintime"`
|
|
FlexTime int64 `json:"flex_time"`
|
|
NoNeedOffWork bool `json:"noneed_offwork"`
|
|
LimitAheadTime int64 `json:"limit_aheadtime"`
|
|
FlexOnDutyTime int64 `json:"flex_on_duty_time"`
|
|
FlexOffDutyTime int64 `json:"flex_off_duty_time"`
|
|
}
|
|
|
|
// GetOption 获取员工打卡规则
|
|
// see https://developer.work.weixin.qq.com/document/path/90263
|
|
func (r *Client) GetOption(req *GetOptionRequest) (*GetOptionResponse, error) {
|
|
var (
|
|
accessToken string
|
|
err error
|
|
)
|
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
|
return nil, err
|
|
}
|
|
var response []byte
|
|
if response, err = util.PostJSON(fmt.Sprintf(getOptionURL, accessToken), req); err != nil {
|
|
return nil, err
|
|
}
|
|
result := &GetOptionResponse{}
|
|
err = util.DecodeWithError(response, result, "GetOption")
|
|
return result, err
|
|
}
|
|
|
|
// GetScheduleListRequest 获取打卡人员排班信息请求
|
|
type GetScheduleListRequest struct {
|
|
StartTime int64 `json:"starttime"`
|
|
EndTime int64 `json:"endtime"`
|
|
UserIDList []string `json:"useridlist"`
|
|
}
|
|
|
|
// GetScheduleListResponse 获取打卡人员排班信息响应
|
|
type GetScheduleListResponse struct {
|
|
util.CommonError
|
|
ScheduleList []ScheduleItem `json:"schedule_list"`
|
|
}
|
|
|
|
// ScheduleItem 排班表信息
|
|
type ScheduleItem struct {
|
|
UserID string `json:"userid"`
|
|
YearMonth int64 `json:"yearmonth"`
|
|
GroupID int64 `json:"groupid"`
|
|
GroupName string `json:"groupname"`
|
|
Schedule Schedule `json:"schedule"`
|
|
}
|
|
|
|
// Schedule 个人排班信息
|
|
type Schedule struct {
|
|
ScheduleList []ScheduleListItem `json:"scheduleList"`
|
|
}
|
|
|
|
// ScheduleListItem 个人排班表信息
|
|
type ScheduleListItem struct {
|
|
Day int64 `json:"day"`
|
|
ScheduleInfo ScheduleInfo `json:"schedule_info"`
|
|
}
|
|
|
|
// ScheduleInfo 个人当日排班信息
|
|
type ScheduleInfo struct {
|
|
ScheduleID int64 `json:"schedule_id"`
|
|
ScheduleName string `json:"schedule_name"`
|
|
TimeSection []ScheduleTimeSection `json:"time_section"`
|
|
}
|
|
|
|
// ScheduleTimeSection 班次上下班时段信息
|
|
type ScheduleTimeSection struct {
|
|
ID int64 `json:"id"`
|
|
WorkSec int64 `json:"work_sec"`
|
|
OffWorkSec int64 `json:"off_work_sec"`
|
|
RemindWorkSec int64 `json:"remind_work_sec"`
|
|
RemindOffWorkSec int64 `json:"remind_off_work_sec"`
|
|
}
|
|
|
|
// GetScheduleList 获取打卡人员排班信息
|
|
// see https://developer.work.weixin.qq.com/document/path/93380
|
|
func (r *Client) GetScheduleList(req *GetScheduleListRequest) (*GetScheduleListResponse, error) {
|
|
var (
|
|
accessToken string
|
|
err error
|
|
)
|
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
|
return nil, err
|
|
}
|
|
var response []byte
|
|
if response, err = util.PostJSON(fmt.Sprintf(getScheduleListURL, accessToken), req); err != nil {
|
|
return nil, err
|
|
}
|
|
result := &GetScheduleListResponse{}
|
|
err = util.DecodeWithError(response, result, "GetScheduleList")
|
|
return result, err
|
|
}
|
|
|
|
// GetHardwareDataRequest 获取设备打卡数据请求
|
|
type GetHardwareDataRequest struct {
|
|
FilterType int64 `json:"filter_type"`
|
|
StartTime int64 `json:"starttime"`
|
|
EndTime int64 `json:"endtime"`
|
|
UserIDList []string `json:"useridlist"`
|
|
}
|
|
|
|
// GetHardwareDataResponse 获取设备打卡数据响应
|
|
type GetHardwareDataResponse struct {
|
|
util.CommonError
|
|
CheckinData []HardwareCheckinData `json:"checkindata"`
|
|
}
|
|
|
|
// HardwareCheckinData 设备打卡数据
|
|
type HardwareCheckinData struct {
|
|
UserID string `json:"userid"`
|
|
CheckinTime int64 `json:"checkin_time"`
|
|
DeviceSn string `json:"device_sn"`
|
|
DeviceName string `json:"device_name"`
|
|
}
|
|
|
|
// GetHardwareData 获取设备打卡数据
|
|
// see https://developer.work.weixin.qq.com/document/path/94126
|
|
func (r *Client) GetHardwareData(req *GetHardwareDataRequest) (*GetHardwareDataResponse, error) {
|
|
var (
|
|
accessToken string
|
|
err error
|
|
)
|
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
|
return nil, err
|
|
}
|
|
var response []byte
|
|
if response, err = util.PostJSON(fmt.Sprintf(getHardwareDataURL, accessToken), req); err != nil {
|
|
return nil, err
|
|
}
|
|
result := &GetHardwareDataResponse{}
|
|
err = util.DecodeWithError(response, result, "GetHardwareData")
|
|
return result, err
|
|
}
|