Skip to main content

Descripción

El módulo Listados es el centro de reportería y análisis estadístico de Nubidoc. Permite a los usuarios generar informes detallados sobre la actividad del centro médico, con estadísticas agregadas por diferentes dimensiones (profesionales, estados, pagadores, prestaciones, etc.). A diferencia de otros módulos que permiten ver registros individuales, Listados se enfoca en análisis agregado y estadísticas. Los resultados se presentan en tablas con contadores y porcentajes, y pueden exportarse a Excel o imprimirse en PDF para su análisis posterior o presentación en reuniones de equipo. Es una herramienta fundamental para la toma de decisiones basada en datos, permitiendo identificar tendencias, medir el rendimiento del centro, analizar la distribución de pacientes, y evaluar la productividad de los profesionales.

Usuarios Objetivo

  • Administradores: Análisis completo de la actividad del centro, estadísticas de facturación, identificación de tendencias
  • Gerentes de clínica: Informes de rendimiento, distribución de pacientes, análisis de productividad
  • Profesionales: Consulta de sus propias estadísticas (citas atendidas, distribución por tipo de servicio)
  • Personal de facturación: Análisis de citas facturadas vs no facturadas, distribución por pagador
  • Marketing: Análisis demográfico de pacientes (sexo, edad, ubicación geográfica)

Casos de Uso Principales

  1. Análisis de Actividad Mensual
    • Actor: Administrador del centro
    • Objetivo: Obtener estadísticas de citas del mes para reunión de equipo
    • Precondiciones: Tener citas registradas en el período
    • Pasos:
      1. Ir a Listados → Citas
      2. Seleccionar rango de fechas (primer y último día del mes)
      3. Seleccionar todos los profesionales (o filtrar por uno específico)
      4. Dejar estados vacío para incluir todos
      5. Clic en “Buscar”
      6. Revisar estadísticas por estado, profesional, pagador, prestación
      7. Exportar a Excel para presentar en reunión
    • Resultado: Informe Excel con estadísticas del mes desglosadas por múltiples dimensiones
  2. Análisis Demográfico de Pacientes
    • Actor: Gerente de marketing
    • Objetivo: Conocer el perfil de pacientes para campañas dirigidas
    • Precondiciones: Base de datos de pacientes
    • Pasos:
      1. Ir a Listados → Pacientes
      2. Dejar todos los filtros vacíos para incluir todos los pacientes
      3. Clic en “Buscar”
      4. Analizar distribución por sexo, edad, país, modo de creación
      5. Exportar informe a Excel
    • Resultado: Perfil demográfico completo de la base de pacientes
  3. Control de Productividad de Profesional
    • Actor: Profesional médico
    • Objetivo: Revisar su actividad del trimestre
    • Precondiciones: Ser profesional con citas registradas
    • Pasos:
      1. Ir a Listados → Citas
      2. Seleccionar rango de fechas del trimestre
      3. Seleccionar solo su nombre en “Profesionales”
      4. Incluir solo estados “finalizada” y “atendida”
      5. Clic en “Buscar”
      6. Revisar número total de citas, distribución por prestación
    • Resultado: Reporte de productividad personal del trimestre
  4. Identificar Pacientes por Código Postal para Campaña Local
    • Actor: Personal de marketing
    • Objetivo: Encontrar pacientes en zona específica para campaña local
    • Precondiciones: Pacientes con código postal registrado
    • Pasos:
      1. Ir a Listados → Pacientes
      2. Introducir código postal en filtro “CP”
      3. Clic en “Buscar”
      4. Revisar estadísticas de pacientes en esa zona
    • Resultado: Datos demográficos de pacientes en código postal específico
  5. Análisis de No-Presentados por Profesional
    • Actor: Administrador
    • Objetivo: Identificar profesionales con alta tasa de no-presentados
    • Precondiciones: Citas con estados registrados
    • Pasos:
      1. Ir a Listados → Citas
      2. Seleccionar rango de fechas (último mes)
      3. En Estados, seleccionar solo “No asiste”
      4. Dejar profesionales vacío para ver todos
      5. Clic en “Buscar”
      6. Revisar tabla “Citas por Profesional”
    • Resultado: Identificación de profesionales con más no-presentados

Opciones del Menú

Opción 1: Citas

  • Función JavaScript: openAppointmentSearchSummary()
  • Vista cargada: partials3.0/summary/summaryappointmentsearch
  • Descripción: Genera estadísticas agregadas de citas con múltiples filtros y dimensiones de análisis
  • Privilegios: Requiere LISTS_VIEW
  • Icono: fa fa-search (lupa)
Estadísticas generadas:
  • Número total de citas que cumplen criterio
  • Número total de pacientes distintos
  • Citas por Estado (con cantidad y porcentaje)
  • Citas por Profesional
  • Citas por Pagador
  • Citas por Prestación
  • Citas por Facturable
  • Comisiones Prestación & Facturable
  • Citas por Centro
  • Citas por Número de visitas (1, 2, 3… 10+)

Opción 2: Pacientes

  • Función JavaScript: openPatientSearchSummary()
  • Vista cargada: partials3.0/summary/patientsummarysearch
  • Descripción: Genera estadísticas demográficas y de distribución de pacientes
  • Privilegios: Requiere LISTS_VIEW
  • Icono: fa fa-search (lupa)
Estadísticas generadas:
  • Número total de pacientes que cumplen criterio
  • Pacientes por Sexo (Hombre, Mujer, Desconocido - con cantidad y %)
  • Pacientes por Edad (rangos de 10 años: 0-9, 10-19, 20-29… Desconocida)
  • Pacientes por Centro
  • Pacientes por País
  • Pacientes por Modo de creación (Usuario, Online)

Opción 3: Diagnósticos (Condicional)

  • Función JavaScript: openEFDiagnosisSummary()
  • Vista cargada: partials3.0/summary/efdiagnosissummarysearch
  • Descripción: Genera estadísticas de diagnósticos (requiere configuración especial del cliente)
  • Privilegios: Requiere LISTS_VIEW + showEFDiagnosisSummary() habilitado
  • Icono: fa fa-search (lupa)
  • Nota: Solo disponible para clientes que tienen habilitada la funcionalidad de diagnósticos

Pantalla 1: Listado de Citas

Función de acceso: openAppointmentSearchSummary() \1

Descripción

Pantalla de búsqueda y análisis estadístico de citas. Permite filtrar citas por múltiples criterios y genera automáticamente estadísticas agregadas en tablas con contadores y porcentajes.

Secciones de la Pantalla

1. Encabezado
  • Título: “BUSCAR CITAS” con icono de lupa
  • Indica claramente el propósito del formulario
2. Formulario de Filtros
  • Fila 1 (siempre visible):
    • Entre Fecha / y fecha (rango de fechas, por defecto desde inicio del mes actual)
    • Profesionales (combo múltiple, permite seleccionar uno o varios)
    • Estados (combo múltiple: programada, confirmada, en sala, finalizada, no asiste, cancelada, etc.)
  • Fila 2 (desplegable con botón ”+” de filtro completo):
    • Pagadores (combo múltiple: PRIVADO, aseguradoras, empresas)
    • Prestaciones (servicios normales: Primera consulta, Consulta, etc.)
    • Otros facturables (servicios de tipo factura)
    • Centro (solo si es multicentro)
    • Citas con paciente SI/NO (solo si se permiten citas sin paciente)
  • Ver datos de paciente: Switch SI/NO para mostrar datos personales en resultados
3. Botones de Acción
  • Buscar (verde) - Ejecuta la búsqueda con los filtros seleccionados
  • Limpiar (icono borrador) - Resetea todos los filtros
  • Filtro completo (icono lupa +) - Muestra/oculta fila 2 de filtros avanzados
4. Área de Resultados (tras buscar)
  • Resumen: “Número total de citas: X” y “Número total de pacientes distintos: Y”
  • Pestañas: CITAS / PROFESIONALES (dos vistas de los mismos datos)
  • Tablas estadísticas: Múltiples tablas con contadores y porcentajes por dimensión
  • Botones de exportación:
    • Exportar a Excel
    • Imprimir informe (PDF)
5. Acciones disponibles
  • Buscar: Genera estadísticas con filtros seleccionados
  • Limpiar: Resetea formulario
  • Toggle filtro: Muestra/oculta filtros avanzados
  • Exportar a Excel: Descarga archivo .xlsx con todas las estadísticas
  • Imprimir: Genera PDF del informe

Notas Especiales

  • Advertencia de rendimiento: Al buscar sin restricciones (todos los datos), el sistema muestra un diálogo advirtiendo que puede tardar hasta 5 minutos en procesar gran volumen de datos
  • Tabs CITAS/PROFESIONALES: Permiten ver los mismos datos desde dos perspectivas diferentes
  • Fecha por defecto: El campo “Entre Fecha” se inicializa al primer día del mes actual a las 00:01

Pantalla 2: Listado de Pacientes

Función de acceso: openPatientSearchSummary() \1

Descripción

Pantalla de búsqueda y análisis estadístico de pacientes. Genera un perfil demográfico completo de la base de pacientes con distribución por sexo, edad, ubicación geográfica y otros criterios.

Secciones de la Pantalla

1. Encabezado
  • Título: “BUSCAR” con icono de lupa
  • Contexto claro de búsqueda de pacientes
2. Formulario de Filtros
  • Centro: Combo múltiple (solo si es multicentro)
  • Sexo: Checkboxes (Hombre, Mujer, Otro)
  • Programa: Combo múltiple (solo si hay programas configurados)
  • F. Nac. entre / y: Rango de fechas de nacimiento
    • Icono pastel: Atajo para buscar cumpleaños del día
    • Icono calculadora: Calculadora de edad para encontrar rango
  • CP: Código postal
  • Campos extra: Campos personalizados configurados por el cliente (variables según centro)
3. Botones de Acción
  • Buscar (verde) - Ejecuta la búsqueda
  • Limpiar (icono borrador) - Resetea filtros
4. Área de Resultados (tras buscar)
  • Resumen: “Número total de pacientes: X”
  • Tablas estadísticas:
    • Pacientes por Sexo (Hombre, Mujer, Desconocido)
    • Pacientes por Edad (rangos de 10 años)
    • Pacientes por Centro
    • Pacientes por País
    • Pacientes por Modo de creación (Usuario, Online)
  • Botón de exportación: Imprimir informe (PDF)
5. Acciones disponibles
  • Buscar: Genera estadísticas demográficas
  • Limpiar: Resetea formulario
  • Imprimir: Genera PDF con estadísticas

Notas Especiales

  • Herramientas de fecha de nacimiento:
    • 🎂 Icono pastel: Busca pacientes que cumplen años hoy
    • 🧮 Icono calculadora: Abre calculadora para encontrar rango de fechas según edad deseada (ej: pacientes entre 40-50 años)
  • Campos extra dinámicos: Cada centro puede tener campos personalizados que aparecerán como filtros adicionales
  • Sin exportar a Excel: Solo disponible exportación a PDF (a diferencia de Citas)

Formulario: Búsqueda de Citas

Propósito: Filtrar citas para generar estadísticas Ubicación: Listados → Citas ID HTML: summaryappointmentsearch

Campos del Formulario

CampoTipoObligatorioDescripciónValidación
Entre FechadatetimeFecha/hora inicial del rangoDebe ser anterior a “y fecha”
y fechadatetimeNoFecha/hora final del rangoDebe ser posterior a “Entre Fecha”
Profesionalesselect multipleNoProfesionales a incluir (vacío = todos)-
Estadosselect multipleNoEstados de cita a incluir (vacío = todos)-
Pagadoresselect multipleNoPagadores a filtrar (vacío = todos)-
Prestacionesselect multipleNoServicios normales a filtrar-
Otros facturablesselect multipleNoServicios facturables a filtrar-
Centroselect multipleNoCentros a filtrar (solo multicentro)-
Citas con pacienteradio (SI/NO)NoFiltrar por existencia de paciente-
Ver datos de pacienteswitch (SI/NO)NoIncluir datos personales en resultadosDefault: NO

Botones y Acciones

  • Buscar
    • Función: Genera estadísticas con filtros aplicados
    • Acción: Valida rango de fechas, muestra advertencia si gran volumen, ejecuta búsqueda en servidor
    • Validaciones: Fecha inicial debe ser anterior a fecha final
  • Limpiar (icono borrador)
    • Función: cleanform(paneId)
    • Acción: Resetea todos los campos del formulario a valores por defecto
    • Validaciones: Ninguna
  • Filtro completo (icono lupa +)
    • Función: toggleAppoSummaryFilter(paneId)
    • Acción: Muestra/oculta fila 2 de filtros avanzados
    • Validaciones: Ninguna

Formulario: Búsqueda de Pacientes

Propósito: Filtrar pacientes para generar estadísticas demográficas Ubicación: Listados → Pacientes ID HTML: patientsummarysearch

Campos del Formulario

CampoTipoObligatorioDescripciónValidación
Centroselect multipleNoCentros a incluir (solo multicentro)-
Sexocheckbox groupNoHombre, Mujer, Otro (vacío = todos)-
Programaselect multipleNoProgramas a filtrar (si existen)-
F. Nac. entredateNoFecha de nacimiento inicialDebe ser anterior a “y”
ydateNoFecha de nacimiento finalDebe ser posterior a “entre”
CPtextNoCódigo postal-
Campos extravariableNoCampos personalizados del clienteSegún configuración

Botones y Acciones

  • Buscar
    • Función: Genera estadísticas demográficas
    • Acción: Ejecuta búsqueda en servidor con filtros aplicados
    • Validaciones: Ninguna estricta (todos los campos opcionales)
  • Limpiar (icono borrador)
    • Función: Resetea formulario
    • Acción: Limpia todos los campos
    • Validaciones: Ninguna
  • Icono pastel 🎂
    • Función: tobirthday(paneId)
    • Acción: Establece rango de fechas para cumpleaños del día actual
    • Validaciones: Ninguna
  • Icono calculadora 🧮
    • Función: birthdaycalculator(paneId)
    • Acción: Abre calculadora para convertir edad en rango de fechas
    • Validaciones: Ninguna

Workflow 1: Generar Informe de Citas del Mes

1. Usuario accede a Listados → Citas

2. Sistema muestra formulario con fecha inicial = 01/MM/AAAA 00:01

3. Usuario ajusta fecha final (último día del mes)

4. Usuario selecciona profesionales (o deja todos)

5. Usuario selecciona estados (o deja todos)

6. Usuario hace clic en "Buscar"

7. Sistema muestra diálogo: "Puede tardar hasta 5 minutos..."

8. Usuario confirma "Sí"

9. Sistema procesa datos (puede tardar varios segundos)

10. Sistema muestra resultados:
    - Resumen: Total de citas, total de pacientes distintos
    - Tablas estadísticas por cada dimensión

11. Usuario revisa estadísticas

12. Usuario hace clic en "Exportar a Excel"

13. Sistema genera archivo .xlsx y lo descarga

14. Usuario abre Excel para análisis o presentación
Variantes del flujo:
  • Si usuario hace clic en “Imprimir informe”: Sistema genera PDF en lugar de Excel
  • Si usuario quiere ver datos de paciente: Activa switch “Ver datos de paciente” antes de buscar
  • Si búsqueda tarda más de 5 minutos: Sistema muestra error de timeout, usuario debe acotar filtros
Errores comunes:
  • Error: “El proceso tardó más de 5 minutos”
    • Causa: Búsqueda sin filtros suficientes en base de datos grande
    • Solución: Acotar rango de fechas o seleccionar menos profesionales/estados
  • Error: “Fecha inicial debe ser anterior a fecha final”
    • Causa: Usuario invirtió fechas en el formulario
    • Solución: Corregir orden de fechas

Workflow 2: Análisis Demográfico de Pacientes

1. Usuario accede a Listados → Pacientes

2. Sistema muestra formulario vacío (sin filtros)

3. Usuario decide criterios de filtro (o deja vacío para todos)
   Ejemplos:
   - Solo mujeres: marca checkbox "Mujer"
   - Solo código postal 28001: escribe "28001" en CP
   - Pacientes entre 40-50 años: usa calculadora de edad

4. Usuario hace clic en "Buscar"

5. Sistema procesa datos

6. Sistema muestra resultados:
   - Total de pacientes
   - Distribución por Sexo
   - Distribución por Edad (rangos de 10 años)
   - Distribución por Centro
   - Distribución por País
   - Distribución por Modo de creación

7. Usuario analiza estadísticas

8. (Opcional) Usuario hace clic en "Imprimir informe"

9. Sistema genera PDF con todas las tablas

10. Usuario guarda/imprime PDF
Variantes del flujo:
  • Si usuario quiere buscar cumpleaños del día: Hace clic en icono 🎂, sistema rellena fechas automáticamente
  • Si usuario quiere pacientes de cierta edad: Hace clic en calculadora 🧮, introduce edad, sistema calcula rango de fechas
Errores comunes:
  • Error: “No hay pacientes que cumplan los criterios”
    • Causa: Filtros demasiado restrictivos
    • Solución: Ampliar criterios o hacer clic en “Limpiar”

Workflow 3: Identificar Tendencias de No-Presentados

1. Administrador recibe quejas de alta tasa de no-presentados

2. Administrador accede a Listados → Citas

3. Administrador configura filtros:
   - Entre Fecha: Último mes
   - Estados: Solo "No asiste"
   - Profesionales: Vacío (todos)

4. Administrador hace clic en "Buscar"

5. Sistema procesa y muestra estadísticas

6. Administrador revisa tabla "Citas por Profesional"

7. Administrador identifica profesionales con más no-presentados

8. Administrador exporta a Excel

9. Administrador analiza tendencias:
   - ¿Hay días de la semana con más no-presentados?
   - ¿Algún profesional destaca significativamente?
   - ¿Algún pagador/tipo de servicio tiene más incidencias?

10. Administrador toma medidas:
    - Mejorar recordatorios por SMS/email
    - Hablar con profesionales específicos
    - Implementar políticas de confirmación

Workflow 4: Campaña de Marketing por Zona Geográfica

1. Equipo de marketing decide campaña local en código postal 28001

2. Usuario accede a Listados → Pacientes

3. Usuario introduce "28001" en campo CP

4. Usuario hace clic en "Buscar"

5. Sistema muestra estadísticas de pacientes en esa zona:
   - Total de pacientes en 28001
   - Distribución por sexo
   - Distribución por edad

6. Usuario analiza perfil demográfico:
   - Edad predominante
   - Sexo predominante
   - Número total (viabilidad de campaña)

7. Usuario exporta informe

8. Equipo de marketing diseña campaña según perfil identificado

Integraciones

Con Agenda:
  • Los listados de citas se basan en datos del módulo Agenda
  • Estados de citas provienen de Agenda
  • Profesionales asignados a citas provienen de configuración de Agenda
Con Pacientes:
  • Listados de pacientes consulta base de datos del módulo Pacientes
  • Datos demográficos (sexo, fecha nacimiento, CP) provienen de Pacientes
  • Modo de creación distingue pacientes creados por usuario vs. online (Agenda Online)
Con Facturación:
  • “Otros facturables” y “Prestaciones” provienen de servicios configurados en Facturación
  • Análisis de “Citas por Facturable” relaciona citas con conceptos facturados
  • Comisiones calculadas según configuración de Facturación
Con Administración:
  • Privilegio LISTS_VIEW configurado en Administración → Permisos
  • Configuración de centros (multicentro) proviene de Administración
  • Programas de pacientes configurados en Administración
Con Mi Facturación:
  • Profesionales pueden usar Listados para revisar su productividad individual
  • Datos de comisiones relevantes para revisión de facturación personal

Dependencias

Requiere:
  • Módulo Agenda: Para tener citas que analizar
  • Módulo Pacientes: Para tener base de datos de pacientes
  • Configuración de permisos: Usuario debe tener privilegio LISTS_VIEW
  • Servicios configurados: Para análisis por prestaciones
Es requerido por:
  • Dirección del centro: Para toma de decisiones estratégicas
  • Auditorías: Para reportes de actividad
  • Marketing: Para campañas dirigidas basadas en datos

Regla 1: Aislamiento Multi-Tenant

  • Descripción: Cada centro médico solo ve estadísticas de sus propios datos
  • Cuándo aplica: Siempre
  • Efecto: Los listados nunca mezclan datos entre diferentes clientes (centros médicos)

Regla 2: Rendimiento y Límite de Tiempo

  • Descripción: Las búsquedas sin filtros restrictivos pueden tardar hasta 5 minutos
  • Cuándo aplica: Al buscar con pocos filtros en bases de datos grandes
  • Efecto: Sistema muestra advertencia al usuario antes de ejecutar búsqueda; si tarda >5 min, muestra error

Regla 3: Fechas por Defecto en Citas

  • Descripción: Campo “Entre Fecha” se inicializa al primer día del mes actual a las 00:01
  • Cuándo aplica: Al abrir Listados → Citas
  • Efecto: Por defecto, búsqueda incluye todo el mes actual (si no se modifica)

Regla 4: Privacidad de Datos de Paciente

  • Descripción: Switch “Ver datos de paciente” controla inclusión de datos personales en resultados
  • Cuándo aplica: En listados de citas
  • Efecto: Si está en NO (default), no se muestran nombres/datos personales; si está en SÍ, se incluyen

Regla 5: Cálculo de Porcentajes

  • Descripción: Todas las tablas estadísticas incluyen columna ”%” calculada automáticamente
  • Cuándo aplica: En todas las estadísticas generadas
  • Efecto: Porcentaje = (Cantidad de esa categoría / Total) × 100, redondeado a 2 decimales

Regla 6: Filtros Vacíos = Incluir Todos

  • Descripción: Si un filtro de combo múltiple está vacío, se incluyen todos los valores
  • Cuándo aplica: En todos los formularios de búsqueda
  • Efecto: Dejar “Profesionales” vacío = incluir todos los profesionales; dejar “Estados” vacío = incluir todos los estados

Mensajes de Éxito

  • “Número total de citas que cumplen el criterio de selección: X”
    • Cuándo aparece: Tras ejecutar búsqueda de citas exitosamente
    • Significado: Se encontraron X citas que cumplen los filtros
  • “Número total de pacientes distintos en la selección: Y”
    • Cuándo aparece: Tras búsqueda de citas (subtítulo)
    • Significado: De las X citas, hay Y pacientes únicos (algunos pacientes pueden tener múltiples citas)
  • “Número total de pacientes que cumplen el criterio de selección: X”
    • Cuándo aparece: Tras búsqueda de pacientes exitosamente
    • Significado: Se encontraron X pacientes que cumplen filtros

Mensajes de Advertencia

  • “Dependiendo del filtro seleccionado, es posible que el sistema necesite procesar un gran volumen de datos. Si el proceso tarda más de 5 minutos, se mostrará un mensaje de error y deberá acotar la selección para restringir el número de resultados. ¿Desea continuar?”
    • Cuándo aparece: Al hacer clic en “Buscar” en Listados → Citas
    • Significado: Búsqueda puede ser lenta; usuario debe confirmar
    • Acción: Usuario puede cancelar y acotar filtros, o continuar

Mensajes de Error

  • “El proceso tardó más de 5 minutos y fue cancelado”
    • Cuándo aparece: Si búsqueda excede límite de tiempo
    • Solución: Acotar rango de fechas, seleccionar menos profesionales/estados, o filtrar por centro específico
  • “Fecha inicial debe ser anterior a fecha final”
    • Cuándo aparece: Si usuario introduce fechas en orden incorrecto
    • Solución: Corregir orden de fechas en formulario
  • “No hay datos que mostrar”
    • Cuándo aparece: Si búsqueda no arroja resultados
    • Solución: Ampliar criterios de búsqueda o verificar que existen datos en el período seleccionado

Mensajes de Información

  • “Sin registros que mostrar”
    • Cuándo aparece: En tablas estadísticas sin datos para una categoría específica
    • Ejemplo: “Citas por Facturable” puede mostrar este mensaje si no hay facturables asociados

Herramienta auxiliar: requerimientos funcionales (/requeriments)

La página /requeriments/index.php muestra un listado simple de requerimientos funcionales en formato ficha. Sirve para consultar tickets preparados para revisión y cambiar su estado o tipo desde la propia ficha.

Qué puedes hacer

  • Ver el listado de requerimientos disponibles.
  • Abrir una ficha concreta.
  • Cambiar el estado y el tipo desde los selectores de la vista detalle.
  • Usar la plantilla JSON enlazada por la propia herramienta para crear nuevos requerimientos.

Cómo funciona a nivel operativo

  • Los JSON activos ya no se guardan dentro del repo.
  • La herramienta usa una carpeta de datos live del servidor.
  • Si esa carpeta está vacía, el sistema la inicializa automáticamente con un contenido base.

Recomendación de uso

Si das de alta un requerimiento nuevo, recarga el índice después de guardar el JSON y entra por el enlace del ticket para revisar que el render y los campos editables se ven bien.

Preguntas Frecuentes

Q: ¿Por qué el botón “Buscar” me pide confirmación en Listados de Citas? A: El sistema advierte que búsquedas sin filtros restrictivos pueden procesar gran volumen de datos y tardar hasta 5 minutos. Es una medida de seguridad para evitar sobrecargar el servidor. Puede continuar o acotar filtros para búsquedas más rápidas. Q: ¿Qué diferencia hay entre “Prestaciones” y “Otros facturables”? A: “Prestaciones” son servicios normales (Primera consulta, Consulta, etc.) que se asocian a citas. “Otros facturables” son servicios de tipo factura (productos, materiales) que pueden o no estar asociados a citas pero se facturan. El filtro permite analizar ambos tipos por separado. Q: ¿Cómo puedo ver solo las citas de un profesional específico? A: En Listados → Citas, en el filtro “Profesionales”, selecciona solo el nombre del profesional deseado. Deja los demás filtros vacíos para incluir todas sus citas, o combina con otros filtros (fechas, estados) para análisis más específico. Q: ¿Qué significa “Número de visitas” en las estadísticas de citas? A: Indica cuántas veces un paciente ha visitado el centro (1ª visita, 2ª visita, 3ª… 10+). Permite analizar si las citas son mayormente de pacientes nuevos (visita 1) o recurrentes (visita 10+). Q: ¿Por qué no puedo exportar a Excel el listado de pacientes? A: Actualmente el listado de pacientes solo permite exportar a PDF (botón “Imprimir informe”). El listado de citas sí tiene ambas opciones (Excel y PDF). Si necesitas datos de pacientes en Excel, considera usar el módulo Pacientes → Buscar → Exportar. Q: ¿Qué hace el icono de pastel 🎂 en búsqueda de pacientes? A: Es un atajo para buscar pacientes que cumplen años HOY. Al hacer clic, el sistema rellena automáticamente el rango de fechas de nacimiento para coincidir con el día y mes actuales (ignorando el año). Útil para campañas de cumpleaños. Q: ¿Cómo funciona la calculadora de edad 🧮? A: Al hacer clic en el icono calculadora, se abre un diálogo donde introduces la edad deseada (ej: 40 años). El sistema calcula automáticamente el rango de fechas de nacimiento correspondiente y lo rellena en los campos “F. Nac. entre” y “y”. Útil para buscar pacientes en cierto rango de edad. Q: ¿Qué es el switch “Ver datos de paciente”? A: Controla si en los resultados del listado de citas se muestran datos personales de los pacientes (nombre, apellidos, DNI, etc.). Por defecto está en NO para proteger la privacidad. Actívalo solo si necesitas ver esa información en las estadísticas. Q: ¿Por qué algunos campos del formulario no aparecen? A: Algunos filtros son condicionales:
  • Centro: Solo aparece si tu clínica tiene configuración multicentro
  • Programa: Solo si hay programas configurados en Administración
  • Citas con paciente: Solo si tu centro permite citas sin paciente asignado
  • Diagnósticos: Solo si el cliente tiene habilitada esta funcionalidad especial
Q: ¿Puedo guardar mis filtros favoritos para reutilizarlos? A: Actualmente no hay función de guardar filtros. Cada vez que abres Listados debes configurar los filtros de nuevo. El único valor que se inicializa automáticamente es “Entre Fecha” (primer día del mes actual). Q: ¿Qué hago si mi búsqueda tarda más de 5 minutos? A: El sistema mostrará un error. Debes acotar la búsqueda:
  1. Reduce el rango de fechas (busca por mes en lugar de por año)
  2. Selecciona menos profesionales (en lugar de todos)
  3. Filtra por centro específico (si eres multicentro)
  4. Selecciona estados específicos (en lugar de todos)
Q: ¿Cómo interpreto la tabla “Pacientes por Edad”? A: Muestra distribución por rangos de 10 años:
  • 0-9 años: Niños
  • 10-19 años: Adolescentes
  • 20-29 años: Jóvenes adultos
  • … y así sucesivamente
  • Desconocida: Pacientes sin fecha de nacimiento registrada
Cada fila muestra cantidad y porcentaje sobre el total. Q: ¿Por qué aparece “Desconocido” en algunas categorías? A: “Desconocido” aparece cuando los datos no están completos:
  • Sexo Desconocido: Pacientes sin sexo registrado
  • Edad Desconocida: Pacientes sin fecha de nacimiento
  • País Desconocido: Pacientes sin país en su dirección
Es normal tener un pequeño porcentaje en “Desconocido”, pero si es alto, indica que falta completar datos en las fichas de pacientes. Q: ¿Qué diferencia hay entre las pestañas CITAS y PROFESIONALES? A: En el listado de citas, tras buscar, hay dos pestañas:
  • CITAS: Vista centrada en las citas (estado, pagador, prestación, etc.)
  • PROFESIONALES: Vista centrada en los profesionales (estadísticas por profesional)
Ambas muestran los mismos datos desde perspectivas diferentes. Usa la que mejor se adapte a tu análisis.

Listado de Citas

Campos de Búsqueda

CampoTipoOperadorDescripción
Entre FechadatetimeCitas con fecha/hora mayor o igual a este valor
y fechadatetimeCitas con fecha/hora menor o igual a este valor
Profesionalesselect multipleINCitas atendidas por estos profesionales (vacío = todos)
Estadosselect multipleINCitas en estos estados (vacío = todos)
Pagadoresselect multipleINCitas con estos pagadores (vacío = todos)
Prestacionesselect multipleINCitas con estas prestaciones (vacío = todas)
Otros facturablesselect multipleINCitas con estos facturables (vacío = todos)
Centroselect multipleINCitas en estos centros (vacío = todos)
Citas con pacienteradio=SI: solo con paciente, NO: solo sin paciente, vacío: todas

Resultados

Sección Resumen:
  • Total de citas
  • Total de pacientes distintos
Tablas Estadísticas (Pestaña CITAS):
  • Citas por Estado: Estados (columna), Cantidad, %
  • Citas por Profesional: Profesionales (columna), Cantidad, %
  • Citas por Pagador: Pagadores (columna), Cantidad, %
  • Citas por Prestación: Prestaciones (columna), Cantidad, %
  • Citas por Facturable: Facturables (columna), Cantidad, %
  • Comisiones Prestación & Facturable: Comisiones (columna), Cantidad, %
  • Citas por Centro: Centros (columna), Cantidad, %
  • Citas por Número de visitas: Nº Visita (columna), Cantidad, %
Acciones sobre resultados:
  • Exportar a Excel: Descarga archivo .xlsx con todas las tablas
  • Imprimir informe: Genera PDF con todas las tablas

Campos de Búsqueda

CampoTipoOperadorDescripción
Centroselect multipleINPacientes de estos centros (vacío = todos)
SexocheckboxINHombre, Mujer, Otro (vacío = todos)
Programaselect multipleINPacientes en estos programas (vacío = todos)
F. Nac. entredatePacientes con fecha de nacimiento ≥ esta fecha
ydatePacientes con fecha de nacimiento ≤ esta fecha
CPtext=Pacientes con este código postal exacto
Campos extravariable= o LIKESegún configuración del campo extra

Resultados

Sección Resumen:
  • Total de pacientes
Tablas Estadísticas:
  • Pacientes por Sexo: Sexo (columna), Cantidad, %
  • Pacientes por Edad: Edad (rangos de 10 años) (columna), Cantidad, %
  • Pacientes por Centro: Centro (columna), Cantidad, %
  • Pacientes por País: País (columna), Cantidad, %
  • Pacientes por Modo de creación: Modo (Usuario/Online) (columna), Cantidad, %
Acciones sobre resultados:
  • Imprimir informe: Genera PDF con todas las tablas

Iconos Principales

  • 🔍 fa fa-search - Búsqueda / Listados
  • 📊 fa fa-bar-chart - Estadísticas (icono del módulo)
  • 📅 fa fa-calendar - Citas
  • 👥 fa fa-users - Pacientes
  • 📄 fa fa-file-excel-o - Exportar a Excel
  • 🖨️ fa fa-print - Imprimir informe
  • 🧹 fa fa-eraser - Limpiar filtros
  • 🔍+ fa fa-search-plus - Mostrar filtro completo
  • 🎂 cake.png - Cumpleaños del día
  • 🧮 calculator.png - Calculadora de edad

Colores en Tablas

  • Encabezado de tablas: Fondo gris claro #f5f5f5
  • Filas pares: Blanco
  • Filas impares: Gris muy claro #fafafa (para mejor legibilidad)
  • Totales: Negrita para resaltar

Layout

  • Formulario de filtros: Dos filas (segunda desplegable con botón de filtro completo)
  • Botones de acción: Alineados a la derecha del formulario
  • Tablas estadísticas: Ancho completo, columnas: Categoría, Cantidad, %
  • Pestañas: CITAS / PROFESIONALES (solo en listado de citas)

Niveles de Acceso

PrivilegioPermite
LISTS_VIEWVer módulo Listados, generar todos los informes

Restricciones

  • Aislamiento multi-tenant: Usuarios solo ven estadísticas de su propio centro médico
  • Sin privilegio LISTS_VIEW: El módulo Listados no aparece en el menú lateral
  • Datos de paciente protegidos: Switch “Ver datos de paciente” controla visibilidad de datos personales
  • Timeout de 5 minutos: Búsquedas que excedan este tiempo son canceladas automáticamente

Exportar a Excel (solo Citas)

  • Formato: .xlsx (Excel 2007+)
  • Contenido:
    • Hoja 1: Resumen (total citas, total pacientes)
    • Hoja 2: Citas por Estado
    • Hoja 3: Citas por Profesional
    • Hoja 4: Citas por Pagador
    • Hoja 5: Citas por Prestación
    • Hoja 6: Citas por Facturable
    • Hoja 7: Comisiones
    • Hoja 8: Citas por Centro
    • Hoja 9: Citas por Número de visitas
  • Nombre del archivo: listado_citas_YYYYMMDD.xlsx

Imprimir Informe (PDF)

  • Formato: PDF
  • Contenido: Todas las tablas estadísticas en un solo documento
  • Incluye:
    • Logo del centro
    • Fecha/hora de generación
    • Filtros aplicados
    • Todas las tablas con formato profesional
  • Nombre del archivo: informe_listado_YYYYMMDD.pdf

Configuraciones de Cliente

  • Habilita la opción “Diagnósticos” en el menú Listados
  • Por defecto: false
  • Solo para clientes con funcionalidad de diagnósticos habilitada
  • Muestra filtro por “Centro” en ambos listados
  • Por defecto: false (un solo centro)
  • Muestra filtro “Citas con paciente” (SI/NO)
  • Por defecto: false
  • Solo para clínicas que permiten citas sin paciente asignado
  • Retorna programas configurados para la clínica
  • Si está vacío, no se muestra filtro “Programa”
  • Retorna campos extra de paciente configurados como “filtrable”
  • Estos campos aparecen dinámicamente en el formulario de búsqueda de pacientes

Tutorial 1: Generar Informe Mensual para Reunión de Equipo

Objetivo: Obtener estadísticas del mes actual para presentar en reunión Tiempo estimado: 5 minutos Pasos:
  1. Acceder al módulo
    • En el menú lateral izquierdo, hacer clic en “Listados”
    • Seleccionar “Citas”
  2. Configurar rango de fechas
    • Verificar que “Entre Fecha” muestra el primer día del mes actual (ej: 01/12/2025 00:00)
    • En “y fecha”, introducir el último día del mes (ej: 31/12/2025 23:59)
    • Alternativamente, hacer clic en el icono de calendario y seleccionar la fecha
  3. Configurar filtros (opcional)
    • Dejar “Profesionales” vacío para incluir a todos
    • Dejar “Estados” vacío para incluir todos los estados
    • Si solo quieres citas finalizadas/atendidas, seleccionar esos estados específicamente
  4. Ejecutar búsqueda
    • Hacer clic en botón verde “Buscar”
    • Confirmar en el diálogo de advertencia (“Sí, continuar”)
    • Esperar a que el sistema procese (puede tardar 10-60 segundos)
  5. Revisar resultados
    • Ver resumen: “Número total de citas: X”
    • Explorar tablas:
      • Citas por Estado: ¿Cuántas finalizadas? ¿Cuántos no-presentados?
      • Citas por Profesional: ¿Quién atendió más pacientes?
      • Citas por Pagador: ¿Distribución privado vs. aseguradoras?
      • Citas por Prestación: ¿Qué servicios son más demandados?
  6. Exportar para la reunión
    • Hacer clic en botón “Exportar a Excel”
    • Guardar archivo (se descarga automáticamente)
    • Abrir Excel, revisar todas las hojas
    • Crear gráficos si es necesario (en Excel)
  7. Presentar en reunión
    • Compartir pantalla con el archivo Excel
    • Comentar tendencias observadas
    • Identificar áreas de mejora

Tutorial 2: Análisis de Cumpleaños para Campaña de Fidelización

Objetivo: Encontrar pacientes que cumplen años en el mes actual para enviar felicitación Tiempo estimado: 3 minutos Pasos:
  1. Acceder al módulo
    • En el menú lateral, hacer clic en “Listados”
    • Seleccionar “Pacientes”
  2. Usar herramienta de cumpleaños
    • Hacer clic en el icono de pastel 🎂 (junto a los campos de fecha de nacimiento)
    • El sistema rellena automáticamente “F. Nac. entre” y “y” con el día de hoy (ignorando año)
    • Esto encuentra pacientes que cumplen años HOY
  3. Para cumpleaños del mes (alternativa manual)
    • En “F. Nac. entre”, introducir: 01/MM/AAAA (primer día del mes actual, cualquier año)
    • En “y”, introducir: 31/MM/AAAA (último día del mes actual, cualquier año)
    • Ejemplo para diciembre: 01/12/1900 hasta 31/12/2024
  4. Ejecutar búsqueda
    • Hacer clic en “Buscar”
    • El sistema muestra total de pacientes con cumpleaños en ese rango
  5. Revisar estadísticas
    • Ver distribución por sexo (para personalizar mensaje)
    • Ver distribución por edad (útil para ofertas específicas)
  6. Exportar lista
    • Hacer clic en “Imprimir informe” (genera PDF)
    • Alternativamente, ir a Módulo Pacientes → Buscar, aplicar los mismos filtros y exportar a Excel para tener emails/teléfonos
  7. Crear campaña
    • Usar los datos demográficos para personalizar mensajes
    • Segmentar por edad si es necesario (ej: descuentos diferentes por franja de edad)
    • Enviar felicitación personalizada vía Marketing → Campañas

Tutorial 3: Identificar Profesional con Más No-Presentados

Objetivo: Detectar si algún profesional tiene tasa alta de no-presentados para tomar medidas Tiempo estimado: 4 minutos Pasos:
  1. Acceder al módulo
    • Ir a “Listados” → “Citas”
  2. Configurar período de análisis
    • En “Entre Fecha”, seleccionar hace 1 mes (ej: si hoy es 19/12, poner 19/11)
    • En “y fecha”, dejar vacío o poner fecha actual
    • Esto analiza el último mes
  3. Filtrar por estado “No asiste”
    • En combo “Estados”, desplegar y seleccionar SOLO “No asiste”
    • Importante: Solo marca este estado, desmarca los demás
  4. Dejar profesionales vacío
    • No seleccionar ningún profesional específico
    • Esto permite ver todos en la tabla comparativa
  5. Ejecutar búsqueda
    • Hacer clic en “Buscar”
    • Confirmar diálogo
  6. Analizar tabla “Citas por Profesional”
    • Ver columna “Cantidad” para cada profesional
    • Identificar quién tiene más no-presentados en números absolutos
    • Ver columna ”%” para comparar proporcionalmente
  7. Comparar con total de citas del profesional (opcional)
    • Volver a “Listados” → “Citas”
    • Ahora en “Profesionales”, seleccionar el profesional identificado
    • En “Estados”, dejar TODOS los estados
    • Buscar de nuevo
    • Ver tabla “Citas por Estado” para ese profesional
    • Calcular: % no-presentados = (No asiste / Total) × 100
  8. Tomar medidas
    • Si la tasa es >10%, considerar:
      • Mejorar recordatorios (SMS/email 24h antes)
      • Implementar confirmación obligatoria
      • Analizar si hay días/horarios con más incidencias
    • Hablar con el profesional para entender causas