O que você de TI deve saber
📘 Padrão de Envio para a ADP API
🔄 Integração via APIs REST
A ADP eXpert realiza integrações via APIs REST, com troca de dados no formato JSON.
Para esta integração, utilizamos o produto Workers Lifecycle Management, responsável pelos eventos de ciclo de vida do colaborador.
Principais endpoints utilizados:
- Método: POST /events/hr/v1/worker.hire
- Método: POST /hr/v1/associates/aoid/dependents
- Método: POST /payroll/v2/workers/aoid/pay-distributions
📄 Documentação oficial: https://developers.adp.com/guides/api-guides/workers-lifecycle-management-apis-guide-for-expert-brazil
Caso o cliente possua regras internas ou transformações específicas, poderá ser necessário incluir uma camada de integração/barramento.
🛠️ Requisitos para Conexão
O cliente deve fornecer:
- Client ID e Client Secret para autenticação OAuth 2.0;
- Ambiente de Homologação liberado.
⚠️ Erros Comuns na Integração
| Mensagem | Motivo | Ação |
|---|---|---|
| 400 Missing required field | Campo obrigatório faltando | Validar preenchimento antes do envio |
| 422 Validation Error | Formatação ou valor invalido | Ajustar conforme schema da API |
| 401 / 403 Unauthorized | Token inválido ou permissão insuficiente | Validar Client ID, Secret e escopos |
Updated about 3 hours ago
