# Guion de demo — Conciliación Bancaria con IA (versión REAL) > ⚠️ **Reemplaza a `guia-demo-conciliacion-bancaria-ia.md`** (esa era la demo con datos > simulados/mock). El módulo ahora es **real**: interpreta los archivos que subís, cruza > por contenido y persiste todo. Los resultados **dependen del archivo** que subas. Este guion aprovecha las funciones nuevas: **resumen ejecutivo con IA, ahorro de tiempo, panel de hallazgos, asiento contable sugerido, sugerencias de conciliación, continuidad período a período y dashboard consolidado**. --- ## 1. Antes de empezar (técnico, una sola vez) 1. **Módulo habilitado.** La empresa debe tener el módulo `CONCILIACION_IA` en su suscripción y el rol del usuario los permisos `CONC_IA_*` (ver/crear/cargar/conciliar). Después de habilitar: **cerrar sesión y volver a entrar** (los permisos se cargan en el login). 2. **API key de IA (para el efecto "wow").** La interpretación de **PDF** y **TXT libre** y el **resumen ejecutivo** usan IA → requieren API key configurada en **Ajustes → IA**. - Sin API key: usá **CSV/Excel** (no necesitan IA) y el resumen sale igual, generado automáticamente por el sistema (sin redacción IA). Todo lo demás funciona. 3. **Archivos de prueba** en `novasispy-erp/demo-conciliacion/` (ya preparados y verificados). > 💡 **Mensaje al cliente:** hoy la conciliación se hace a mano, comparando el extracto del > banco contra la planilla propia línea por línea. Esta herramienta lo hace **automáticamente**, > acepta los archivos **en cualquier formato**, y entrega un informe listo para el contador. ### Archivos y qué mostrar con cada uno **Mis movimientos:** | Archivo | Formato | Necesita IA | Para mostrar… | |---|---|---|---| | `mis-movimientos.xlsx` | Excel | No | El caso típico: la planilla propia. **Recomendado para arrancar.** | | `mis-movimientos.txt` | Texto libre | **Sí** | El "wow": un libro banco escrito a mano, sin columnas, que la IA entiende igual. | **Extracto del banco:** | Archivo | Formato | Necesita IA | Para mostrar… | |---|---|---|---| | `extracto-bnf.csv` | CSV | No | Export del homebanking. **Recomendado para arrancar.** | | `extracto-bnf.pdf` | PDF | **Sí** | El extracto oficial del banco (lo más común). | > ❗ **Word (.doc/.docx) todavía no** está soportado (llega en la próxima versión). No lo uses en la demo. **Combo recomendado para la reunión:** - **Sin riesgo (sin depender de IA):** `mis-movimientos.xlsx` + `extracto-bnf.csv` → **78% conciliado**. - **Con efecto IA (si hay API key):** `mis-movimientos.txt` + `extracto-bnf.pdf` → mismo resultado, pero mostrás el spinner *"Interpretando con IA…"* y el resumen redactado por IA. --- ## 2. Recorrido completo (paso a paso) ### Paso 0 — El dashboard consolidado *(feature nueva #7)* - Al entrar a **Conciliación IA**, arriba del historial hay una fila de indicadores: **Conciliaciones · Finalizadas · Pendientes · Promedio conciliado**. - 💬 *"De un vistazo ves el estado de todas tus cuentas bancarias."* ### Paso 1 — Nueva conciliación → Datos de la cuenta - Clic en **Nueva conciliación**. - Completar: **Nombre de cuenta** (ej. `BNF Cta. Cte. Principal`), **Banco** (selector con buscador), **Moneda** (Guaraníes), **Período** (abril 2026, viene precargado). - **Dejá tildado** *"Arrastrar partidas en tránsito del período anterior"* *(feature #6)*. - 💬 *"Si el mes pasado quedó un cheque sin cobrar, el sistema se acuerda y lo trae para cruzarlo ahora."* - **Continuar.** ### Paso 2 — Subir los dos archivos - Subí **Mis movimientos** (`.xlsx` o `.txt`) y **Extracto del banco** (`.csv` o `.pdf`). - Con PDF/TXT aparece **"Interpretando con IA…"** unos segundos y luego *"N movimientos detectados"*. - 💬 *"La IA interpreta el contenido aunque el archivo no tenga columnas prolijas."* - Cuando estén los dos, **Continuar**. ### Paso 3 — Conciliar y ver el resultado - Clic en **Conciliar automáticamente**. Aparece el resultado con **78% conciliado**. Ahora mostrá, de arriba hacia abajo, las funciones nuevas: 1. **Resumen ejecutivo** *(feature #1)* — un párrafo tipo *"Se conciliaron 9 de 23 movimientos (78%). El banco cobró comisiones e ITF no registrados por Gs. 54.300. Hay un cheque de Gs. 1.750.000 emitido sin cobrar. Recomendación: registrar las comisiones y vigilar el cheque."* - Chip **"Generado con IA"** (si hay key) o **"Resumen automático"** (si no). - 💬 *"No te da una tabla: te da la conclusión, como te la contaría tu contador."* 2. **Chip de ahorro de tiempo** *(feature #2)* — *"Ahorro ≈ 15 min de trabajo manual"*. - 💬 *"Esto que el sistema hizo en segundos, a mano lleva su tiempo — y ahí se escapan los errores."* 3. **Panel de hallazgos** *(feature #3)* — tarjetas: *cargos del banco sin registrar*, *partidas tuyas sin espejo*, *baja confianza*, con su monto. 4. **Asiento contable sugerido** *(feature #4)* — desplegá *"Asiento contable sugerido"*: el sistema ya propone el asiento (Debe: Gastos bancarios / Comisiones / ITF · Haber: Banco). - 💬 *"No solo detecta: te deja el asiento contable armado."* **✅ Qué verificar (caso normal `xlsx` + `csv`):** 78% · 0 con diferencia · **2 pendientes míos** (cheque no cobrado + una línea de baja confianza) · **3 pendientes del banco** (comisión, ITF, intereses). --- ## 3. Resolver en vivo hasta el 100% *(no es solo un reporte)* Cada fila pendiente o con diferencia tiene su **acción**, y **el % sube en vivo** (queda guardado): - **Pendientes del banco** → **Registrar**: la comisión, el ITF y los intereses se cargan en "mis registros" y quedan conciliados. - **Pendiente mío** (cheque N° 004530) → **En tránsito**: sale del período y queda para el próximo extracto (se vigila). - 💬 **Remate:** *"En un par de clics dejo la cuenta cuadrada — no me llevo una lista de problemas, me llevo el trabajo hecho."* --- ## 4. Variante "con errores a propósito" (cierre potente) Muestra que el sistema **no solo cruza lo que coincide, sino que detecta los problemas**. Repetí una **Nueva conciliación** subiendo `extracto-bnf-CON-ERRORES.csv` (o `.pdf`) del lado del banco. **Resultado real: ≈ 73% conciliado, con `Con diferencia: 2`.** | Error introducido | Cómo lo detecta | |---|---| | El banco cobró de más (DISTRIBUIDORA LOPEZ +3.000, ANDE +5.000) | **Concilian igual pero marcadas "con diferencia"** (tarjeta *Con diferencia: 2*, columna resaltada) | | "VENTA CONTADO" figura un día después en el banco | **Concilia igual** (tolerancia de fecha ±2 días) | | Aporte IPS que el banco no procesó | **Pendiente de "mis registros"** | | Débito automático de seguro no registrado | **Pendiente del "banco"** | - En una **conciliada con diferencia** → **Registrar dif.**: carga la comisión incluida y la conciliación queda limpia. - 💬 *"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."* --- ## 5. Sugerencias de conciliación *(feature #5)* Si quedan pendientes que **"casi cruzan"** (importe muy parecido, referencia o concepto similar, fecha corrida), aparece la sección **"Sugerencias de conciliación"** con un **% probable** y un botón **Conciliar**. - 💬 *"Para lo dudoso, el sistema te propone el cruce y vos decidís con un clic. La IA resuelve lo difícil, no solo lo obvio."* --- ## 6. Descargar el informe - **Ver / Descargar PDF** → modal con la vista previa del documento ejecutivo (resumen + tablas), refleja el **estado actual** (después de resolver acciones). - **Descargar Excel** → planilla `.xlsx` **real multi-hoja** (Resumen · Conciliadas · Pendientes mis registros · Pendientes banco · En tránsito), generada por el sistema. - 💬 *"Te llevás un entregable listo para gerencia o el contador, sin armar nada a mano."* --- ## 7. Continuidad período a período *(feature #6, opcional)* Si tenés tiempo, mostrá el valor recurrente: 1. Volvé a **Nueva conciliación**, misma cuenta, período **mayo**, con *"Arrastrar partidas en tránsito"* tildado. 2. El cheque que marcaste **En tránsito** en abril **aparece ya precargado** en mayo. - 💬 *"El sistema se acuerda del cheque que no se cobró y lo trae solo al mes siguiente."* --- ## 8. Guion corto (versión reunión, 3 minutos) 1. *"Hoy conciliar el banco es manual y lento."* → abrir **Conciliación IA** (mostrar el dashboard). 2. *"Subo mis movimientos y el extracto, en el formato que sea."* → Paso 2 (*Interpretando con IA…*). 3. *"El sistema los cruza solo y me lo explica."* → **Conciliar** → **78%** + **resumen ejecutivo** + **ahorro de tiempo**. 4. *"Y me deja el asiento contable armado."* → desplegar **Asiento sugerido**. 5. *"Lo que no cruza, lo resuelvo acá mismo."* → **Registrar** / **En tránsito** → el % sube a **100%**. 6. *"Y me llevo el informe listo."* → **PDF** + **Excel**. 7. **Cierre:** repetir con `-CON-ERRORES` → *"miren cómo detecta que el banco cobró de más"*. --- ## 9. Preguntas frecuentes | Pregunta | Respuesta | |---|---| | ¿Necesito cargar todo antes? | No. Se suben dos archivos y listo; sirve aunque hoy usen solo Excel. | | ¿Qué formatos acepta? | Excel, CSV, PDF y TXT en ambos lados. (Word llega pronto.) | | ¿Y si el archivo está desordenado? | La IA lo interpreta igual; las líneas dudosas se marcan como *baja confianza* para revisar. | | ¿Puede equivocarse? | Solo cruza lo que coincide con seguridad (monto, tipo y fecha, con una tolerancia chica para comisiones). El resto queda pendiente para revisión manual. | | ¿Qué hago con los pendientes? | No es un reporte: cada línea tiene su acción (Registrar / En tránsito / Registrar dif.) y el % sube en vivo. | | ¿Los datos quedan guardados? | Sí. Todo se persiste: podés reabrir la conciliación y reexportar cuando quieras. | --- ## 10. Checklist técnico antes de la reunión - [ ] Módulo `CONCILIACION_IA` habilitado y permisos `CONC_IA_*` en el rol; **relogin** hecho. - [ ] (Para PDF/TXT y resumen IA) **API key** cargada en Ajustes → IA y probada. - [ ] Archivos `demo-conciliacion/` a mano (xlsx, csv, txt, pdf y sus `-CON-ERRORES`). - [ ] Prueba previa: `xlsx` + `csv` → **78%**; `-CON-ERRORES` → **73% con 2 diferencias**. - [ ] Backend de dev **reiniciado** para tomar las rutas del módulo.