Reglas de Validacion

Las reglas de validacion controlan cuando se puede cambiar el estado de una postulacion, asegurando que se cumplan ciertos requisitos antes de avanzar en el proceso.

Que son las reglas de validacion

Las reglas definen condiciones que deben cumplirse para cambiar el estado de un candidato. Por ejemplo:

• No marcar como "Entrevistando" sin prueba tecnica completada
• No marcar como "Oferta" sin entrevista realizada
• No marcar como "Contratado" sin documentos completos

Acceder al editor de reglas

1. Ve a la vacante
2. Haz clic en "Configurar"
3. Navega al paso de "Reglas de Validacion"
4. O desde el menu → "Reglas"

Nota: Esta funcionalidad requiere el feature "automation" en tu plan.

Anatomia de una regla

Cada regla tiene:

Nombre

Identificador descriptivo de la regla.

Ejemplo: "Requiere prueba tecnica para entrevista"

Descripcion

Explicacion detallada de lo que valida.

Tipo de disparador

Cuando se evalua la regla:

Estado disparador

El estado especifico (si aplica al tipo de disparador).

Tipo de condicion

Que se verifica (ver seccion siguiente).

Configuracion de condicion

Parametros especificos de la condicion.

Mensaje de error

Texto mostrado cuando la validacion falla.

Prioridad

Orden de evaluacion (menor numero = mayor prioridad).

Bloqueo duro vs suave

• Bloqueo duro: Impide el cambio de estado Y el movimiento en el tablero
• Bloqueo suave: Impide cambio de estado pero permite movimiento

Tipos de condiciones

1. Prueba por tipo completada

Codigo: test_by_type

Requiere pruebas completadas de un tipo especifico.

Configuracion:

• testType: Tipo de prueba (cognitiva, personalidad, etc.)
• minCount: Cantidad minima de pruebas
• requirePassing: Requiere que haya pasado
• passingScoreThreshold: Porcentaje minimo para pasar

Ejemplo:

• Condicion: test_by_type
• testType: quiz
• minCount: 1
• requirePassing: true
• passingScoreThreshold: 70

2. Evento asistido

Codigo: event_attended

Requiere asistencia a eventos (entrevistas, reuniones).

Configuracion:

• eventType: Tipo de evento (interview, meeting, call, assessment)
• requiredStatus: Estado del evento (confirmed, completed)
• minCount: Cantidad minima

Ejemplo:

• Condicion: event_attended
• eventType: interview
• requiredStatus: completed
• minCount: 1

3. Documentos completados

Codigo: document_request_completed

Requiere que todas las solicitudes de documentos esten completas.

Configuracion: Ninguna (valida todos los documentos pendientes).

Uso: Antes de marcar como contratado, asegurar que entrego todos los documentos.

4. Score de compatibilidad IA

Codigo: ai_compatibility_score

Requiere un puntaje minimo en el analisis de IA.

Configuracion:

• minScore: Puntaje minimo (0-10)

Ejemplo:

• Condicion: ai_compatibility_score
• minScore: 6

5. Score de match de habilidades

Codigo: skill_match_score

Requiere un porcentaje minimo de compatibilidad de habilidades.

Configuracion:

• minScore: Porcentaje minimo (0-100)

Ejemplo:

• Condicion: skill_match_score
• minScore: 70

6. CV/Resume cargado

Codigo: resume_uploaded

Requiere que el candidato tenga CV.

Configuracion:

• checkUserProfile: Verificar tambien en perfil del usuario

7. Procesos completados

Codigo: min_processes_completed

Requiere completar X procesos (llegar a etapa final).

Configuracion:

• minCount: Cantidad de procesos
• sameProject: Solo contar procesos del mismo proyecto

8. Etapas finales alcanzadas

Codigo: min_final_steps_completed

Requiere llegar a etapa final X veces.

Configuracion:

• minCount: Cantidad de veces
• sameProject: Solo contar del mismo proyecto

Crear una regla

1. Haz clic en "Nueva Regla"
2. Completa el formulario:
   • Nombre: Requiere entrevista para oferta
   • Descripcion: El candidato debe tener al menos una entrevista completada
   • Disparador: Al cambiar A
   • Estado: offered
   • Condicion: event_attended
   • Tipo evento: interview
   • Estado evento: completed
   • Cantidad minima: 1
   • Mensaje de error: El candidato debe completar al menos una entrevista antes de recibir oferta
   • Prioridad: 1
   • Bloqueo: Duro
3. Haz clic en "Guardar"

Editar regla

1. En la lista de reglas, haz clic en la regla
2. Modifica los campos necesarios
3. Haz clic en "Guardar"

Activar/Desactivar regla

1. En la lista de reglas
2. Usa el toggle de activacion
3. Las reglas desactivadas no se evaluan

Eliminar regla

1. Haz clic en el icono de eliminar
2. Confirma la accion
3. La regla se elimina permanentemente

Orden de evaluacion

1. Las reglas se evaluan en orden de prioridad (menor numero primero)
2. Se evaluan todas las reglas aplicables al cambio
3. Si alguna falla, se muestra el error de la primera que fallo
4. Se retornan todas las reglas fallidas para referencia

Respuesta de validacion fallida

Cuando una regla bloquea el cambio:

{
  "message": "El candidato debe completar la prueba tecnica",
  "code": "VALIDATION_RULES_FAILED",
  "failedRules": [
    {
      "ruleId": 1,
      "ruleName": "Requiere prueba tecnica",
      "conditionType": "test_by_type",
      "message": "Debe completar al menos 1 prueba tipo quiz",
      "details": {
        "required": 1,
        "completed": 0,
        "testType": "quiz"
      }
    }
  ]
}

Ejemplos de configuracion

Pipeline basico

Regla 1: CV requerido para revision

• Disparador: Al cambiar A → reviewing
• Condicion: resume_uploaded
• Bloqueo: Duro

Regla 2: Prueba para entrevista

• Disparador: Al cambiar A → interviewing
• Condicion: test_by_type (quiz, 1, passing)
• Bloqueo: Duro

Regla 3: Entrevista para oferta

• Disparador: Al cambiar A → offered
• Condicion: event_attended (interview, completed, 1)
• Bloqueo: Duro

Regla 4: Documentos para contratar

• Disparador: Al cambiar A → hired
• Condicion: document_request_completed
• Bloqueo: Duro

Pipeline con IA

Regla 1: Match minimo para revision

• Disparador: Al cambiar A → reviewing
• Condicion: skill_match_score (minScore: 50)
• Bloqueo: Suave

Regla 2: Analisis IA para shortlist

• Disparador: Al cambiar A → shortlisted
• Condicion: ai_compatibility_score (minScore: 6)
• Bloqueo: Duro

Mejores practicas

Reglas progresivas

Configura reglas que se vuelven mas estrictas conforme avanza el proceso:

1. Revision: CV + match basico
2. Entrevista: Prueba completada
3. Oferta: Entrevista completada
4. Contratado: Documentos completos

Mensajes claros

Usa mensajes de error que indiquen:

• Que falta
• Como cumplir el requisito
• Quien puede ayudar

No sobre-validar

Demasiadas reglas:

• Ralentizan el proceso
• Frustran a reclutadores
• Pueden tener conflictos

Probar antes de activar

1. Crea la regla desactivada
2. Usa "Vista previa" para probar
3. Activa cuando estes seguro

Problemas comunes

"No puedo cambiar el estado"

Causa: Una regla esta bloqueando el cambio.

Solucion:

• Revisa el mensaje de error
• Cumple el requisito indicado
• O desactiva temporalmente la regla

"La regla no se evalua"

Causas:

• La regla esta desactivada
• El disparador no coincide con el cambio
• El estado configurado es diferente

Solucion: Verifica configuracion de disparador y estado.

"Quiero permitir excepciones"

Opcion 1: Usa bloqueo suave (permite movimiento manual) Opcion 2: Desactiva temporalmente la regla Opcion 3: Agrega el admin como excepcion (no disponible actualmente)