Personio 人力资源集成金蝶云星空解决方案
更新: 10/8/2026 字数: 0 字 时长: 0 分钟
业务背景
| 源系统 | 成集云 | 目标系统 |
|---|---|---|
| Personio 人力资源系统（HRIS，DACH 区主流） |  | 金蝶云星空 |
在欧洲（德国、奥地利、瑞士等 DACH 区域）及跨境雇佣团队的企业，普遍使用 Personio 作为一体化 HRIS，管理员工档案、组织架构、入职离职、请假（Absences）与出勤（Attendances）。而企业的薪酬核算、社保、财务与本地化考勤仍在 金蝶云星空 中处理。两套系统各管一段，带来典型痛点：
- 员工异动不同步：员工入职、转正、调岗、离职在 Personio 发生后，HR 需手动在金蝶同步员工状态与合同信息，滞后且易漏，导致薪酬核算对象不准。
- 组织架构割裂：部门（Org Units）、岗位、汇报关系在 Personio 维护，金蝶的组织机构需重复录入，两边不一致时影响费用归集与权限。
- 假勤数据孤岛：员工请假（Absence Periods）与出勤（Attendances）停留在 Personio，无法自动回写金蝶考勤与薪酬假勤，月度算薪仍需人工核对。
- 合规风险：欧盟劳动法规对员工档案、合同到期、剩余假期有严格要求，分散管理难以及时预警，存在合规隐患。
基于 成集云（iPaaS）数据集成平台，可将 Personio 的人事主数据与假勤数据自动同步至金蝶云星空，实现"入转调离—组织—假勤"全链路贯通。
解决方案
基于成集云数据集成平台，构建 Personio 与金蝶云星空之间的可视化自动同步任务。通过 Personio API v2（OAuth 2.0 Client Credentials 授权，Base
https://api.personio.de/v2）拉取员工（persons）、组织单元（org-units）、请假期间（absence-periods）、出勤期间（attendances）与请假类型（absence-types），并由成集云完成字段映射、编码转换与增量校验后，自动写入金蝶云星空的员工、部门、岗位、员工状态、请假单、考勤与假期余额，以定时增量 + 状态事件双通道保障组织与人事数据一致。
业务流程
一、基础资料同步流程
1. 员工档案同步流程
- Personio
/v2/persons（含 first_name、last_name、email、position、department、office、hire_date、status 等）同步至金蝶 员工/职员表，员工唯一 ID 作为映射键，支持新增与字段变更增量更新。
2. 部门与岗位同步流程
- Personio
/v2/org-units（部门与团队）映射为金蝶 部门 与 岗位，保持组织树与汇报关系一致，支撑费用与成本归集。
二、人事异动同步流程
1. 入职/离职/调岗同步流程
- 依据
hire_date/contract_end_date/status/position变更，自动更新金蝶员工在职状态、合同有效期与岗位归属，确保薪酬核算对象准确。
三、假勤同步流程
1. 请假同步流程
/v2/absence-periods（按员工、起止日期、请假类型）同步为金蝶 请假单/考勤记录，结合/v2/absence-types区分年假、病假等类别，已批准计入有效休假。
2. 出勤同步流程
/v2/attendances（出勤与休息时段）同步为金蝶 考勤记录/工时，支撑工时统计与薪酬假勤取数。
对接说明
一、基础资料同步（Personio → 金蝶）
| Personio 对象 | 金蝶云星空对象 | 关键字段 |
|---|---|---|
| persons（员工） | 员工/职员表 | id → 员工编码；first_name+last_name → 姓名；email → 工作邮箱；department/position → 部门岗位 |
| org-units（组织单元） | 部门/岗位 | name → 名称；层级 → 组织树 |
| absence-types（请假类型） | 假期类别 | id+name → 年假/病假等类别 |
二、业务单据同步（Personio → 金蝶）
| Personio 对象 | 金蝶云星空对象 | 同步规则 |
|---|---|---|
| persons 状态字段 | 员工状态/合同 | hire_date → 入职日期；contract_end_date → 离职日期；status → 在职/离职 |
| absence-periods | 请假单/考勤记录 | employeeId + absence_type + start/end 映射请假单 |
| attendances | 考勤记录/工时 | employeeId + 时段映射考勤，供算薪取数 |
三、同步规则与过滤条件
- 租户隔离：API 按 Personio 企业 Client 区分，成集云按企业配置独立连接，避免跨租户串数据。
- 鉴权：使用 Personio API v2 OAuth 2.0 Client Credentials（
/v2/auth/token换取 Bearer Token，有效期 24 小时，401 自动重取）；仅在 Personio 授予persons:read、absences:read、org-units:read等必要权限范围。 - 增量同步：以员工
updated_since、请假/出勤的日期区间作为增量标识，定时（建议每 30 分钟）拉取变更，降低接口调用量。 - 映射键：以 Personio
personId作为金蝶员工唯一映射键，离职员工保留历史档案不删除，仅更新状态。 - 过滤条件：仅同步在职/试用等有效状态员工主数据；请假仅同步已批准（approved）状态，拒绝态不入账。
- 异常处理：字段缺失（如必填部门为空）由成集云标记待补录并告警，不阻断整体同步。
业务价值
- 人事零重复录入：员工入转调离与组织变更自动同步金蝶，HR 摆脱双系统手工维护。
- 薪酬核算准确：请假与出勤实时回写，月度算薪取数不再依赖人工核对，降低错算与漏算。
- 组织一致：部门/岗位/汇报关系单边维护、双边一致，费用归集与权限分配更可靠。
- 欧盟合规可控：员工证件、合同到期、剩余假期自动留痕与预警，降低 DACH 区域劳动合规风险。
- 管理可视：金蝶统一视角的组织与人力看板，支撑实时人力成本与编制分析。
接口文档
- Personio API v2 开发者文档（认证
/v2/auth/token、persons / org-units / absence-periods / attendances）：https://developer.personio.de/ - 金蝶云星空开放 API（OpenAPI / Web API：员工、部门、岗位、请假单、考勤与薪酬取数接口）：
https://dev.kingdee.com/