北森 API
  1. 工时开放接口
北森 API
  • 个人发展计划
    • 带教信息
      • 获取带教信息
      • 逻辑删除带教信息
      • 添加带教信息
    • 发展目标
      • 更新发展目标
      • 获取发展目标信息
    • 个人发展计划
      • 获取发展计划信息
    • 轮岗信息
      • 获取轮岗信息
      • 逻辑删除轮岗信息
      • 添加轮岗信息
  • 绩效管理
    • 活动接口
      • 获取当前用户MOU可见范围的活动
    • 绩效活动接口
      • 创建绩效活动
      • 获取绩效活动信息
    • 绩效接口
      • 获取当前用户MOU可见范围的绩效
    • 考核项接口
      • 获取考核项信息
      • 修改考核项
  • 假勤管理
    • 班次
      • 根据员工ID获取班次
      • 根据考勤卡号和日期获取某人班次数据
      • 获取租户班次信息
      • 添加固定班次
      • 添加弹性班次
    • 北森考勤数据推送程序
      • 获取租户最新配置
      • 获取命令接口
      • 客户端命令执行回复
      • 日志开放接口
      • 下载文件接口
    • 出差
      • 按照创建时间获取出差数据
      • 按照审批通过时间获取出差数据
      • 按出差开始时间获取出差数据
      • 接收出差数据
      • 删除推送错误的出差数据
    • 调休假
      • 查询调休假明细列表
      • 批量删除调休假明细
      • 批量添加调休假明细
    • 打卡
      • 北森假勤团队内部使用
      • 获取打卡数据
      • 接收打卡数据【考勤】
      • 接收打卡数据
    • 工时开放接口
      • 获取工时数据
        POST
      • 添加工时
        POST
    • 公出
      • 根据审批完成时间获取公出数据
      • 获取公出数据
      • 接收公出数据
      • 删除推送错误的公出数据
    • 假期余额
      • 获取假期余额数据
      • 通过UserId获取假期余额数据
    • 加班
      • 获取加班数据
      • 将加班数据推送至北森系统
      • 将加班数据推送至北森系统
    • 考勤记录
      • 获取补签卡数据
      • 获取考勤数据
      • 获取补签记录(新版)
      • 批量发起补签数据(发起流程)
    • 考勤档案相关接口
      • 通过UserIds获取考勤档案
    • 排班
      • 获取排班数据
      • 设置某条排班数据某天的班次
    • 日报
      • 获取日报数据
      • 获取日报分摊数据
    • 休假
      • 撤销休假数据
      • 根据审批通过时间获取休假数据
      • 获取休假数据
      • 获取员工已对冲的休假信息
      • 接收休假数据
    • 月报
      • 获取月报数据
      • 获取月报明细
    • 组织日历
      • 获取组织日历数据
  • 继任与发展
    • 储备人才
      • 更新储备人才
      • 根据查询条件分页获取储备人才数据。
    • 关键职位
      • 根据查询条件分页获取关键职位数据。
    • 继任地图
      • 根据查询条件分页获取继任数据。
    • 盘点活动
      • 根据查询条件分页获取盘点活动数据。
    • 盘点分类
      • 根据查询条件分页获取盘点分类数据。
    • 盘点对象
      • 根据查询条件分页获盘点对象数据。
    • 人才池
      • 根据查询条件分页获取人才池数据。
    • 人才池分类
      • 根据查询条件分页获取人才池分类数据。
    • 校准会相关
      • 根据查询条件分页获取校准会数据。
    • 准备度
      • 根据查询条件分页获取准备度数据。
  • 开放平台
    • 示例-基本值类型
      • Model中有可空值类型
      • 使用ProtoBuf的返回Model
      • 一个String的返回
      • 一个Dictionary的返回
      • 一个Int的List的返回
    • 示例-基本引用类型
      • 测试泛型好不好使
      • Cloud运行态批量操作
      • Cloud运行态基本操作
  • 目标管理
    • 目标服务
      • 根据审批单ID获取审批状态和跳转链接
      • 根据年度周期负责人获取开始结束时间
      • 搜索目标
    • 目标操作
      • 获取导入目标的所有导入参数
      • 目标完成值的导入
      • 目标的导入
  • 日程
    • 日程数据
      • 获取日程列表
    • 日程类型
      • 获取日程类型
  • 闪面
    • 提供面试安排接口
      • 发起面试安排,通过邮件或者短信邀请作答
      • 发起面试安排
      • 根据面试安排ID获取闪面结果
  • 薪酬管理
    • 成本中心对外接口
      • 成本中心批量删除
      • 成本中心新增
      • 成本中心编辑操作
    • 对外公开的薪酬数据接口
      • 查询薪酬的对外公开数据(发薪数据、薪资档案、成本中心)
      • 查询薪酬的对外公开数据(薪资档案)
      • 查询成本分摊结果明细数据(成本分摊结果明细)
      • 查询薪酬的对外公开数据(发薪数据)
      • 获取未删除的所有成本中心
    • 接受外部数据接口
      • /v1/ExternalData
  • 组织员工
    • 合同协议(不推荐)
      • 部分更新员工的合同协议
      • 变更员工合同协议
      • 根据员工UserID集合获取所有未删除的合同协议相关信息
      • 新建员工的合同协议
      • 续签员工合同协议
      • 终止员工合同协议
    • 合同协议(New)
      • 变更员工合同协议
      • 根据时间窗滚动查询变动的合同协议信息
      • 根据员工UserID集合获取指定条件的合同协议相关信息
      • 更新员工的合同协议
      • 批量删除员工合同协议
      • 续签员工合同协议
      • 新建员工的合同协议
      • 终止员工合同协议
    • Offer(New)
      • 根据时间窗滚动查询变动的Offer信息
      • 批量新增待发Offer
    • Offer(不推荐)
      • 批量新增(待发送状态)Offer
    • 设置(不推荐)
      • 分页查询未删除的指定设置对象的相关信息
      • 根据ID列表查询指定设置对象的相关信息
    • 通用(New)
      • 根据时间窗滚动查询变动的通用对象信息
      • 根据主键ID集合获取指定的通用对象信息
    • 员工子集(不推荐)
      • 部分更新指定子集对象相关信息
      • 根据员工子集对象ID集合获取指定的员工子集相关信息
      • 根据员工UserID获取指定员工的指定员工子集相关信息
      • 根据时间窗分页查询变动的员工子集变动信息
      • 删除指定子集对象相关信息
      • 新建指定员工的指定子集对象相关信息
    • 员工与任职(New)
      • 待入职员工入职
      • 发起离职交接流程
      • 根据员工UserID集合获取指定条件的任职记录相关信息
      • 根据时间窗滚动查询变动的员工与单条任职信息
      • 根据员工Email获取员工UserID
      • 根据员工UserID获取该员工的直线下级员工信息列表
      • 根据员工UserID集合获取未删除的员工相关信息
      • 滚动查询指定组织下的员工与单条任职信息
      • 根据时间窗滚动查询变动的员工与多条任职信息
      • 更新指定员工的员工信息与任职记录
      • 结束实习
      • 实习生转正
      • 试用期转正
      • 删除指定待入职员工的员工信息与任职记录
      • 完成审批
      • 新建待入职员工
      • 新建在职员工、外部人员、实习生
      • 直接退休正式员工
      • 直接离职已入职的正式员工或实习生
      • 直接调动已入职的正式员工或实习生
    • 员工与任职(不推荐)
      • 根据员工UserID集合获取指定条件的任职记录相关信息
      • 根据业务修改时间窗分页查询变动的员工相关信息
      • 根据员工UserID获取该员工的直线下级员工信息列表
      • 根据员工UserID集合获取未删除的员工相关信息
      • 更新指定员工的员工信息与任职记录
      • 根据员工Email获取员工UserID
      • 根据修改时间窗分页查询变动的员工相关信息
      • 结束实习
      • 试用期转正
      • 实习生转正
      • 删除指定待入职员工的员工信息与任职记录
      • 完成审批
      • 新增待入职员工
      • 新增已入职的正式员工
      • 新增已入职的实习生
      • 直接离职已入职的正式员工或实习生
      • 直接调动已入职的正式员工或实习生
      • 直接退休正式员工
    • 员工子集(New)
      • 部分更新指定子集对象相关信息
      • 根据员工子集对象ID集合获取指定的员工子集相关信息
      • 根据时间窗滚动查询变动的员工子集信息
      • 根据员工UserID获取指定员工的指定员工子集相关信息
      • 批量删除某类员工子集
      • 新建指定员工的指定子集对象相关信息
    • 职等(New)
      • 根据时间窗滚动查询变动的职等信息
    • 职位(New)
      • 部分更新职位
      • 根据时间窗滚动查询变动的职位信息
      • 根据职位OId集合获取的职位相关信息
      • 批量删除职位
      • 启用职位
      • 停用职位
      • 新增职位
    • 组织单元(不推荐)
      • 部分更新组织单元
      • 查询指定组织下的行政维度子组织列表信息
      • 根据组织OId集合获取组织相关信息
      • 根据时间窗分页查询变动的组织变动信息
      • 启用组织单元
      • 删除组织单元
      • 停用组织单元
      • 新增组织单元
    • 职务(不推荐)
      • 部分更新职务
      • 根据时间窗分页查询变动的职务变动信息
      • 根据职务OId集合获取职务相关信息
      • 启用职务
      • 删除职务
      • 停用职务
      • 新增职务
    • 职务序列(不推荐)
      • 根据职务序列OId集合获取未删除的职务序列相关信息
      • 根据时间窗分页查询变动的职务序列变动信息
    • 职位(不推荐)
      • 部分更新职位
      • 根据时间窗分页查询变动的职位变动信息
      • 根据职位Id集合获取未删除的职位相关信息
      • 启用职位
      • 删除职位
      • 停用职位
      • 新增职位
    • 组织单元(New)
      • 查询指定组织的下级组织单元列表
      • 更新组织单元
      • 根据时间窗滚动查询变动的组织单元信息
      • 根据组织OId集合获取组织相关信息
      • 批量查询指定组织的下级组织树分支
      • 启用组织单元
      • 停用组织单元
      • 新增组织单元
    • 职务序列(New)
      • 根据时间窗滚动查询变动的职务序列信息
      • 更新职务序列
      • 新建职务序列
    • 职层(New)
      • 根据时间窗滚动查询变动的职层信息
    • 职务(New)
      • 根据时间窗滚动查询变动的职务信息
      • 更新职务
      • 批量删除职务
      • 启用职务
      • 停用职务
      • 通过职务OID获取职务信息
      • 新增职务
    • 资源集合(New)
      • 根据时间窗滚动查询变动的资源集合信息
    • 组织编制(New)
      • 获取全部编制或者指定部门编制
      • 新建组织编制和新建细分编制
    • 专业条线(New)
      • 根据时间窗滚动查询变动的专业条线信息
    • 职级类别(New)
      • 根据时间窗滚动查询变动的职级类别信息
    • 职级(New)
      • 根据时间窗滚动查询变动的职级信息
  • 招聘管理系统
    • 操作记录
      • 获取当前应聘者的全部操作记录历史
    • 面试
      • 根据面试时间获取面试
      • 根据面试日程获取面试信息
      • 根据面试ID获取面试信息
      • 根据应聘者GUID获取面试信息
      • 根据申请ID获取面试信息
      • 根据应聘者CID获取面试信息
      • 根据面试ID获取评价详情
    • 门店
      • 创建门店
      • 更新门店
      • 获取门店信息
      • 启用门店
      • 删除门店
      • 停用门店
    • 内外推
      • 查询推荐人信息
      • 根据推荐人ID查询积分明细
      • 根据推荐人ID调整积分余额
    • 渠道
      • 根据条件获取渠道列表
    • 人才库
      • 储备到人才库
      • 分批次获取人才库列表
      • 获取指定人才库下的应聘者Id列表
      • 获取某时间段内指定人才库下新增或更新的应聘者Id列表
      • 移出人才库
    • 入职管理
      • 查询待入职人员信息
      • 查询Offer信息
      • 更新Offer信息
      • 获取offerId
      • 获取待入职员工Id
    • 日历
      • 查询日历事件
      • 创建或更新指定事件
      • 删除指定事件
    • 申请
      • 根据申请Id批量获取申请详情页免登录地址
      • 根据同步Id获取应聘者投递简历结果
      • 更新申请信息
      • 根据搜索条件查询应聘者申请信息
      • 根据申请ID获取申请信息
      • 获取应聘者申请对象信息
      • 批量根据同步Id获取应聘者投递简历结果
      • 应聘者投递简历
      • 转移阶段状态
    • 设置相关
      • 根据流程编码获取流程及其包含阶段状态内容
      • 根据流程id获取流程及其包含阶段状态内容
      • 获取流程列表
    • 应聘者
      • 创建或更新应聘者
      • 根据附加资料Id删除应聘者附加资料
      • 更新应聘者个人信息
      • 根据同步Id获取应聘者Id
      • 根据申请Id添加应聘者附加资料
      • 根据搜索条件获取应聘者Id
      • 根据应聘者Id添加应聘者附加资料
      • 根据应聘者Id查询应聘者附加资料
      • 获取一段时间内新增或更新的应聘者Id
      • 获取标准简历
      • 获取应聘者原始简历文件
      • 批量根据同步Id获取应聘者Id
      • 批量获取应聘者个人信息
      • 批量获取简历模块信息
    • 职位广告
      • 分渠道获取广告列表
      • 根据搜索条件获取职位广告列表
      • 获取职位分类数据
      • 获取企业租户下的长招、热招职位广告
    • 招聘需求
      • 按条件获取招聘需求
      • 创建招聘需求
      • 关联招聘需求
      • 更新招聘需求
      • 取消关联招聘需求
    • 职位
      • 创建职位
      • 根据条件获取职位列表
      • 根据职位Id获取职位列表
      • 根据职位编码获取职位列表
      • 更新职位
  • 360评估反馈
    • IAPI360Provider
      • 根据邮箱和reportno获取报告下载地址(对外开放平台接口提供)
      • 获取评价者作答链接(对外开放平台接口提供)
      • 获取用户所有套卷的得分(对外开放平台接口提供)
  • PaaS平台
    • Ocean
      • 获取异步报表生成状态
      • 获取【分析报表、定制报表】报表的列表详细数据
      • 获取【自由报表】数据
      • 获取租户下报表(租户级+应用级)
      • 获取【分析报表、定制开发】报表表头数据
      • 刷新【自由报表、定制报表】数据
  1. 工时开放接口

添加工时

POST
/AttendanceOpen/api/v1/WorkingHour/Add
接口限制:100次/秒/企业 3000次/分钟/企业
适用场景:向北森系统推送工时数据
警告信息:-
tips:异步执行,单次推送数据不能超过1000条
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://openapi.italent.cn/AttendanceOpen/api/v1/WorkingHour/Add' \
--header 'Content-Type: application/json' \
--data-raw '{
    "WorkingHours": [
			{
				"Name": "综合工时1",
				"Email": "zonghegongshi1@beisen.com",
				"AttendanceOrg": "广州&小鹏汽车科技有限公司",
				"StartDate": "2020-10-01",
				"EndDate": "2020-10-31",
				"StandardWorkingHours": 147,
				"StandardWorkingHoursAdjust": 0,
				"ActualStandardWorkingHours": 147,
				"AttendanceWorkingHours": 140,
				"AttendanceWorkingHoursAdjust": 0,
				"CarryOverWorkingHours": 0,
				"CarryOverStatus": "未结算",
				"BalanceToMonthlyLimit": 0,
				"BalanceToVacationLimit": 0,
				"BalanceToNextCycleLimit": 0,
				"Remark": null,
				"Properties": {}
			}],
			"Email": "wangxu@bei.com"
}'
响应示例响应示例
{
  "Code": "Succeed",
  "Message": "string"
}

请求参数

Body 参数application/json
WorkingHours
array [object {16}] 
工时导入数据
必需
Name
string 
员工姓名
必需
Email
string 
电子邮箱
必需
StartDate
string 
必需
开始时间 如:"2020-10-01"
EndDate
string 
必需
结束时间 如:"2020-10-02"
StandardWorkingHours
string 
标准工时
必需
StandardWorkingHoursAdjust
string 
标准工时调整值
必需
AttendanceWorkingHours
string 
出勤工时
必需
AttendanceWorkingHoursAdjust
string 
出勤工时调整值
必需
CarryOverWorkingHours
string 
结转工时
可选
CarryOverStatus
string 
必需
结算状态查看可用选项
BalanceToMonthlyLimit
string 
结算至月报额度
可选
BalanceToVacationLimit
string 
转调休假额度
可选
ExchangeLeaveValidityDate
string 
调休假有效期
可选
BalanceToNextCycleLimit
string 
结转至下一周期额度
可选
Remark
string 
备注
可选
Properties
object 
自定义字段
可选
Email
string 
此邮箱发送邮件
必需
示例

返回响应

🟢200OK
application/json
Body
Code
enum<string> 
可选
返回状态编码
200 成功
206 部分成功
401 无权限
417 失败
枚举值:
SucceedPartSucceedNoPermissionFailed
Message
string 
错误信息
可选

【北森】API开发者 微信交流群

用微信扫右侧二维码,加入【北森】API开发者 交流群,互助沟通

扫码加入交流群
上一页
获取工时数据
下一页
根据审批完成时间获取公出数据
Built with