ADP Workforce Now
ADP Workforce Now 集成通过 ADP 的 Workers API 读取员工,并让 Directory 保持最新:姓名、工作邮箱和个人邮箱、雇用日期和资历日期、部门、业务单元、职类、地点、经理和离职日期。Pyn 只读取;不会向 ADP 写回任何内容。
- 你是 Pyn 中的管理员或所有者,并且你的工作区启用了 ADP;只有这样,磁贴才会出现在 Available 下。
- ADP 管理员可以在 ADP API Central 中创建一个项目,并添加权限范围
/hr/workerInformationManagement/workerManagement/workerProfileManagement/worker.read。没有它,连接可以通过认证,但不会返回任何员工。 - 你有该项目的 Client ID 和 Client Secret,以及项目的 SSL 证书和私钥。Pyn 团队会和你一起生成证书对,由你把证书上传到 ADP 项目;联系 support@pynhq.com 开始这一步。
- 出生日期在 ADP 中默认被遮盖。要同步生日,ADP 管理员需要在数据连接器的应用配置文件上显示该字段。

-
在 Pyn 中,打开左侧导航中的 Settings,然后打开 Integrations 下的 Available。
-
选择 ADP 磁贴。Connect to ADP 对话框打开。
-
输入来自 API Central 的 Client ID 和 Client Secret。
-
粘贴 SSL Certificate 和 Private Key。
-
选择 Connect。Pyn 通过 ADP 测试这些凭据时,对话框显示 “Validating those credentials…”,这可能需要一点时间。在 ADP 接受这些凭据之前,不会保存任何内容。
-
成功后,通知显示 “Your ADP Workforce Now integration has successfully been added to Pyn. It will take a minute or two for the employee data to be pulled from ADP.”。
如果对话框报告错误,按原因对照:“Could not verify the credentials. The Client ID or Client Secret appear to be invalid.” / “The SSL certificate appears to be invalid. Please check the certificate and try again.” / “ADP is returning an error. Please try again later.” / “An unexpected error occurred. Please check the details and try again. If the error persists, contact support.”。对话框保留你输入的内容,所以更正后再次选择 Connect。
Pyn 大约每小时从 ADP 刷新一次,并在 History 下记录每次运行。逐字段如下:
| Pyn 属性 | 来自 ADP |
|---|---|
| 显示名称、常用名、法定姓名 | 设置了常用名时为常用名,否则为法定姓名 |
| 工作邮箱、个人邮箱 | 商务和个人电子邮件地址 |
| 入职日期 | 原始雇用日期 |
| 司龄起算日期 | 资历日期 |
| 离职日期 | 离职日期 |
| 状态 | 员工状态代码:A 在职、L 休假、T 已离职 |
| 部门、业务单元、职类、职位、地点 | 主要工作分配 |
| 经理 | 该分配的汇报对象员工 |
| 生日、时区 | 未遮盖时为出生日期;时区来自法定(家庭)地址的国家和邮政编码,回退到工作地点的国家 |
| 外部 id | Worker ID 和 associate OID |
既没有商务邮箱也没有个人邮箱的员工在有邮箱之前不会出现在 Directory 中。工作者类型默认不映射;Pyn 支持可以把它从主要工作分配映射为自定义字段。完整矩阵见 HRIS 字段,员工如何匹配见同步频率与匹配。
打开 Installed 下的 ADP 磁贴,打开 … 菜单并选择 Test Connection。“Successfully tested the connection to ADP Workforce Now.” 表示成功。“An error occurred connecting to ADP Workforce Now. Please check your credentials or contact support if the issue persists.” 表示凭据已不再有效;重新连接。然后打开员工,检查姓名、雇用日期和汇报关系。
重新连接或断开连接
Section titled “重新连接或断开连接”- Reconnect(… 菜单)打开 Reconnect to ADP,有同样的四个字段;输入新凭据并选择 Connect。“Your ADP Workforce Now integration has successfully been updated.” 表示成功。Pyn 会先通过 ADP 测试新凭据;如果对话框报告错误,集成保留原有的凭据。
- Deactivate 停止同步但不删除凭据;Activate 恢复同步。
| 你看到的 | 含义 |
|---|---|
| 磁贴位于 Needs Attention 🚨 下,History 中有一条 “Error: Authentication failed, please reconnect” | ADP 拒绝了凭据,通常发生在轮换之后。用新值重新连接。 |
| History 中有一条带警告圆点的 “ADP appears to have a temporary outage” | ADP 返回了服务器错误或无法访问(连接超时或中断)。集成保持活跃,下一次计划刷新会重试,所以除非反复出现,否则无需处理。 |
| 连接正常但没有员工出现 | API 项目缺少 worker.read 权限范围。在 API Central 中添加它并刷新。 |
| 缺少生日 | 该字段在 ADP 中被遮盖。在应用配置文件上显示它。 |
| 缺少某些人 | 既没有商务邮箱也没有个人邮箱的员工不会出现在 Directory 中。 |