Usa l'IA per suggerire account e spiegare le transazioni, poi verifica le voci rispetto ai documenti sorgente prima di salvarle. Questa guida esamina un piccolo esempio fittizio attraverso la categorizzazione, la revisione, la validazione e una query che puoi verificare.
Scegli un flusso di lavoro ospitato o locale qui sotto. L'esempio pratico utilizza un file locale di esempio così puoi riprodurre ogni controllo prima di collegare l'IA ai tuoi libri contabili.
Scegli il tuo flusso di lavoro
| La tua configurazione | Inizia qui | Come le modifiche raggiungono il tuo registro |
|---|---|---|
| Usi Beancount.io | Usa Smart Import per i file di estratto conto, o Assistente IA per domande e modifiche proposte. | Rivedi le righe prima di inviare un'importazione. Per le modifiche dell'Assistente, rivedi la diff proposta e scegli Approva o Nega. |
| Usi un client IA esterno | Segui la guida alla configurazione di Beancount MCP per connettere il tuo client a un registro ospitato. | Una prova a secco visualizza in anteprima un'operazione di modifica. Una chiamata di scrittura separata la conferma. I prompt di approvazione dipendono dalle impostazioni del tuo client. |
| Tieni file locali | Usa il convertitore CSV a Beancount o un importatore, poi chiedi a uno strumento IA di suggerire categorie. | Rivedi le voci proposte, valida il file e salva le modifiche accettate. |
L'Assistente ospitato e MCP sono integrazioni di Beancount.io. Installare il motore contabile open-source Beancount non aggiunge questi servizi a un registro locale.
Prima di iniziare
Tieni a portata di mano il tuo estratto conto, il conto a cui appartiene e un elenco di conti di destinazione consentiti. Conserva l’estratto conto originale per poterlo confrontare con il risultato.
Per la procedura locale, installa Beancount usando la guida introduttiva. Ti servirà anche Beanquery per eseguire la query finale da terminale. L'esempio presuppone USD per tutto e nessuna transazione esistente nel file di esempio.
Per i dati reali, decidi quali informazioni il tuo strumento IA può ricevere. Rimuovi gli identificatori non necessari prima di condividere un estratto conto. Un registro locale può comunque inviare dati a un modello cloud tramite un editor o un client MCP. Controlla le politiche sui dati del client e del fornitore del modello; tenere un file sul tuo computer non significa di per sé che il suo contenuto rimanga locale.
1. Inizia con le transazioni sorgente
Il nostro conto corrente fittizio inizia agosto con 1.000,00 USD. Il suo estratto conto contiene tre prelievi e chiude a 805,10 USD dopo quei prelievi:
date,payee,description,amount
2026-08-03,Office Depot,Printer paper,-45.00
2026-08-04,Cloud Hosting Inc,Monthly hosting,-120.00
2026-08-05,Amazon,Online purchase,-29.90Gli importi negativi qui indicano denaro in uscita dal conto corrente. Conferma la convenzione sui segni della tua banca prima di importare; altre esportazioni e importatori potrebbero usare una convenzione diversa.
Nel convertitore CSV, mappa queste quattro colonne e imposta l'account sorgente su Assets:Bank:Checking con valuta USD. Lascia Inverti ogni segno disattivato per questo esempio. Verifica che le registrazioni sorgente siano negative. Un account di destinazione provvisorio è solo un segnaposto finché non hai rivisto le categorie.
Se inizi con un'immagine di ricevuta o un PDF, confronta le date, gli importi, le valute e il numero di transazioni estratte con il documento originale prima di categorizzare qualsiasi cosa. Mantieni i valori sorgente intatti mentre decidi gli account.
2. Chiedi categorie con limiti espliciti
Usa un prompt che nomini gli account consentiti e lasci spazio all'incertezza:
Suggerisci un account di destinazione per ogni riga in questo estratto conto di esempio. L'account sorgente è Assets:Bank:Checking. Usa solo Expenses:Office:Supplies o Expenses:Business:Hosting. Restituisci la data originale, il beneficiario, l'importo, l'account suggerito e una breve motivazione. Se la descrizione è insufficiente, restituisci NEEDS_REVIEW e spiega quali informazioni mancano. Non inventare account, non modificare importi e non scrivere sul registro.
Fornisci le tre righe CSV con il prompt. Un risultato utile sarebbe simile a questo; la formulazione del modello e i suggerimenti possono variare:
| Data | Beneficiario | Importo (USD) | Account suggerito | Motivo della revisione |
|---|---|---|---|---|
| 2026-08-03 | Office Depot | -45.00 | Expenses:Office:Supplies | La descrizione identifica della carta per stampante. |
| 2026-08-04 | Cloud Hosting Inc | -120.00 | Expenses:Business:Hosting | La descrizione identifica un canone di hosting. |
| 2026-08-05 | Amazon | -29.90 | NEEDS_REVIEW | Il nome del venditore non identifica cosa è stato acquistato. |
Il prompt esprime la tua intenzione. Non impone permessi a uno strumento che può scrivere file. Configura i controlli di approvazione del client prima di dargli accesso a un registro reale.
3. Risolvi l'incertezza e rivedi le voci
Controlla la ricevuta per l'acquisto Amazon. In questo esempio, identifica un cavo USB-C per l'ufficio e il revisore assegna Expenses:Office:Supplies. Senza quella prova, lascia la riga in sospeso piuttosto che accettare una categoria ipotizzata.
Crea un nuovo file chiamato review.beancount con l'esempio completo qui sotto. Include le dichiarazioni degli account e il saldo di apertura che il CSV non contiene. Se hai usato il convertitore, confronta le sue transazioni con queste voci revisionate; non aggiungere entrambe le copie allo stesso registro.
option "title" "AI bookkeeping review example"
option "operating_currency" "USD"
2026-08-01 open Assets:Bank:Checking USD
2026-08-01 open Equity:Opening-Balances USD
2026-08-01 open Expenses:Office:Supplies USD
2026-08-01 open Expenses:Business:Hosting USD
2026-08-01 * "Opening balance"
Assets:Bank:Checking 1000.00 USD
Equity:Opening-Balances -1000.00 USD
2026-08-03 * "Office Depot" "Printer paper"
Assets:Bank:Checking -45.00 USD
Expenses:Office:Supplies 45.00 USD
2026-08-04 * "Cloud Hosting Inc" "Monthly hosting"
Assets:Bank:Checking -120.00 USD
Expenses:Business:Hosting 120.00 USD
2026-08-05 * "Amazon" "Online purchase; receipt: office USB-C cable"
Assets:Bank:Checking -29.90 USD
Expenses:Office:Supplies 29.90 USD
2026-08-06 balance Assets:Bank:Checking 805.10 USDLa transazione di saldo iniziale appartiene a questo registro di pratica vuoto. In un registro esistente, usa il suo saldo consolidato e le dichiarazioni degli account invece di aggiungere un altro saldo iniziale.
Prima di accettare una modifica proposta, confronta ogni transazione con la sua riga sorgente. Conferma i segni, la valuta, gli account e la ricevuta di supporto. Un nome di venditore familiare da solo non stabilisce lo scopo di un acquisto.
4. Valida e riconcilia
Esegui il validatore di Beancount sul file locale di esempio:
bea --file review.beancount checkL'esempio completo dovrebbe superare senza errori. La sua asserzione di saldo verifica l'importo sul conto corrente all'inizio del 6 agosto, dopo i tre prelievi precedenti.
Conferma il risultato rispetto all'estratto conto:
- Tre transazioni dell'estratto conto appaiono una volta ciascuna, oltre al saldo iniziale.
- I prelievi totalizzano 194,90 USD.
- Il conto corrente contiene 805,10 USD: i 1.000,00 USD iniziali meno quei prelievi.
- Le forniture per ufficio totalizzano 74,90 USD e l'hosting totalizza 120,00 USD.
Se lasci la transazione Amazon in sospeso, il conto corrente rimane a 835,00 USD e l'asserzione fallisce di 29,90 USD. Investiga quella differenza; non aggiungere una rettifica inspiegabile solo per far passare il controllo.
bea check rileva errori di sintassi, account, bilanciamento e asserzioni di saldo. Non può stabilire che una ricevuta sia autentica, che tu abbia scelto la categoria di spesa giusta o che ogni riga dell'estratto conto sia presente. Una transazione registrata sull'account di spesa sbagliato può comunque bilanciare perfettamente.
Quando qualcosa non corrisponde
| Sintomo | Controllo successivo |
|---|---|
| Il saldo differisce dall'estratto conto | Confronta il saldo iniziale, il numero di transazioni, i segni, le date e gli importi con la sorgente. |
| Due voci sembrano uguali | Confronta gli identificatori delle transazioni sorgente e le ricevute. Lo stesso venditore e importo possono rappresentare due acquisti legittimi. |
| Il modello inventa un account | Scegli un account esistente o creane deliberatamente uno nuovo dopo aver rivisto il tuo piano dei conti. |
| L'estrazione omette una riga o cambia un decimale | Correggi i dati estratti rispetto al documento originale prima di categorizzarli. |
| Il validatore passa ma un report sembra sbagliato | Ispeziona le scelte degli account, il periodo di rendicontazione e le singole registrazioni. |
Chiedi all'IA di spiegare le discrepanze e di indicare le righe interessate. Conferma le prove prima di eliminare un presunto duplicato o modificare un importo.
5. Salva il risultato revisionato e interrogalo
Quando ripeti questo flusso di lavoro con il tuo estratto conto, unisci solo le transazioni revisionate nel tuo registro reale, poi valida il file combinato. Tieni le voci fittizie nel file di esempio. Se usi Git, ispeziona la diff e fai commit attraverso il tuo flusso di lavoro abituale. Tieni l'estratto conto sorgente disponibile per riconciliazioni future. La guida ai flussi di lavoro scriptabili copre l'automazione locale ripetibile.
Puoi verificare i totali dell'esempio con Beancount Query Language. Con Beanquery installato, esegui:
bea --file review.beancount query "SELECT account, sum(position) WHERE account ~ '^Expenses:' AND date >= 2026-08-01 AND date < 2026-09-01 GROUP BY account"I due totali delle spese dovrebbero essere 74,90 USD per le forniture per ufficio e 120,00 USD per l'hosting. Ispeziona l'intervallo di date e il filtro sugli account della query oltre al suo output.
Con un client IA collegato a un registro contenente l'esempio, puoi chiedere:
Interroga il registro di esempio per le spese di agosto 2026 raggruppate per account. Mostra la query e i suoi risultati. Non modificare alcun file.
Confronta la sua risposta con gli stessi totali. Una risposta fluente è utile solo quando i suoi numeri possono essere ricondotti al registro.
Applica il processo di revisione in Beancount.io
Per i file di estratto conto, apri Importa → Smart Import nella barra laterale del tuo registro. Rivedi le righe estratte, scegli Account Sorgente e Valuta, e usa Compilazione IA per i suggerimenti sugli account di destinazione. Correggi le categorie prima di inviare Importa, il cui pulsante include il numero di transazioni. Controlla il giornale risultante e i saldi in un registro di esempio prima di elaborare un estratto conto reale. Verifica che i prelievi riducano l'account sorgente; il CSV sopra è preparato per il convertitore locale e gli importatori possono interpretare i segni in modo diverso.
Per l'Assistente ospitato, apri Chiedi a Beancount.io all'interno del tuo registro. Inizia con una domanda sulle voci esistenti. Quando propone una modifica al file, rivedi la diff prima di approvarla. Le importazioni accettate e le modifiche dell'Assistente sono registrate in Git così puoi ispezionarle o annullarle.
Per MCP, segui le istruzioni di configurazione specifiche del client indicate sopra e autorizza il registro previsto. Chiedi editLedgerFiles con dry_run: true prima di consentire una modifica. Ispeziona i contenuti proposti e il riepilogo dell'operazione, poi consenti una chiamata di scrittura separata solo dopo la revisione. L'anteprima dry-run non stabilisce la correttezza contabile né garantisce che il tuo client chiederà il permesso prima di una scrittura successiva.
Mantieni il processo di revisione mentre automatizzi
Inizia con un piccolo lotto e registra quali suggerimenti modifichi. Trasforma le mappature ripetute e confermate in regole di importazione esplicite o fornisci esempi revisionati come contesto. Non dare per scontato che un modello impari in modo permanente da una correzione in una conversazione.
Mantieni separati i controlli di estrazione, la revisione delle categorie e la riconciliazione dell'estratto conto. Ognuno cattura un tipo diverso di errore. Per le importazioni ricorrenti, controlla anche che importare la stessa sorgente due volte non duplichi silenziosamente le transazioni.
La ricerca supporta questa distinzione tra sintassi valida e contabilità corretta. Lo studio di Figueroa Rosero e colleghi del gennaio 2025 ha valutato piccoli modelli open-weight su scenari di rapporti finanziari e generazione di transazioni utilizzando prompt strutturati. I suoi risultati descrivono quei modelli e compiti, piuttosto che un tasso di accuratezza per gli assistenti odierni o il tuo flusso di importazione. Giudica il tuo flusso di lavoro utilizzando transazioni sorgente controllate e le correzioni che richiedono.
Strumenti per un flusso di lavoro locale ripetibile
Scegli uno strumento per la parte del processo che devi ripetere:
- Beangulp fornisce un framework per importatori. Sostituisce il vecchio framework
beancount.ingestin Beancount 3. - smart_importer è un pacchetto installato separatamente che aggiunge suggerimenti di apprendimento automatico agli importatori. Non è una funzionalità LLM integrata.
- Beanborg documenta la categorizzazione basata su regole, suggerimenti di apprendimento automatico e previsioni ChatGPT opzionali. Controlla la sua configurazione attuale e la compatibilità prima di adottarlo.
Per un contesto più ampio, vedi la guida all'automazione della contabilità e la guida al flusso di lavoro contabile mensile.
Esplora un esempio più ampio
Il registro pubblico qui sotto è separato dall'esercizio con tre transazioni. Usalo per esplorare come account, transazioni e report si combinano prima di collegare l'IA ai tuoi libri contabili.