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


MensagemMotivoAção
400 Missing required fieldCampo obrigatório faltandoValidar preenchimento antes do envio
422 Validation ErrorFormatação ou valor invalidoAjustar conforme schema da API
401 / 403 UnauthorizedToken inválido ou permissão insuficienteValidar Client ID, Secret e escopos