# 📅 Gestor de Permisos, Vacaciones y Asistencia (Factorial HR & BambooHR API)

> **Resumen para No Técnicos**: Permite que tu Inteligencia Artificial gestione las solicitudes de vacaciones, permisos médicos y ausencias de tus trabajadores desde una aplicación móvil o por chat, calcule cuántos días libres le corresponden por ley a cada quien y mantenga el calendario de turnos del equipo al día sin enredos en hojas de cálculo.

| Metadato | Detalle |
|---|---|
| **Tipo** | API REST Oficial de Gestión de Recursos Humanos y Nómina |
| **Área Empresarial** | 06. Talento, Gestión de Personal y Control de Asistencia |
| **Nivel de Dificultad** | 🟡 Media |
| **Modelo de Costo** | Planes PyME desde $3 a $5 USD por colaborador al mes (Prueba gratuita disponible) |
| **Enlace Oficial** | [Factorial HR Developers](https://factorialhr.es/api) / [BambooHR API](https://documentation.bamboohr.com/docs) |

---

## 💡 ¿Para qué le sirve a tu empresa? (Valor Real)

En muchas pequeñas empresas, los permisos se piden por notas de voz sueltas o papelitos: *"Jefe, me tomo el viernes que viene y me lo descuenta de vacaciones"*. 

A fin de año nadie recuerda si el empleado se tomó 10 o 15 días, lo que genera **discusiones incómodas y reclamos laborales**.

Con **Factorial HR** o **BambooHR**:
- El trabajador solicita sus días libres desde su celular en 10 segundos.
- La IA verifica si otros 3 compañeros del mismo departamento ya pidieron ese mismo día (evitando que la oficina quede vacía).
- El jefe recibe una notificación para aprobar o rechazar con un toque.
- El saldo de días pendientes de ley se descuenta de forma automática y transparente.

---

## 🎁 ¿Qué valor aporta frente a soluciones tradicionales?

- **Cumplimiento de Leyes Laborales Locales**: Aplica las reglas de días de vacaciones según la legislación de cada país (Colombia 15 días hábiles, México 12 días primer año, Chile 15 días, Perú 30 días).
- **Control de Incapacidades Médicas**: Guarda los certificados médicos escaneados en el expediente digital de cada empleado.
- **Reloj Checador Digital**: Permite registrar la hora de entrada y salida con geolocalización o código QR.

---

## 🔑 ¿Qué necesitas para activarlo?

1. Una cuenta activa en Factorial HR o BambooHR.
2. Tu API Key generada en el panel de administrador.

---

## ⚙️ Configuración Paso a Paso

Variables de entorno para tus flujos de automatización:

```env
# Variables de entorno (.env)
FACTORIAL_API_KEY=tu_api_key_factorial
FACTORIAL_COMPANY_ID=12345
PAIS_LEGISLACION_LABORAL=CO # CO, MX, CL, PE, AR
```

---

## 🤖 Consultor Interactivo (Prompt Guiado para tu IA)

Copia y pega este prompt en tu chat con la IA:

```markdown
Actúa como mi Coordinador de Gestión Humana y Asistencia.
Vamos a revisar el estado de permisos, vacaciones y turnos del equipo.

Por favor, pregúntame:
1. ¿Deseas consultar el saldo de vacaciones de un empleado, procesar una nueva solicitud o ver el calendario de ausencias del mes?
2. Si es una solicitud: ¿cuál es el nombre del colaborador, fecha de inicio, fecha de fin y motivo (Vacaciones, Permiso Personal, Incapacidad Médica)?
3. ¿Deseas verificar si hay solapamientos con otros miembros clave del mismo equipo?

Con esa información, consultaré el sistema de RRHH, comprobaré los saldos legales disponibles y te entregaré la recomendación para aprobación de la jefatura.
```

---

## 🌎 Caso de Uso Real en América Latina

**Empresa**: "Distribuidora de Alimentos FríoSur" (Almacén frigorífico en Puerto Montt, Chile).
- **Problema**: En temporada de verano, todos los choferes pedían vacaciones la misma semana, colapsando los despachos hacia los supermercados.
- **Resultado con la API**: La IA organiza el calendario de descansos escalonados con 2 meses de anticipación, asegurando que siempre haya al menos el 70% de la flota operativa. Cero camiones parados por falta de personal.

---

## 🛡️ Consideraciones de Privacidad

- **Expedientes Médicos Confidenciales**: Los diagnósticos e incapacidades médicas son datos personales altamente sensibles. Solo deben tener acceso el área de recursos humanos y la gerencia autorizada.