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
-
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:
- Ir a Listados → Citas
- Seleccionar rango de fechas (primer y último día del mes)
- Seleccionar todos los profesionales (o filtrar por uno específico)
- Dejar estados vacío para incluir todos
- Clic en “Buscar”
- Revisar estadísticas por estado, profesional, pagador, prestación
- Exportar a Excel para presentar en reunión
- Resultado: Informe Excel con estadísticas del mes desglosadas por múltiples dimensiones
-
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:
- Ir a Listados → Pacientes
- Dejar todos los filtros vacíos para incluir todos los pacientes
- Clic en “Buscar”
- Analizar distribución por sexo, edad, país, modo de creación
- Exportar informe a Excel
- Resultado: Perfil demográfico completo de la base de pacientes
-
Control de Productividad de Profesional
- Actor: Profesional médico
- Objetivo: Revisar su actividad del trimestre
- Precondiciones: Ser profesional con citas registradas
- Pasos:
- Ir a Listados → Citas
- Seleccionar rango de fechas del trimestre
- Seleccionar solo su nombre en “Profesionales”
- Incluir solo estados “finalizada” y “atendida”
- Clic en “Buscar”
- Revisar número total de citas, distribución por prestación
- Resultado: Reporte de productividad personal del trimestre
-
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:
- Ir a Listados → Pacientes
- Introducir código postal en filtro “CP”
- Clic en “Buscar”
- Revisar estadísticas de pacientes en esa zona
- Resultado: Datos demográficos de pacientes en código postal específico
-
Análisis de No-Presentados por Profesional
- Actor: Administrador
- Objetivo: Identificar profesionales con alta tasa de no-presentados
- Precondiciones: Citas con estados registrados
- Pasos:
- Ir a Listados → Citas
- Seleccionar rango de fechas (último mes)
- En Estados, seleccionar solo “No asiste”
- Dejar profesionales vacío para ver todos
- Clic en “Buscar”
- 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)
- 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)
- 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()
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
-
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
- 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
- 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)
- 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()
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
- 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)
- Buscar (verde) - Ejecuta la búsqueda
- Limpiar (icono borrador) - Resetea filtros
- 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)
- 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
| Campo | Tipo | Obligatorio | Descripción | Validación |
|---|---|---|---|---|
| Entre Fecha | datetime | Sí | Fecha/hora inicial del rango | Debe ser anterior a “y fecha” |
| y fecha | datetime | No | Fecha/hora final del rango | Debe ser posterior a “Entre Fecha” |
| Profesionales | select multiple | No | Profesionales a incluir (vacío = todos) | - |
| Estados | select multiple | No | Estados de cita a incluir (vacío = todos) | - |
| Pagadores | select multiple | No | Pagadores a filtrar (vacío = todos) | - |
| Prestaciones | select multiple | No | Servicios normales a filtrar | - |
| Otros facturables | select multiple | No | Servicios facturables a filtrar | - |
| Centro | select multiple | No | Centros a filtrar (solo multicentro) | - |
| Citas con paciente | radio (SI/NO) | No | Filtrar por existencia de paciente | - |
| Ver datos de paciente | switch (SI/NO) | No | Incluir datos personales en resultados | Default: 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
- Función:
-
Filtro completo (icono lupa +)
- Función:
toggleAppoSummaryFilter(paneId) - Acción: Muestra/oculta fila 2 de filtros avanzados
- Validaciones: Ninguna
- Función:
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
| Campo | Tipo | Obligatorio | Descripción | Validación |
|---|---|---|---|---|
| Centro | select multiple | No | Centros a incluir (solo multicentro) | - |
| Sexo | checkbox group | No | Hombre, Mujer, Otro (vacío = todos) | - |
| Programa | select multiple | No | Programas a filtrar (si existen) | - |
| F. Nac. entre | date | No | Fecha de nacimiento inicial | Debe ser anterior a “y” |
| y | date | No | Fecha de nacimiento final | Debe ser posterior a “entre” |
| CP | text | No | Código postal | - |
| Campos extra | variable | No | Campos personalizados del cliente | Segú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
- Función:
-
Icono calculadora 🧮
- Función:
birthdaycalculator(paneId) - Acción: Abre calculadora para convertir edad en rango de fechas
- Validaciones: Ninguna
- Función:
Workflow 1: Generar Informe de Citas del Mes
- 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
-
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
- 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
- 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
Workflow 4: Campaña de Marketing por Zona Geográfica
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
- 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)
- “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
- Privilegio
LISTS_VIEWconfigurado en Administración → Permisos - Configuración de centros (multicentro) proviene de Administración
- Programas de pacientes configurados en Administració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
- 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
- Reduce el rango de fechas (busca por mes en lugar de por año)
- Selecciona menos profesionales (en lugar de todos)
- Filtra por centro específico (si eres multicentro)
- Selecciona estados específicos (en lugar de todos)
- 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
- Sexo Desconocido: Pacientes sin sexo registrado
- Edad Desconocida: Pacientes sin fecha de nacimiento
- País Desconocido: Pacientes sin país en su dirección
- CITAS: Vista centrada en las citas (estado, pagador, prestación, etc.)
- PROFESIONALES: Vista centrada en los profesionales (estadísticas por profesional)
Listado de Citas
Campos de Búsqueda
| Campo | Tipo | Operador | Descripción |
|---|---|---|---|
| Entre Fecha | datetime | ≥ | Citas con fecha/hora mayor o igual a este valor |
| y fecha | datetime | ≤ | Citas con fecha/hora menor o igual a este valor |
| Profesionales | select multiple | IN | Citas atendidas por estos profesionales (vacío = todos) |
| Estados | select multiple | IN | Citas en estos estados (vacío = todos) |
| Pagadores | select multiple | IN | Citas con estos pagadores (vacío = todos) |
| Prestaciones | select multiple | IN | Citas con estas prestaciones (vacío = todas) |
| Otros facturables | select multiple | IN | Citas con estos facturables (vacío = todos) |
| Centro | select multiple | IN | Citas en estos centros (vacío = todos) |
| Citas con paciente | radio | = | SI: solo con paciente, NO: solo sin paciente, vacío: todas |
Resultados
Sección Resumen:- Total de citas
- Total de pacientes distintos
- 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, %
- Exportar a Excel: Descarga archivo .xlsx con todas las tablas
- Imprimir informe: Genera PDF con todas las tablas
Campos de Búsqueda
| Campo | Tipo | Operador | Descripción |
|---|---|---|---|
| Centro | select multiple | IN | Pacientes de estos centros (vacío = todos) |
| Sexo | checkbox | IN | Hombre, Mujer, Otro (vacío = todos) |
| Programa | select multiple | IN | Pacientes en estos programas (vacío = todos) |
| F. Nac. entre | date | ≥ | Pacientes con fecha de nacimiento ≥ esta fecha |
| y | date | ≤ | Pacientes con fecha de nacimiento ≤ esta fecha |
| CP | text | = | Pacientes con este código postal exacto |
| Campos extra | variable | = o LIKE | Según configuración del campo extra |
Resultados
Sección Resumen:- Total de pacientes
- 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, %
- 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
| Privilegio | Permite |
|---|---|
LISTS_VIEW | Ver 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:-
Acceder al módulo
- En el menú lateral izquierdo, hacer clic en “Listados”
- Seleccionar “Citas”
-
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
-
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
-
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)
-
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?
-
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)
-
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:-
Acceder al módulo
- En el menú lateral, hacer clic en “Listados”
- Seleccionar “Pacientes”
-
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
-
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
-
Ejecutar búsqueda
- Hacer clic en “Buscar”
- El sistema muestra total de pacientes con cumpleaños en ese rango
-
Revisar estadísticas
- Ver distribución por sexo (para personalizar mensaje)
- Ver distribución por edad (útil para ofertas específicas)
-
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
-
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:-
Acceder al módulo
- Ir a “Listados” → “Citas”
-
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
-
Filtrar por estado “No asiste”
- En combo “Estados”, desplegar y seleccionar SOLO “No asiste”
- Importante: Solo marca este estado, desmarca los demás
-
Dejar profesionales vacío
- No seleccionar ningún profesional específico
- Esto permite ver todos en la tabla comparativa
-
Ejecutar búsqueda
- Hacer clic en “Buscar”
- Confirmar diálogo
-
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
-
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
-
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
- Si la tasa es >10%, considerar:

