Documentazione

AloxBook è pensato per offrirti una visione chiara delle finanze quotidiane attraverso una struttura semplice. I dati vengono conservati in file SQLite locali sotto il tuo controllo e l'interfaccia rende intuitiva la partita doppia anche a chi non la conosce.

Panoramica

AloxBook utilizza la contabilità in partita doppia: ogni transazione trasferisce un importo da un conto di origine a uno di destinazione. Questa semplice regola offre una visione affidabile della provenienza del denaro, della sua destinazione e dei motivi per cui cambiano i saldi.

Installazione

Requisiti di sistema

• Windows 10 o successivo (64 bit)
• macOS 15 Sequoia o successivo (Apple Silicon o Intel)
• Linux: Flatpak su x86_64 o aarch64 oppure AppImage su x86_64

Installazione

In Windows, installa preferibilmente AloxBook dal Microsoft Store. È il metodo di installazione consigliato e offre aggiornamenti gestiti dallo Store. I pacchetti diretti Setup.exe e WinGet restano disponibili come alternative. Per le altre piattaforme, scegli il pacchetto nella sezione Download. La relativa guida contiene i passaggi aggiornati e le note specifiche per la piattaforma. I pacchetti AloxBook sono autonomi: non è necessario installare separatamente .NET o altre dipendenze dell'applicazione.

Aggiornamenti

• Microsoft Store: gli aggiornamenti delle installazioni dallo Store vengono distribuiti tramite Microsoft Store.
• Setup.exe, WinGet, DMG macOS e AppImage: quando la ricerca degli aggiornamenti è attiva, AloxBook scarica una nuova versione in background e la applica dopo la chiusura; la nuova versione si avvia al lancio successivo.
• Flathub: il centro software o flatpak update installa gli aggiornamenti. Per questo AloxBook nasconde la propria impostazione di aggiornamento all'interno di Flatpak.
• Pacchetto Flatpak diretto: questa alternativa avanzata non dispone di una fonte di aggiornamento gestita. Installa AloxBook da Flathub se desideri aggiornamenti automatici del pacchetto.

Verifica di un download diretto

Il collegamento ai checksum accanto alla versione corrente nella sezione Download elenca l'hash SHA-256 di ogni file pubblicato. Un valore corrispondente dimostra che il file coincide con quello pubblicato; poiché il manifesto proviene dallo stesso sito, non dimostra in modo indipendente l'identità dell'editore. Il pacchetto macOS firmato e la scheda Flathub verificata offrono controlli aggiuntivi sull'editore.

Primi passi

1. Crea un nuovo file — scegli File → Nuovo e salvalo in una posizione che renda semplici i backup
2. Imposta una password — proteggi il file se altre persone possono accedere allo stesso dispositivo (facoltativo, ma consigliato)
3. Scegli un piano dei conti — parti da una struttura che potrai rinominare e adattare in seguito, anziché da un elenco vuoto
4. Aggiungi le prime transazioni — comincia da stipendio, affitto, spesa, trasferimenti o altri movimenti ricorrenti

Conti

In AloxBook i conti sono organizzati in un albero gerarchico che parte da tre conti principali:

• Attività e debiti — conti correnti, contanti, risparmi, immobili e debiti come prestiti o carte di credito (saldi negativi)
• Entrate — stipendio, interessi, dividendi, rimborsi e altro
• Uscite — affitto, spesa alimentare, utenze, tempo libero e altro

Puoi creare sottoconti a qualsiasi livello. Ad esempio, sotto Uscite potresti avere Abitazione → Affitto e Abitazione → Utenze. I saldi vengono sommati lungo l'albero.

Creazione di un conto

Apri la scheda Conti, fai clic con il pulsante destro del mouse sul conto padre (oppure usa la barra degli strumenti), seleziona Aggiungi conto e assegnagli un nome.

Transazioni

Una transazione in AloxBook coinvolge sempre due conti: il denaro passa da un conto a un altro. È il principio fondamentale della contabilità in partita doppia.

Esempi:

• Entrate: Stipendio → Attività e debiti: Conto corrente — ricevi lo stipendio
• Attività e debiti: Conto corrente → Uscite: Spesa alimentare — fai la spesa
• Attività e debiti: Conto corrente → Attività e debiti: Risparmi — trasferisci denaro sul conto di risparmio
• Entrate: Stipendio → Uscite: Spesa alimentare — paghi il pasto in mensa direttamente dalla busta paga

Creazione di una transazione

Nella scheda Transazioni, fai clic sul pulsante +. Inserisci la data, il conto di origine, il conto di destinazione, l'importo e il testo della descrizione.

Modelli

I modelli permettono di salvare le transazioni usate più spesso e riutilizzarle rapidamente. Un modello memorizza il conto di origine, quello di destinazione, l'importo e il testo descrittivo (tutti facoltativi).

Per creare un modello, apri la scheda Modelli e fai clic sul pulsante +. Per applicarlo, selezionalo dall'elenco nella finestra "Crea nuova transazione": i valori del modello verranno inseriti automaticamente.

Importazione CSV

AloxBook può importare estratti conto bancari da file CSV. Il sistema di importazione è altamente configurabile:

• I profili di importazione vengono creati e salvati automaticamente dopo l'assegnazione a un conto
• Le regole di importazione associano automaticamente le transazioni a un modello in base a pattern di testo e importi
• Ogni transazione viene mostrata in anteprima e può essere modificata singolarmente prima del salvataggio
• Il rilevamento dei duplicati impedisce di importare due volte le stesse transazioni

Configurazione dell'importazione CSV

1. Apri la scheda Transazioni
2. Fai clic sul pulsante Importa CSV nella barra degli strumenti
3. Seleziona il tuo file CSV
4. La mappatura delle colonne viene rilevata automaticamente; è possibile regolare i dettagli manualmente
5. Controlla l'anteprima e fai clic su Importa

Rilevamento automatico del formato

L'importazione CSV è progettata per adattarsi a formati diversi. Rileva automaticamente il separatore, la codifica del testo, il formato della data, il separatore decimale, le righe di intestazione e il contenuto delle colonne. In questo modo, i file esportati dalla maggior parte delle banche e delle carte di credito possono essere importati senza configurazione manuale. Se un'impostazione non viene riconosciuta correttamente, puoi modificarla nei dettagli dell'importazione. Sono supportate anche colonne separate dare/avere e campi di riferimento, descrizione e beneficiario separati da barre verticali.

Formati bancari verificati

A ogni versione, i formati di esportazione elencati di seguito vengono verificati automaticamente usando file di esempio reali, per assicurarsi che siano riconosciuti senza configurazione. Si tratta soltanto di una selezione, non di un elenco completo: molte altre banche usano formati simili che vengono importati altrettanto bene.

Esportazione CSV

AloxBook può esportare in un file CSV la vista delle transazioni attualmente visualizzata. Il file contiene le stesse righe, nello stesso ordine della tabella, e rispetta i filtri e l'ordinamento attivi.

• Le prime righe CSV descrivono il filtro e l'ordinamento attivi, quindi i file esportati mantengono il loro contesto
• Le date e gli importi vengono formattati in base alle impostazioni regionali correnti
• Il separatore dipende dal formato regionale: punto e virgola quando la virgola è usata come separatore decimale, virgola negli altri casi
• Il file usa la codifica UTF-8 con BOM, per una migliore compatibilità con i fogli di calcolo

Esportazione di transazioni

1. Apri la scheda Transazioni
2. Applica qualsiasi filtro o ordinamento che desideri esportare
3. Fai clic sul pulsante Esporta CSV nella barra degli strumenti
4. Scegli il nome e il percorso del file di destinazione

Chiusura e riporto

Se preferisci conservare un file per ogni periodo contabile, ad esempio uno per anno, la funzione Chiudi e riporta il file semplifica l'operazione:

1. Scegli File → Chiudi e riporta il file
2. AloxBook crea un nuovo file con l'intera struttura dei conti
3. I saldi dei conti Attività vengono riportati come saldi iniziali
4. I modelli vengono copiati nel nuovo file
5. I conti delle entrate e delle uscite ricominciano da zero
6. Il tuo vecchio file rimane intatto ed è contrassegnato come protetto da scrittura

In questo modo inizi il nuovo periodo con ordine e conservi l'intera cronologia nel file precedente.

Crittografia

La protezione con password è facoltativa. Quando viene impostata una password, SQLCipher cifra il libro con AES-256; senza password, il libro è un database SQLite non cifrato. Le password dimenticate non possono essere recuperate.

Lingua e formati regionali

AloxBook supporta inglese, tedesco, francese, spagnolo e italiano. Puoi cambiare lingua in qualsiasi momento nelle Impostazioni: l'intera interfaccia si aggiorna immediatamente, senza riavviare l'app.

Il formato di numeri e date può essere scelto separatamente nelle Impostazioni. Sistema usa il formato del sistema operativo, mentre Come la lingua dell'app segue la lingua dell'interfaccia.

Formato file

Ogni libro è un unico file portatile .aloxbook nella posizione scelta. Contiene conti, transazioni, modelli, impostazioni di importazione e preferenze specifiche del libro; non esiste una cartella dati separata da spostare insieme al file.

• Chiudi AloxBook prima di copiare, spostare o includere il file in un backup. In questo modo tutte le modifiche al database saranno terminate. Se il file si trova in una cartella sincronizzata, attendi anche il completamento della sincronizzazione prima di aprire la copia altrove.
• Conserva la password insieme alle informazioni sui backup, ma separata dal libro. Un libro crittografato non può essere recuperato senza password.
• Prima di aprire per la prima volta un vecchio libro importante con una versione più recente di AloxBook, crea una normale copia del file.

Aggiornamenti del database

Una versione più recente di AloxBook può aggiornare sul posto la struttura del database quando apre un vecchio libro. I dati rimangono nello stesso file, ma una versione precedente di AloxBook potrebbe poi non riuscire più ad aprirlo. AloxBook rifiuta di aprire un database creato da una versione più recente non supportata invece di tentare un ripristino rischioso.

Accesso ed esportazione

Un libro non crittografato è un database SQLite esaminabile con i comuni strumenti SQLite. Un libro protetto da password richiede uno strumento compatibile con SQLCipher e la password corretta. Per il normale scambio di dati, usa l'esportazione CSV per esportare le transazioni visualizzate, inclusi filtro e ordinamento attivi. Non servono un account AloxBook o un servizio cloud per accedere ai dati o spostarli.

Risoluzione dei problemi

Problema di installazione o avvio

I pacchetti ufficiali di AloxBook includono le dipendenze dell'applicazione, quindi non dovrebbe essere necessario installare .NET separatamente. Scarica di nuovo il pacchetto corrente, segui la nota nella relativa guida di installazione e confronta il file con il checksum SHA-256 pubblicato. Se il problema persiste, contatta l'assistenza indicando versione di AloxBook, versione e architettura del sistema operativo, fonte di installazione, messaggio di errore esatto e passaggio non riuscito.

Il file non si apre

Se ricevi un errore durante l'apertura di un file, controlla:

• Il file è un file .aloxbook valido?
• Stai inserendo la password corretta?
• Il file è stato creato o aggiornato da una versione più recente di AloxBook? Aggiorna AloxBook prima di riprovare.
• Se il file è stato copiato da una cartella sincronizzata, copia e sincronizzazione erano terminate dopo la chiusura di AloxBook?
• Il file è protetto da scrittura? AloxBook può aprire file protetti da scrittura in modalità di sola lettura.

Problemi di importazione CSV

Se il CSV della tua banca non viene importato correttamente, controlla le impostazioni del profilo di importazione: delimitatore (virgola, punto e virgola, tabulazione), formato della data, separatore decimale e mappatura delle colonne. È possibile visualizzare in anteprima i dati analizzati prima dell'importazione per verificare che le impostazioni siano corrette.

L'esportazione CSV ha un aspetto diverso in un foglio di calcolo

L'esportazione CSV utilizza le impostazioni regionali correnti per date, separatori decimali e delimitatore CSV. Le prime due righe riportano intenzionalmente il filtro e l'ordinamento attivi, così da conservare il contesto del file.