Documentación

AloxBook está pensado para darte una visión clara de las finanzas cotidianas con una estructura sencilla. Tus datos financieros se guardan en archivos SQLite locales que controlas, y la interfaz hace comprensible la partida doble incluso si estás empezando.

Resumen

AloxBook usa contabilidad por partida doble: cada transacción se mueve desde una cuenta origen hacia una cuenta destino. Esa regla sencilla te da una vista fiable de dónde vino el dinero, adónde fue y por qué cambiaron los saldos.

Instalación

Requisitos del sistema

• Windows 10 o posterior (64 bits)
• macOS 15 Sequoia o posterior (Apple Silicon o Intel)
• Linux: Flatpak en x86_64 o aarch64, o AppImage en x86_64

Instalar

En Windows, instala preferentemente AloxBook desde Microsoft Store. Es la vía de instalación recomendada y ofrece actualizaciones gestionadas por Store. Los paquetes directos Setup.exe y WinGet siguen disponibles como alternativas. Para otras plataformas, elige tu paquete en la sección de descargas. Su guía de instalación contiene los pasos actuales y las notas específicas de la plataforma. Los paquetes de AloxBook son autónomos; no necesitas instalar .NET ni otras dependencias de la aplicación por separado.

Actualizaciones

• Microsoft Store: las actualizaciones de las instalaciones realizadas desde Store se distribuyen a través de Microsoft Store.
• Setup.exe, WinGet, DMG de macOS y AppImage: cuando la búsqueda de actualizaciones está activada, AloxBook descarga una nueva versión en segundo plano y la aplica después de cerrar la aplicación; la nueva versión se inicia la próxima vez.
• Flathub: tu centro de software o flatpak update instala las actualizaciones. Por eso AloxBook oculta su propio ajuste de actualización dentro de Flatpak.
• Paquete Flatpak directo: esta alternativa avanzada no tiene una fuente de actualizaciones gestionada. Instala desde Flathub si quieres actualizaciones automáticas del paquete.

Verificar una descarga directa

El enlace de sumas de comprobación junto a la versión actual en la sección de descargas muestra el resumen SHA-256 de cada archivo publicado. Un valor coincidente demuestra que tu archivo corresponde al archivo publicado; como el manifiesto se sirve desde el mismo sitio web, no demuestra por sí solo la identidad del editor. El paquete firmado de macOS y la ficha verificada de Flathub aportan comprobaciones adicionales del editor.

Primeros pasos

1. Crea un libro nuevo: usa Archivo → Nuevo y elige dónde vivirá tu archivo .aloxbook para que las copias de seguridad sean sencillas
2. Establece una contraseña: protege el libro cuando otras personas puedan acceder al mismo dispositivo (opcional, pero recomendable)
3. Elige una plantilla de cuentas: empieza con una estructura que puedas renombrar y adaptar después, en lugar de una lista vacía
4. Añade tus primeras transacciones: empieza con salario, alquiler, compras, transferencias u otros movimientos recurrentes

Cuentas

Las cuentas en AloxBook se organizan en un árbol jerárquico con tres categorías raíz:

• Activos y deudas: cuentas bancarias, efectivo, ahorros, inmuebles y deudas como préstamos o tarjetas de crédito (saldos negativos)
• Ingresos: salario, intereses, dividendos, devoluciones, ...
• Gastos: alquiler, alimentación, suministros, ocio, ...

Puedes crear subcuentas en cualquier nivel. Por ejemplo, bajo Gastos podrías tener Vivienda → Alquiler, Vivienda → Suministros, etc. Los saldos se agregan hacia arriba en el árbol.

Crear una cuenta

Cambia a la pestaña Cuentas, haz clic derecho sobre una cuenta superior (o usa la barra de herramientas) y selecciona Insertar cuenta. Dale un nombre.

Transacciones

Una transacción en AloxBook siempre implica dos cuentas: el dinero fluye desde una cuenta hacia otra. Este es el principio central de la partida doble.

Ejemplos:

• Ingresos: Salario → Activos y deudas: Cuenta bancaria: recibes la nómina
• Activos y deudas: Cuenta bancaria → Gastos: Alimentación: compras comida
• Activos y deudas: Cuenta bancaria → Activos y deudas: Ahorros: transfieres a ahorros
• Ingresos: Salario → Gastos: Alimentación: pagas la comida de la cantina mediante nómina

Crear una transacción

En la pestaña Transacciones, haz clic en el icono de suma. Rellena la fecha, cuenta origen, cuenta destino, importe y texto descriptivo.

Plantillas

Las plantillas permiten guardar transacciones frecuentes para reutilizarlas rápido. Una plantilla guarda la cuenta origen, la cuenta destino, el importe y el texto descriptivo (todos opcionales).

Para crear una plantilla, ve a la pestaña Plantillas y haz clic en el icono de suma. Para aplicar una plantilla, selecciónala en la lista del diálogo "Crear nueva transacción": sus valores se rellenan automáticamente en la nueva transacción.

Importación CSV

AloxBook puede importar extractos bancarios desde archivos CSV. El sistema de importación es muy configurable:

• Los perfiles de importación se crean y guardan automáticamente después de asignarles una cuenta
• Las reglas de importación asignan automáticamente transacciones importadas a una plantilla según patrones de texto e importes
• Cada transacción importada se ve en una vista previa y puede editarse individualmente antes de guardarla
• La detección de duplicados evita importar dos veces las mismas transacciones

Configurar la importación CSV

1. Cambia a la pestaña Transacciones
2. Haz clic en el botón Importar CSV de la barra de herramientas
3. Selecciona tu archivo CSV
4. La asignación de columnas se detecta automáticamente; puedes ajustar los detalles manualmente
5. Revisa la vista previa y haz clic en Importar

Detección automática de formato

La importación CSV es intencionadamente genérica. Detecta automáticamente separador, codificación de texto, formato de fecha, separador decimal, filas de cabecera y roles de columnas, por lo que la mayoría de exportaciones de bancos y tarjetas se importan sin configuración manual. Si algo se detecta mal, puedes ajustarlo en los detalles de importación. También se admiten columnas separadas de débito/crédito y campos de referencia, descripción y beneficiario separados por barras verticales.

Formatos bancarios verificados

Los formatos siguientes se comprueban automáticamente en cada release con archivos de ejemplo reales, por lo que se sabe que se detectan directamente. Es solo una selección de lo que funciona, no una lista completa, y muchos otros bancos usan formatos muy parecidos que también se importan bien.

Exportación CSV

AloxBook puede exportar a CSV la vista de transacciones visible actualmente. La exportación sigue las mismas filas y el mismo orden que ves en la tabla, incluidos filtros y ordenación activos.

• Las primeras filas del CSV describen el filtro y la ordenación activos, para conservar el contexto
• Las fechas y los importes se formatean según la configuración regional actual
• El separador sigue la región: punto y coma para culturas con coma decimal, coma en los demás casos
• El archivo se escribe como CSV UTF-8 con marca de orden de bytes para mejorar la compatibilidad con hojas de cálculo

Exportar transacciones

1. Cambia a la pestaña Transacciones
2. Aplica el filtro u ordenación que quieras exportar
3. Haz clic en el botón Exportar CSV de la barra de herramientas
4. Elige el nombre y la ubicación del archivo de destino

Cerrar y traspasar

Si prefieres mantener un archivo por periodo financiero (por ejemplo, uno por año), la función Cerrar y traspasar lo hace sencillo:

1. Ve a Archivo → Cerrar y traspasar
2. AloxBook crea un archivo nuevo con toda tu estructura de cuentas
3. Todos los saldos de cuentas de activo se traspasan como saldos iniciales
4. Todas las plantillas se copian
5. Las cuentas de ingresos y gastos empiezan de cero
6. El archivo antiguo queda intacto y se marca como protegido contra escritura

Así tienes un inicio limpio para el nuevo periodo y conservas el historial completo en el archivo anterior.

Cifrado

La protección con contraseña es opcional. Cuando se establece una contraseña, SQLCipher cifra el libro con AES-256; sin contraseña, el libro es una base de datos SQLite sin cifrar. Las contraseñas olvidadas no se pueden recuperar.

Idioma y región

AloxBook está disponible en español, inglés, alemán, francés e italiano. Puedes cambiar el idioma en cualquier momento desde Ajustes; toda la interfaz se actualiza al instante sin reiniciar.

Los números y las fechas usan el formato regional elegido por separado en Ajustes. Sistema conserva el formato del sistema operativo; Coincidir con el idioma de la aplicación sigue el idioma de la interfaz.

Formato de archivo

Cada libro es un único archivo portátil .aloxbook en la ubicación que elijas. Contiene las cuentas, transacciones, plantillas, ajustes de importación y preferencias del libro; no hay ninguna carpeta de datos adicional que debas mover con él.

• Cierra AloxBook antes de copiar, mover o respaldar el archivo. Así te aseguras de que todos los cambios en la base de datos hayan terminado. Si el archivo está en una carpeta sincronizada, espera también a que termine la sincronización antes de abrir la copia en otro lugar.
• Guarda la contraseña con la información de tus copias de seguridad, pero separada del libro. Un libro cifrado no se puede recuperar sin ella.
• Antes de abrir por primera vez un libro antiguo importante con una versión más reciente de AloxBook, haz una copia normal del archivo.

Actualizaciones de la base de datos

Una versión más reciente de AloxBook puede actualizar directamente la estructura de la base de datos al abrir un libro antiguo. Tus datos permanecen en el mismo archivo, pero puede que una versión anterior de AloxBook ya no pueda abrirlo. AloxBook rechaza una base creada por una versión posterior no compatible en lugar de intentar una reversión insegura.

Acceso y exportación

Un libro sin cifrar es una base de datos SQLite que se puede examinar con herramientas SQLite habituales. Un libro protegido con contraseña requiere una herramienta compatible con SQLCipher y la contraseña correcta. Para el intercambio normal, usa la exportación CSV para exportar las transacciones mostradas, incluidos el filtro y el orden activos. No necesitas una cuenta de AloxBook ni un servicio en la nube para acceder a tus datos o moverlos.

Solución de problemas

Problema de instalación o inicio

Los paquetes oficiales de AloxBook incluyen sus dependencias, por lo que no deberías tener que instalar .NET por separado. Descarga de nuevo el paquete actual, sigue la nota de su guía de instalación y compara el archivo con la suma SHA-256 publicada. Si sigue fallando, contacta con soporte indicando la versión de AloxBook, la versión y arquitectura del sistema operativo, la fuente de instalación, el mensaje de error exacto y el paso que falló.

El archivo no se abre

Si aparece un error al abrir un archivo, comprueba:

• ¿Es un archivo .aloxbook válido?
• ¿Estás introduciendo la contraseña correcta?
• ¿Se creó o actualizó el archivo con una versión más reciente de AloxBook? Actualiza AloxBook antes de intentarlo de nuevo.
• Si el archivo se copió desde una carpeta sincronizada, ¿terminaron la copia y la sincronización después de cerrar AloxBook?
• ¿El archivo está protegido contra escritura? AloxBook puede abrir archivos protegidos en modo solo lectura.

Problemas al importar CSV

Si el CSV de tu banco no se importa correctamente, revisa los ajustes del perfil de importación: delimitador (coma, punto y coma, tabulador), formato de fecha, separador decimal y asignación de columnas. Puedes previsualizar los datos analizados antes de importarlos para comprobar que los ajustes son correctos.

La exportación CSV se ve distinta en una hoja de cálculo

La exportación CSV usa tu región actual para fechas, separadores decimales y delimitador CSV. Las dos primeras filas registran intencionadamente el filtro y la ordenación activos para que el archivo pueda entenderse más adelante.