Cómo conectar tu ERP con Sesame mediante API REST
La integración entre un ERP corporativo y una plataforma de RRHH es uno de los proyectos de digitalización más frecuentes en empresas enterprise. Sesame HR facilita esta integración gracias a su API REST documentada bajo la especificación OpenAPI 3.0, que permite sincronizar datos de empleados, estructuras organizativas y eventos de RRHH de forma automatizada.
Mantener los datos sincronizados entre el ERP y Sesame HR elimina la duplicidad de información, reduce errores de entrada manual y permite que los equipos de IT, finanzas y RRHH trabajen con una fuente única de verdad.
Proceso de integración
💡 Antes de comenzar, asegúrate de que tienes activado el Add On de API en tu cuenta de Sesame HR y de que dispones de 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 tokens desde el panel de administración, en Configuración > Integraciones > API. Cada petición al API 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 coste / 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 da de alta un nuevo empleado en el ERP, se puede disparar automáticamente la creación de su ficha en Sesame HR mediante una llamada POST al endpoint de empleados. Del mismo modo, cuando un empleado causa baja en el ERP, se puede actualizar o desactivar su registro 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 actuar como fuente de verdad para las incidencias que afectan a la nómina. A través de la API puedes exportar automáticamente hacia el sistema de nómina:
- Horas extras y fichajes: mediante los endpoints de 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. Monitorización 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 polling periódico. Consulta la sección de Webhooks de esta guía para más detalles.
🛠️ ¿Necesitas ayuda con la integración? Nuestro equipo técnico puede asesorarte en el diseño e implementación. Contacta con tu Account Manager o abre un ticket de soporte. |