Ir al contenido
PynPyn

ADP Workforce Now

La integración con ADP Workforce Now lee los trabajadores a través de la Workers API de ADP y mantiene al día el Directory: nombres, correo de trabajo y personal, fechas de contratación y de antigüedad, departamento, unidad de negocio, clase de puesto, ubicación, manager y fecha de baja. Pyn solo lee; no escribe nada en ADP.

  • Eres administrador o propietario en Pyn, y ADP está habilitado para tu workspace; solo entonces aparece el mosaico bajo Available.
  • Un administrador de ADP puede crear un proyecto en ADP API Central y añadir el alcance /hr/workerInformationManagement/workerManagement/workerProfileManagement/worker.read. Sin él, la conexión se autentica pero no devuelve trabajadores.
  • Tienes el Client ID y el Client Secret del proyecto, y el certificado SSL y la clave privada del proyecto. El equipo de Pyn genera el par de certificados contigo y tú subes el certificado al proyecto de ADP; escribe a support@pynhq.com para empezar.
  • La fecha de nacimiento está enmascarada en ADP por defecto. Para sincronizar cumpleaños, un administrador de ADP revela el campo en el perfil de aplicación del conector de datos.
The Connect to ADP dialog with its four credential fields.
Connect to ADP asks for the Client ID, Client Secret, SSL Certificate and Private Key.
  1. En Pyn, abre Settings en la navegación izquierda y después Available bajo Integrations.

  2. Selecciona el mosaico ADP. Se abre el diálogo Connect to ADP.

  3. Introduce el Client ID y el Client Secret de API Central.

  4. Pega el SSL Certificate y la Private Key.

  5. Selecciona Connect. El diálogo muestra “Validating those credentials…” mientras Pyn prueba las credenciales con ADP, lo que puede tardar un poco. No se guarda nada hasta que ADP las acepta.

  6. Si todo va bien, un aviso dice “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.”

Si el diálogo informa de un error, relaciónalo con su causa: “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.” El diálogo conserva lo que introdujiste, así que corrígelo y vuelve a seleccionar Connect.

Pyn actualiza desde ADP aproximadamente una vez por hora y registra cada ejecución bajo History. Campo por campo:

Propiedad en Pyn Desde ADP
Nombre para mostrar, nombre preferido, nombre legal El nombre preferido cuando está definido; si no, el nombre legal
Correo de trabajo, correo personal Las direcciones de correo de empresa y personal
Fecha de inicio La fecha de contratación original
Fecha de antigüedad La fecha de antigüedad
Fecha de baja La fecha de baja
Estado El código de estado del trabajador: A activo, L de permiso, T baja
Departamento, unidad de negocio, clase de puesto, puesto, ubicación La asignación de trabajo principal
Manager El trabajador al que reporta la asignación
Cumpleaños, zona horaria La fecha de nacimiento cuando no está enmascarada; la zona horaria a partir del país y el código postal de la dirección legal (domicilio), y si no, del país de la ubicación de trabajo
Id externo El Worker ID y el associate OID

Los trabajadores sin correo de empresa ni personal no aparecen en el Directory hasta que llega un correo. El tipo de trabajador no se mapea por defecto; el soporte de Pyn puede mapearlo desde la asignación de trabajo principal como campo personalizado. Consulta Campos del HRIS para la matriz completa y Cadencia de sincronización y emparejamiento para saber cómo se emparejan los empleados.

Abre el mosaico de ADP bajo Installed, abre el menú … y selecciona Test Connection. “Successfully tested the connection to ADP Workforce Now.” lo confirma. “An error occurred connecting to ADP Workforce Now. Please check your credentials or contact support if the issue persists.” significa que las credenciales ya no funcionan; reconecta. Después abre Employees y comprueba nombres, fechas de contratación y líneas de reporte.

  • Reconnect (el menú …) abre Reconnect to ADP con los mismos cuatro campos; introduce las nuevas credenciales y selecciona Connect. “Your ADP Workforce Now integration has successfully been updated.” lo confirma. Pyn prueba primero las nuevas credenciales con ADP; si el diálogo informa de un error, la integración conserva las credenciales que tenía.
  • Deactivate detiene la sincronización sin eliminar las credenciales; Activate la reanuda.
Qué ves Qué significa
El mosaico bajo Needs Attention 🚨 y una entrada de History “Error: Authentication failed, please reconnect” ADP rechazó las credenciales, normalmente tras una rotación. Reconecta con los valores nuevos.
Una entrada de History “ADP appears to have a temporary outage” con un punto de advertencia ADP devolvió un error de servidor o no se pudo contactar (la conexión agotó el tiempo de espera o se cortó). La integración sigue activa y la siguiente actualización programada lo reintenta, así que no hay nada que hacer salvo que se repita.
La conexión funciona, pero no aparecen empleados Al proyecto de API le falta el alcance worker.read. Añádelo en API Central y actualiza.
Faltan los cumpleaños El campo está enmascarado en ADP. Revélalo en el perfil de aplicación.
Faltan algunas personas Los trabajadores sin correo de empresa ni personal no aparecen en el Directory.