- Introduccion
- Primeros Pasos
- Dashboard
- Transacciones
- Cuentas Bancarias
- Tarjetas de Credito
- Presupuestos
- Metas de Ahorro
- Prestamos
- Financiamientos
- Transacciones Recurrentes
- Importar Transacciones
- Reportes
- Logros y Gamificacion
- Salud Financiera e IA
- Telegram Bot
- Configuracion
FinanceApp es una aplicacion web de finanzas personales disenada para usuarios mexicanos. Permite registrar ingresos, gastos, transferencias, presupuestos, prestamos, metas de ahorro y mas — todo en pesos mexicanos (MXN).
- Personas que quieren controlar sus gastos diarios
- Quienes manejan multiples cuentas bancarias y tarjetas de credito
- Personas con prestamos que necesitan seguimiento de amortizacion
- Quienes quieren presupuestar y ahorrar con metas claras
- Usuarios que prefieren una app privada (self-hosted, datos propios)
- Todo en un lugar: Cuentas, TDC, prestamos, presupuestos, ahorro
- Inteligencia Artificial: Escaneo de recibos, analisis financiero, categorizacion automatica
- Automatizacion: Transacciones recurrentes, renovacion de presupuestos, pagos de prestamos
- Gamificacion: Logros, rachas, XP — motivacion para mantener buenos habitos financieros
- Privacidad: Tus datos en tu servidor, sin compartir con terceros
FinanceApp se puede instalar en tu celular como una app nativa:
- Abre
https://finance.oravi.mx en Chrome (Android) o Safari (iOS)
- Chrome: Toca el banner "Instalar" o Menu → "Agregar a pantalla de inicio"
- Safari: Toca el boton Compartir → "Agregar a pantalla de inicio"
- La app aparece en tu pantalla de inicio como cualquier otra app
Funciona en modo standalone (sin barra del navegador) y cachea recursos para carga rapida.
- Abre
https://finance.oravi.mx en tu navegador
- Veras la pagina de bienvenida con informacion sobre las funcionalidades
- Haz clic en "Iniciar sesion"
- Ingresa tu correo electronico y contrasena
- Haz clic en "Entrar"
- Seras redirigido al Dashboard
Nota: El registro de nuevos usuarios es por invitacion. Contacta al administrador para crear tu cuenta.
-
Crear tus cuentas bancarias (Seccion Cuentas)
- Agrega tus cuentas de banco, efectivo, monederos electronicos
- Ingresa el saldo actual de cada una
-
Registrar tus tarjetas de credito (Seccion Tarjetas)
- Agrega nombre, ultimos 4 digitos, limite y saldo actual
-
Crear tu primer presupuesto (Seccion Presupuestos)
- Define limites mensuales por categoria (comida, transporte, etc.)
-
Registrar tus primeras transacciones (Seccion Transacciones o boton flotante +)
El Dashboard es la vista principal despues de iniciar sesion. Muestra un resumen completo de tu situacion financiera.
En la parte superior veras 4 tarjetas:
| Tarjeta |
Que muestra |
| Balance total |
Suma de todas tus cuentas bancarias |
| Ingresos del mes |
Total de ingresos del mes actual + cambio vs mes anterior (%) |
| Gastos del mes |
Total de gastos del mes actual + cambio vs mes anterior (%) |
| Deuda total |
Saldo de tarjetas de credito + saldo de prestamos |
Un anillo circular muestra tu score de salud financiera (0-100) con un grado (A-F). Debajo, barras de progreso muestran cada factor que influye en tu score. A la derecha, alertas e insights automaticos te avisan sobre:
- Si estas gastando mas que el mes pasado
- Si algun presupuesto esta cerca del limite
- Si tu ratio de deuda es alto
- Progreso hacia tus metas de ahorro
Debajo de los insights, un boton "Analizar con IA" genera recomendaciones personalizadas usando Gemini AI. El analisis incluye un resumen de tu situacion y 3-5 recomendaciones concretas.
- Desglose por categoria: Grafica de dona mostrando en que gastas mas
- Tendencias: Grafica de linea de 6 meses mostrando ingresos vs gastos
Barras de progreso de tus presupuestos y prestamos mas recientes con porcentaje de consumo/pago.
Las ultimas 5 transacciones con icono, descripcion, monto y fecha.
La seccion de Transacciones es el corazon de la aplicacion. Aqui registras todo movimiento de dinero.
| Tipo |
Descripcion |
Efecto en balance |
| Ingreso |
Dinero que entra (sueldo, ventas, etc.) |
+Cuenta |
| Gasto |
Dinero que sale (compras, servicios, etc.) |
-Cuenta o +Saldo TDC |
| Transferencia |
Mover dinero entre cuentas |
-Cuenta origen, +Cuenta destino |
| Pago TDC |
Pagar tarjeta de credito |
-Cuenta, -Saldo TDC |
| Pago Prestamo |
Pagar cuota de prestamo |
-Cuenta, actualiza amortizacion |
- Haz clic en el boton flotante (+) en la esquina inferior derecha, o en "Nueva transaccion" en la pagina de Transacciones
- Selecciona el tipo (ingreso, gasto, transferencia, etc.)
- Llena los campos:
- Monto: En pesos mexicanos
- Descripcion: Que fue
- Fecha: Cuando ocurrio
- Cuenta: De donde sale o a donde entra
- Categoria: Clasificacion (comida, transporte, sueldo, etc.)
- Presupuesto: Opcional, asociar a un presupuesto
- Notas: Opcional, informacion adicional
- Haz clic en "Guardar"
Si una compra incluye items de diferentes categorias (ej: supermercado = comida + limpieza + mascotas):
- Al crear transaccion, activa "Dividir transaccion"
- Agrega sub-items con monto y categoria individual
- La suma de sub-items debe ser igual al monto total
- Al crear transaccion, haz clic en "Escanear recibo"
- Sube una foto del ticket o factura
- La IA extrae automaticamente: monto, descripcion, fecha y categoria
- Revisa y confirma los datos antes de guardar
- Barra de busqueda: Escribe para buscar por descripcion, cuenta, categoria o monto
- Filtros: Tipo, cuenta, tarjeta de credito, categoria, rango de fechas
- Paginacion: Navega entre paginas de resultados
Si cometiste un error, puedes reversar una transaccion:
- Busca la transaccion en la lista
- Haz clic en el boton de acciones → "Reversar"
- Se crea una transaccion opuesta que restaura los balances
- La transaccion original queda marcada como "Reversada"
En la parte superior de la lista se muestran los totales del periodo/filtro actual:
- Total ingresos
- Total gastos
- Balance neto
- Numero de transacciones
Registra todas tus fuentes de dinero para tener un balance consolidado.
| Tipo |
Icono |
Uso tipico |
| Banco |
Edificio |
Cuentas de debito, cheques |
| Efectivo |
Billete |
Dinero en cartera |
| Monedero Electronico |
Telefono |
Mercado Pago, PayPal, etc. |
| Inversion |
Grafica |
CETES, fondos, crypto |
- Ve a Cuentas en el menu lateral
- Haz clic en "Nueva cuenta"
- Ingresa nombre, tipo y saldo inicial
- Guardar
El balance de cada cuenta se actualiza automaticamente con cada transaccion:
- Ingresos suman al balance
- Gastos restan del balance
- Transferencias mueven dinero entre cuentas
No necesitas actualizar manualmente los saldos.
Lleva control del saldo, limite disponible y fechas importantes de tus TDC.
- Ve a Tarjetas en el menu lateral
- Haz clic en "Nueva tarjeta"
- Ingresa:
- Nombre: Ej. "BBVA Oro"
- Ultimos 4 digitos: Para identificarla
- Limite de credito: Monto maximo
- Saldo actual: Lo que debes actualmente
- Dia de corte: Cuando cierra el periodo
- Dia de pago: Fecha limite de pago
Para registrar un pago a tu TDC:
- Crea una transaccion tipo "Pago TDC"
- Selecciona la cuenta de donde sale el dinero
- Selecciona la tarjeta a la que pagas
- Ingresa el monto
El saldo de la tarjeta se reduce y el balance de la cuenta tambien.
Al crear un gasto, selecciona la tarjeta en lugar de una cuenta:
- El gasto se registra
- El saldo de la TDC aumenta (debes mas)
- No afecta el balance de tus cuentas
Establece limites de gasto por categoria para controlar tus finanzas.
- Ve a Presupuestos en el menu lateral
- Haz clic en "Nuevo presupuesto"
- Configura:
- Nombre: Ej. "Gastos mensuales Febrero"
- Periodo: Mensual, quincenal, semanal o personalizado
- Fechas: Inicio y fin del periodo
- Limite total: Monto maximo total
- Agrega items por categoria:
- Comida: $5,000
- Transporte: $2,000
- Entretenimiento: $1,500
En la pagina de detalle del presupuesto veras:
- Barra de progreso por categoria: Verde (<70%), amarillo (70-90%), rojo (>90%)
- Gasto actual vs limite: Cuanto has gastado de cada categoria
- Transacciones asociadas: Las transacciones que cuentan para este presupuesto
El dashboard te avisara cuando:
- Un presupuesto supera el 70% del limite → Alerta amarilla
- Un presupuesto supera el 90% del limite → Alerta roja
Los presupuestos mensuales se renuevan automaticamente al terminar el periodo. El scheduler crea un nuevo presupuesto para el siguiente mes con los mismos items y limites.
Define objetivos de ahorro y haz seguimiento de tu progreso.
- Ve a Metas de Ahorro en el menu lateral
- Haz clic en "Nueva meta"
- Configura:
- Nombre: Ej. "Vacaciones Cancun"
- Monto objetivo: Cuanto quieres ahorrar
- Fecha limite: Cuando lo necesitas (opcional)
- Cuenta destino: A donde va el dinero ahorrado
- Icono y color: Para personalizar
- En el detalle de la meta, haz clic en "Contribuir"
- Selecciona el monto y la cuenta de origen
- Se crea automaticamente una transferencia de tu cuenta a la cuenta de la meta
| Indicador |
Que muestra |
| Progreso % |
Cuanto llevas del objetivo |
| Monto actual |
Cuanto has ahorrado |
| Ahorro mensual necesario |
Cuanto debes ahorrar al mes para llegar a tiempo |
| En ritmo |
Si vas al dia o atrasado |
- Activa: Meta en progreso
- Lograda: Se alcanzo el monto objetivo (automatico al contribuir)
- Cancelada: Se cancelo manualmente
Administra tus creditos con tabla de amortizacion automatica.
- Ve a Prestamos en el menu lateral
- Haz clic en "Nuevo prestamo"
- Ingresa:
- Nombre: Ej. "Auto Nissan"
- Monto del prestamo: Capital original
- Tasa de interes anual: En porcentaje (ej: 15.50%)
- Plazo en meses: Duracion del credito
- Frecuencia de pago: Mensual o quincenal
- Dia de pago: Dia del mes (y segundo dia si es quincenal)
- Cuenta: De donde se hacen los pagos
- Fecha de inicio: Cuando empezo el credito
Al crear el prestamo se genera automaticamente una tabla de amortizacion (sistema frances = cuota fija) que muestra para cada pago:
| Columna |
Descripcion |
| No. pago |
Numero secuencial |
| Fecha |
Cuando se debe pagar |
| Pago |
Monto fijo de la cuota |
| Capital |
Parte que reduce la deuda |
| Interes |
Parte que es costo del credito |
| Saldo |
Lo que queda por pagar |
Al crear un prestamo, se genera automaticamente una transaccion recurrente que ejecuta los pagos segun la frecuencia configurada. No tienes que recordar pagar manualmente.
Puedes hacer pagos adelantados al capital:
- En el detalle del prestamo, haz clic en "Pago extra"
- Ingresa el monto adicional
- Se recalcula el saldo y los pagos restantes
- Barra de progreso: Cuanto has pagado del total
- Saldo actual: Lo que falta por pagar
- Pagos restantes: Cuantas cuotas faltan
- Total de intereses: Cuanto pagaras en intereses
Un tracker simple para prestamos informales o deudas sin tabla de amortizacion.
¶ Cuando Usarlo
- Prestamos a familiares o amigos
- Deudas sin tasa de interes
- Pagos en parcialidades sin contrato formal
- Ve a Financiamientos en el menu lateral
- Haz clic en "Nuevo financiamiento"
- Ingresa nombre y descripcion
- Agrega entradas:
| Tipo |
Significado |
| Prestamo |
Dinero que te prestaron (aumenta deuda) |
| Abono |
Pago que hiciste (reduce deuda) |
El sistema calcula automaticamente:
- Total prestamos: Suma de todo lo prestado
- Total abonos: Suma de lo pagado
- Balance: Lo que debes actualmente
Automatiza ingresos y gastos que se repiten periodicamente.
- Ve a Recurrentes en el menu lateral
- Haz clic en "Nuevo recurrente"
- Configura:
- Tipo: Ingreso, gasto, transferencia, pago TDC, pago prestamo
- Frecuencia: Diario, semanal, quincenal, mensual, trimestral, anual
- Monto y descripcion
- Cuenta/TDC: De donde o a donde
- Categoria
- Fecha de inicio y fecha de fin (opcional)
| Recurrente |
Tipo |
Frecuencia |
| Sueldo |
Ingreso |
Quincenal |
| Renta |
Gasto |
Mensual |
| Netflix |
Gasto |
Mensual |
| Pago TDC |
Pago TDC |
Mensual |
| Ahorro automatico |
Transferencia |
Quincenal |
Un scheduler revisa cada hora si hay recurrentes pendientes de ejecucion. Cuando llega la fecha:
- Se crea la transaccion correspondiente
- Se actualizan los balances
- Se calcula la proxima fecha de ejecucion
Si el servidor estuvo apagado, al reiniciar ejecuta automaticamente los recurrentes atrasados.
Importa transacciones masivamente desde archivos CSV de tu banco.
- Subir archivo: Ve a Importar, selecciona tu archivo CSV y la cuenta destino
- Vista previa: El sistema:
- Auto-detecta el formato (encoding, separador, columnas)
- Muestra cada fila con los datos extraidos
- Sugiere categoria automaticamente usando reglas de categorizacion
- Marca duplicados que ya existen en tu historial
- Revisar: Puedes:
- Cambiar la categoria sugerida
- Marcar filas para saltar (no importar)
- Verificar que montos y fechas sean correctos
- Confirmar: Haz clic en "Importar" para crear las transacciones
| Caracteristica |
Descripcion |
| Auto-encoding |
Detecta UTF-8 o Latin-1 automaticamente |
| Auto-separador |
Detecta coma, punto y coma o tabulador |
| Auto-columnas |
Identifica columnas de fecha, descripcion, monto, debito, credito |
| Auto-categoria |
Aplica reglas de categorizacion a la descripcion |
| Anti-duplicados |
Detecta transacciones que ya existen (misma fecha + monto + descripcion) |
Crea reglas para que la importacion asigne categorias automaticamente:
- En Importar → seccion Reglas
- Haz clic en "Nueva regla"
- Configura:
- Patron: Texto a buscar en la descripcion (ej: "UBER", "OXXO", "NOMINA")
- Categoria: A que categoria asignar
- Prioridad: Reglas con mayor prioridad se aplican primero
Ejemplo:
| Patron |
Categoria |
Prioridad |
| UBER |
Transporte |
10 |
| OXXO |
Tienda de conveniencia |
10 |
| NOMINA |
Sueldo / Nomina |
10 |
| AMAZON |
Entretenimiento |
5 |
Analiza tus finanzas con graficas interactivas y exporta los datos.
- Selecciona mes o ano
- Ve totales: ingresos, gastos, balance neto
- Compara con el periodo anterior (variacion porcentual)
- Ve totales consolidados: balance de cuentas, deuda TDC, deuda prestamos
- Grafica de dona interactiva mostrando la distribucion de gastos (o ingresos)
- Tabla con: categoria, monto, porcentaje del total, numero de transacciones
- Filtra por tipo (ingreso/gasto) y rango de fechas
- Grafica de linea mostrando la evolucion de ingresos, gastos y balance neto
- Configurable: ultimos 3, 6, 12 o 24 meses
- Identifica patrones estacionales
Haz clic en "Exportar CSV" para descargar los datos del reporte actual en formato compatible con Excel.
FinanceApp te motiva con logros, rachas y experiencia para mantener buenos habitos financieros.
Una racha es el numero de dias consecutivos que registras al menos una transaccion. Cada dia que registras algo, la racha aumenta. Si dejas de registrar un dia, se reinicia a 0.
- Cada logro desbloqueado otorga XP (puntos de experiencia)
- Tu nivel se calcula como:
nivel = XP / 100 + 1
- Ej: 250 XP = Nivel 3
| Logro |
Descripcion |
Recompensa |
| Primera Transaccion |
Registra tu primera transaccion |
25 XP |
| Racha de 7 dias |
7 dias consecutivos registrando |
50 XP |
| Racha de 30 dias |
30 dias consecutivos |
100 XP |
| 100 Transacciones |
Alcanza 100 transacciones totales |
75 XP |
| 500 Transacciones |
Alcanza 500 transacciones totales |
150 XP |
| Logro |
Descripcion |
Recompensa |
| Maestro del Presupuesto |
Termina un mes dentro del presupuesto |
100 XP |
| Gasto Consciente |
Reduce gastos vs mes anterior |
75 XP |
| Tracker de Gastos |
Categoriza 50 gastos |
50 XP |
| Logro |
Descripcion |
Recompensa |
| Primera Meta |
Crea tu primera meta de ahorro |
25 XP |
| Meta Lograda |
Alcanza una meta de ahorro |
100 XP |
| Ahorrador 10% |
Ahorra 10% de tus ingresos |
75 XP |
| Ahorrador 20% |
Ahorra 20% de tus ingresos |
150 XP |
| Logro |
Descripcion |
Recompensa |
| 3 Cuentas |
Registra 3 cuentas bancarias |
50 XP |
| Categoria Personalizada |
Crea una categoria propia |
25 XP |
| Primera Importacion |
Importa transacciones desde CSV |
50 XP |
| Prestamo Liquidado |
Paga completamente un prestamo |
200 XP |
- Ve a Logros en el menu lateral
- Ve tu nivel, XP total, racha actual y logros desbloqueados
- Filtra por categoria: Todos, Constancia, Gastos, Ahorro, Hitos
- Los logros desbloqueados se muestran en amarillo, los bloqueados en gris
FinanceApp calcula automaticamente un score de 0 a 100 basado en 7 factores:
| Factor |
Peso |
Que evalua |
| Ratio de deuda |
30% |
Deuda total vs ingreso anualizado |
| Adherencia presupuestal |
25% |
Que tan bien cumples tus presupuestos |
| Tasa de ahorro |
25% |
Porcentaje de ingreso que ahorras |
| Consistencia |
20% |
Dias activos en los ultimos 30 dias |
| Grado |
Score |
Significado |
| A |
90-100 |
Excelente salud financiera |
| B |
70-89 |
Buena, con areas de mejora |
| C |
50-69 |
Regular, necesita atencion |
| D |
30-49 |
Preocupante, tomar accion |
| F |
0-29 |
Critico, requiere cambios inmediatos |
El sistema genera alertas basadas en reglas:
- Gasto excesivo: Gastas >20% mas que el mes anterior
- Categoria dominante: Una sola categoria >40% del gasto total
- Presupuesto alto: Presupuesto al 70% o 90% del limite
- Carga recurrente: Gastos recurrentes >50% del ingreso
- Deuda alta: Ratio de deuda >40%
Al hacer clic en "Analizar con IA":
- Se envian tus datos financieros (anonimos, solo numeros) a Gemini AI
- El modelo analiza tu situacion y genera:
- Un parrafo resumen de tu estado financiero
- 3-5 recomendaciones concretas y personalizadas
- Las recomendaciones se muestran debajo de tus insights
Ejemplos de recomendaciones:
- "Reduce tus gastos en Entretenimiento un 15% para mejorar tu tasa de ahorro"
- "Considera hacer un pago extra a tu prestamo para reducir intereses"
- "Tu fondo de emergencia cubre solo 1 mes. El objetivo ideal son 3-6 meses"
Registra transacciones desde Telegram sin abrir la app web.
- Ve a Configuracion en el menu lateral
- En la seccion Telegram, haz clic en "Vincular Telegram"
- Se genera un link unico para tu cuenta
- Abre el link en Telegram (o escanea el QR)
- El bot confirma la vinculacion
Envia mensajes naturales al bot:
| Mensaje |
Resultado |
| "tacos 150" |
Gasto: $150 en Comida y restaurantes |
| "uber 89" |
Gasto: $89 en Transporte |
| "me pagaron 15000" |
Ingreso: $15,000 |
| "supermercado walmart 2500" |
Gasto: $2,500 en Supermercado |
Si la IA no puede determinar todos los campos, el bot te preguntara:
- De que cuenta o tarjeta sale
- Confirmacion del monto y categoria
¶ Comandos
| Comando |
Descripcion |
/start |
Iniciar bot / vincular cuenta |
/status |
Ver resumen financiero |
/cancel |
Cancelar operacion en curso |
En Configuracion → Telegram → "Desvincular" para remover la conexion.
- Ve a Configuracion en el menu lateral
- Haz clic en "Exportar datos"
- Se descarga un archivo JSON con todos tus datos:
- Cuentas, categorias, transacciones
- Presupuestos, metas, prestamos
- Recurrentes, reglas, financiamientos
Usa esto como backup periodico de tu informacion.
- En Configuracion, seccion "Restaurar"
- Sube un archivo JSON previamente exportado
- Atencion: Esto reemplaza TODOS tus datos actuales
- Confirma la operacion
- En Configuracion, seccion "Resetear"
- Haz clic en "Eliminar todos mis datos"
- Atencion: Esta accion es irreversible
- Se eliminan todas tus transacciones, cuentas, presupuestos, etc.
- Tu cuenta de usuario permanece activa (solo se borran los datos financieros)
- Vincular: Genera link para conectar tu cuenta de Telegram
- Desvincular: Elimina la conexion con Telegram
- Estado: Muestra si tu cuenta esta vinculada
| # |
Funcionalidad |
Descripcion Corta |
| 1 |
Dashboard |
Vista completa de tu situacion financiera |
| 2 |
Transacciones |
Ingresos, gastos, transferencias, pagos TDC/prestamo, splits, OCR |
| 3 |
Cuentas |
Banco, efectivo, e-wallet, inversion con balance automatico |
| 4 |
Tarjetas de Credito |
Control de saldo, limite, fechas de corte y pago |
| 5 |
Presupuestos |
Limites por categoria con renovacion automatica |
| 6 |
Metas de Ahorro |
Objetivo, contribuciones, ritmo, logro automatico |
| 7 |
Prestamos |
Amortizacion francesa, pagos automaticos, pagos extra |
| 8 |
Financiamientos |
Tracker simple de prestamos/abonos informales |
| 9 |
Recurrentes |
Automatizacion de ingresos/gastos periodicos |
| 10 |
Importar CSV |
Auto-deteccion, categorizacion, anti-duplicados |
| 11 |
Reportes |
Resumen, categorias, tendencias, export CSV |
| 12 |
Logros |
16 logros, rachas, XP, niveles |
| 13 |
Salud Financiera |
Score 0-100, grado A-F, 7 factores |
| 14 |
IA (Gemini) |
Analisis personalizado, OCR de recibos |
| 15 |
Telegram Bot |
Transacciones por chat, vinculacion |
| 16 |
Configuracion |
Backup, restaurar, resetear, Telegram |
| 17 |
PWA |
Instalable, responsive, offline |