Cómo conectar tu ERP con Sesame mediante API REST
La integración entre un ERP corporativo y una plataforma de RR. HH. es uno de los proyectos de digitalización más comunes en empresas grandes. Sesame HR facilita esta integración a través de su API REST, documentada bajo la especificación OpenAPI 3.0, que permite sincronizar datos de empleados, estructuras organizacionales y eventos de RR. HH. de forma automatizada.
Mantener la información sincronizada entre el ERP y Sesame HR elimina duplicidades, reduce errores manuales y permite que los equipos de TI, finanzas y RR. HH. trabajen con una única fuente de datos confiable.
Proceso de integración
💡 Antes de comenzar, asegúrate de tener activado el Add-on de API en tu cuenta de Sesame HR y contar con tu token de autenticación. |
1. Autenticación
La API de Sesame HR utiliza autenticación mediante Bearer Token. El administrador puede generar y gestionar los tokens desde el panel en Configuración >> Integraciones >> API. Cada solicitud debe incluir el token en la cabecera de autorización:
|
GET /core/v3/employees Host: api-eu1.sesametime.com Authorization: Bearer {tu_token} Accept: application/json |
2. Mapeo de entidades
Antes de iniciar la sincronización, es necesario mapear las entidades del ERP con las de Sesame HR. Los recursos principales a mapear son:
Entidad ERP |
Recurso Sesame API |
Endpoint |
Empleado / Trabajador |
Employees |
/core/v3/employees |
Departamento / Unidad |
Departments |
/core/v3/departments |
Centro de costo / Sede |
Offices |
/core/v3/offices |
Contrato laboral |
Contracts |
/contract/v1/contracts |
Datos salariales |
Salaries |
/contract/v1/salaries |
3. Sincronización de altas y bajas
Cuando se registra un nuevo empleado en el ERP, se puede automatizar la creación de su perfil en Sesame HR mediante una solicitud POST al endpoint de empleados.
De igual forma, cuando un empleado deja la empresa, su registro puede actualizarse o desactivarse automáticamente en Sesame.
|
POST /core/v3/employees Content-Type: application/json Authorization: Bearer {tu_token}
{ "firstName": "María", "lastName": "García López", "email": "maria.garcia@empresa.com", "departmentId": "uuid-del-departamento", "officeId": "uuid-de-la-oficina" } |
4. Traspaso de variables de nómina
Sesame HR puede funcionar como fuente principal de datos para incidencias que impactan la nómina. A través de la API puedes exportar automáticamente:
- Horas extras y registros de asistencia: mediante Work Entries (/schedule/v1/work-entries).
- Ausencias y permisos: mediante Vacation y Absence Day Off Requests (/schedule/v1/vacation-day-off-requests).
- Compensaciones variables mensuales: mediante Monthly Variable Compensations (/contract/v1/monthly-variable-compensations).
- Grupos de cotización: mediante Contribution Groups (/contract/v1/contribution-groups).
5. Monitoreo y webhooks
Sesame HR permite configurar webhooks para notificar a sistemas externos cuando ocurren eventos relevantes. Esto permite que el ERP se mantenga actualizado en tiempo real sin necesidad de consultas periódicas.
Consulta la sección de Webhooks en la documentación para más información.
🛠️ ¿Necesitas ayuda con la integración? Nuestro equipo técnico puede apoyarte en el diseño e implementación. Contacta a tu Account Manager o crea un ticket desde el soporte. |