¿Qué es la API de Sesame y para qué sirve?
La API de Sesame es una herramienta diseñada para facilitar la integración de nuestra plataforma con otros sistemas que utilizas en tu operación diaria. Es especialmente útil para empresas que trabajan con ecosistemas tecnológicos complejos y necesitan que la información de RR. HH. fluya de forma automática y segura entre diferentes herramientas.
Si utilizas varias soluciones para gestionar procesos como recursos humanos, nómina, control de asistencia o Business Intelligence, la API de Sesame te permite conectarlas de forma automatizada, sin intervención manual.
¿Qué recursos puedes gestionar con la API?
La API permite acceder y gestionar los principales recursos de la plataforma de forma programática. A continuación, se detallan las áreas disponibles:
|
Recurso |
Qué puedes hacer |
👤 |
Empleados |
Crear, actualizar, eliminar y consultar perfiles de empleados. Gestionar información, asignar mánagers, departamentos y oficinas desde sistemas externos como ERPs o plataformas de incorporación. |
📄 |
Contratos |
Gestionar contratos de empleados, incluyendo tipos, anexos y finalizaciones. Consultar contratos activos, datos de nómina y niveles de puesto. |
💰 |
Salarios y compensaciones |
Administrar salarios base, compensaciones fijas y variables mensuales. Gestionar grupos de cotización para integraciones con sistemas de nómina. |
⏰ |
Control de asistencia |
Registrar entradas y salidas, gestionar pausas, validar registros y administrar incidencias. |
🏖️ |
Ausencias y vacaciones |
Crear y gestionar solicitudes de vacaciones y ausencias, configurar calendarios y aprobar o rechazar solicitudes. |
📁 |
Documentos |
Listar carpetas de la empresa, subir documentos vinculados a empleados y descargar archivos de forma automatizada. |
🏢 |
Estructura organizacional |
Consultar y actualizar departamentos, oficinas, grupos, roles y asignaciones de empleados. |
💼 |
Reclutamiento |
Crear y gestionar candidatos, subir documentos y consultar el estado de los procesos de selección. |
📊 |
Proyectos y tiempo |
Gestionar proyectos, clientes y tareas. Registrar horas trabajadas por proyecto mediante inicio/fin. |
🎓 |
Capacitación |
Crear capacitaciones, asignar empleados y dar seguimiento al progreso de cada curso. |
💸 |
Gastos |
Consultar gastos de la empresa, categorías y métodos de pago configurados. |
🔄 |
Turnos y planificación |
Gestionar turnos, plantillas de horario y asignaciones a empleados. |
📋 |
Encuestas |
Consultar evaluaciones de la empresa y responder evaluaciones de candidatos. |
🔧 |
Campos personalizados |
Crear, actualizar y eliminar campos personalizados para adaptar la información de empleados. |
📨 |
Solicitudes |
Consultar solicitudes personalizadas y acceder a sus documentos adjuntos. |
📈 |
Estadísticas |
Acceder a datos de control de asistencia y banco de horas para la generación de reportes. |
¿Qué ventajas tiene el uso de la API?
Con el Add-on de la API podrás sincronizar información entre Sesame y otras plataformas, lo que te permitirá:
- Reducir tareas manuales y errores al sincronizar empleados, contratos y datos salariales automáticamente.
- Centralizar la información de tus empleados, utilizando Sesame como fuente única de datos.
- Automatizar procesos como registros de asistencia, ausencias, gestión de contratos o registro de horas por proyecto.
- Alimentar tus herramientas de Business Intelligence exportando datos hacia plataformas 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 (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
Transfiere automáticamente datos salariales (salario base, compensaciones, variables y grupos de cotización) hacia tu sistema de nómina, lo que elimina la entrada manual de datos mes a mes.
Control de acceso físico
Conecta sistemas de acceso (tornos, lectores de tarjetas o dispositivos biométricos) con Sesame HR para registrar entradas y salidas en tiempo real.
Integración con Business Intelligence
Exporta datos de RR. HH. (asistencia, ausencias, horas por proyecto, rotación) a herramientas como Power BI, Tableau o Looker.
Registro de horas por proyecto
Integra herramientas de gestión de proyectos para registrar automáticamente el tiempo dedicado a cada cliente o proyecto.
Automatización de reclutamiento
Conecta plataformas ATS con Sesame para sincronizar candidatos, documentos y estados del proceso de selección.
Detalles técnicos de la API de Sesame
Autenticación
La API utiliza autenticación mediante Bearer Token. Debes incluir tu token en la cabecera Authorization de cada solicitud:
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 cuenta con servidores regionales para garantizar la residencia de datos. La URL base es:
https://api-{region}.sesametime.com |
Donde {region} corresponde a 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 distintos lenguajes y plataformas.
Documentación interactiva
Puedes explorar los endpoints, probar solicitudes y revisar los esquemas de datos en: apidocs.sesametime.com
🚀 La API de Sesame está disponible como Add-on. Si aún no lo tienes activado. Contacta a tu Account Manager o escríbenos a través del chat de soporte para comenzar a integrarla. |