# Conciliación Bancaria: dashboard y Reporte Integral [Beta]

El **Dashboard** y el **Reporte Integral** representan el centro de mando del módulo de **Conciliación Bancaria - Recaudos** de **nuby**. Desde aquí puedes supervisar el progreso de los lotes activos de conciliación, retomar procesos guardados como borrador, auditar el histórico de cierres y analizar indicadores de rendimiento contable (KPIs) en tiempo real para mantener el control absoluto de tus cuentas bancarias.

<div class="page-content" dir="auto" id="bkmrk-"><div dir="auto">---

</div></div><p class="callout success">Para navegar esta guía de **nuby**, haz clic sobre la sección que desees consultar. Cada bloque colapsable se expandirá al hacer clic.</p>

<div class="page-content" dir="auto" id="bkmrk-1.-%C2%BFc%C3%B3mo-acceder-al-"><div dir="auto">  <details><summary>1. ¿Cómo acceder al Dashboard y menú de acciones? 🛠️</summary>

#### 🔐 Paso 1. Iniciar sesión

Ingresa a **nuby** con tu usuario y contraseña habituales de la inmobiliaria.

#### 📂 Paso 2. Navegar al módulo

1. En el menú principal, dirígete al módulo de **Contabilidad y Finanzas** o usa el buscador de la barra superior.
2. Selecciona la opción **"Conciliación Bancaria"**.
3. El sistema te dirigirá de forma predeterminada a la pantalla del **Dashboard principal**.

#### 📌 Paso 3. Menú de Acciones Globales (Esquina superior derecha)

En la esquina superior derecha del Dashboard verás una botonera que te permite acceder a las distintas funcionalidades del módulo según tus permisos:

- 📊 **Reporte Integral** → Te lleva a la pantalla de KPIs consolidados donde puedes filtrar registros y exportar datos históricos.
- ⚙️ **Admin Plantillas** → Permite administrar, renombrar o eliminar las plantillas de mapeo de archivos bancarios guardadas por ti o por el equipo.
- ➕ **Nueva Conciliación** → Abre el formulario para seleccionar una cuenta e iniciar un nuevo lote de conciliación subiendo un extracto bancario.

</details>  <details><summary>2. Estructura de la grilla de conciliaciones (Dashboard) 📋</summary>

La tabla principal del Dashboard de **nuby** te muestra el listado ordenado de todos los lotes de conciliación cargados, priorizando los más nuevos en la parte superior. A continuación te explicamos cada columna y sus opciones de filtrado:

#### 🔹 **Pestañas de Filtro Rápido (Cabecera de la tabla)**

Antes de aplicar filtros avanzados, puedes usar las pestañas visuales de la cabecera para aislar rápidamente los lotes por su estado contable general:

- **📝 Borrador** → Muestra únicamente lotes en carga o mapeo inicial.
- **⚙️ En proceso** → Lotes en etapa de conciliación automática o resolución manual (pestaña activa por defecto).
- **✅ Finalizado** → Histórico de lotes cerrados y contabilizados de forma definitiva.
- **❌ Error** → Muestra lotes que sufrieron fallas críticas durante la lectura.
- **Todos** → Lista de todos los registros históricos de carga.

#### 🔹 **Columnas y Filtros Detallados:**

<table style="width: 100%;"><thead><tr><th style="width: 9.5167%;">Columna</th><th style="width: 44.6242%;">Descripción y Tipo de Campo</th><th style="width: 45.8591%;">Filtros y Herramientas</th></tr></thead><tbody><tr><td style="width: 9.5167%;">**ID**</td><td style="width: 44.6242%;">Consecutivo único y secuencial asignado por **nuby** a cada lote subido.</td><td style="width: 45.8591%;">Filtro de búsqueda numérica exacta en la cabecera.</td></tr><tr><td style="width: 9.5167%;">**Fecha de Carga**</td><td style="width: 44.6242%;">Día y hora exacta en la que el lote fue ingresado por el usuario.</td><td style="width: 45.8591%;">Filtro oculto (ordenado de forma predeterminada por fecha descendente).</td></tr><tr><td style="width: 9.5167%;">**Cuenta Bancaria**</td><td style="width: 44.6242%;">Muestra la entidad financiera y el número de cuenta al que corresponde el extracto.</td><td style="width: 45.8591%;">**Selector dropdown** para filtrar rápidamente por una cuenta específica registrada.</td></tr><tr><td style="width: 9.5167%;">**Archivo**</td><td style="width: 44.6242%;">Nombre original del archivo de extracto bancario subido desde tu equipo.</td><td style="width: 45.8591%;">**Smart Search (búsqueda inteligente)** para buscar por palabras clave o extensiones del archivo.</td></tr><tr><td style="width: 9.5167%;">**Progreso**</td><td style="width: 44.6242%;">Barra visual interactiva que representa la cantidad de registros procesados frente al total de filas del extracto.</td><td style="width: 45.8591%;">Muestra la cifra en formato `Procesados / Totales` al lado de la barra de progreso.</td></tr><tr><td style="width: 9.5167%;">**Estado**</td><td style="width: 44.6242%;">Representa el estado operativo del lote mediante etiquetas de colores y emojis (📝 Borrador, ⚙️ En proceso, ✅ Finalizado, ❌ Error).</td><td style="width: 45.8591%;">Selector dropdown integrado para aislar lotes específicos.</td></tr><tr><td style="width: 9.5167%;">**Paso**</td><td style="width: 44.6242%;">Indica la etapa técnica actual del lote dentro de la ruta de conciliación.</td><td style="width: 45.8591%;">Ayuda a identificar rápidamente qué lotes requieren atención y en qué paso exacto se encuentran (ver listado de pasos más abajo).</td></tr><tr><td style="width: 9.5167%;">**Creado por**</td><td style="width: 44.6242%;">Nombre y apellido del usuario de la inmobiliaria que realizó la carga.</td><td style="width: 45.8591%;">Selector dropdown dinámico cargado con los usuarios que han creado lotes.</td></tr></tbody></table>

#### 🔹 **Estados de Paso Detallados:**

La columna **"Paso"** utiliza las siguientes etiquetas del sistema para indicarte en qué parte de la ruta está cada lote de conciliación:

- **Carga** → El archivo se está subiendo o validando inicialmente.
- **Limpieza** → El motor está aislando logos u omitiendo filas vacías.
- **Mapeo** → Pendiente de configurar la correspondencia de columnas (Paso 2).
- **Mapeo OK** → Las columnas están configuradas y confirmadas correctamente.
- **Conciliación** → El motor de coincidencia automática está procesando los cruces.
- **Intervención Manual** → El lote requiere que resuelvas diferencias en la tabla de Discrepancias.
- **Listo para Contabilizar** → Todas las filas están conciliadas u omitidas y listas para el cierre.
- **Contabilizando** → El sistema está generando los recibos de caja y asientos contables en segundo plano.
- **Contabilizado** → Los registros contables oficiales se crearon con éxito.
- **Finalizado** → El proceso concluyó de forma segura y el espacio temporal fue archivado.

</details>  <details><summary>3. Acciones de fila (retomar, visualizar y eliminar) ⚙️</summary>

Al final de cada renglón en la grilla del Dashboard de **nuby**, se muestran botones de acción dinámicos que se adaptan al estado del lote y a los permisos de tu rol:

#### ▶️ Acción 1. Retomar (Icono de Play)

- **Cuándo aparece** → Disponible en lotes con estado **Borrador** o **En proceso**.
- **¿Qué hace?** → Lee el paso actual del lote y te redirige de forma automática a la pantalla exacta de la ruta donde dejaste el proceso (ya sea el Paso 2 de Mapeo de Columnas, Paso 3 de Mapeo de Estados o directamente a la tabla del Paso 5 de Resolución).
- **Por qué es útil** → Permite que múltiples usuarios colaboren o que puedas pausar y reanudar tu conciliación de forma segura sin perder tu progreso de emparejamientos manuales.

#### 👁️ Acción 2. Visualizar / Consultar (Icono de Ojo)

- **Cuándo aparece** → Siempre disponible (según permisos de consulta).
- **¿Qué hace?** → Si el lote está en proceso, te permite ingresar a ver el avance de emparejamientos en modo de **Solo Lectura** (sin poder modificar asociaciones manuales). Si el lote está en estado **Finalizado**, te redirige de forma automática al visor específico de conciliación finalizada, donde puedes consultar los recibos oficiales y asientos contables creados.

#### 🗑️ Acción 3. Eliminar (Icono de Papelera)

- **Cuándo aparece** → Disponible únicamente si posees permisos de eliminación y el lote se encuentra en estado **Borrador**, **En proceso** o **Error**.
- **¿Qué hace?** → Elimina por completo el lote temporal de tus borradores de trabajo. Al hacer clic, el sistema te solicitará confirmación mediante el mensaje: *"¿Estás seguro de que deseas eliminar esta conciliación? Esta acción no se puede deshacer."*
- **Importante:** Eliminar un lote en borrador **no altera los saldos de tus facturas ni elimina documentos contables reales**, ya que toda la operación en esta etapa es un borrador preliminar. Es seguro de ejecutar si subiste un extracto incorrecto por error.

</details>  <details><summary>4. El Reporte Integral (Análisis de KPIs y métricas) 📊</summary>

Al hacer clic en el botón **"Reporte Integral"** en la cabecera del Dashboard, accederás a un panel de analítica avanzada que consolida el rendimiento contable de todas tus operaciones bancarias en **nuby**. Este panel se divide en dos secciones principales:

#### 📊 Sección A: Las Tarjetas de KPIs Consolidados

Estas tarjetas inteligentes se calculan de forma instantánea aplicando los filtros activos y te muestran el desglose de montos y registros del sistema:

1. 🏢 **Total Conciliaciones** → Muestra la cantidad total de lotes e indica cuántos registros o filas individuales de extractos bancarios han sido procesados por la inmobiliaria en total.
2. 🏆 **Emparejamiento Automático** → Muestra el porcentaje (`%`) promedio de éxito del motor inteligente de **nuby**. Te indica cuántos de esos cientos de registros se emparejaron automáticamente por coincidencia exacta en las primeras pasadas sin requerir intervención del usuario.
3. 💰 **Cierre Real** → Representa el monto monetario total y la cantidad de filas que fueron **efectivamente contabilizadas** y oficializadas en bloque hacia las cuentas contables definitivas desde este módulo.
4. 🤝 **Preexistencia Confirmada** → Indica la cantidad de transacciones y el monto asociado que correspondían a cobros, egresos o documentos que ya habían sido conciliados o registrados mediante otros flujos tradicionales del sistema, confirmando su coincidencia de manera segura.
5. 🕒 **Listo para Contabilizar** → Detalla el valor monetario y número de registros que ya fueron emparejados (manual o automáticamente) y están en borrador, listos para que apliques la acción masiva de contabilización.
6. ⚠️ **Pendiente de Resolución** → El monto total y número de filas activas que están sin emparejar, con diferencias o marcadas como discrepancias sin resolver en tus espacios de trabajo de borrador.
7. 📁 **Omitidos** → El acumulado de dinero y registros que los usuarios decidieron marcar como ignorados o apartados del proceso operativo por tratarse de traslados, duplicados o transacciones ajenas al recaudo de cartera.
8. 🔍 **Diferencias Detectadas** → La cantidad total de registros en el sistema que presentan discrepancias de montos (menores o mayores valores recibidos) o discrepancias de concepto bancario frente al documento del sistema.
9. 🚨 **Errores de Contabilización** → Cantidad de filas que, al intentar realizar el cierre masivo, sufrieron algún rechazo (por ejemplo, porque la factura fue pagada en otro módulo en el mismo instante o hubo un bloqueo de cuenta contable), permitiéndote identificarlas y reintentar su procesamiento de forma quirúrgica.

#### 📋 Sección B: Detalle Consolidado de Registros

Debajo de los KPIs verás una grilla unificada que lista las transacciones individuales conciliadas. Desde cada renglón puedes:

- Consultar el lote de origen de la transacción.
- Ver el tercero y el documento asociado (factura, recibo, egreso) mediante enlaces directos a sus respectivos módulos para facilitar labores de auditoría.
- Exportar los datos consolidados en bloque para reportes externos.

</details>  <details><summary>5. Solución de problemas frecuentes 🔍</summary>

<table><thead><tr><th>Problema en el Dashboard</th><th>Posible causa</th><th>Cómo solucionarlo en nuby</th></tr></thead><tbody><tr><td>**Al ingresar aparece una pantalla en blanco o alerta de "No tienes permisos"**</td><td>Tu rol de usuario tiene permisos restringidos y no posee acceso al módulo de Conciliaciones.</td><td>Solicita al administrador del sistema que te otorgue permisos de visualización (`access` / `view`) para habilitar el Dashboard.</td></tr><tr><td>**El botón de "Eliminar" (Papelera) no aparece en una fila**</td><td>El lote ya se encuentra en estado **Finalizado** o está en proceso asíncrono de contabilización masiva.</td><td>Por seguridad contable, los lotes ya finalizados son históricos permanentes y no pueden eliminarse bajo ninguna circunstancia.</td></tr><tr><td>**Un lote lleva mucho tiempo en paso "Contabilizando"**</td><td>El lote es sumamente grande y el motor asíncrono lo está procesando en segundo plano, o hubo una pausa temporal del servicio de colas.</td><td>Puedes navegar por otros módulos de **nuby** o refrescar el Dashboard después de unos minutos. Si persiste por horas, notifica al administrador de sistemas para verificar el servicio de colas de fondo (Supervisor/Redis).</td></tr><tr><td>**Un lote tiene estado "Error" y paso "Carga" o "Limpieza"**</td><td>El archivo bancario presentaba fallas estructurales graves de lectura (caracteres corruptos o celdas dañadas) que detuvieron la carga masiva.</td><td>Elimina el lote con el botón de la papelera, abre tu archivo de extracto en Excel, verifica que no tenga filas completamente corruptas y vuelve a iniciar la carga.</td></tr><tr><td>**Los KPIs del Reporte Integral no muestran datos del mes actual**</td><td>Los filtros de fecha o cuenta bancaria en la cabecera no incluyen el período de tiempo deseado.</td><td>Verifica y ajusta los campos de filtros de fecha y cuenta en el panel del Reporte Integral para actualizar los KPIs de forma instantánea.</td></tr></tbody></table>

</details>  </div></div><p class="callout info">**Ruta de Aprendizaje recomendada:** Explora cada paso del módulo de Conciliación Bancaria en **nuby** mediante nuestros manuales detallados:</p>

<div class="page-content" dir="auto" id="bkmrk-consulte-la-gu%C3%ADa-de-"><div dir="auto">- Consulte la guía de introducción global: [ *<span class="tw-font-bold tw-text-arrBlue hover:tw-text-nubyBlue tw-cursor-pointer">Conciliación Bancaria: Capítulo Principal</span>* ](https://docs.nuby.ai/books/finanzas/chapter/conciliacion-bancaria)
- Consulte la guía de carga inicial: [ *<span class="tw-font-bold tw-text-arrBlue hover:tw-text-nubyBlue tw-cursor-pointer">Conciliación Bancaria: Paso 1, cargar archivo</span>* ](https://docs.nuby.ai/books/finanzas/page/conciliacion-bancaria-paso-1-cargar-archivo-beta)
- Consulte la guía de correspondencia de archivos: [ *<span class="tw-font-bold tw-text-arrBlue hover:tw-text-nubyBlue tw-cursor-pointer">Conciliación Bancaria: Paso 2, mapeo de columnas</span>* ](https://docs.nuby.ai/books/finanzas/page/conciliacion-bancaria-paso-2-mapeo-de-columnas-beta)
- Consulte la guía de parametrización de estados bancarios: [ *<span class="tw-font-bold tw-text-arrBlue hover:tw-text-nubyBlue tw-cursor-pointer">Conciliación Bancaria: Paso 3, mapeo de estados</span>* ](https://docs.nuby.ai/books/finanzas/page/conciliacion-bancaria-paso-3-mapeo-de-estados-beta)
- Consulte la guía de indicadores de carga: [ *<span class="tw-font-bold tw-text-arrBlue hover:tw-text-nubyBlue tw-cursor-pointer">Conciliación Bancaria: Paso 4, resultado del cargue</span>* ](https://docs.nuby.ai/books/finanzas/page/conciliacion-bancaria-paso-4-resultado-del-cargue-beta)
- Consulte la guía de operación manual de discrepancias: [ *<span class="tw-font-bold tw-text-arrBlue hover:tw-text-nubyBlue tw-cursor-pointer">Conciliación Bancaria: Paso 5, resolución</span>* ](https://docs.nuby.ai/books/finanzas/page/conciliacion-bancaria-paso-5-resolucion-beta)

</div></div>