Requisitos previos :
Plan requerido : People.
Configuración previa : La clave API (token) es generada por el equipo de Combo — contacta con nuestro equipo de soporte para solicitarla.
Recurso técnico : La API no es plug & play. Su implementación requiere desarrollo por tu parte.
¿Qué es la API Partner de Combo?
La API (Application Programming Interface) Partner es una interfaz que permite a dos aplicaciones comunicarse e intercambiar datos de forma automatizada.
Nuestra API Combo permite recuperar los datos de Combo para analizarlos, transformarlos y conectarlos con otras herramientas (dashboards, BI, software de nómina…).
¿Cómo obtener tu clave API?
La clave API (también llamada "token") es generada por nuestro equipo de Combo.
Dirígete a partner.combohr.com/swagger :
Haz clic en el botón Authorize.
Introduce tu clave API en el campo Value.
Haz clic de nuevo en Authorize, luego en Close.
Ya estás conectado y puedes ejecutar solicitudes de lectura (
GET) y de escritura (POST).
💡
El Swagger es la referencia completa de todos los endpoints disponibles.
Comparte directamente este enlace con tu equipo técnico o desarrollador — sabrán cómo utilizarlo.
¿Qué datos son accesibles en lectura (GET)?
Los siguientes datos pueden exportarse desde Combo hacia tu herramienta :
Planificación : fecha del turno, horas planificadas de inicio/fin, horas reales de inicio/fin, tiempo de pausa planificado y real, nota planificada y real, nombre y apellido del empleado, equipo planificado, etiqueta.
Contratos : ID empleado, nombre, apellido, número de seguridad social, fechas de inicio y fin de contrato, jornada semanal, número de días trabajados por semana, tipo de contrato, equipo de adscripción, rol, salario mensual bruto o tarifa horaria bruta, e-mail, dirección postal, nacionalidad, puesto de trabajo, motivo de fin de contrato.
Historial de contratos : historial completo de un contrato y sus anexos.
Contratos finalizados : contratos cerrados en un período determinado.
Facturación : facturación previsional y real por establecimiento para la semana en curso.
💡 La masa salarial cargada no está expuesta directamente a través de la API. Puede calcularse a partir de los datos de salario bruto transmitidos.
¿Qué datos son accesibles en escritura (POST)?
Los siguientes datos pueden enviarse hacia Combo desde tu herramienta :
Facturación : envío de la facturación previsional y real en el informe de análisis de Combo — útil si tu software de caja no está integrado de forma nativa. El location ID (identificador del establecimiento) es obligatorio para cada envío.
Número de empleado : actualización del identificador del empleado para facilitar el matching con tu software de nómina.
💡 La API no permite crear turnos, publicar una planificación ni crear o modificar fichas de empleados.
¿Qué no permite la API de Combo?
La API Partner de Combo es principalmente una API de lectura. No permite :
La importación o creación de planificaciones desde una herramienta externa.
La creación o modificación de fichas de empleados.
La sincronización bidireccional automática.
La conexión nativa con software de nómina — estos conectores funcionan mediante exportaciones dedicadas, distintas de la API Partner.
¿Cómo conectar un software de caja para sincronizar la facturación?
Combo ofrece integraciones nativas con los principales software de caja del mercado, gratuitas y reservadas a los Admins.
Dirígete a Configuración > Integraciones > Caja :
Haz clic en la tarjeta de tu software de caja.
Autentícate según el método propio de cada caja (ver a continuación).
Asocia cada caja al establecimiento de Combo correspondiente.
Software de caja disponibles y método de autenticación :
Agora — activa la integración e introduce la URL de la máquina que aloja Agora y el token API recuperado desde tu cuenta Agora.
Revo XEF — activa la integración e introduce el tenant de conexión y el token de autenticación recuperado desde tu cuenta Revo XEF.
Una vez conectada la caja, la facturación sin IVA se sincroniza automáticamente cada noche entre las 3:30 y las 4:30 (según la zona horaria de la cuenta), siempre que las cajas estén correctamente cerradas.
💡
Si tu software de caja no está en la lista, utiliza la API Partner (solicitud
POSTcon el location ID) para sincronizar la facturación manualmente.La integración de caja sincroniza únicamente la facturación — no transfiere ningún otro dato hacia Combo.
FAQ
¿Cómo verificar que mi clave API es válida ?
¿Cómo verificar que mi clave API es válida ?
Realiza una solicitud GET en el Swagger. Una respuesta 200 OK confirma que tu clave funciona. Un error 401 Unauthorized indica una clave incorrecta o expirada — contacta con [email protected].
¿Mi clave API funciona para todos mis establecimientos ?
¿Mi clave API funciona para todos mis establecimientos ?
Sí, un solo token cubre la totalidad de la cuenta. Utiliza el location ID para filtrar los datos por establecimiento.
¿Puedo importar planificaciones o crear empleados a través de la API ?
¿Puedo importar planificaciones o crear empleados a través de la API ?
No. La API no permite la creación de turnos, la publicación de planificaciones ni la creación de fichas de empleados.
¿Cuántos tokens debo solicitar si quiero conectar dos herramientas ?
¿Cuántos tokens debo solicitar si quiero conectar dos herramientas ?
Un token por herramienta.