@jiexiaoyin/wecom-api 0.0.2

package/src/modules/chain/index.js

@@ -0,0 +1,193 @@
+/**
+ * 上下游管理模块
+ * API 章节：六 - 上下游
+ * 包含：基础接口、上下游通讯录管理、上下游规则、回调事件
+ */
+
+const WeComSDK = require('../../sdk');
+
+class Chain extends WeComSDK {
+  constructor(config) {
+    super(config);
+  }
+
+  // ========== 基础接口 ==========
+
+  /**
+   * 获取应用共享信息
+   * @param {string} agentId 应用 ID
+   */
+  async getCorpSharedInfo(agentId) {
+    return this.post('/thirdparty/get_corp_shared_info', { agentid: agentId });
+  }
+
+  /**
+   * 获取下级/下游企业的 access_token
+   * @param {string} corpId 下级企业 ID
+   */
+  async getSubCorpToken(corpId) {
+    return this.post('/thirdparty/get_sub_corp_token', { corpid: corpId });
+  }
+
+  /**
+   * 获取下级/下游企业小程序 session
+   * @param {string} userId 用户 ID
+   * @param {string} sessionKey 小程序 session key
+   * @param {number} type 类型
+   */
+  async getSubCorpMiniProgramSession(userId, sessionKey, type = 1) {
+    return this.post('/thirdparty/get_sub_corp_mini_program_session', {
+      userid: userId,
+      session_key: sessionKey,
+      type
+    });
+  }
+
+  /**
+   * 获取上下游关联客户信息（已添加客户）
+   * @param {string} userId 成员 ID
+   * @param {string} externalUserId 外部客户 ID
+   */
+  async getChainCustomerInfo(userId, externalUserId) {
+    return this.post('/externalchain/get_customer_info', {
+      userid: userId,
+      external_userid: externalUserId
+    });
+  }
+
+  /**
+   * 获取上下游关联客户信息（未添加客户）
+   * @param {string} chainId 上下游 ID
+   * @param {string} userId 成员 ID
+   */
+  async getChainPendingCustomerInfo(chainId, userId) {
+    return this.post('/externalchain/get_pending_customer_info', {
+      chain_id: chainId,
+      userid: userId
+    });
+  }
+
+  // ========== 上下游通讯录管理 ==========
+
+  /**
+   * 获取上下游信息
+   * @param {string} chainId 上下游 ID
+   */
+  async getChainInfo(chainId) {
+    return this.post('/externalchain/get_chain_info', { chain_id: chainId });
+  }
+
+  /**
+   * 批量导入上下游联系人
+   * @param {string} chainId 上下游 ID
+   * @param {number} importType 导入类型: 1-成员 2-客户
+   * @param {string} mediaId 文件 ID
+   */
+  async importChainContacts(chainId, importType, mediaId) {
+    return this.post('/externalchain/import_contacts', {
+      chain_id: chainId,
+      import_type: importType,
+      media_id: mediaId
+    });
+  }
+
+  /**
+   * 获取异步任务结果
+   * @param {string} jobId 任务 ID
+   */
+  async getChainJobResult(jobId) {
+    return this.post('/externalchain/get_job_result', { jobid: jobId });
+  }
+
+  /**
+   * 移除企业
+   * @param {string} chainId 上下游 ID
+   * @param {string} corpId 企业 ID
+   */
+  async removeChainCorp(chainId, corpId) {
+    return this.post('/externalchain/remove_corp', {
+      chain_id: chainId,
+      corpid: corpId
+    });
+  }
+
+  /**
+   * 查询成员自定义 ID
+   * @param {string} customId 成员自定义 ID
+   */
+  async getMemberCustomIdInfo(customId) {
+    return this.post('/externalchain/get_member_custom_id', { custom_id: customId });
+  }
+
+  /**
+   * 获取下级企业加入的上下游
+   * @param {string} corpId 下级企业 ID
+   */
+  async getSubCorpChains(corpId) {
+    return this.post('/externalchain/get_sub_corp_chains', { corpid: corpId });
+  }
+
+  // ========== 上下游规则管理 ==========
+
+  /**
+   * 获取对接规则 ID 列表
+   * @param {string} chainId 上下游 ID
+   * @param {number} offset 偏移量
+   * @param {number} size 每页数量
+   */
+  async getChainRuleIds(chainId, offset = 0, size = 100) {
+    return this.post('/externalchain/get_rule_id_list', {
+      chain_id: chainId,
+      offset,
+      limit: size
+    });
+  }
+
+  /**
+   * 删除对接规则
+   * @param {string} chainId 上下游 ID
+   * @param {string} ruleId 规则 ID
+   */
+  async deleteChainRule(chainId, ruleId) {
+    return this.post('/externalchain/delete_rule', {
+      chain_id: chainId,
+      rule_id: ruleId
+    });
+  }
+
+  /**
+   * 获取对接规则详情
+   * @param {string} chainId 上下游 ID
+   * @param {string} ruleId 规则 ID
+   */
+  async getChainRuleDetail(chainId, ruleId) {
+    return this.post('/externalchain/get_rule_detail', {
+      chain_id: chainId,
+      rule_id: ruleId
+    });
+  }
+
+  /**
+   * 新增对接规则
+   * @param {object} rule 规则配置
+   */
+  async createChainRule(rule) {
+    return this.post('/externalchain/add_rule', rule);
+  }
+
+  /**
+   * 更新对接规则
+   * @param {string} chainId 上下游 ID
+   * @param {string} ruleId 规则 ID
+   * @param {object} rule 规则配置
+   */
+  async updateChainRule(chainId, ruleId, rule) {
+    return this.post('/externalchain/update_rule', {
+      chain_id: chainId,
+      rule_id: ruleId,
+      ...rule
+    });
+  }
+}
+
+module.exports = Chain;

package/src/modules/checkin/index.js

@@ -0,0 +1,142 @@
+/**
+ * 打卡考勤模块
+ * API 章节：二十一
+ */
+
+const WeComSDK = require('../../sdk');
+
+class CheckIn extends WeComSDK {
+  constructor(config) {
+    super(config);
+  }
+
+  /**
+   * 获取企业所有打卡规则
+   */
+  async getCorpRules() {
+    return this.post('/checkin/getcorpcheckintypes', {});
+  }
+
+  /**
+   * 获取员工打卡规则
+   * @param {string} userId 成员 userid
+   * @param {number} dateTime 查询日期时间戳
+   */
+  async getUserRules(userId, dateTime) {
+    return this.post('/checkin/getcheckinrule', { userid: userId, datetime: dateTime });
+  }
+
+  /**
+   * 获取打卡记录数据
+   * @param {number} startTime 开始时间戳
+   * @param {number} endTime 结束时间戳
+   * @param {string[]} userIds 成员 userid 列表
+   * @param {number} type 打卡类型: 1-上下班 2-外出 3-全部
+   */
+  async getRecords(startTime, endTime, userIds, type = 1) {
+    return this.post('/checkin/getcheckindata', {
+      starttime: startTime,
+      endtime: endTime,
+      userid: userIds,
+      type
+    });
+  }
+
+  /**
+   * 获取打卡日报数据
+   * @param {number} startTime 开始时间戳
+   * @param {number} endTime 结束时间戳
+   * @param {string[]} userIds 成员 userid 列表
+   */
+  async getDailyReport(startTime, endTime, userIds) {
+    return this.post('/checkin/getcheckin_daydata', {
+      starttime: startTime,
+      endtime: endTime,
+      userid: userIds
+    });
+  }
+
+  /**
+   * 获取打卡月报数据
+   * @param {number} startTime 开始时间戳
+   * @param {number} endTime 结束时间戳
+   * @param {string[]} userIds 成员 userid 列表
+   */
+  async getMonthlyReport(startTime, endTime, userIds) {
+    return this.post('/checkin/getcheckin_monthdata', {
+      starttime: startTime,
+      endtime: endTime,
+      userid: userIds
+    });
+  }
+
+  /**
+   * 获取打卡人员排班信息
+   * @param {number} startTime 开始时间戳
+   * @param {number} endTime 结束时间戳
+   * @param {string[]} userIds 成员 userid 列表
+   */
+  async getSchedule(startTime, endTime, userIds) {
+    return this.post('/checkin/getcheckinschedulist', {
+      starttime: startTime,
+      endtime: endTime,
+      userid: userIds
+    });
+  }
+
+  /**
+   * 为打卡人员排班
+   * @param {string} userId 成员 userid
+   * @param {number} scheduleTime 排班日期时间戳
+   * @param {object} schedule 班次信息
+   */
+  async addSchedule(userId, scheduleTime, schedule) {
+    return this.post('/checkin/addcheckinschedulist', {
+      userid: userId,
+      schedule_time: scheduleTime,
+      schedule
+    });
+  }
+
+  /**
+   * 为打卡人员补卡
+   * @param {string} userId 成员 userid
+   * @param {number} checkinTime 补卡时间戳
+   * @param {string} notes 备注
+   */
+  async addCheckinRecord(userId, checkinTime, notes = '') {
+    return this.post('/checkin/addcheckinrecord', {
+      userid: userId,
+      checkin_time: checkinTime,
+      notes
+    });
+  }
+
+  /**
+   * 获取设备打卡数据
+   * @param {number} startTime 开始时间戳
+   * @param {number} endTime 结束时间戳
+   * @param {string} deviceId 设备ID
+   */
+  async getDeviceData(startTime, endTime, deviceId) {
+    return this.post('/checkin/get_device_checkin_data', {
+      starttime: startTime,
+      endtime: endTime,
+      device_id: deviceId
+    });
+  }
+
+  /**
+   * 录入打卡人员人脸信息
+   * @param {string} userId 成员 userid
+   * @param {string} faceData 人脸数据 (base64)
+   */
+  async addFace(userId, faceData) {
+    return this.post('/checkin/add_face', {
+      userid: userId,
+      face_data: faceData
+    });
+  }
+}
+
+module.exports = CheckIn;

package/src/modules/checkin_rules/index.js

@@ -0,0 +1,251 @@
+/**
+ * 打卡规则管理模块
+ * API 章节：二十一 - 打卡（规则管理）
+ * 包含：管理打卡规则、设备打卡数据
+ */
+
+const WeComSDK = require('../../sdk');
+
+class CheckInRules extends WeComSDK {
+  constructor(config) {
+    super(config);
+  }
+
+  // ========== 打卡规则管理 ==========
+
+  /**
+   * 获取企业所有打卡规则
+   * @param {number} offset 偏移量
+   * @param {number} size 每页数量
+   */
+  async getCheckInRules(offset = 0, size = 100) {
+    return this.post('/checkin/get_rule', { offset, limit: size });
+  }
+
+  /**
+   * 获取打卡规则详情
+   * @param {string} groupId 打卡组 ID
+   */
+  async getCheckInRuleDetail(groupId) {
+    return this.post('/checkin/get_rule_detail', { group_id: groupId });
+  }
+
+  /**
+   * 创建打卡规则
+   * @param {object} rule 打卡规则配置
+   */
+  async createCheckInRule(rule) {
+    return this.post('/checkin/add_rule', rule);
+  }
+
+  /**
+   * 更新打卡规则
+   * @param {string} groupId 打卡组 ID
+   * @param {object} rule 打卡规则配置
+   */
+  async updateCheckInRule(groupId, rule) {
+    return this.post('/checkin/update_rule', {
+      group_id: groupId,
+      ...rule
+    });
+  }
+
+  /**
+   * 删除打卡规则
+   * @param {string} groupId 打卡组 ID
+   */
+  async deleteCheckInRule(groupId) {
+    return this.post('/checkin/del_rule', { group_id: groupId });
+  }
+
+  /**
+   * 拷贝打卡规则
+   * @param {string} sourceGroupId 源打卡组 ID
+   * @param {string} newGroupName 新打卡组名称
+   */
+  async copyCheckInRule(sourceGroupId, newGroupName) {
+    return this.post('/checkin/copy_rule', {
+      source_group_id: sourceGroupId,
+      new_group_name: newGroupName
+    });
+  }
+
+  // ========== 打卡人员管理 ==========
+
+  /**
+   * 获取打卡规则成员
+   * @param {string} groupId 打卡组 ID
+   */
+  async getCheckInRuleUsers(groupId) {
+    return this.post('/checkin/get_rule_user', { group_id: groupId });
+  }
+
+  /**
+   * 添加入打卡规则成员
+   * @param {string} groupId 打卡组 ID
+   * @param {string[]} userIds 成员 ID 列表
+   * @param {number[]} departmentIds 部门 ID 列表
+   */
+  async addCheckInRuleUsers(groupId, userIds = [], departmentIds = []) {
+    return this.post('/checkin/add_rule_user', {
+      group_id: groupId,
+      users: userIds,
+      departments: departmentIds
+    });
+  }
+
+  /**
+   * 删除打卡规则成员
+   * @param {string} groupId 打卡组 ID
+   * @param {string[]} userIds 成员 ID 列表
+   * @param {number[]} departmentIds 部门 ID 列表
+   */
+  async removeCheckInRuleUsers(groupId, userIds = [], departmentIds = []) {
+    return this.post('/checkin/del_rule_user', {
+      group_id: groupId,
+      users: userIds,
+      departments: departmentIds
+    });
+  }
+
+  // ========== 打卡地点管理 ==========
+
+  /**
+   * 获取打卡地点列表
+   * @param {string} groupId 打卡组 ID
+   */
+  async getCheckInLocations(groupId) {
+    return this.post('/checkin/get_location_list', { group_id: groupId });
+  }
+
+  /**
+   * 添加打卡地点
+   * @param {string} groupId 打卡组 ID
+   * @param {object} location 地点配置
+   */
+  async addCheckInLocation(groupId, location) {
+    return this.post('/checkin/add_location', {
+      group_id: groupId,
+      ...location
+    });
+  }
+
+  /**
+   * 删除打卡地点
+   * @param {string} groupId 打卡组 ID
+   * @param {string} locationId 地点 ID
+   */
+  async deleteCheckInLocation(groupId, locationId) {
+    return this.post('/checkin/del_location', {
+      group_id: groupId,
+      location_id: locationId
+    });
+  }
+
+  // ========== 设备打卡数据 ==========
+
+  /**
+   * 获取设备打卡数据
+   * @param {string} deviceId 设备 ID
+   * @param {number} startTime 开始时间戳
+   * @param {number} endTime 结束时间戳
+   */
+  async getDeviceCheckInData(deviceId, startTime, endTime) {
+    return this.post('/checkin/get_device_data', {
+      device_id: deviceId,
+      start_time: startTime,
+      end_time: endTime
+    });
+  }
+
+  /**
+   * 获取设备列表
+   * @param {number} offset 偏移量
+   * @param {number} size 每页数量
+   */
+  async getDeviceList(offset = 0, size = 100) {
+    return this.post('/checkin/get_device_list', { offset, limit: size });
+  }
+
+  // ========== 打卡提醒设置 ==========
+
+  /**
+   * 设置打卡提醒
+   * @param {string} groupId 打卡组 ID
+   * @param {number} remindTime 提醒时间（秒）
+   * @param {string} remindLocation 提醒地点
+   */
+  async setCheckInReminder(groupId, remindTime, remidLocation = '') {
+    return this.post('/checkin/set_remind', {
+      group_id: groupId,
+      remind_time: remindTime,
+      remind_location: remidLocation
+    });
+  }
+
+  // ========== 排班管理 ==========
+
+  /**
+   * 获取打卡人员排班信息
+   * @param {number} startTime 开始时间戳
+   * @param {number} endTime 结束时间戳
+   * @param {string} userId 成员 ID（可选）
+   * @param {number} departmentId 部门 ID（可选）
+   */
+  async getCheckInSchedule(startTime, endTime, userId = '', departmentId = '') {
+    return this.post('/checkin/get_schedulelist', {
+      starttime: startTime,
+      endtime: endTime,
+      userid: userId,
+      department_id: departmentId
+    });
+  }
+
+  /**
+   * 为打卡人员排班
+   * @param {string} userId 成员 ID
+   * @param {number} scheduleDate 排班日期时间戳
+   * @param {string} dayType 日期类型: workdays-工作日, holidays-节假日
+   * @param {string} timeSection 时段配置
+   */
+  async setCheckInSchedule(userId, scheduleDate, dayType = 'workdays', timeSection = '') {
+    return this.post('/checkin/add_schedulelist', {
+      userid: userId,
+      schedule_date: scheduleDate,
+      day_type: dayType,
+      time_section: timeSection
+    });
+  }
+
+  /**
+   * 清除打卡人员排班
+   * @param {number} startTime 开始时间戳
+   * @param {number} endTime 结束时间戳
+   * @param {string[]} userIds 成员 ID 列表
+   */
+  async clearCheckInSchedule(startTime, endTime, userIds) {
+    return this.post('/checkin/del_schedulelist', {
+      starttime: startTime,
+      endtime: endTime,
+      useridlist: userIds
+    });
+  }
+
+  // ========== 补卡管理 ==========
+
+  /**
+   * 为打卡人员补卡
+   * @param {string} userId 成员 ID
+   * @param {number} time 补卡时间戳
+   * @param {string} notes 备注
+   */
+  async addCheckInRecord(userId, time, notes = '') {
+    return this.post('/checkin/add_checkin_record', {
+      userid: userId,
+      time,
+      notes
+    });
+  }
+}
+
+module.exports = CheckInRules;