> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nubidoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Listados

> Informes y estadísticas

### 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.

### Quién puede utilizarlo

* **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)

### Tareas habituales

1. **Análisis de Actividad Mensual**
   Un administrador puede obtener las estadísticas del mes cuando hay citas registradas en el periodo.
   * **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
        El Excel resultante desglosa las estadísticas del mes por las dimensiones disponibles.

2. **Análisis Demográfico de Pacientes**
   Un usuario autorizado puede analizar el perfil demográfico de los pacientes registrados para preparar campañas dirigidas.
   * **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
        El informe resume la distribución demográfica de los pacientes que cumplen los filtros.

3. **Control de Productividad de Profesional**
   Un profesional con citas registradas puede revisar su actividad del trimestre.
   * **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
        El resultado muestra la actividad del profesional durante el periodo seleccionado.

4. **Identificar Pacientes por Código Postal para Campaña Local**
   El personal autorizado puede analizar una zona concreta cuando los pacientes tienen su 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
        El resultado resume los datos demográficos de los pacientes del código postal indicado.

5. **Análisis de No-Presentados por Profesional**
   Un administrador puede comparar los no-presentados por profesional cuando las citas tienen su estado actualizado.
   * **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"
        El resultado permite identificar qué profesionales concentran más citas con el estado "No asiste".

***

### Opciones del Menú

#### Opción 1: Citas

* **Descripción:** Genera estadísticas agregadas de citas con múltiples filtros y dimensiones de análisis
* **Acceso:** Disponible para los usuarios cuyo rol permite consultar listados
* **Icono:** 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

* **Descripción:** Genera estadísticas demográficas y de distribución de pacientes
* **Acceso:** Disponible para los usuarios cuyo rol permite consultar listados
* **Icono:** 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)
* Pacientes por cada lista de campos extra con estadística activada (el título de la tabla es el nombre de la lista, ej: Procedencia): una fila por valor — los valores eliminados de la configuración siguen contando y se muestran con el sufijo "(eliminada)" — más la fila "Desconocida" con los pacientes sin valor

#### Opción 3: Diagnósticos

* **Descripción:** Genera estadísticas de diagnósticos
* **Icono:** lupa
* **Nota:** Solo aparece cuando la funcionalidad de diagnósticos está disponible para el centro

***

### Pantalla 1: Listado de Citas

#### 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 (selector que permite elegir uno o varios)
  * Estados (selector con programada, confirmada, en sala, finalizada, no asiste, cancelada, etc.)

* **Fila 2 (desplegable con botón "+" de filtro completo):**
  * Pagadores (selector de PRIVADO, aseguradoras y 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:** Opción SI/NO para mostrar datos personales en los resultados

**3. Botones de Acción**

* **Buscar** (verde) - Ejecuta la búsqueda con los filtros seleccionados
* **Limpiar** (icono borrador) - Restablece todos los filtros
* **Filtro completo** (icono lupa +) - Muestra/oculta fila 2 de filtros avanzados

**4. Área de Resultados (tras buscar)**

* **Resumen:** total de citas y total de pacientes distintos
* **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:** Restablece el formulario
* **Filtro completo:** Muestra u oculta los 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
* **Pestañas CITAS/PROFESIONALES:** Permiten ver los mismos datos desde dos perspectivas diferentes
* **Fecha inicial:** El campo "Entre Fecha" muestra inicialmente el primer día del mes actual
* **Un informe cada vez:** solo puede haber un informe de Listados calculándose por clínica. Si se lanza otro mientras tanto, aparece el aviso "Ya hay un informe en curso para esta cuenta. Espere a que termine antes de lanzar otro." y el que ya estaba en marcha continúa sin verse afectado

***

### Pantalla 2: Listado de Pacientes

#### 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:** Selector de uno o varios centros (solo si es multicentro)
* **Sexo:** Casillas de selección (Hombre, Mujer, Otro)
* **Programa:** Selector de uno o varios programas (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 disponibles en el centro

**3. Botones de Acción**

* **Buscar** (verde) - Ejecuta la búsqueda
* **Limpiar** (icono borrador) - Restablece los filtros

**4. Área de Resultados (tras buscar)**

* **Resumen:** total de pacientes encontrados
* **Estadísticas (gráfico y tabla):** Cada estadística se muestra como un gráfico circular acompañado de su tabla de datos:
  * 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)
  * Pacientes por cada lista de campos extra con estadística (ej: Procedencia): incluye los valores eliminados de la configuración con el sufijo "(eliminada)" y la fila "Desconocida" (pacientes sin valor), de modo que, en listas de un único valor por paciente, la tabla suma el total de pacientes de la búsqueda (si un paciente tiene varios valores de la misma lista, cuenta una vez por cada valor)
* **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)
* **Un informe cada vez:** igual que en Citas, solo puede haber un informe de Listados calculándose por clínica. Este listado revisa todos los pacientes del centro, así que en clínicas grandes puede tardar varios minutos

***

### Formulario: Búsqueda de Citas

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

#### Campos del Formulario

| Campo                 | Obligatorio | Descripción                                                                 |
| --------------------- | ----------- | --------------------------------------------------------------------------- |
| Entre Fecha           | Sí          | Fecha y hora iniciales del rango; deben ser anteriores a la fecha final     |
| y fecha               | No          | Fecha y hora finales del rango                                              |
| Profesionales         | No          | Profesionales a incluir; si se deja vacío, se incluyen todos                |
| Estados               | No          | Estados de cita a incluir; si se deja vacío, se incluyen todos              |
| Pagadores             | No          | Pagadores que se quieren analizar                                           |
| Prestaciones          | No          | Prestaciones que se quieren analizar                                        |
| Otros facturables     | No          | Otros conceptos facturables que se quieren analizar                         |
| Centro                | No          | Centros que se quieren incluir; solo aparece en configuraciones multicentro |
| Citas con paciente    | No          | Permite mostrar solo citas con paciente o solo citas sin paciente           |
| Ver datos de paciente | No          | Incluye datos personales en los resultados; está desactivado inicialmente   |

#### Botones y Acciones

* **Buscar**
  * Genera las estadísticas con los filtros aplicados.
  * Comprueba que la fecha inicial sea anterior a la fecha final y avisa si la selección puede producir muchos resultados.

* **Limpiar** (icono borrador)
  * Restablece los campos del formulario.

* **Filtro completo** (icono lupa +)
  * Muestra u oculta los filtros avanzados.

***

### Formulario: Búsqueda de Pacientes

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

#### Campos del Formulario

| Campo         | Obligatorio | Descripción                                                     |
| ------------- | ----------- | --------------------------------------------------------------- |
| Centro        | No          | Centros a incluir; solo aparece en configuraciones multicentro  |
| Sexo          | No          | Hombre, Mujer u Otro; si se deja vacío, se incluyen todos       |
| Programa      | No          | Programas que se quieren incluir, cuando estén disponibles      |
| F. Nac. entre | No          | Fecha de nacimiento inicial; debe ser anterior a la fecha final |
| y             | No          | Fecha de nacimiento final                                       |
| CP            | No          | Código postal                                                   |
| Campos extra  | No          | Campos personalizados disponibles en el centro                  |

#### Botones y Acciones

* **Buscar**
  * Genera las estadísticas demográficas con los filtros aplicados.

* **Limpiar** (icono borrador)
  * Limpia todos los campos.

* **Icono pastel** 🎂
  * Establece el rango de fechas para buscar los cumpleaños del día actual.

* **Icono calculadora** 🧮
  * Abre la calculadora que convierte una edad en un rango de fechas de nacimiento.

***

### Flujo 1: Generar Informe de Citas del Mes

```
1. Usuario accede a Listados → Citas
   ↓
2. El formulario muestra como fecha inicial el primer día del mes actual
   ↓
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 el usuario quiere ver datos de paciente: Activa "Ver datos de paciente" antes de buscar
* Si la búsqueda supera el tiempo permitido, el sistema muestra un aviso y el usuario debe acotar los filtros

**Errores comunes:**

* **Error:** "El proceso tardó más de 5 minutos"
  * **Causa:** La selección incluye demasiados resultados
  * **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

***

### Flujo 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 la opción "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"

***

### Flujo 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
```

***

### Flujo 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:**

* Los listados usan la información registrada en el 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:**

* Los roles con acceso a Listados se configuran en Administración
* 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

### Antes de empezar

Para utilizar Listados:

* **Módulo Agenda:** Para tener citas que analizar
* **Módulo Pacientes:** Para tener pacientes que analizar
* **Configuración de permisos:** El rol del usuario debe permitir consultar Listados
* **Servicios configurados:** Para análisis por prestaciones

***

### Separación de datos por centro

Cada organización solo puede consultar sus propios datos. Los listados no mezclan información de organizaciones distintas.

### Búsquedas con muchos resultados

Una búsqueda con pocos filtros puede tardar varios minutos. Nubidoc avisa antes de ejecutarla y, si supera el tiempo permitido, pide acotar la selección.

### Fecha inicial de las citas

Al abrir **Listados → Citas**, el campo "Entre Fecha" muestra inicialmente el primer día del mes actual. Puede modificarlo antes de buscar.

### Privacidad de los datos del paciente

En los listados de citas, la opción "Ver datos de paciente" controla la inclusión de datos personales. Si está en NO, no se muestran nombres ni otros datos personales; actívela solo cuando sean necesarios.

### Cálculo de porcentajes

Las tablas estadísticas muestran la cantidad de cada categoría y su porcentaje sobre el total, redondeado a dos decimales.

### Filtros vacíos

Si un filtro admite varias opciones y queda vacío, Nubidoc incluye todos los valores. Por ejemplo, dejar "Profesionales" o "Estados" vacío incluye a todos los profesionales o estados.

***

### Mensajes de Éxito

* **Número total de citas que cumplen el criterio de selección:** indica cuántas citas cumplen los filtros.

* **Número total de pacientes distintos en la selección:** indica cuántos pacientes únicos hay; un paciente puede tener varias citas.

* **Número total de pacientes que cumplen el criterio de selección:** indica cuántos pacientes cumplen los 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

## Preguntas Frecuentes

**Q: ¿Cómo saco e imprimo las comisiones de un doctor al final del mes?**
A: En **Listados → Citas**, pon el rango del mes y pulsa **Buscar**. En la tarjeta del profesional aparece el botón **ver comisiones**, que abre la tabla **Comisiones de usuario según filtro** (Paciente, Fecha, Prestación/es, Estado, Importe total, Importe cobrado, Comisión y Porcentaje) con una fila **TOTALES** y un botón **Imprimir**. Necesitas que tu centro tenga activadas y configuradas las comisiones Centro → Profesional; si no, ni la tabla ni el botón aparecen.

**Q: En "ver comisiones", ¿puedo listar solo las citas que ya están cobradas?**
A: No: esa tabla lista **todas** las citas del mes, cobradas y no cobradas (la columna **Importe cobrado** de cada línea te permite distinguirlas), y no se puede exportar a Excel. Si necesitas acotar a lo cobrado, ve a **Agenda → Buscar citas**, despliega los filtros con la lupa "+" y usa **Fecha pago entre fecha** con el rango del mes: la tabla trae la columna **C.Prof** con la comisión del profesional, suma los totales en el pie y el botón **Exportar** genera un Excel con la columna **Comisión profesional**.

**Q: Filtro por "Fecha pago entre fecha" y me falta parte de la comisión del mes. ¿Por qué?**
A: Casi seguro es la **hora** del último día. Esos campos son de fecha **y hora**, y el filtro compara con el instante exacto: si dejas el último día del mes a las **00:00**, se quedan fuera todos los cobros de ese día. Pon el primer día a las **00:00** y el último a las **23:59** (por ejemplo, `01/06/2026 00:00` y `30/06/2026 23:59`).

**Q: ¿La comisión se reduce si la cita se ha cobrado solo en parte?**
A: No. La comisión que ves es la comisión íntegra de la cita, calculada a partir de sus prestaciones: **no se reparte en proporción a lo cobrado**. Una cita con 30 € de comisión que se ha cobrado a medias sigue apareciendo con 30 €.

**Q: ¿Por qué el botón "Buscar" me pide confirmación en Listados de Citas?**
A: El sistema advierte que una selección amplia puede tardar varios minutos. Puede continuar o acotar los filtros para obtener el resultado más rápido.

**Q: Me sale "Ya hay un informe en curso para esta cuenta". ¿Qué significa?**
A: Que alguien de su clínica está sacando ya un informe de Listados y aún no ha terminado. Solo puede calcularse uno a la vez por clínica, así que el suyo no se ha ejecutado; espere a que acabe el primero y vuelva a pulsar **Buscar**. Tenga en cuenta que **el límite es por clínica, no por usuario**: puede tocarle esperar aunque sea otra persona, en otro ordenador, quien esté sacando el informe. No hay que esperar ningún tiempo extra: en cuanto el primero termina, el siguiente ya se puede lanzar. Mientras tanto el resto del programa funciona con normalidad (fichas, agenda, citas de un paciente). Si el aviso le aparece a menudo, es señal de que los informes de su centro tardan demasiado: acote el rango de fechas o añada filtros (profesional, centro, estado) y se calcularán mucho antes.

**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: El listado de pacientes permite exportar a PDF mediante **Imprimir informe**. El listado de citas ofrece Excel y PDF. Para obtener pacientes en Excel, utilice **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é hace la opción "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 cuando esta funcionalidad está disponible para el centro

**Q: ¿Puedo guardar mis filtros favoritos para reutilizarlos?**
A: No se pueden guardar filtros favoritos. Cada vez que abra Listados deberá configurarlos de nuevo; **Entre Fecha** muestra inicialmente el 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
* **"Desconocida" en una lista de campos extra (ej: Procedencia)**: Pacientes sin ningún valor asignado en esa lista

Es normal tener un pequeño porcentaje en "Desconocido", pero si es alto, indica que falta completar datos en las fichas de pacientes.

**Q: ¿Por qué una fila de la tabla de Procedencia lleva el sufijo "(eliminada)"?**
A: Ese valor se eliminó de la configuración de la lista: ya no se puede seleccionar en las fichas ni aparece en el desplegable del filtro, pero los pacientes que lo tenían asignado lo conservan, así que siguen contando en la estadística con esa fila diferenciada. Gracias a esto, en listas de un único valor por paciente la tabla suma el total de pacientes de la búsqueda (si un paciente tiene varios valores de la misma lista, cuenta una vez por cada valor). Si no quieres ver esa fila, reasigna en la ficha de esos pacientes un valor activo de la lista.

**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

Al generar listados, el botón **Buscar** cambia a **Buscando...** y queda deshabilitado mientras se calculan y cargan las tablas de resultados. En listados pesados, espere a que el botón vuelva a su estado normal antes de lanzar otra consulta.

#### Campos de Búsqueda

| Campo              | Descripción                                                                |
| ------------------ | -------------------------------------------------------------------------- |
| Entre Fecha        | Incluye citas desde esta fecha y hora                                      |
| y fecha            | Incluye citas hasta esta fecha y hora                                      |
| Profesionales      | Citas atendidas por los profesionales seleccionados; vacío incluye a todos |
| Estados            | Citas en los estados seleccionados; vacío incluye todos los estados        |
| Pagadores          | Citas de los pagadores seleccionados; vacío incluye todos los pagadores    |
| Prestaciones       | Citas con las prestaciones seleccionadas; vacío incluye todas              |
| Otros facturables  | Citas con los conceptos seleccionados; vacío incluye todos                 |
| Centro             | Citas de los centros seleccionados; vacío incluye todos                    |
| Citas con paciente | Permite mostrar solo citas con paciente, solo citas sin paciente 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

| Campo         | Descripción                                                      |
| ------------- | ---------------------------------------------------------------- |
| Centro        | Pacientes de los centros seleccionados; vacío incluye todos      |
| Sexo          | Hombre, Mujer u Otro; vacío incluye todos                        |
| Programa      | Pacientes de los programas seleccionados; vacío incluye todos    |
| F. Nac. entre | Fecha de nacimiento inicial                                      |
| y             | Fecha de nacimiento final                                        |
| CP            | Pacientes con el código postal indicado                          |
| Campos extra  | Criterios disponibles según los campos personalizados del centro |

#### 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, %
* **Pacientes por cada lista de campos extra con estadística:** Valor (columna), Cantidad, % — los valores eliminados aparecen con el sufijo "(eliminada)" y los pacientes sin valor en la fila "Desconocida"

**Acciones sobre resultados:**

* **Imprimir informe:** Genera PDF con todas las tablas

***

### Iconos Principales

* 🔍 - Búsqueda / Listados
* 📊 - Estadísticas (icono del módulo)
* 📅 - Citas
* 👥 - Pacientes
* 📄 - Exportar a Excel
* 🖨️ - Imprimir informe
* 🧹 - Limpiar filtros
* 🔍+ - Mostrar filtro completo
* 🎂 - Cumpleaños del día
* 🧮 - Calculadora de edad

### Colores en Tablas

* **Encabezado de tablas:** Fondo gris claro
* **Filas pares:** Blanco
* **Filas impares:** Gris muy claro para mejorar la legibilidad
* **Totales:** Negrita para resaltar

### Distribución de la pantalla

* **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

Los usuarios cuyo rol permite consultar Listados pueden abrir el módulo y generar los informes disponibles. Si el rol no tiene ese permiso, Listados no aparece en el menú.

### Restricciones

* **Separación de datos:** Los usuarios solo ven estadísticas de la organización y los centros a los que tienen acceso
* **Sin permiso de consulta:** El módulo Listados no aparece en el menú lateral
* **Datos de paciente protegidos:** La opción "Ver datos de paciente" controla la visibilidad de los datos personales
* **Límite de 5 minutos:** Las búsquedas que excedan este tiempo se cancelan y deben repetirse con filtros más acotados

***

### 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`

***

### Opciones que pueden aparecer

* **Diagnósticos:** La opción aparece cuando el centro tiene habilitada esta funcionalidad.
* **Centro:** El filtro aparece en configuraciones multicentro.
* **Citas con paciente:** El filtro aparece cuando el centro permite citas sin paciente asignado.
* **Programa:** El filtro aparece cuando hay programas configurados.
* **Campos personalizados:** Los campos de paciente configurados para usarse como filtros aparecen en la búsqueda de pacientes.

***

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

**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**
   * Revisar el total de citas del resumen
   * 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

**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

**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 "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
