ADP Mobile Solutions 数据 API：薪酬、工时与福利

ADP Mobile Solutions 是 ADP, INC.（Automatic Data Processing）推出的员工自助应用。ADP 总部位于美国新泽西州，是 RUN Powered by ADP、ADP Workforce Now 与 ADP Vantage HCM 等薪酬与人力资本管理平台的提供商。员工用自己的 ADP 账户登录后，首页会按个人账户呈现日常的薪酬与工时事务：查看工资单与税表，在余额卡片上按政策查询带薪休假余额，在排班表中浏览已排班次并查看本周期工时汇总，打卡上下班，提交请假申请并跟踪审批进度，以及拍下纸质支票即可设置或更改直接存款账户、无需手动输入银行路由号码。该应用面向美国市场，服务于在 ADP 上运行薪酬、工时与福利的企业中的小时工和受薪员工——他们希望在手机上而不是在办公桌或共用终端前处理工资、排班与休假；在这一员工端角色上，它与 Paychex、Workday、UKG 等薪酬与人力资源服务商的自助应用同台竞争。

按政策划分的带薪休假余额、已排班次与各工资周期的工时合计，构成了应用在员工登录后读取的记录核心。余额以 timeOffBalances 返回，按 roleCode 并截至某个 balanceAsOfDate 查询，因此每项假期政策的小时数都对应一个明确日期。班次以 timeSchedule 返回，时间窗口由 startDate 与 endDate 界定，关联到 workAssignmentId 并标出 latestShift；timePeriodCalculations 则保存每个周期累计的工时。请假申请走相反方向，以 events 的形式经由 TimeOffReview 从提交走到审批。

这份记录挂在一个以 id 与 realmID 为键的资料信封上，其中的 authScheme、Locale 和条款接受标记 tncAccepted 决定为该员工开启哪些功能。银行一侧，在 bankRoutingServiceEnabled 开启时，从纸质支票照片中读取的 routingNumber 记录了员工直接存款所入账的银行。

薪酬、劳动力管理与入职系统都需要从 ADP 获取这份按员工划分的记录。财务团队把每位员工的 id、realmID 与 timePeriodCalculations 合计关联起来，在发薪前核对排班工时与薪酬发放。缺勤管理工具按 roleCode 与 balanceAsOfDate 读取 timeOffBalances 来预测排班覆盖，再跟踪 TimeOffReview 事件，让已批准的休假无需重复录入即可进入排班系统。入职流程把每个采集到的 routingNumber 与银行路由目录比对，在首次发薪前发现录错的存款账户。openData Studio 将这份工时、休假与直接存款记录转化为可调用的开放数据，支撑上述集成。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

OAuth 令牌签发（有作用域的访问令牌）
POST /v1/auth/token opendata
签发有作用域的 OAuth2 访问令牌，应用将其作为 Bearer 凭证附加到会话、GraphQL 与 OCR 调用；time-and-attendance 作用域控制打卡、余额与排班数据。
认证方式： OAuth2 应用凭证（HTTP Basic）。签发有作用域的 Bearer 访问令牌——例如打卡、余额与排班功能所需的 time-and-attendance 作用域。
- access_token
- token_type
- expires_in
- scope
- refresh_token
```
POST /v1/auth/token HTTP/1.1
Authorization: Basic <base64(appKey:appSecret)>
Content-Type: application/x-www-form-urlencoded

grant_type=password&username=jdoe&password=******&scope=time_attendance
```
```
{
  "access_token": "eyJhbGciOiJSUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "time_attendance"
}
```
服务器会话 + 用户资料
POST /v1/session/login osint
登录后创建服务器会话，并返回员工的资料信封——用户 id、realm、认证方案、地区设置与条款接受标记——用于个性化首页与功能开关。
认证方式：表单凭证 POST（username/password）并附带 client-app 头；所得会话会升级为 OAuth Bearer 令牌用于后续调用。
- id
- realmID
- authScheme
- tncAccepted
- Locale
- authToken
- enableForgotPassword
- enableChangePassword
```
POST /v1/session/login HTTP/1.1
Content-Type: application/x-www-form-urlencoded;charset=UTF-8
X-Client-App: mobile

username=jdoe&password=******
```
```
{
  "user": {
    "id": "3fa9c1e2-7b5d-4c2a-9e01-8f2d6a41b0c7",
    "realmID": "GLOBL",
    "authScheme": "federated",
    "tncAccepted": true,
    "Locale": {"language": "en", "country": "US"},
    "enableForgotPassword": true,
    "enableChangePassword": true
  }
}
```

请假余额（GraphQL）

POST /v1/graphql opendata

按角色读取已登录员工截至某日期的带薪休假余额——即应用 PTO 余额卡片背后的数字。

认证方式：带 time-and-attendance 作用域的 OAuth2 Bearer 访问令牌。

roleCode
balanceAsOfDate
timeOffBalances

POST /v1/graphql HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{"operationName":"GetTimeOffBalances","variables":{"roleCode":"employee","balanceAsOfDate":"2026-09-24"},"query":"query GetTimeOffBalances($roleCode: String!, $balanceAsOfDate: String!) { timeOffBalances { timeOffBalances(roleCode: $roleCode, balanceAsOfDate: $balanceAsOfDate) } }"}

{
  "data": {
    "timeOffBalances": {
      "timeOffBalances": [
        {"policy": "Vacation", "balance": 62.5, "unit": "hours", "balanceAsOfDate": "2026-09-24"},
        {"policy": "Sick", "balance": 24.0, "unit": "hours", "balanceAsOfDate": "2026-09-24"}
      ]
    }
  }
}

排班与周期工时合计（GraphQL）

POST /v1/graphql opendata

拉取员工在日期区间内的已排班次（GetTimeSchedule）与每周期工时合计（GetTimePeriodCalculations），对应排班网格与工时汇总界面。

认证方式：带 time-and-attendance 作用域的 OAuth2 Bearer 访问令牌。

roleCode
startDate
endDate
workAssignmentId
includeSegments
latestShift
timeSchedule
timePeriodCalculations

POST /v1/graphql HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{"operationName":"GetTimeSchedule","variables":{"startDate":"2026-09-21","endDate":"2026-09-27","workAssignmentId":"W-10432"},"query":"query GetTimeSchedule($startDate: String!, $endDate: String!, $workAssignmentId: String) { timeScheduleData: timeSchedule { timeSchedule(roleCode: \"employee\", startDate: $startDate, endDate: $endDate, workAssignmentId: $workAssignmentId, includeSegments: \"Manual\") } }"}

{
  "data": {
    "timeScheduleData": {
      "timeSchedule": [
        {"date": "2026-09-24", "workAssignmentId": "W-10432", "segments": [{"start": "09:00", "end": "17:00", "kind": "Manual"}]}
      ]
    }
  }
}

提交请假申请（GraphQL mutation）

POST /v1/graphql opendata

提交员工的请假申请事件以供审核，并返回提交后的状态——即应用请假流程的写入侧。

认证方式：带 time-and-attendance 作用域的 OAuth2 Bearer 访问令牌。

myEvents
events
Event
TimeOffReview

POST /v1/graphql HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{"operationName":"PostTimeOffReview","variables":{"myEvents":[{"type":"vacationRequest","startDate":"2026-10-05","endDate":"2026-10-06","unit":"days"}]},"query":"mutation PostTimeOffReview($myEvents: [Event]!) { TimeOffReview(events: $myEvents) }"}

{
  "data": {
    "TimeOffReview": {
      "events": [
        {"id": "EVT-88120", "type": "vacationRequest", "status": "pending", "startDate": "2026-10-05", "endDate": "2026-10-06"}
      ]
    }
  }
}

银行路由号 OCR（支票照片）

POST /v1/ocr/bank-routing openbanking

从拍摄的纸质支票中读取银行路由号，让员工无需手动输入即可设置或更改直接存款账户。

认证方式：来自移动会话的 OAuth2 Bearer 访问令牌。

routingNumber
bankRoutingServiceEnabled

POST /v1/ocr/bank-routing HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: multipart/form-data; boundary=----appform

------appform
Content-Disposition: form-data; name="checkImage"; filename="check.jpg"
Content-Type: image/jpeg

<JPEG bytes>
------appform--

{
  "routingNumber": "021000021",
  "confidence": 0.98
}

数据类别

工资单
请假余额
排班
打卡记录
请假申请
用户资料
银行路由数据

数据使用场景与案例

薪酬对账数据源
财务团队将每位员工的会话资料（id、realmID）与经 GraphQL 网关拉取的 timePeriodCalculations 合计关联，在发薪前把排班工时与薪酬发放对账。
缺勤管理自动化
劳动力管理工具读取 timeOffBalances（roleCode、balanceAsOfDate）预测人力覆盖，再跟踪 PostTimeOffReview 事件，让获批假期直接进入排班系统而无需重复录入。
直接存款入职校验
在设置银行账户时，将银行路由号 OCR 端点返回的 routingNumber 与路由目录核对，在首次发薪前发现误录的存款账户。

常见问题

ADP Mobile Solutions 接口暴露哪些数据？

员工本人的雇佣数据：会话与资料字段（id、realmID、locale），经 GetTimeOffBalances 的带薪休假余额，经 GetTimeSchedule 与 GetTimePeriodCalculations 的已排班次与周期工时合计，经 PostTimeOffReview 的请假申请提交，以及从支票照片读取的银行路由信息。

应用如何认证其请求？

登录通过向 /v1/session/login 发起带 client-app 头的表单 POST 创建服务器会话，令牌由 /v1/auth/token 的 OAuth2 授权签发。工时与考勤调用随后发送携带 time-and-attendance 作用域的 OAuth2 Bearer 令牌。

哪个端点承载工时与考勤数据？

位于 /v1/graphql 的有作用域 GraphQL 网关。它提供余额、排班与工时卡查询（如 GetTimeOffBalances、GetTimeSchedule），并接受请假申请等 mutation（如 PostTimeOffReview）。

应用暴露任何银行数据吗？

是的——一个窄的银行面：OCR 端点 /v1/ocr/bank-routing 从拍摄的支票中提取 routingNumber，以便员工配置直接存款。

与 ADP Mobile Solutions 相似的应用

Workday — Workday 是面向大型企业的 HCM 平台，其移动应用让员工查看工资、申请休假并处理人事事务，是 ADP 在大型企业市场的主要替代选择。
Paychex Flex — Paychex Flex 是面向中小企业的薪酬与人事平台，其移动自助应用可查看工资单、休假与福利。
UKG — UKG（Ultimate Kronos Group）是一套劳动力管理系统，以 AI 驱动的排班、工时考勤以及面向小时工的员工自助功能著称。
Gusto — Gusto 是面向小企业的薪酬、福利与人事平台，定价按员工透明计费，并提供移动端友好的员工自助门户。
Paycom — Paycom 是一套单数据库的薪酬与人事系统，其 Beti 工具让员工在发薪前自行核对并确认工资。
Paylocity — Paylocity 是面向中型企业的薪酬与人事平台，将工资与请假自助功能与同事互认、员工互动等参与度功能结合在一起。
Rippling — Rippling 将薪酬人事与 IT 设备及应用管理整合在同一系统中，可跨公司各类工具自动化员工入职流程。
MyWalmart — MyWalmart 是沃尔玛的员工自助应用，可查看排班与工资并打卡上下班，是面向大型小时工团队的同类功能应用。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

ADP Mobile Solutions 数据 API：薪酬、工时与福利

应用截图

API 端点一览

OAuth 令牌签发（有作用域的访问令牌）

服务器会话 + 用户资料

请假余额（GraphQL）

排班与周期工时合计（GraphQL）

提交请假申请（GraphQL mutation）

银行路由号 OCR（支票照片）

数据类别

数据使用场景与案例

薪酬对账数据源

缺勤管理自动化

直接存款入职校验

常见问题

与 ADP Mobile Solutions 相似的应用

更多企业办公类应用

CryptoRush: Crypto Simulator

Darwinbox

Google Ads

greytHR

相关主题

需要集成这个 App 的数据 API？

ADP Mobile Solutions 数据 API：薪酬、工时与福利

应用截图

API 端点一览

OAuth 令牌签发（有作用域的访问令牌）

服务器会话 + 用户资料

请假余额（GraphQL）

排班与周期工时合计（GraphQL）

提交请假申请（GraphQL mutation）

银行路由号 OCR（支票照片）

数据类别

数据使用场景与案例

薪酬对账数据源

缺勤管理自动化

直接存款入职校验

常见问题

相关应用

与 ADP Mobile Solutions 相似的应用

更多企业办公类应用

CryptoRush: Crypto Simulator

Darwinbox

Google Ads

greytHR

相关主题

需要集成这个 App 的数据 API？