¿Qué es la API de Sesame y para qué sirve?
La API de Sesame es una herramienta pensada para facilitar la integración de nuestra plataforma con otros softwares que utilices en tu día a día. Esta capacidad es fundamental para las empresas que trabajan con ecosistemas tecnológicos complejos y necesitan que los datos de RRHH fluyan de forma automática y segura entre sistemas.
Si trabajas con varias herramientas para gestionar tus procesos de recursos humanos, nómina, control de presencia o Business Intelligence, la API de Sesame te permite conectar todo de forma programada y sin intervención manual.
¿Qué recursos puedes gestionar con la API?
La API permite acceder y manipular los principales recursos de la plataforma de forma programática. A continuación se detallan todas las áreas disponibles:
|
Recurso |
Qué puedes hacer |
👤 |
Empleados |
Crear, actualizar, eliminar y consultar fichas de empleados. Gestionar perfiles, asignar managers, departamentos y oficinas desde sistemas externos como ERPs o plataformas de onboarding. |
📄 |
Contratos |
Gestionar contratos de empleados con sus tipos, anexos y terminaciones. Consultar contratos activos, datos de payroll y niveles de puesto. |
💰 |
Salarios y compensaciones |
Administrar salarios base, compensaciones fijas y variables mensuales. Gestionar grupos de cotización para la integración con sistemas de nómina. |
⏰ |
Control horario |
Registrar fichajes con clock-in/clock-out, gestionar pausas (work breaks), validar registros y gestionar incidencias de fichaje. |
🏖️ |
Ausencias y vacaciones |
Crear y gestionar solicitudes de vacaciones y ausencias, configurar calendarios de vacaciones y festivos, aceptar o rechazar solicitudes. |
📁 |
Documentos |
Listar directorios de la empresa, subir documentos vinculados a empleados y descargar archivos de forma automatizada. |
🏢 |
Estructura organizativa |
Consultar y actualizar departamentos, oficinas, grupos de entidades, roles y asignaciones de empleados a cada unidad. |
💼 |
Reclutamiento |
Crear y gestionar candidatos, subir documentos de candidatos y consultar el estado de candidaturas por vacante. |
📊 |
Proyectos y tiempo |
Gestionar proyectos, clientes y tareas planificadas. Registrar imputaciones de tiempo por proyecto con start/stop. |
🎓 |
Formación |
Crear formaciones, asignar empleados y hacer seguimiento del estado de completitud de cada formación. |
💸 |
Gastos |
Consultar gastos de la empresa, categorías de gasto y métodos de pago configurados. |
🔄 |
Turnos y planificación |
Gestionar turnos, plantillas horarias, planificadores y asignaciones de turno a empleados. |
📋 |
Encuestas |
Consultar evaluaciones de la empresa y responder evaluaciones de reclutamiento de candidatos. |
🔧 |
Campos personalizados |
Crear, actualizar y eliminar campos custom para adaptar los datos de empleados a las necesidades de cada organización. |
📨 |
Solicitudes |
Consultar solicitudes personalizadas y sus tipos, acceder a los documentos adjuntos de cada solicitud. |
📈 |
Estadísticas |
Acceder a datos estadísticos de control horario y bolsa de horas para la generación de informes. |
¿Qué ventajas tiene el uso de la API?
Con el Add On de la API podrás sincronizar datos de forma automática entre Sesame y otras plataformas, lo que te permitirá:
- Reducir tareas manuales y errores de duplicidad al sincronizar empleados, contratos y datos salariales automáticamente.
- Centralizar la información de tus empleados pudiendo ser Sesame la fuente única de verdad conectada a todos tus sistemas.
- Automatizar procesos operativos como fichajes, ausencias, gestión de contratos o la imputación de horas por proyecto.
- Alimentar tu Business Intelligence exportando datos de RRHH hacia herramientas como Power BI o Tableau.
Casos de uso
Estas son algunas de las integraciones más comunes que nuestros clientes realizan con la API de Sesame HR:
Sincronización ERP ↔ Sesame
Sincroniza automáticamente altas, bajas y cambios contractuales entre tu ERP corporativo (SAP, Oracle, Microsoft Dynamics, etc.) y Sesame HR. Cuando se da de alta un empleado en el ERP, se crea automáticamente en Sesame con todos sus datos.
Integración con nómina
Traspasa automáticamente datos salariales completos (salario base, compensaciones, variables mensuales y grupos de cotización) hacia tu software de nómina, eliminando la entrada manual de datos mes a mes.
Control de acceso físico
Conecta sistemas de control de acceso físico (tornos, lectores de tarjeta, terminales biométricos) con Sesame HR para registrar fichajes en tiempo real mediante los endpoints de clock-in y clock-out.
Exportación a Business Intelligence
Extrae datos de RRHH (estadísticas de fichajes, ausencias, horas por proyecto, rotación) hacia herramientas de BI como Power BI, Tableau o Looker para generar dashboards ejecutivos.
Imputación de horas por proyecto
Conecta herramientas de gestión de proyectos con los endpoints de Time Entries para registrar automáticamente las horas dedicadas a cada proyecto y cliente.
Automatización de reclutamiento
Integra plataformas ATS externas con Sesame para sincronizar candidatos, documentos y estados de proceso de selección de forma automática.
Detalles técnicos de la API de Sesame
Autenticación
La API utiliza autenticación Bearer Token. Debes incluir tu token en la cabecera Authorization de cada petición:
Authorization: Bearer {tu_token_aqui} |
Puedes obtener y gestionar tu token desde Configuración > Integraciones > API dentro de tu panel de Sesame HR.
URL base y servidores regionales
La API dispone de servidores regionales para garantizar la residencia de datos. La URL base sigue el formato:
https://api-{region}.sesametime.com |
Donde {region} es el identificador de tu región (por ejemplo, eu1 para Europa).
Especificación y versionado
La API sigue la especificación OpenAPI 3.0 (OAS 3.0) y está documentada en formato Swagger, lo que facilita su integración con cualquier lenguaje de programación, plataforma tecnológica o herramienta de generación de código.
Documentación interactiva
Puedes explorar todos los endpoints, probar peticiones y ver los esquemas de datos en nuestra documentación Swagger en: apidocs.sesametime.com
🚀 La API de Sesame está disponible como Add On. Si aún no lo tienes activado, contacta con tu Account Manager o escríbenos a través del chat de soporte para comenzar a integrar. |