# 🏦 Compatibilidad de Bancos - Importación Excel

## ✅ Bancos y Apps Soportadas

Tu app ahora **reconoce automáticamente** estos formatos de Excel:

### 🟢 **Yape / Plin** (PROBADO ✓)
**Columnas esperadas:**
- Tipo de Transacción → PAGASTE / TE PAGÓ
- Fecha de operación → DD/MM/YYYY
- Monto → Número con decimales
- Origen → Mi cuenta (opcional)
- Destino → Amigo/Negocio (opcional)
- Mensaje → Descripción (opcional)

**Compatibilidad:** ⭐⭐⭐⭐⭐ Perfecta

---

### 🟢 **Scotiabank** (AHORA COMPATIBLE!)
**Columnas esperadas:**
- Fecha Movimiento / Fecha Valor / Fecha
- Descripción / Detalle
- Monto / Importe
- Saldo Valor / Saldo (opcional)

**Qué hace la app:**
- Usa la **Descripción como concepto del gasto**
- Infiere el Tipo (PAGASTE por defecto)
- Si el Saldo existe, lo usa como "destino"
- Auto-clasifica el gasto

**Compatibilidad:** ⭐⭐⭐⭐⭐ Ahora funciona!

---

### 🟡 **BCP, BBVA, Interbank** (PARCIAL)
**Columnas esperadas:**
- Fecha
- Descripción / Concepto
- Monto / Importe
- Saldo (opcional)

**Qué hace:**
- Auto-detecta y normaliza
- Funciona bien si hay Fecha + Monto + Descripción
- Clasifica gastos automáticamente

**Compatibilidad:** ⭐⭐⭐⭐ Buena

---

### 🟠 **Otros Bancos**
La app intenta detectar automáticamente usando:
- Cualquier columna con "Fecha" / "Date"
- Cualquier columna con "Monto" / "Importe" / "Amount"
- Cualquier columna con "Descripción" / "Concepto"

**Compatibilidad:** ⭐⭐⭐ Depende del formato

---

## 📋 Pasos para Importar

### 1️⃣ **Exporta tu Excel del banco**
Algunos bancos lo llaman:
- "Descargar movimientos"
- "Exportar"
- "Movimientos" → "Guardar como Excel"

### 2️⃣ **Abre la app**
```
http://192.168.1.100/gastos
```

### 3️⃣ **Nuevo Gasto → 📊 Importar Excel**

### 4️⃣ **Selecciona tu archivo .xlsx**

### 5️⃣ **Mira el Preview**
- Se mostrarán las primeras 5 filas
- Verás si se detectó correctamente
- Si falta algo, cancela y ajusta el Excel

### 6️⃣ **Click: "Importar a Base de Datos"**

✅ **¡Listo!** Los datos aparecen en la tabla

---

## 🔧 Si No Funciona

### ❌ Error: "El archivo está vacío"
- El Excel no tiene datos
- **Solución:** Verifica que el Excel tenga al menos 1 fila con datos

### ❌ Error: "No se pudieron procesar los registros"
- Las columnas no coinciden
- **Solución:** 
  1. Abre el Excel en Excel/Sheets
  2. Ve a la página del analizador: `http://192.168.1.100/gastos/analizar_excel.html`
  3. Carga tu Excel ahí para ver la estructura exacta
  4. Envía una captura

### ❌ Error: "Monto inválido"
- El monto tiene símbolos ($, €, etc.)
- **Solución:** Edita el Excel y deja solo números y puntos (ej: 45.50)

### ❌ Error: "Fecha no válida"
- Formato de fecha incorrecto
- **Solución:** Formato esperado: **DD/MM/YYYY** (ej: 18/06/2026)

---

## 📊 Analizador Visual

Si tu banco no funciona, usala esta herramienta:

### 🌐 `analizar_excel.html`
**Ubicación:** `http://192.168.1.100/gastos/analizar_excel.html`

**Qué hace:**
1. Subes tu Excel
2. Muestra TODAS las columnas y datos
3. Genera JSON con la estructura

**Uso:**
- Sirve para diagnosticar problemas
- Ayuda a ajustar formatos
- Envía capturas al soporte

---

## ✨ Soporte Automático

La app ahora:

✅ **Detecta automáticamente el banco**
- Busca patrones de nombres de columna
- Intenta múltiples filas de inicio
- Normaliza nombres a formato estándar

✅ **Limpia datos**
- Quita espacios en blanco
- Convierte montos correctamente
- Parsea múltiples formatos de fecha

✅ **Valida antes de guardar**
- Rechaza montos cero o negativos
- Requiere fecha y concepto
- Avisa si hay errores por fila

✅ **Clasifica automáticamente**
- Detecta categoría por concepto
- Asigna Transporte, Alimentación, etc.
- Usa palabras clave del descripción

---

## 🚀 Próximas Mejoras

Planeadas:
- [ ] Importar de Google Sheets
- [ ] API directa de bancos
- [ ] Conversión de monedas
- [ ] Plantillas por banco

---

## 📞 ¿Necesitas ayuda?

Si tu banco **aún no funciona:**

1. **Ve a:** `http://192.168.1.100/gastos/analizar_excel.html`
2. **Carga tu Excel**
3. **Copia la salida JSON**
4. **Comparte conmigo**

Y ajustaré el formato! 💪

---

**Última actualización:** 18 de Junio 2026
**Versión:** 2.1 - Soporte Multi-Banco