Skip to main content

​
Preview de Impacto

El Preview de Impacto es una característica que te permite ver exactamente cuántos slots de citas se bloquearán con un cierre ANTES de crearlo. Esto te ayuda a tomar decisiones informadas y evitar bloquear disponibilidad por error.
Feature destacada (2026-01-03): Esta funcionalidad fue agregada recientemente para mejorar la planificación y reducir errores al crear cierres.

​
¿Qué Muestra el Preview?

El preview calcula y muestra en tiempo real:
MétricaDescripción
Slots normalesTotal de slots disponibles en el período (SIN el cierre)
Slots bloqueadosSlots que se bloquearán CON el cierre
% de impacto(slots bloqueados / slots normales) × 100
Nivel de impactoHIGH (100%), MEDIUM (50-99%), LOW (<50%)
Email notificationSí ✅ si impacto HIGH, No ❌ si MEDIUM/LOW

​
Niveles de Impacto

HIGH (100%)

Todos los slots bloqueadosSignifica que NINGÚN paciente podrá agendar citas en ese período.Acciones sugeridas:
  • Verificar fechas son correctas
  • Considerar notificar manualmente a clientes
  • Evaluar si es necesario dividir el cierre
Email: Sí ✅ (automático)

MEDIUM (50-99%)

Mayoría de slots bloqueadosLa mayoría de citas se bloquearán, pero algunos slots siguen disponibles (otros proveedores).Acciones sugeridas:
  • Validar que otros proveedores cubren demanda
  • Considerar ajustar fechas si es muy alto (>90%)
Email: No ❌

LOW (<50%)

Impacto mínimoMenos de la mitad de slots se bloquean. Disponibilidad parcial garantizada.Acciones sugeridas:
  • Safe to proceed
  • No requiere acciones adicionales
Email: No ❌

​
Cómo Usar el Preview

1

Completar formulario de cierre

Antes de hacer preview, completa:
  • Tipo de cierre (clinic-wide o provider-specific)
  • Proveedor (si es provider-specific)
  • Fecha y hora de inicio
  • Fecha y hora de fin
  • Razón (opcional)
El preview requiere al menos las fechas (inicio/fin) para calcular. El tipo y proveedor afectan el resultado.
2

Click en 'Preview Impacto'

En el formulario de cierre, haz click en el botón “Preview Impacto”.El sistema ejecutará en tiempo real:
  1. Llamada a API: POST /v1/closures/impact-preview
  2. Cálculo de disponibilidad normal (sin el cierre)
  3. Simulación del cierre propuesto
  4. Comparación de slots (antes vs después)
  5. Cálculo de nivel de impacto
3

Revisar resultados

El sistema mostrará una tabla con detalles del impacto:Información general:
  • Período: 2026-08-01 a 2026-08-15 (15 días)
  • Tipo: Cierre de clínica (clinic-wide)
  • Proveedor: Todos
Métricas de impacto:
  • Slots normales: 300 slots
  • Slots bloqueados: 300 slots
  • % de impacto: 100%
  • Nivel: HIGH
  • Email notification: Sí ✅
Desglose por día (opcional):
FechaSlots normalesSlots bloqueados% Impacto
2026-08-012020100%
2026-08-022020100%
…………
2026-08-152020100%
4

Interpretar resultados

Usa la siguiente guía para interpretar:Si nivel es HIGH (100%):
  • ⚠️ Reconsiderar: ¿Las fechas son correctas?
  • ⚠️ Notificar: ¿Debo avisar manualmente a clientes?
  • ⚠️ Alternativas: ¿Puedo dividir el cierre en períodos más pequeños?
Si nivel es MEDIUM (50-99%):
  • ✅ Validar: ¿Otros proveedores cubren la demanda?
  • ✅ Ajustar: ¿Puedo cambiar fechas para reducir impacto?
Si nivel es LOW (<50%):
  • ✅ Safe to proceed: Impacto mínimo, puedes crear el cierre sin preocupaciones
5

Decidir acción

Basándote en los resultados, decide:Opción A: Crear el cierre (si impacto es aceptable)
  • Click en “Crear Cierre”
  • El sistema procederá con la creación
Opción B: Ajustar fechas (si impacto es muy alto)
  • Modifica inicio/fin en el formulario
  • Ejecuta preview nuevamente
  • Repite hasta encontrar impacto aceptable
Opción C: Cancelar (si el cierre no es necesario)
  • Click en “Cancelar”
  • No se crea el cierre

​
Ejemplos de Preview

Configuración propuesta:
  • Tipo: Cierre de clínica
  • Inicio: 2026-08-01 00:00
  • Fin: 2026-08-15 23:59
  • Razón: “Vacaciones de verano”
Resultado del Preview:
Período: 2026-08-01 a 2026-08-15 (15 días)
Tipo: Clinic-wide (toda la clínica)

Slots normales: 300 slots
  - 20 slots/día × 15 días
  - 3 proveedores × 20 slots/proveedor/día ÷ 3

Slots bloqueados: 300 slots (100%)

Nivel de impacto: HIGH
Email notification: Sí ✅
Interpretación:
  • ⚠️ Impacto HIGH: TODOS los slots bloqueados
  • ⚠️ Acción sugerida: Verificar fechas, considerar notificar clientes manualmente
  • ✅ Email enviado automáticamente a admins
Decisión: Si las fechas son correctas, proceder con creación. Email automático alertará a admins.
Configuración propuesta:
  • Tipo: Cierre de proveedor
  • Proveedor: Dr. García
  • Inicio: 2026-02-03 00:00
  • Fin: 2026-02-04 23:59
  • Razón: “Permiso médico personal”
Resultado del Preview:
Período: 2026-02-03 a 2026-02-04 (2 días)
Tipo: Provider-specific (Dr. García)

Slots normales (clínica completa): 120 slots
  - 20 slots/día × 2 días × 3 proveedores

Slots Dr. García: 40 slots
  - 20 slots/día × 2 días

Slots bloqueados: 40 slots
% de impacto total: 33% (40/120)

Nivel de impacto: MEDIUM
Email notification: No ❌
Interpretación:
  • ✅ Impacto MEDIUM: Solo 33% de slots bloqueados
  • ✅ Otros proveedores (Dra. López, Dra. Fernández) disponibles
  • ✅ NO se envía email (impacto no es HIGH)
Decisión: Safe to proceed. Impacto aceptable, disponibilidad parcial garantizada.
Configuración propuesta:
  • Tipo: Cierre de proveedor
  • Proveedor: Ana López
  • Inicio: 2026-03-10 09:00
  • Fin: 2026-03-10 14:00
  • Razón: “Capacitación: Curso de técnicas avanzadas”
Resultado del Preview:
Período: 2026-03-10 09:00 a 14:00 (5 horas)
Tipo: Provider-specific (Ana López)

Slots normales (clínica completa): 60 slots
  - 20 slots/día × 3 proveedores

Slots Ana (día completo): 20 slots
Slots Ana (mañana 9-14): 10 slots

Slots bloqueados: 10 slots
% de impacto total: 17% (10/60)
% de impacto Ana: 50% (10/20)

Nivel de impacto: LOW (total), MEDIUM (Ana)
Email notification: No ❌
Interpretación:
  • ✅ Impacto LOW (total): Solo 17% de slots clínica bloqueados
  • ⚠️ Impacto MEDIUM (Ana): 50% de slots de Ana bloqueados
  • ✅ Ana sigue disponible 14:00-18:00 (tarde)
  • ✅ Otros proveedores disponibles todo el día
Decisión: Safe to proceed. Impacto mínimo en disponibilidad general.
Configuración propuesta:
  • Tipo: Cierre de clínica
  • Inicio: 2026-12-25 00:00
  • Fin: 2026-12-25 23:59
  • Razón: “Día festivo - Navidad”
Resultado del Preview:
Período: 2026-12-25 (1 día)
Tipo: Clinic-wide

Slots normales: 20 slots
Slots bloqueados: 20 slots (100%)

Nivel de impacto: HIGH
Email notification: Sí ✅
Interpretación:
  • ⚠️ Impacto HIGH: Día completo bloqueado
  • ✅ Esperado: Es un día festivo (normal que esté cerrado)
  • ✅ Email enviado para alerta
Decisión: Proceder con creación. Es un cierre esperado.

​
Casos Especiales del Preview

Problema: El preview indica Slots normales: 0.Causa probable:
  • La clínica ya está cerrada esos días (no hay work_hours configurados)
  • El período seleccionado cae en días sin horarios de trabajo
Ejemplo:
  • Clínica solo trabaja lunes-viernes (work_hours)
  • Intentas crear cierre para sábado-domingo
  • Preview muestra 0 slots normales (ya cerrado)
Solución:
  • Verificar work_hours de la clínica
  • Si es correcto, no es necesario crear el cierre (ya está cerrado por work_hours)
  • Si quieres bloquear explícitamente, puedes crear el cierre de todos modos
Problema: Preview mostraba 100 slots bloqueados, pero después de crear solo se bloquearon 80.Causa probable:
  • Citas ya agendadas reducen los slots disponibles
  • El preview calcula slots TEÓRICOS (sin considerar citas existentes)
Explicación:
  • Preview: Calcula disponibilidad basada en work_hours y duración de servicios
  • Realidad: Citas ya agendadas consumen slots
Ejemplo:
  • Preview: 100 slots disponibles teóricamente
  • Realidad: 20 citas ya agendadas = 80 slots realmente disponibles
  • Cierre bloquea solo los 80 slots libres
Solución:
  • El preview es un estimado
  • Para cálculo exacto, revisa el calendario y cuenta citas existentes manualmente
  • El sistema NUNCA cancela citas existentes al crear cierre
Problema: Tengo 5 proveedores, ¿cómo interpreto el preview para cierre de 1 proveedor?Solución: El preview mostrará DOS porcentajes:1. % de impacto total (clínica completa):
  • Considera todos los proveedores
  • Ejemplo: 20% (1 de 5 proveedores)
2. % de impacto del proveedor específico:
  • Solo para ese proveedor
  • Ejemplo: 100% (todos los slots del proveedor bloqueados)
Interpretación:
  • Si % total es LOW (<50%): Disponibilidad parcial garantizada ✅
  • Si % proveedor es HIGH (100%): Ese proveedor no estará disponible ⚠️
Recomendación:
  • Usa % total para evaluar impacto en clínica
  • Usa % proveedor para validar que las fechas son correctas para ese empleado
Problema: Ya tengo un cierre existente, creo otro solapado. ¿Cómo se calcula el preview?Solución: El preview calcula el impacto ADICIONAL del nuevo cierre:Escenario:
  • Cierre existente: Dr. García, 1-5 de agosto (40 slots bloqueados)
  • Cierre nuevo: Dra. López, 3-7 de agosto (50 slots)
Preview del cierre nuevo:
  • Slots normales: 100 slots (período 3-7 agosto)
  • Slots ya bloqueados por Dr. García: 20 slots (solapamiento 3-5 agosto)
  • Slots bloqueados por Dra. López: 50 slots
  • Total slots bloqueados después: 70 slots (20 García + 50 López)
  • Impacto adicional del nuevo cierre: 50 slots (solo López)
Interpretación:
  • El preview muestra impacto del cierre que estás creando AHORA
  • No suma cierres existentes (esos ya están en efecto)

​
Limitaciones del Preview

Preview es un estimado, NO un cálculo exacto. Razones:
  1. No considera citas existentes: Calcula slots teóricos basados en work_hours, pero citas ya agendadas reducen slots reales.
  2. Asume disponibilidad uniforme: No considera variaciones en demanda (ej: lunes puede tener más citas que viernes).
  3. No considera recursos: Si servicios requieren recursos específicos (salas, equipos), el preview no valida disponibilidad de recursos.
  4. Cache puede estar desactualizada: Si work_hours o servicios cambiaron recientemente, el preview puede usar datos en cache (hasta 5 min).
Recomendación: Usa preview como guía, pero revisa el calendario manualmente para cierres críticos.
Para cálculo exacto:
  1. Ejecuta preview (obtén estimado)
  2. Navega al calendario para el período del cierre
  3. Cuenta citas existentes manualmente
  4. Calcula: Slots reales disponibles = Slots preview - Citas existentes
Esto te dará el número exacto de slots que se bloquearán.

​
API Endpoint

El preview utiliza el endpoint: 
POST /v1/closures/impact-preview
Content-Type: application/json

{
  "clinic_id": "abc-123",
  "provider_id": null,
  "starts_at": "2026-08-01T00:00:00Z",
  "ends_at": "2026-08-15T23:59:59Z"
}
  • provider_id: null para cierre clinic-wide, UUID para cierre provider-specific
Response: 
{
  "period_start": "2026-08-01T00:00:00Z",
  "period_end": "2026-08-15T23:59:59Z",
  "total_slots_available": 300,
  "total_slots_blocked": 300,
  "impact_percentage": 100.0,
  "impact_level": "HIGH",
  "will_send_email": true,
  "breakdown_by_day": [
    {
      "date": "2026-08-01",
      "slots_available": 20,
      "slots_blocked": 20,
      "impact_percentage": 100.0
    }
  ]
}

​
Próximos Pasos

Crear Cierre

Después de preview, crear el cierre

Ver Upcoming Closures

Revisa cierres próximos (14 días)

Cancelar Cierre

Cómo eliminar un cierre existente

Volver a Overview

Conceptos generales de cierres