Cómo configurar integraciones Global Payroll

En Rankmi, el módulo de Global Payroll te ofrece herramientas robustas para gestionar la nómina de tu empresa. Una parte fundamental de esta gestión es la capacidad de integrar el sistema con otras plataformas y de personalizar la documentación. Este artículo te guiará a través de la configuración de plantillas de documentos, la sincronización de datos clave y la implementación de webhooks para automatizar notificaciones.

2. Sincronización de datos con Core y Posiciones

Rankmi te permite sincronizar automáticamente la información del máster de personas (Core) con el módulo de Global Payroll. Esto asegura que los datos de tus colaboradores estén siempre actualizados en ambos sistemas, minimizando errores y la necesidad de doble digitación.

Sincronización Core-Payroll

Esta sincronización bidireccional garantiza que los cambios en los datos de los colaboradores se reflejen en ambos módulos:

• Modificaciones en Core: Cualquier actualización en campos como área, cargo y supervisor de un colaborador en el máster de personas (Core) generará automáticamente una actualización en su información personal y en su contrato/anexo en Payroll. Al guardar estos cambios, se te preguntará si deseas generar un nuevo anexo de contrato para mantener un historial de modificaciones.
• Modificaciones en Payroll: De manera recíproca, si realizas cambios en los campos área, cargo o supervisordirectamente desde el contrato de un colaborador en Payroll, estos se sincronizarán automáticamente con los datos del colaborador en Core.
• Datos por país: El campo "País de contratación" en el máster de colaboradores es crucial, ya que vincula al usuario con la configuración de nómina específica de ese país. Si un usuario se crea en un país sin configuración de Payroll, se sincronizará por defecto con Argentina.
• Sincronización de entidades: La sincronización bidireccional también se extiende a entidades como Razones Sociales, Centros de Costo y Sucursales. Solo los campos compartidos entre Core y Payroll se sincronizan; los campos específicos de cada módulo deben configurarse directamente en el respectivo sistema. Por ejemplo, los centros de costo creados en Core se replicarán en todos los países de Payroll habilitados.

Sincronización Posiciones Core-Payroll

Si tu empresa utiliza el módulo de Posiciones, la sincronización es aún más detallada:

• Datos de Posición: Cuando tienes el módulo de Posiciones activo, la posición de un colaborador incluye campos como Empresa, Sucursal, Área, Cargo y Centro de Costo.
• Actualizaciones bidireccionales: Si actualizas la información de una posición en Core (Máster), estos cambios se reflejarán automáticamente en Payroll. De igual forma, si modificas una posición en Payroll, la información se actualizará en Core. La información personal del colaborador mantiene su sincronización bidireccional.
• Generación de anexos: Al modificar campos como Cargo, Estructura Organizacional, Sucursal, Centro de Costo y Posición Padre (supervisor directo) en una posición asociada a un contrato, se generará automáticamente un nuevo anexo de contrato en Payroll, creando un historial de modificaciones.
• Requisitos para la activación: Para habilitar esta sincronización, debes tener el módulo de Posiciones activo en su versión completa (full) y asegurarte de que todas las posiciones estén activas en Payroll. Es fundamental que todos los contratos tengan el 100% de la información obligatoria completa y que la posición asignada en el máster coincida con la del contrato vigente en Payroll para evitar inconsistencias.

Configuración de sincronización de campos entre Posiciones y Payroll

Puedes personalizar qué campos se sincronizan entre Posiciones y Payroll:

• Campos por defecto: La información fundamental de la relación laboral (Posición, Razón Social, Sucursal, Cargo, Área y Jefe directo) se sincroniza automáticamente y no es configurable.
• Campos configurables: Puedes elegir activar la sincronización para campos adicionales como Grupo de nóminay Salario (transversales), o Configuración avanzada, Plaza de trabajo y Timbrado (específicos de México).
• Impacto de la configuración:
  • Si la sincronización de un campo configurable está activada, la información establecida en Core prevalecerá y no podrá ser editada directamente en Payroll.
  • Si la sincronización está desactivada, el campo en Payroll permanecerá libre para que puedas asignar su valor independientemente de la información de la posición.
• Dónde configurar: Dirígete al módulo de Posiciones y busca la sección Sincronización de campos. Aquí podrás activar o desactivar la sincronización para cada campo configurable. Por defecto, esta configuración está desactivada y afectará a todas las posiciones de tu organización.

3. Configuración de Webhooks

Los webhooks son una herramienta poderosa que te permite configurar comunicaciones en tiempo real con servicios web externos. Esto es ideal para automatizar notificaciones y mantener otros sistemas informados sobre eventos específicos que ocurren en tu módulo de Global Payroll.

Cómo configurar un nuevo webhook

1. Ve a Configuración General > Webhooks.
2. Haz clic en el botón + Nuevo Webhook.

Se abrirá un modal donde deberás proporcionar la siguiente información:

• Nombre: Un nombre para identificar tu configuración de webhook.
• Código: Un código único sin espacios para identificarlo internamente.
• URL: La URL a la que se enviarán las notificaciones. Actualmente, solo se admiten URLs con protocolo HTTP y HTTPS.
• Token: Un valor de seguridad para autenticar que las notificaciones provienen de tu sistema.
• Presente en: Define dónde se incluirá el token en la solicitud (Header, Query string o Payload).
• Llave identificador token: Un valor opcional que puede mostrar una clave con la que se identifica el token (por ejemplo, "Authorization" para el Header).
• Entidad: Selecciona la entidad de Payroll sobre la cual el webhook notificará. Puedes definir si se notificará el ciclo de vida completo de la entidad o eventos específicos (creación, actualización, eliminación) o cambios de estado. Algunas entidades disponibles incluyen:
  • Estado de periodo: Notifica cambios en el estado de un periodo (Abierto, Cerrado, Consolidado).
  • Contratos: Notifica la creación, actualización o eliminación de contratos.
  • Faltas: Notifica la creación, actualización o eliminación de faltas.
  • Vacaciones: Notifica la creación, actualización o eliminación de periodos de vacaciones.

Una vez que hayas configurado tu webhook, puedes usar el botón Probar para simular el mensaje JSON que se enviaría y verificar que la configuración sea correcta.

Gestión y monitoreo de webhooks

• Edición y eliminación: Para editar o eliminar un webhook existente, haz clic en los tres puntos verticales (⋮) al lado del nombre del webhook en el listado principal y selecciona la opción deseada.
• Ver detalle: Puedes ver el detalle de un webhook haciendo clic en el botón "Ver detalle" en su entrada.
• Historial de logs: Para monitorear el historial de notificaciones enviadas por un webhook, accede a "Historial de logs" desde el menú de tres puntos. Ten en cuenta que los logs se retienen por un periodo de 7 días.