---
title: "ADP Workforce Now"
description: "使用基于证书的 API 凭据从 ADP Workforce Now 同步员工、测试连接，并在 ADP 轮换凭据时重新连接。"
sidebar:
  label: 概览
  order: 0
area: integrations
feature: adp
appPath: /settings/integrations/available
lastVerified: 2026-11-15
version: "2026-11-10"
audience: admin
related:
  - integrations
  - integrations/hris-fields
  - integrations/sync-and-matching
  - directory/employees
intercom:
  - id: "16055385"
    title: Connecting to ADP Workforce Now (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16055385-connecting-to-adp-workforce-now-pyn-2
    note: replaces
  - id: "6116909"
    title: Connecting Pyn to ADP (Pyn 1)
    url: https://intercom.help/pyn/en/articles/6116909-connecting-pyn-to-adp-pyn-1
    note: "Pyn 1 article, kept for reference"
translation:
  source: integrations/adp/index.mdx
  sourceSha: 1538dda1545788323f5959b4a659d7da70e131ee
---

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 管理员需要在数据连接器的应用配置文件上显示该字段。

![Connect to ADP asks for the Client ID, Client Secret, SSL Certificate and Private Key.](https://support.pyn.ai/media/integrations/adp/integrations-adp-connect.png)

## 连接

1. 在 Pyn 中，打开左侧导航中的 **Settings**，然后打开 **Integrations** 下的 **Available**。

2. 选择 **ADP** 磁贴。**Connect to ADP** 对话框打开。

3. 输入来自 API Central 的 **Client ID** 和 **Client Secret**。

4. 粘贴 **SSL Certificate** 和 **Private Key**。

5. 选择 **Connect**。Pyn 通过 ADP 测试这些凭据时，对话框显示 "Validating those credentials..."，这可能需要一点时间。在 ADP 接受这些凭据之前，不会保存任何内容。

6. 成功后，通知显示 "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 字段](https://support.pyn.ai/zh-cn/integrations/hris-fields/)，员工如何匹配见[同步频率与匹配](https://support.pyn.ai/zh-cn/integrations/sync-and-matching/)。

## 测试

打开 **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." 表示凭据已不再有效；重新连接。然后打开[员工](https://support.pyn.ai/zh-cn/directory/employees/)，检查姓名、雇用日期和汇报关系。

## 重新连接或断开连接

- **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 中。 |

## 相关

- [集成](https://support.pyn.ai/zh-cn/integrations/)，查看目录。
- [HRIS 字段](https://support.pyn.ai/zh-cn/integrations/hris-fields/)，查看字段矩阵。
- [同步频率与匹配](https://support.pyn.ai/zh-cn/integrations/sync-and-matching/)，了解计划和匹配。
- [员工](https://support.pyn.ai/zh-cn/directory/employees/)，检查同步的记录。
