CAPITALHUMANO IA PRO · MANUAL CORPORATIVO DE INTEGRACIÓN 2026

MANUAL DE INTEGRACIÓN

Documentación Técnica Avanzada de Procesos de IA, Nóminas STPS, Onboarding y Bóveda de Secretos

01. INTRODUCCIÓN GENERAL DEL ECOSISTEMA

CapitalHumano IA Pro es la solución definitiva de nivel corporativo para la adquisición y retención inteligente de talento. El sistema integra algoritmos predictivos, RAG (Generación Aumentada de Recuperación) y procesamiento de voz e imagen nativa para automatizar flujos complejos de RRHH y nóminas, logrando un **retorno de inversión (ROI) del 320%** en reducción de OpEx en los primeros 6 meses.

En un ecosistema B2B, la velocidad y la asertividad cultural son determinantes. Por ello, la plataforma trabaja en sinergia con modelos LLM avanzados como Gemini 2.5 Flash-Lite, permitiendo procesar cientos de currículums, estructurar entrevistas de audio de forma autónoma y proyectar nóminas sin cuellos de botella humanos.

10x
Ahorro de Tiempo
320%
ROI Financiero
94%
Match Accuracy
90d
Digital Twin

02. ANALYTICS Y DASHBOARD RESILIENTE

El Dashboard Central es el cerebro estadístico de la plataforma. Integra el mecanismo Anti-Zero KPIs Merger, lo que significa que el panel siempre se muestra poblado y operativo de forma resiliente, recurriendo a un pool de datos mock de alta fidelidad si la conexión a base de datos se interrumpe temporalmente.

Vacantes Cobertas
45 / 50
Tiempo de Cobertura
12.5 días
-4.2 días vs promedio industria
Culture Fit Promedio
87.4%
Plantilla alineada al ADN

Mecanismo Anti-Zero Merger

Implementado en analyticsService.ts. En caso de fallas de RLS, tablas vacías o desconexión en el proyecto Supabase, el sistema intercepta las peticiones y realiza un merge dinámico de los campos nulos con el pool de datos demo para evitar vistas en 0 o pantallas blancas de error.

03. PIPELINE DE RECLUTAMIENTO Y SOURCING IA

El pipeline automatiza el proceso desde la requisición inicial del puesto hasta el primer filtro conversacional. Integra un escáner multimodal OCR para procesar expedientes impresos o CVs y un módulo RAG (Talent Rediscovery) que mapea candidatos pasivos de base de datos para nuevas posiciones.

Diagrama 1: Flujo del Candidato y Sourcing IA
1. SOURCING IA CV Upload / LinkedIn 2. OCR & MATCH Match Score 0-100 3. CHAT SCREEN Conversacional Automatizado 4. EVALUACIONES Voz IA + SkillForge 5. HIRED Digital Twin
💡 Haz clic en cualquier nodo para ver los detalles técnicos del proceso.

04. ENTREVISTADOR IA POR VOZ NATIVA

Gemini 2.5 Live voice technology

El Entrevistador IA es un agente conversacional interactivo por voz y texto que evalúa candidatos en tiempo real. Enlaza con Edge Functions en Supabase para transcribir y analizar el audio del micrófono de forma nativa. Produce una rúbrica de idoneidad y detecta competencias complejas al instante.

Diagrama 2: Motor de Entrevista y Transcripción
A. INICIAR SESIÓN Perfil de Puesto B. AUDIO STREAMING Gemini 2.5 Live Link C. TRANSCRIPCIÓN Speech-to-Text D. RÚBRICA Y SCORE Competencias Detectadas

Guía Automatizada de Preguntas

Al enlazar una vacante, la IA extrae los requisitos obligatorios de puesto para estructurar una rúbrica en base al framework de entrevista por competencias (Star method). Esto elimina la discrepancia y el sesgo del entrevistador humano.

Rúbrica Exportable en PDF

Al finalizar la sesión, se compila un reporte consolidado con scores del 1 al 10 en base a competencias técnicas y soft-skills. Cuenta con un motor de PDF integrado para su descarga directa.

05. SKILLFORGE Y PRUEBAS PSICOMÉTRICAS

Aplica pruebas científicas y de competencias técnicas al instante sin pagar licenciamientos externos. El módulo de Evaluaciones Psicométricas integra test estructurados como DISC y Cleaver, y los califica en base a patrones arquetípicos de comportamiento analizados con IA.

SkillForge es el motor de exámenes técnicos personalizables. Permite crear reactivos complejos, pruebas de programación de código y tests matemáticos, y los corrige al vuelo con explicaciones detalladas para el reclutador.

Pruebas DISC y Cleaver

Identifica perfiles de comportamiento dominantes (Decisión, Influencia, Constancia y Apego). La IA correlaciona el resultado con el rol ideal del puesto para garantizar afinidad operativa.

Automatización de SkillForge

Crea bancos de preguntas usando plantillas o pidiendo soporte a Gemini 2.5 para redactar preguntas de código, comprensión de lectura o matemáticas. Los candidatos responden en un portal interactivo cronometrado.

06. LINKS PÚBLICOS DE APLICACIÓN

Diseñado para la máxima conversión de candidatos. Los reclutadores pueden despachar Links Públicos de Entrevista que expiran de forma automática según la configuración del puesto (24h, 48h, 7 días). El candidato ingresa al portal interactivo sin necesidad de credenciales ni inicio de sesión.

Los flujos están optimizados para dispositivos móviles. Al abrir el link, el candidato completa sus datos, sube su CV (con OCR automático en backend), responde a las preguntas predefinidas y realiza el screening de voz de forma guiada en menos de 10 minutos.

07. DNA CULTURAL Y CULTURE FIT SCORE

El DNA Cultural Score mide la alineación valórica de cada candidato con la cultura organizacional de tu empresa en una escala del 0 al 100. Funciona convirtiendo los valores corporativos y respuestas conductuales del candidato en vectores numéricos comparables semánticamente.

Dimensiones del ADN Organizacional

Orientación a Resultados 92% Match
Colaboración y Equipo 85% Match
Innovación y Aprendizaje 78% Match
CULTURE FIT SCORE
85
APTO PARA CONTRATAR

08. MOTOR DE PREDICCIÓN DE RENUNCIA (RETENCIÓN)

El motor predictivo opera analizando continuamente señales conductuales e interacciones de cada colaborador, asignándoles un Índice de Riesgo de Rotación de 0 a 100. Esto permite a RRHH detectar descontento o desinterés de forma preventiva para ejecutar planes de contención.

Métricas de Alerta

  • ▸ Faltas Recurrentes: Caída repentina de asistencia perfecta.
  • ▸ Antigüedad en Rol: Más de 18 meses sin ajuste o promoción.
  • ▸ Desempeño: Baja constante en la OEE individual.
  • ▸ Feedback: Sentimiento negativo analizado en minutas.

Protocolo de Intervención

Al detectar un score superior a 70, la plataforma emite una alerta directa a RRHH detallando el caso y sugiriendo una **Reunión de Stay Interview** asíncrona, notificando automáticamente al jefe de área con recomendaciones de RAG.

09. TALENT MARKETPLACE INTERNO

El Talent Marketplace impulsa la movilidad interna y la retención del personal actual. Los empleados activos pueden ver vacantes internas que se adecúan a su perfil según el recomendador de IA, y postularse en un clic de manera confidencial sin salir de la plataforma.

Este flujo mitiga la rotación de talento al ofrecer planes de carrera transparentes y visibles, permitiendo cubrir puestos estratégicos de forma inmediata con colaboradores que ya dominan la cultura de la empresa.

10. ONBOARDING DIGITAL TWIN 90 DÍAS

La representación digital del proceso de Onboarding de cada colaborador monitorea de extremo a extremo la integración en los primeros 90 días, asegurando que se cumplan las etapas críticas para evitar la deserción temprana.

Diagrama 3: Pipeline de Onboarding de 90 Días
SEM 1: BIENVENIDA Altas, EPP, Firmas DÍAS 8-30: ADAPTACIÓN Universidad & Shadowing DÍAS 31-60: PROD. OEE Individual, OKRs DÍAS 61-90: CIERRE Evaluación 360°

11. EXPEDIENTES, CONTRATOS Y LIQUIDACIONES

El panel administrativo de recursos humanos centraliza la gestión del expediente digital. El **Generador de Contratos Inteligente** emplea IA para redactar cláusulas a la medida en base al rol y la ley federal del trabajo, generando PDFs listos para firma en segundos.

El módulo de Finiquitos y Liquidaciones permite registrar terminaciones de forma legal. Realiza cálculos exactos para separaciones proporcionales de aguinaldo, prima vacacional, prima de antigüedad e indemnización de 90 días por despido, garantizando absoluta transparencia financiera.

12. CÁLCULO DE NÓMINA E IMPUESTOS MX 2026

El motor de nómina de CapitalHumano IA Pro calcula con precisión centesimal los sueldos netos en base a las retenciones del SAT e IMSS vigentes para el ejercicio 2026. Cumple con la normativa STPS y genera timbrados CFDI 4.0.

Diagrama 4: Arquitectura del Motor de Cálculo de Nómina
SUELDO BRUTO Sueldo Base + OT + Bonos (-) ISR RETENIDO Tablas Art. 96 SAT (-) CUOTA IMSS Enfermedad, Vida, Retiro SUELDO NETO Monto a Dispersar TIMBRADO CFDI 4.0 XML & PDF Autorizado

Ecuaciones y Modelado de Nómina

// Salario Bruto Total del Periodo
Salario_Bruto = (Salario_Diario × Días_Trabajados) + (Horas_Extra_Dobles × Valor_Hora × 2) + (Horas_Extra_Triples × Valor_Hora × 3) + Bono_Productividad_OEE
// Deducción de ISR Retenido
Base_ISR = Salario_Bruto - Ingresos_Exentos_SAT
ISR_Mensual = Cuota_Fija + ((Base_Mensualizada - Límite_Inferior) × Tasa_Excedente_Porcentaje) - Subsidio_Empleo
// Deducción IMSS Cuota Obrera (LSS 2026)
Salario_Mensual = Salario_Diario × 30
IV_CV = Salario_Mensual × 0.01750  // IV 0.625% + CV 1.125% — sobre salario completo
EM = Max(0, Salario_Mensual − UMA × 30.4 × 3) × 0.004  // 0.40% solo sobre excedente de 3 UMAs
IMSS_Periodo = ((IV_CV + EM) / 30) × Días_Periodo

13. CONTROL Y AUDITORÍA DE TOKENS IA (ROI)

Para asegurar una total rentabilidad y cumplimiento del ROI de Agus Pro, la plataforma integra un panel central de Control de Tokens. Registra y visualiza en tiempo real el consumo por cada tenant y usuario, comparando la inversión acumulada contra un límite presupuestal mensual fijo de $300 USD.

Toda transacción de inferencia de IA (Gemini 2.5 Flash-Lite, deepseek, opencode o together AI) registra asíncronamente en la tabla de Supabase ai_token_usage el conteo de tokens de prompt, tokens de completion, el modelo y el costo estimado en dólares, proporcionando un control financiero absoluto.

14. BÓVEDA DE SECRETOS Y API INTEGRATION (ZERO HARDCODING)

Bajo el estándar de **Zero Hardcoding**, la plataforma prohíbe la presencia de claves privadas o marcas en código fuente. Las credenciales de APIs críticas se resguardan cifradas en Supabase y son cargadas dinámicamente según el contexto de tenant.

Selector de Proveedor de IA

Configurable directamente en la sección de Ajustes. Permite al Administrador alternar entre Gemini 2.5, Deepseek, Together AI u OpenCode para la inferencia de RAG y parsing de CVs sin tocar código.

select_api_provider()

Integración de Whatsapp Cloud API

Permite despachar recordatorios de entrevistas online de forma automática a los candidatos y alertas de asistencia al manager usando plantillas oficiales.

whatsapp_cloud_api

15. NOM-035-STPS-2018 — GUÍA III

Evaluación de factores de riesgo psicosocial · Obligatoria para empresas con 50+ trabajadores

Flujo de aplicación

1. Crear enlace

Admin ingresa nombre, puesto y área del empleado. El sistema genera un UUID único válido por 30 días.

NOM-035 Dashboard → Crear enlace

2. Enviar al empleado

Copia el link y compártelo por WhatsApp, email o Slack. El empleado no necesita cuenta ni contraseña.

/nom035/[token]

3. Responder (72 preguntas)

Cuestionario Guía III oficial DOF. Sección a sección, escala Siempre–Nunca. Preguntas condicionales para supervisores y quienes atienden clientes.

~12 secciones · ~10 min

4. Resultados automáticos

Calificación por dominio con niveles oficiales. Token marcado como completado. Visible en el dashboard de administrador.

nom035_evaluaciones → Dashboard

Escala de respuesta oficial

4

Siempre

3

Casi siempre

2

Algunas veces

1

Casi nunca

0

Nunca

⚠️ Ítems inversos: algunas preguntas miden condiciones positivas (ej. "Puedo decidir cuánto trabajo hago"). Su puntaje se invierte: score = 4 − valor_raw antes de sumar al dominio.

11 Dominios evaluados

🏭 Ambiente de trabajo (Q1–5)

Condiciones físicas, herramientas, iluminación, seguridad del espacio.

⏱️ Carga de trabajo (Q6–16)

Sobrecarga cuantitativa, presión de tiempo, ritmo e intensidad.

🕐 Jornada de trabajo (Q17–18)

Horas extra, tiempos de descanso y recuperación.

🏠 Interfaz trabajo-familia (Q19–22)

Balance vida personal vs. laboral, impacto en familia.

🎛️ Control del trabajo (Q23–30)

Autonomía, participación en decisiones, uso y desarrollo de habilidades.

👔 Liderazgo (Q31–41)

Relación con jefe directo, claridad de instrucciones, trato.

🤝 Relaciones en el trabajo (Q42–46)

Apoyo de compañeros, colaboración, trabajo en equipo.

🏢 Entorno organizacional (Q47–56)

Cultura, reconocimiento, sentido de pertenencia, comunicación.

🚨 Violencia laboral (Q57–64)

Acoso, hostigamiento, discriminación, intimidación.

👥 Atención a clientes (Q65–68) condicional

Solo para empleados que brindan servicio directo al cliente.

👑 Supervisión (Q69–72) condicional

Solo para jefes, supervisores y líderes de equipo.

Niveles de riesgo oficiales

NULO

Sin acciones requeridas

BAJO

Acciones de mejora recomendadas

MEDIO

Programa de intervención en 3 meses

ALTO

Intervención inmediata

MUY ALTO

Revisión urgente + STPS

El riesgo general de la empresa = el nivel más alto entre todos los dominios evaluados.

NOM-035 vs. Encuesta de Bienestar / Clima

Aspecto NOM-035 Guía III Encuesta Bienestar / Clima
Objetivo Cumplimiento legal STPS Satisfacción subjetiva del empleado
Preguntas 72 fijas (DOF 2018) Personalizables por empresa
Obligatorio Sí — 50+ trabajadores No (buena práctica)
Consecuencia Evidencia ante auditoría STPS Insight interno / mejora continua
Periodicidad Mínimo cada 2 años A discreción del admin
Acceso empleado Solo por token público Token público o login

Obligaciones legales (NOM-035-STPS-2018)

  • Aplicar Guía III a todos los trabajadores de centros con 50+ empleados.
  • Reaplicar cada vez que existan cambios significativos en procesos o condiciones de trabajo.
  • Identificar y analizar los factores de riesgo de los trabajadores que tuvieron acontecimientos traumáticos severos.
  • Establecer y difundir una Política de Prevención de riesgos psicosociales.
  • Conservar registros mínimo 1 año (para empresas de 50–100 trabajadores) o 3 años (100+ trabajadores).

16. PANEL DE INVESTIGACIONES

Integración con BuhoLegal · Antecedentes · CURP · SAT · Cédulas · Monitoreo

El Panel de Investigaciones unifica la investigación de antecedentes de candidatos en un solo flujo. Integra la API de BuhoLegal para consultar bases de datos oficiales mexicanas y genera un reporte PDF profesional con el branding del tenant.

Búsqueda de Antecedentes

Consulta por nombre o CURP en el sistema judicial mexicano. Obtiene causas penales, sentencias y su situación actual.

Validación CURP

Valida CURP contra RENAPO. Verifica autenticidad, estatus y datos asociados del candidato.

Listas Negras SAT

Consulta de 69 matrices de riesgo fiscal: 69B, 69, factureras, EFOS, EDOS, cancelados y más.

Cédulas Profesionales

Verifica cédulas profesionales de la SEP por nombre o CURP. Confirmación de validez y nivel de estudios.

Edictos DOF

Consulta de personas físicas y morales en edictos del Diario Oficial de la Federación.

Monitoreo de Expedientes

Suscribe expedientes judiciales para monitoreo automático. Recibe alertas cuando hay movimientos o actualizaciones.

Reporte PDF Profesional

Al finalizar la investigación, el sistema compila un reporte PDF con:

  • Header y footer con logo y branding del tenant
  • Resumen ejecutivo con nivel de riesgo general (verde/amarillo/rojo)
  • Tabla detallada de fuentes consultadas con resultados
  • Recomendaciones automáticas basadas en hallazgos

17. PRUEBAS PSICOMÉTRICAS AVANZADAS

DISC · Cleaver · Big Five · Reportes PDF automáticos

El módulo de Pruebas Psicométricas permite aplicar evaluaciones de personalidad científicas directamente desde la plataforma, sin necesidad de licenciamientos externos ni integraciones de terceros. Cada evaluación se califica automáticamente con IA y genera un reporte PDF profesional.

DISC

Evalúa cuatro dimensiones conductuales: Dominio, Influencia, Estabilidad y Cumplimiento. Ideal para roles de liderazgo y ventas.

Cleaver

Identifica estilos de comportamiento y motivaciones internas del candidato. Recomendado para puestos operativos y de servicio.

Big Five

Evalúa apertura, responsabilidad, extraversión, amabilidad y neuroticismo. El estándar académico para profiling de personalidad.

Automatización Inteligente

  • Asignación automática de prueba según el perfil del puesto
  • Corrección y calificación instantánea con IA
  • Recomendación de idoneidad basada en patrones arquetípicos
  • Historial de evaluaciones por candidato

Reporte PDF Profesional

  • Perfil gráfico con puntuaciones por dimensión
  • Descripción detallada del perfil conductual
  • Comparativa vs perfil ideal del puesto
  • Recomendaciones de onboarding y gestión