Candidatos propuestos

Desde el panel de la empresa, el company_user ve los candidatos que el equipo HUMAE ha asignado y presentado a sus vacantes. No accede al directorio completo — solo ve a quienes HUMAE seleccionó.

URL y acceso

URL: /me/empresa/vacantes/{id} → tab "Candidatos". Quién: miembros de la Company (owner por ahora; manager/viewer pospuestos).

Qué ve la empresa

Para una vacante dada, se listan los VacancyAssignment cuya stage sea:

• presented
• interviewing
• finalist
• hired (histórico de esa vacante)

No ve:

• sourced — aún no presentados por el recruiter.
• rejected / withdrawn por otra razón.

Los company_notes SÍ, las recruiter_notes NO.

Vista de lista

┌──────────────────────────────────────────────────┐
│  👤 Ana Pérez                      Presented    │
│  Backend Engineer Senior                         │
│  CDMX · 8 años · $60K-$70K                      │
│  🏷️ React  Node  AWS                             │
│  [Ver detalle]  [Solicitar entrevista]          │
├──────────────────────────────────────────────────┤
│  👤 Luis Díaz                    Interviewing   │
│  Backend Engineer                                │
│  Mty · 5 años · $45K-$55K                       │
│  📅 Entrevista jueves 24 abril 10:00             │
│  [Ver detalle]                                   │
└──────────────────────────────────────────────────┘

Vista de detalle

GET /api/v1/vacancies/{vid}/assignments/{aid} (visible si company_user pertenece a la vacancy).

Muestra:

• Datos del candidato (sin datos de contacto PII):
  • Nombre, foto, headline, ubicación, años de experiencia.
  • Skills, idiomas, educación, experiencias.
  • Score psicométrico por dimensión.
  • CV descargable en PDF (link firmado).
• Notas de la empresa (company_notes + histórico en VacancyAssignmentNote).
• Entrevistas asociadas (estado, fecha).
• Botones de acción según etapa.

Acciones disponibles

Añadir nota

Endpoint: POST /vacancies/{vid}/assignments/{aid}/notesBody: {"body": "Buen fit técnico pero pregunté sobre X, revisar"}

Las notas con visibilidad company son visibles al recruiter también, pero no a otras empresas ni a candidatos.

Solicitar entrevista

Endpoint: POST /vacancies/{vid}/assignments/{aid}/request-interviewBody:

{
  "preferred_dates": ["2026-04-22T10:00:00-06:00", "2026-04-22T15:00:00-06:00"],
  "mode": "online",
  "notes": "Preferimos Google Meet"
}

• No agenda la entrevista directamente — notifica al recruiter para que él coordine.
• El recruiter recibe un email + in-app notification con la solicitud.
• Después el recruiter agenda usando ScheduleInterviewDialog.

Confirmar entrevista

Cuando la entrevista ya está agendada, el company_user puede confirmar:

Endpoint: POST /api/v1/interviews/{id}/confirm

• Igual que el flujo del candidato.
• Notifica al candidato + al recruiter.

Dar feedback

Endpoint: POST /api/v1/vacancies/{vid}/assignments/{aid}/company-feedbackBody:

{
  "feedback": "Muy profesional, excelente comunicación. Proceder.",
  "rating": 5
}

Se guarda en la asignación y aparece en el timeline.

Avanzar o rechazar

No directamente. El company_user no mueve estados del pipeline — solo le pide al recruiter que lo haga (vía nota o mensaje). El recruiter HUMAE decide la transición formal.

Fase 2: se puede dar botones de "recomendar avanzar" / "rechazar" que el recruiter recibe como acción sugerida.

Filtros

En el listado de candidatos de una vacante:

• Por stage: presented, interviewing, finalist, hired.
• Por rating que dio la empresa.
• Por orden: más recientes, prioridad, por presentación.

Descargar CV

Endpoint: GET /api/v1/vacancies/{vid}/assignments/{aid}/candidate-cv.pdf

• Valida que la empresa dueña del vacancy sea la del user.
• Devuelve el mismo PDF que el candidato vería, pero sin teléfono y email del candidato.

Exportar candidatos a CSV

Endpoint: GET /api/v1/vacancies/{vid}/assignments/export?format=csv

• Solo para owners/managers.
• Genera CSV con: nombre, email enmascarado, ubicación, años de experiencia, stage, fecha de presentación.
• Útil para pipeline reporting interno de la empresa.

Notificaciones que recibe company_user

Evento	Canal
Candidato presentado	Email + in-app
Entrevista agendada	Email + in-app
Candidato confirmó entrevista	Email + in-app
Entrevista reprogramada o cancelada	Email + in-app
Candidato marcado como finalista	Email + in-app
Recruiter responde a nota	In-app
Candidato se retira	In-app

Privacidad del candidato

• La empresa no ve el email o teléfono del candidato hasta que el recruiter le pase el contacto (después de confirmar entrevista).
• La empresa no ve las respuestas a preguntas psicométricas, solo el score agregado.
• La empresa no ve documentos subidos por el candidato al panel interno (CV generado sí; documentos adicionales no).

Siguiente

Detalle del sub-flujo de confirmación: Confirmar entrevistas →