ADP Workforce Now Integration — Proposed Guide
Planned API — Reference OnlyADP Workforce Now Integration: A possible employee-data workflow could use authorized ADP Workforce Now employment attributes to inform organizational…
Overview
A possible employee-data workflow could use authorized ADP Workforce Now employment attributes to inform organizational context. It should not imply that payroll or reimbursement payments are processed.
Key concepts
Limit mapping to approved identities, department and manager references. Define source ownership and effective dates.
Implementation considerations
No ADP connection is active. Provider access, eligible fields and customer consent must be confirmed before reading any employee data.
Illustrative data model
This local fixture shows a possible representation for the concepts above. It is not an endpoint response, production configuration or a claim that the described capability is implemented.
{
"reference_only": true,
"topic": "ADP Workforce Now Integration",
"external_id": "external_example_123",
"user_id": "usr_example_123",
"department_id": "dept_example_123",
"manager_id": "usr_example_123"
}Design review checklist
- Document which organization owns the adp workforce now integration representation and which actor may view or change it.
- Test the boundaries of external id, user id, department id, manager id using synthetic values, including missing or inconsistent references.
- Before future implementation, obtain an approved contract and review failure behavior. This documentation does not authorize production activation.
Proposed data types
| Name | Type | Description |
|---|---|---|
| external_id | string | Fictional source/provider correlation value, not a credential or proof of synchronization. |
| user_id | string | Stable fictional user reference; not a secret and not evidence that a resource exists. |
| department_id | string | Stable fictional department reference; not a secret and not evidence that a resource exists. |
| manager_id | string | Stable fictional manager reference; not a secret and not evidence that a resource exists. |