BambooHR 人力资源集成金蝶云星空解决方案
更新: 9/16/2026 字数: 0 字 时长: 0 分钟
业务背景
| 源系统 | 成集云 | 目标系统 |
|---|---|---|
| BambooHR 人力资源系统（HRIS） |  | 金蝶云星空 |
成长型及出海企业在海外或跨地区雇佣团队时，普遍使用 BambooHR 作为轻量 HRIS 管理员工档案、组织架构、入职离职与请假考勤。而企业的薪酬核算、社保、财务与部分本地化考勤仍在 金蝶云星空 中处理。两套系统各管一段，带来典型痛点：
- 员工入职、转正、调岗、离职等异动在 BambooHR 发生后，HR 需手动在金蝶同步员工状态与合同信息，滞后且易漏，导致薪酬核算对象不准。
- 部门、岗位、汇报关系在 BambooHR 维护，金蝶的组织机构需重复录入，两边不一致时影响费用归集与权限。
- 员工请假（Time Off）申请与剩余假期余额停留在 BambooHR，无法自动回写金蝶考勤与薪酬假勤，月度算薪仍需人工核对。
- 外籍/远程员工档案（证件、合同到期、紧急联系人等）分散，合规风险难以及时发现。
基于 成集云（iPaaS）数据集成平台，可将 BambooHR 的人事主数据与假勤数据自动同步至金蝶云星空，实现"入转调离—组织—假勤"全链路贯通。
解决方案
基于成集云数据集成平台，构建 BambooHR 与金蝶云星空之间的可视化自动同步任务。通过 BambooHR REST API（API Key 走 HTTP Basic，或 OAuth 2.0 Bearer Token，按
companyDomain租户隔离）拉取员工目录、元数据字段、部门岗位与请假数据，并由成集云完成字段映射、编码转换与增量校验后，自动写入金蝶云星空的员工、部门、岗位、员工状态、请假单与假期余额，以定时增量 + 状态事件双通道保障组织与人事数据一致。
业务流程
一、基础资料同步流程
1. 员工档案同步流程
- BambooHR
employees（directory / 指定 fields）同步至金蝶 员工/职员表，员工唯一 ID 作为映射键，支持新增与字段变更增量更新。
2. 部门与岗位同步流程
- BambooHR 的 division / department / location / jobTitle 映射为金蝶 部门 与 岗位，保持组织树与汇报关系一致，支撑费用与成本归集。
二、人事异动同步流程
1. 入职/离职/调岗同步流程
- 依据
hireDate/terminationDate/employmentStatus/jobTitle变更，自动更新金蝶员工在职状态、合同有效期与岗位归属，确保薪酬核算对象准确。
三、假勤同步流程
1. 请假申请同步流程
time_off/requests（status：requested / approved / denied）按员工、请假类型、起止日期同步为金蝶 请假单/考勤记录，已批准（approved）计入有效休假。
2. 假期余额同步流程
employees/{id}/time_off/calculator返回的假期结余同步至金蝶 假期余额/薪酬假勤，月度算薪时自动取数，无需人工核对。
对接说明
一、基础资料同步（BambooHR → 金蝶）
| BambooHR 对象 | 金蝶云星空对象 | 关键字段 |
|---|---|---|
| employees（directory / fields） | 员工/职员表 | id → 员工编码；firstName+lastName → 姓名；workEmail → 工作邮箱；department/jobTitle → 部门岗位 |
| meta/fields | 字段字典 | 自定义字段（custom_fields）映射金蝶扩展属性 |
| division / department / location | 部门 | name → 部门名称；层级 → 组织树 |
| jobTitle | 岗位 | name → 岗位名称 |
二、业务单据同步（BambooHR → 金蝶）
| BambooHR 对象 | 金蝶云星空对象 | 同步规则 |
|---|---|---|
| employees 状态字段 | 员工状态/合同 | hireDate → 入职日期；terminationDate → 离职日期；employmentStatus → 在职/离职 |
| time_off/requests | 请假单/考勤记录 | employeeId + timeOffTypeId + start/end + status 映射请假单，approved 计入休假 |
| time_off/calculator | 假期余额/薪酬假勤 | 按 employeeId 与 typeId 同步结余，供算薪取数 |
三、同步规则与过滤条件
- 租户隔离：API 按
companyDomain区分企业，成集云按租户配置独立连接，避免跨租户串数据。 - 鉴权：使用 BambooHR API Key（HTTP Basic，用户名=API Key、密码=任意非空串）或 OAuth 2.0；仅申请
employees、meta、time_off必要权限范围。 - 增量同步：以员工
id与lastChanged/字段变更作为增量标识，定时（建议每 30 分钟）拉取变更，降低接口调用量。 - 映射键：以 BambooHR
employeeId作为金蝶员工唯一映射键，离职员工保留历史档案不删除，仅更新状态。 - 过滤条件：仅同步
employmentStatus有效区间内的在职/试用员工主数据；请假仅同步 approved / requested 状态，denied 不入账。 - 异常处理：字段缺失（如必填部门为空）由成集云标记待补录并告警，不阻断整体同步。
业务价值
- 人事零重复录入：员工入转调离与组织变更自动同步金蝶，HR 摆脱双系统手工维护。
- 薪酬核算准确：请假与假期余额实时回写，月度算薪取数不再依赖人工核对，降低错算与漏算。
- 组织一致：部门/岗位/汇报关系单边维护、双边一致，费用归集与权限分配更可靠。
- 合规可控：外籍/远程员工证件、合同到期自动留痕与预警，降低劳动合规风险。
- 管理可视：金蝶统一视角的组织与人力看板，支撑实时人力成本与编制分析。
接口文档
- BambooHR 开放 API 文档：https://documentation.bamboohr.com （Base
https://api.bamboohr.com/api/gateway.php/{companyDomain}/v1，HTTP Basic / OAuth 2.0；含 employees / meta/fields / time_off/requests / time_off/calculator 等） - 金蝶云星空开放 API 文档（OpenAPI / Web API：员工、部门、岗位、请假单、考勤与薪酬取数接口）