📄 Reportes

Reporte de Cliente

El Reporte de Cliente es un PDF multipágina generado por el sistema que consolida toda la actividad técnica de un laboratorio cliente en un período de tiempo determinado. Incluye KPIs operacionales, tabla completa de servicios GMP, asistencias técnicas y una ficha detallada por cada equipo.

ℹ️
Generación en el navegador

El PDF se genera íntegramente en el navegador (tecnología jsPDF + html2canvas). No requiere ningún plugin ni descarga adicional. La generación puede tardar entre 5 y 30 segundos dependiendo de la cantidad de equipos y páginas del reporte.

Cómo acceder al Reporte de Cliente

1
Navegá al módulo Equipos (/equipos)

El botón de reporte está en el encabezado del módulo Equipos.

2
Click en el botón "📄 Reportes"

El botón está en la barra de herramientas superior del módulo, junto a los filtros. Se abre el modal de Reporte de Cliente.

Configurar el reporte

El modal de reporte tiene un formulario de selección para definir el alcance del PDF:

CampoObligatorioDescripción
Cliente (Laboratorio)✅ SíLista desplegable de todos los laboratorios activos. El reporte incluirá todos los equipos de ese cliente.
Sector❌ NoSi se selecciona, el reporte se limita a los equipos de ese sector específico dentro del laboratorio.
Fecha de inicio✅ SíInicio del período a reportar. Los servicios con fecha anterior no se incluyen.
Fecha de fin✅ SíFin del período a reportar (inclusive).
💡
Períodos recomendados

Para reportes mensuales: primer y último día del mes. Para reportes anuales: 01/01/AAAA al 31/12/AAAA. Para reportes de calificación: las fechas exactas del período de calificación según el protocolo cliente.

1
Seleccioná el laboratorio cliente

Obligatorio. Filtra todos los datos del reporte a ese cliente.

2
Seleccioná el sector (opcional)

Dejá vacío para incluir todos los sectores del laboratorio.

3
Ingresá las fechas de inicio y fin

El sistema filtra servicios GMP e historial AT/RB cuya fecha de ejecución caiga dentro del rango.

4
Click en "Generar reporte"

El sistema consulta el backend y prepara el HTML del reporte. Aparece un indicador de carga.

Contenido del PDF

El PDF generado tiene una estructura fija de páginas:

PáginaTítuloContenido
Pág. 1 Portada — Resumen ejecutivo Encabezado ION-target, nombre del cliente, período.
KPI cards: total equipos, servicios GMP en período, AT/RB en período, equipos con vencimiento próximo.
Tabla GMP por tipo: cuántos servicios de cada tipo (IQ, OQ, PM, etc.).
Tabla GMP por estado: Finalizado / En Ejecución / Cancelado.
Tabla actividad por equipo: próximo vencimiento con semáforo.
Pág. 2 Servicios GMP del período Tabla completa con todos los servicios GMP del período: número ITS, tipo, equipo, fecha ejecución, fecha vencimiento, estado. Solo aparece si hay registros GMP en el período.
Pág. 3 AT/RB del período Tabla completa con todas las Asistencias Técnicas y Reparaciones de Banco del período: número AT/RB, tipo, equipo, fecha, estado, técnico. Solo aparece si hay registros AT/RB.
Págs. 4+ Ficha técnica por equipo Una página por cada equipo del cliente (o del sector si se filtró).
Incluye: identificación completa del equipo, módulos y consumibles asociados, mini-KPIs del período (servicios ejecutados, AT/RB), próximo vencimiento con semáforo, tabla de servicios GMP del equipo en el período, tabla de AT/RB del equipo.
PÁG. 1 Portada KPIs Resumen PÁG. 2 Servicios GMP si hay registros PÁG. 3 AT / RB del período si hay registros PÁG. 4 Ficha Equipo 1 PÁG. N Ficha Equipo N Una ficha por cada equipo del cliente en el período

Descargar el PDF

1
Después de configurar, click en "Generar y Descargar"

El sistema genera el HTML internamente y lo convierte a PDF página por página.

2
Esperá la generación (5–30 segundos según la cantidad de equipos)

Verás un indicador de progreso. No cierres la ventana durante la generación.

3
El PDF se descarga automáticamente

Se guarda con el nombre: Reporte_[Laboratorio]_[Fecha].pdf en tu carpeta de descargas.

⚠️
No cerrés el modal durante la generación

El PDF se genera en el navegador. Si cerrás el modal o navegás a otra pestaña durante la generación, el proceso puede interrumpirse y tendrás que volver a generarlo.

Enviar el reporte por email

Podés enviar el PDF directamente al cliente desde el mismo modal, sin necesidad de descargarlo primero:

1
Después de generar el PDF, click en "Enviar por correo"

Se abre el modal de envío con el PDF ya adjunto (no se regenera).

2
Verificá o modificá el destinatario

El email del laboratorio cliente se precarga automáticamente desde la ficha del laboratorio. Podés modificarlo.

3
Completá el asunto y mensaje (opcional)

El sistema incluye un mensaje predeterminado. Podés personalizarlo.

4
Click en "Enviar"

El email se envía vía Resend API con el PDF adjunto en base64. El envío queda registrado en el audit trail como evento ENVIO_REPORTE.

ℹ️
Confirmación de envío

Verás un toast de confirmación verde cuando el email se envíe correctamente. Si hay un error (email incorrecto, problema de conexión), aparece un toast rojo con el detalle del error.

⚖️
Trazabilidad del envío

Cada envío de reporte queda registrado en el log de actividad del sistema con: usuario que lo envió, destinatario, fecha/hora y el correlation ID de la operación.


Preguntas frecuentes

El reporte tarda demasiado en generarse+
El tiempo de generación es proporcional a la cantidad de equipos y páginas. Un laboratorio con 5 equipos puede tardar 10 segundos; uno con 20 equipos puede tardar 60 segundos. Si el proceso se demora más de 2 minutos, verificá tu conexión a internet y volvé a intentarlo. No cerrés el modal durante la generación.
El PDF se generó pero algunas páginas aparecen en blanco+
Esto puede ocurrir si hay equipos sin datos en el período seleccionado. Verificá las fechas del período y que los servicios estén registrados con fecha de ejecución dentro del rango. Si el problema persiste, intentá con un período más amplio.
¿Puedo enviar el reporte a más de un destinatario?+
En esta versión, el envío es a un único destinatario. Si necesitás enviar a múltiples personas, descargá el PDF y envialo manualmente desde tu cliente de correo.
El email del laboratorio que aparece en el campo destinatario es incorrecto+
El email se toma de la ficha del laboratorio en el módulo Laboratorios. Pedile a un Administrador que actualice el email del laboratorio en Admin → Laboratorios o modificalo directamente en el campo antes de enviar.
¿Puedo generar el reporte sin incluir el sector?+
Sí. El campo Sector es opcional. Si lo dejás vacío, el reporte incluirá todos los equipos del laboratorio independientemente de su sector. Esto es útil para reportes globales del cliente.
¿Se puede programar el envío automático del reporte?+
El envío automático programado no está disponible en esta versión para el Reporte de Cliente. El sistema sí tiene notificaciones automáticas de vencimientos (configurables en Admin → Notificaciones) pero el Reporte de Cliente es siempre un proceso manual.