Requisitos previos :
Plan requerido : People.
Rol requerido : Propietario, Administrador o rol de RR. HH. autorizado. Los directores, managers y empleados no tienen acceso a la gestión de tokens.
Recurso técnico : La API no es una solución lista para usar. Su implementación requiere un desarrollo de tu parte o de un partner referenciado.
¿Qué es la API de Partner Combo?
La API (Application Programming Interface) de 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 a otras herramientas (dashboards, BI, software de nómina, TPV, reclutamiento…).
¿Cómo obtener un acceso a la API?
Combo propone dos caminos según tu situación.
Camino 1 — Conectar un partner referenciado
Accede a Configuración > Integración :
Busca el partner deseado.
Abre su ficha para entender los datos intercambiados.
Genera un token asociado específicamente a ese partner. Se crea un token por partner y por cuenta.
Copia el token y compártelo únicamente con el partner correspondiente.
Revoca el token desde la misma ficha si la conexión ya no es necesaria.
Camino 2 — Crear una clave personalizada
Accede a Configuración > Integración > Acceso API :
Haz clic en Crear una clave.
Nombra la clave para identificar la herramienta o el proyecto asociado.
Utiliza esta clave para un desarrollo interno o una herramienta no referenciada en la Marketplace.
💡 ¿Aún no tienes acceso a la pestaña Acceso API o a los distintos partners en Integración? Esta funcionalidad se está desplegando de forma progresiva. Mientras tanto, contacta con nuestro equipo de soporte, que generará la clave API en tu lugar y te la compartirá directamente.
¿Cómo proteger mis accesos a la API?
Cada token da acceso completo a los datos de tu cuenta. Algunas buenas prácticas permiten limitar los riesgos.
Usa un token distinto para cada herramienta o partner conectado.
No transmitas nunca el mismo token a varios partners diferentes.
Comparte el token únicamente con el partner o el desarrollador directamente implicado.
Revoca el token en cuanto un partner deje de utilizarse o ante cualquier duda.
Utiliza los identificadores de establecimiento (location ID) para limitar o filtrar los datos cuando sea necesario.
⚠️ Un token comprometido da acceso a todos los datos autorizados de tu cuenta. Ante cualquier duda, revócalo inmediatamente desde la ficha del partner o la pestaña Acceso API.
¿A qué datos se puede acceder 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 apellidos del empleado, equipo planificado, etiqueta.
Contratos : ID del empleado, nombre, apellidos, número de seguridad social, fechas de inicio y fin de contrato, jornada laboral semanal, número de días trabajados por semana, tipo de contrato, equipo de referencia, rol, salario mensual bruto o tarifa horaria bruta, e-mail, dirección postal, nacionalidad, puesto de trabajo, estado jornada pactada, motivo de fin de contrato.
Historial de contratos : historial completo de un contrato y sus adendas.
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 de Partner Combo. Puede calcularse a partir de los datos de salario bruto transmitidos.
¿A qué datos se puede acceder en escritura (POST)?
Los siguientes datos pueden enviarse hacia Combo desde tu herramienta :
Facturación : envío de la facturación previsional y real al informe de análisis de Combo — útil si tu software de TPV no está integrado de forma nativa. El location ID (identificador del establecimiento) es obligatorio en 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 de Partner Combo no permite crear turnos, publicar planificaciones ni crear o modificar fichas de empleados.
¿Por qué la API Combo no permite ciertas acciones?
La API de Partner Combo es una API principalmente en 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 a través de exportaciones dedicadas, distintas de la API de Partner.
¿Cómo conectar un software de TPV para enviar la facturación?
Combo propone integraciones nativas con los principales TPV del mercado, gratuitas y reservadas a los Admins.
Accede a Configuración > Integración > Caja :
Haz clic en la tarjeta de tu software de TPV.
Autentícate según el método propio de cada TPV (ver a continuación).
Asocia cada TPV al establecimiento 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 conectado el TPV, la facturación neta sube automáticamente cada noche entre las 3:30 y las 4:30 (según el huso horario de la cuenta), siempre que los TPV estén correctamente cerrados.
💡
Si tu software de TPV no aparece en la lista, utiliza la API de Partner (solicitud
POSTcon el location ID) para enviar la facturación manualmente.La integración de TPV solo transfiere la facturación — no envía ningún otro dato hacia Combo.
FAQ
¿Mi clave API funciona para todos mis establecimientos?
¿Mi clave API funciona para todos mis establecimientos?
Sí, un único token cubre toda la cuenta. Usa 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 de Partner Combo es principalmente en lectura. La creación de turnos, la publicación de planificaciones y la creación de fichas de empleados no son posibles a través de la API.
¿Cuántos tokens debo solicitar si quiero conectar dos herramientas?
¿Cuántos tokens debo solicitar si quiero conectar dos herramientas?
Un token por herramienta o partner. No compartas nunca el mismo token entre dos partners diferentes — eso haría imposible cualquier revocación selectiva.
¿Qué ocurre si revoco un token por error?
¿Qué ocurre si revoco un token por error?
La herramienta conectada pierde inmediatamente el acceso a los datos de Combo. Genera un nuevo token desde la ficha del partner o la pestaña Acceso API y compártelo con tu partner para restablecer la conexión.