# Guía de prueba — Demo Conciliación Bancaria con IA > ⚠️ **DESACTUALIZADA — describe la demo con datos simulados (mock).** El módulo ya es real. > Usá **`guia-demo-conciliacion-bancaria-ia-REAL.md`**. > Guía para **mostrar y probar** la demo de Conciliación Bancaria con IA dentro del ERP. > La demo funciona con **datos de ejemplo (fake)**: no necesita configuración, no toca la > base de datos real y no depende de que la empresa use otros módulos. Sirve para que el > cliente vea, en vivo, cómo funcionaría la conciliación bancaria automática. --- ## 1. Antes de empezar - **Tener el sistema abierto y con sesión iniciada** (cualquier usuario logueado lo ve). - No hace falta cargar nada ni configurar cuentas: los datos ya están simulados. - Ideal mostrarlo en pantalla completa o proyectado. > 💡 **Mensaje para transmitir al cliente:** hoy la conciliación bancaria se hace a mano, > comparando el extracto del banco contra la planilla propia, línea por línea. Esta > herramienta lo hace **automáticamente**, aceptando los archivos **en cualquier formato** > (Excel, Word, PDF, TXT o CSV), y entrega un documento listo para el contador o la gerencia. ### Archivos de prueba (ya preparados) Hay un set de archivos listos para usar en la demo, en la carpeta del frontend **`novasispy-erp/demo-conciliacion/`** (ver su `LEEME.md`). Coinciden con lo que la demo muestra, así que la historia cierra si el cliente los abre. **Lado “Mis movimientos”** (elegí uno para mostrar distintos formatos): | Archivo | Formato | Para mostrar… | |---|---|---| | `mis-movimientos.xlsx` | Excel | El caso típico: planilla propia. | | `mis-movimientos.doc` | Word | “También acepta Word.” | | `mis-movimientos.txt` | Texto libre | El “wow”: un libro banco escrito a mano, sin columnas. | **Lado “Extracto del banco”:** | Archivo | Formato | Para mostrar… | |---|---|---| | `extracto-bnf.pdf` | PDF | El extracto oficial del banco (lo más común). | | `extracto-bnf.csv` | CSV | Export del homebanking. | > El Excel y el PDF son archivos **reales** (se abren en Excel / Acrobat). El `.txt` narrativo > es el más efectista para el “wow” de la IA. --- ## 2. Cómo abrir la demo 1. En el **menú lateral izquierdo**, hacer clic en **“Conciliación IA”** (ícono de lupa, cerca de *Tesorería*). 2. Se abre la pantalla principal con: - Un título y una breve explicación. - Una guía desplegable **“¿Cómo funciona?”**. - El **historial de conciliaciones** (dos ejemplos ya cargados). - El botón **“Nueva conciliación”** (arriba a la derecha). **✅ Qué verificar:** la pantalla carga sin errores y se ven las dos conciliaciones de ejemplo (una *BNF – 93% conciliado – Finalizada* y una *Ueno – Pendiente de conciliar*). --- ## 3. Recorrido completo (paso a paso) ### Paso 0 — Iniciar una conciliación nueva - Hacer clic en **“Nueva conciliación”**. - Se abre un asistente de **3 pasos** (se ve la barra de pasos arriba). ### Paso 1 — Datos de la cuenta - Completar: - **Nombre de la cuenta**: por ejemplo `BNF Cta. Cte. Principal` (texto libre). - **Banco**: es un **selector con buscador** — escribís y filtra la lista de bancos de Paraguay (BNF, Continental, Itaú, Sudameris, Ueno, etc.). También podés escribir uno nuevo. - **Moneda**: Guaraníes (PYG). - **Período desde / hasta**: viene precargado (abril 2026), se puede dejar así. - Hacer clic en **“Continuar”**. **✅ Qué verificar:** el botón *Continuar* se habilita al poner el nombre de la cuenta. > 💬 **Punto a destacar:** la cuenta es de **texto libre** — no requiere tener el módulo de > Tesorería configurado. Funciona incluso para empresas que hoy llevan todo en Excel. ### Paso 2 — Subir los dos archivos - Hay dos zonas de carga: - **“Mis movimientos”** (lo que la empresa tiene: Excel, Word, PDF, TXT o CSV). - **“Extracto del banco”** (PDF, Excel o CSV). - Hacer clic en **“Seleccionar archivo”** en cada una y elegir **cualquier archivo** de ejemplo (la demo no lee el archivo real: simula la interpretación). - Al seleccionar cada uno: - Aparece un **spinner “Interpretando con IA…”** (unos segundos). - Luego muestra **“N movimientos detectados”** y, si corresponde, un aviso de líneas de **baja confianza** para revisar. - Cuando **ambos** archivos estén cargados, hacer clic en **“Continuar”**. **✅ Qué verificar:** - Se ve el spinner de “Interpretando con IA…” en cada carga. - Cada zona queda en verde con la cantidad de movimientos detectados. - El botón *Continuar* se habilita solo cuando los **dos** archivos están cargados. > 💬 **Punto a destacar:** la IA interpreta el contenido **aunque el archivo no tenga > columnas prolijas**. El usuario no tiene que dar formato ni ordenar nada. ### Paso 3 — Conciliar y ver el resultado - Se muestra un resumen (“Todo listo para conciliar: X movimientos tuyos contra Y del banco”). - Hacer clic en **“Conciliar automáticamente”**. - Tras unos segundos aparece el **resultado**: - Una barra con el **porcentaje conciliado** (≈ **78%**). - Cuatro tarjetas: **Conciliadas**, **Pendientes (mis registros)**, **Pendientes (banco)**, **Con diferencia**. - **Pestañas** con el detalle: - **Conciliadas**: pares cruzados con importe propio, importe del banco y diferencia. - **Pendientes · mis registros**: por ejemplo un cheque emitido aún no cobrado. - **Pendientes · banco**: por ejemplo comisión bancaria, ITF e intereses que el banco cobró/acreditó y la empresa no tenía registrados. - **Cada fila pendiente o con diferencia tiene un botón de acción** (columna "Acción"): se resuelven desde la misma pantalla (ver sección 8). No es solo un reporte. **✅ Qué verificar:** - El porcentaje conciliado aparece y la barra se llena. - En **Conciliadas**, las diferencias por comisión se muestran resaltadas. - En los pendientes del banco aparecen conceptos típicos (comisión, ITF, intereses). - Al usar los botones de acción, la fila se mueve y el porcentaje sube en vivo. > 💬 **Punto a destacar:** el sistema **no inventa** conciliaciones. Lo que no cruza con > seguridad queda separado y marcado para revisión manual — transparencia total. --- ## 4. Descargar el documento de resultado En la pantalla de resultado hay dos botones: - **“Ver / Descargar PDF”** → abre un **modal con la vista previa** del documento ejecutivo (resumen + tablas) y, desde ahí, el botón para **descargarlo**. Ideal para entregar a gerencia o al contador. El PDF refleja el **estado actual** (después de resolver acciones). - **“Descargar Excel”** → baja una planilla con las secciones (conciliadas, pendientes de cada lado) para trabajar el detalle. **✅ Qué verificar:** el PDF se previsualiza en el modal y se descarga; el Excel se abre bien. > 💬 **Punto a destacar:** al final del proceso el usuario tiene un **entregable listo**, > sin armar nada a mano. --- ## 5. Cerrar el recorrido - Hacer clic en **“Finalizar sesión”**. - Vuelve al historial, ahora con la conciliación recién hecha agregada y su porcentaje. --- ## 6. Guion sugerido (versión corta para la reunión) 1. “Hoy conciliar el banco es manual y lento.” → abrir **Conciliación IA**. 2. “Subo mis movimientos y el extracto, en el formato que sea.” → **Paso 2**, mostrar el *“Interpretando con IA…”*. 3. “El sistema los cruza solo.” → **Conciliar automáticamente** → mostrar el **78%**. 4. “Lo que no cruza, queda marcado para revisar — nada se concilia a ciegas.” → pestañas de pendientes. 5. “Y me llevo el informe listo.” → **Descargar PDF**. 6. **Cierre potente (opcional):** repetir la conciliación subiendo el extracto **`extracto-bnf-CON-ERRORES`** para mostrar cómo detecta diferencias (ver sección 8). 7. Cierre: “Esto es una demostración con datos de ejemplo. Si les sirve, lo dejamos funcionando con sus archivos y cuentas reales.” --- ## 7. Preguntas frecuentes durante la demo | Pregunta del cliente | Respuesta | |---|---| | ¿Necesito cargar todo en el sistema antes? | No. Se suben dos archivos y listo; sirve aunque hoy usen solo Excel. | | ¿Qué formatos acepta? | Excel, Word, PDF, TXT y CSV en ambos lados. | | ¿Y si un archivo está desordenado o es una foto/escaneo con texto? | La IA lo interpreta igual; las líneas dudosas se marcan para revisar. | | ¿Puede equivocarse? | Solo cruza lo que coincide con seguridad (monto, tipo y fecha). El resto lo deja pendiente para revisión manual. | | ¿Y qué hago con los pendientes y las diferencias? | No es solo un reporte: cada línea tiene su **acción**. En un pendiente del banco (comisión, ITF, débito) tocás **“Registrar”** y queda cargado y conciliado. En una partida propia (cheque no cobrado) la marcás **“En tránsito”** para vigilarla. En una conciliada con diferencia tocás **“Registrar dif.”** para cargar la comisión. Cada acción sube el % en vivo. | | ¿Los datos de la demo son reales? | No, son de ejemplo. En la versión real trabaja con sus movimientos y extractos. | --- ## 8. Variante “con errores a propósito” (cierre potente) Sirve para mostrar que el sistema **no solo cruza lo que coincide, sino que detecta los problemas**. Se activa automáticamente al subir el extracto del banco especial. **Cómo usarla:** 1. Iniciar una **Nueva conciliación** (o repetir la anterior). 2. En “Mis movimientos”, subir cualquiera de los `mis-movimientos.*` de siempre. 3. En “Extracto del banco”, subir **`extracto-bnf-CON-ERRORES.pdf`** (o `.csv`). El sistema reconoce el escenario por el nombre del archivo. 4. **Conciliar automáticamente.** **Qué va a mostrar (≈ 73% conciliado, en vez del 78% del caso normal):** | Error introducido | Cómo lo detecta la demo | |---|---| | El banco cobró de más en 2 pagos (DISTRIBUIDORA LOPEZ +3.000, ANDE +5.000) | Se concilian igual pero marcadas **“con diferencia”** (tarjeta *Con diferencia: 2* + columna resaltada) | | “VENTA CONTADO” figura un día después en el banco | Se **concilia igual** — demuestra la tolerancia de fecha | | Aporte IPS que el banco todavía no procesó | **Pendiente de “mis registros”** | | Débito automático de seguro no registrado por la empresa | **Pendiente del “banco”** | > 💬 **Frase de cierre:** “Miren cómo detecta que el banco cobró de más, que falta cargar un > movimiento y que hay un débito que no estaba registrado — nada se le escapa. Esto, a mano, > lleva horas y es donde se escapan los errores.” ### Resolver desde la misma pantalla (no es solo un reporte) Cada línea pendiente o con diferencia tiene un botón de acción — mostralo para dejar claro que el trabajo se **resuelve acá**, no solo se informa: - **Pendiente del banco** (comisión, ITF, débito de seguro) → **“Registrar”**: se carga el movimiento y pasa a conciliado (sube el %). - **Pendiente de mis registros** (cheque no cobrado, IPS no procesado) → **“En tránsito”**: se reserva para el próximo extracto y sale del período. - **Conciliada con diferencia** (banco cobró de más) → **“Registrar dif.”**: carga la comisión y la conciliación queda limpia. > 💬 **Remate:** resolvé 2–3 líneas en vivo y mostrá cómo el porcentaje sube hasta **100%**: > “en un par de clics dejás la cuenta cuadrada — no te llevás una lista de problemas, te llevás > el trabajo hecho”. --- > **Nota interna (no mostrar al cliente):** esta demo usa datos simulados vía la capa mock del > frontend. La arquitectura ya está preparada para conectarse al backend real sin rehacer las > pantallas (ver `docs/plan-conciliacion-bancaria-ia-ADAPTADO.md`). El escenario “con errores” > se dispara cuando el nombre del archivo del extracto contiene “ERRORES” > (ver `src/api/conciliacionBancariaIa.mock.js`). ## 9. Habilitar el módulo por empresa (interno) Es un **módulo real** del sistema (`CONCILIACION_IA`), gateado por permisos — ya no se ve para todos. Para habilitarlo a una empresa que quiera probar la demo: - **Empresa holding/reseller:** saltea el plan. Con el privilegio `CONC_IA_VER` en el perfil del usuario ya lo ve. Los perfiles de sistema con selector `*` lo reciben automáticamente al sembrar el catálogo (en cada arranque del backend). - **Empresa cliente normal:** agregar el módulo **`CONCILIACION_IA`** a su **suscripción** (Suscripciones) y asignar los privilegios `CONC_IA_*` a su rol (Configuración → Perfiles). > ⚠️ Los módulos/permisos se cargan **en el login**. Después de habilitar, el usuario debe > **cerrar sesión y volver a entrar** para que el ítem “Conciliación IA” aparezca en el menú. > El código del módulo es `CONCILIACION_IA` (la columna `modulos.codigo` es VarChar(20), por eso > no es `CONCILIACION_BANCARIA_IA`).