Scegli una data di passaggio, esporta il bilancio di verifica di QuickBooks per il giorno precedente e apri il tuo libro contabile Beancount con un pad e un balance per ogni conto patrimoniale. Quando bea check passa e il saldo del patrimonio netto corrisponde a QuickBooks, i tuoi libri contabili sono stati spostati. Tutto ciò che segue la data di passaggio viene registrato in Beancount.
Questa guida funziona per QuickBooks Online e QuickBooks Desktop. Non dipende da un importatore QuickBooks, perché nessuno viene fornito con Beancount. Prima sposti i saldi, poi decidi quanta cronologia portare con te.
Se stai ancora decidendo se cambiare, leggi prima Beancount vs QuickBooks.
1. Decidere la data di passaggio e cosa mantenere
Scegli il primo giorno di un anno fiscale, ad esempio 2026-01-01. Un confine annuale mantiene un anno fiscale in un unico sistema. Significa anche che il tuo primo conto economico in Beancount parte da zero.
Decidi ora quanta cronologia Beancount deve contenere:
- Solo saldi. Apri alla data di passaggio e conserva i report di QuickBooks come archivio per gli anni precedenti. Questo è il percorso più rapido, e il resto di questa guida lo presuppone.
- Riepiloghi annuali. Aggiungi una scrittura di riepilogo per ogni anno passato dal bilancio di verifica di ciascun anno. I tuoi report pluriennali funzionano così in Beancount.
- Cronologia completa delle transazioni. Converti l'esportazione del Libro giornale con uno script. Questo è il lavoro maggiore, e la sezione 5 spiega cosa comporta.
Termina la riconciliazione di ogni conto bancario e carta in QuickBooks fino al giorno precedente la data di passaggio. Un saldo non riconciliato trasferisce il suo errore nel tuo nuovo libro contabile.
2. Esportare da QuickBooks
Hai bisogno di tre report, tutti con data di chiusura al giorno precedente la data di passaggio (2025-12-31 in questa guida):
| Report | Cosa ti fornisce |
|---|---|
| Elenco dei conti | Ogni nome e tipo di conto, per la mappatura al punto 3 |
| Bilancio di verifica | Il saldo finale di ogni conto, che diventa i tuoi saldi di apertura |
| Libro giornale | Ogni transazione, per la cronologia e per il tuo archivio |
QuickBooks Online. Vai su Report, poi Report standard, e apri ogni report per nome. Seleziona Esporta/Stampa, poi Esporta in Excel. L'Elenco dei conti è il report del piano dei conti. Lo strumento Esporta dati sotto Impostazioni, nella colonna Strumenti, esporta una serie di report ed elenchi come file Excel in un unico file zip. Intuit documenta entrambi i percorsi in Export your QuickBooks Online data.
Queste esportazioni di QuickBooks Online sono file Excel. Apri ciascuno in un foglio di calcolo e salva una copia CSV se uno script dovrà leggerlo.
Gli allegati vengono esportati separatamente. In QuickBooks Online, vai su Impostazioni, poi Allegati, seleziona i file e scegli Azioni in blocco poi Esporta. Conserva lo zip con il tuo archivio.
QuickBooks Desktop. Su Windows, apri ogni report da Report, poi Centro report. Seleziona Excel, poi Crea nuovo foglio di lavoro. La finestra successiva può salvare direttamente un foglio di lavoro Excel o un file CSV, come descritto in Export reports as Excel workbooks. Desktop può anche esportare elenchi, incluso il piano dei conti, come file IIF: File, poi Utilità, poi Esporta, poi Elenchi in file IIF. L'esportazione IIF copre solo gli elenchi. Intuit afferma che puoi importare le transazioni ma non esportarle, come spiegato in Export, import, and edit IIF files.
Conserva le esportazioni originali invariate. Sono la tua prova se un numero viene contestato in seguito.
3. Mappare i conti su una gerarchia Beancount
Beancount ha cinque conti radice. Ogni tipo di conto QuickBooks finisce sotto uno di essi:
| Tipo di conto QuickBooks | Conto Beancount |
|---|---|
| Banca | Assets:Bank:Checking, Assets:Bank:Savings |
| Crediti verso clienti (A/R) | Assets:AccountsReceivable |
| Altre attività correnti, Immobilizzazioni | Assets:Prepaid:…, Assets:Equipment:… |
| Carta di credito | Liabilities:CreditCard:Visa |
| Debiti verso fornitori (A/P), Altri debiti correnti | Liabilities:AccountsPayable, Liabilities:SalesTax |
| Debiti a lungo termine | Liabilities:Loans:… |
| Patrimonio netto, Utili portati a nuovo, Patrimonio netto di apertura | Equity:Opening-Balances |
| Ricavi, Altri ricavi | Income:Sales, Income:Interest |
| Costo del venduto | Expenses:COGS:… |
| Spese, Altre spese | Expenses:Rent, Expenses:Software |
I nomi dei conti iniziano con una lettera maiuscola e non contengono spazi, quindi "Office Supplies" diventa Expenses:Office-Supplies. I sottoconti di QuickBooks diventano segmenti più profondi, come Expenses:Vehicle:Fuel.
Gli Utili portati a nuovo e il Patrimonio netto di apertura confluiscono in un unico conto Equity:Opening-Balances. Beancount calcola gli utili dell'anno corrente dai tuoi conti di ricavi e spese, quindi non serve riportare alcun conto separato per gli utili portati a nuovo.
4. Aprire il libro contabile alla data di passaggio
Questa azienda di esempio ha un bilancio di verifica di quattro righe al 2025-12-31. Le righe di ricavi e spese sono già confluite negli Utili portati a nuovo. QuickBooks Online fa lo stesso quando inizia un nuovo anno fiscale, come descritto in View retained earnings account details.
| Conto | Dare | Avere |
|---|---|---|
| Conto corrente | 12.450,00 | |
| Crediti verso clienti (A/R) | 3.200,00 | |
| Carta di credito Visa | 1.875,40 | |
| Utili portati a nuovo | 13.774,60 | |
| Totale | 15.650,00 | 15.650,00 |
Salva questo come main.bean:
option "operating_currency" "USD"
2025-12-31 open Assets:Bank:Checking USD
2025-12-31 open Assets:AccountsReceivable USD
2025-12-31 open Liabilities:CreditCard:Visa USD
2025-12-31 open Equity:Opening-Balances USD
; Opening balances from the QuickBooks Trial Balance as of 2025-12-31
2025-12-31 pad Assets:Bank:Checking Equity:Opening-Balances
2025-12-31 pad Assets:AccountsReceivable Equity:Opening-Balances
2025-12-31 pad Liabilities:CreditCard:Visa Equity:Opening-Balances
2026-01-01 balance Assets:Bank:Checking 12450.00 USD
2026-01-01 balance Assets:AccountsReceivable 3200.00 USD
2026-01-01 balance Liabilities:CreditCard:Visa -1875.40 USD
2026-01-01 balance Equity:Opening-Balances -13774.60 USDOgni pad chiede a Beancount di inserire la scrittura che rende vera la successiva asserzione balance. Il lato di bilanciamento di ogni pad va a Equity:Opening-Balances. Un'asserzione balance viene verificata all'inizio della sua data, quindi i pad sono datati al giorno precedente la data di passaggio.
Gli addebiti diventano numeri positivi e gli accrediti diventano numeri negativi. Ecco perché il saldo Visa è -1875.40 USD.
L'ultima riga è la riconciliazione. Il patrimonio netto deve risultare -13774.60 USD, l'accredito degli Utili portati a nuovo. Una cifra di attività o passività digitata male modifica il patrimonio netto inserito dal pad, e quell'asserzione fallisce.
Per un'azienda reale, aggiungi un open, un pad e un balance per ogni conto patrimoniale del bilancio di verifica. Suddividi A/R e A/P in un sottoconto per cliente o fornitore se tieni traccia delle fatture aperte per nome.
5. Importare la cronologia
Dopo la data di passaggio, registra nuove attività in Beancount. Gli estratti conto bancari e delle carte sono la fonte principale. Converti un'esportazione CSV bancaria nel browser con il convertitore da CSV a Beancount, oppure usa la guida all'importazione bancaria per la riga di comando.
Gli anni passati sono opzionali. Non esiste un'importazione con un clic da un'esportazione del Libro giornale di QuickBooks. Spostare quella cronologia è un passaggio di mappatura manuale o tramite script:
- Salva l'esportazione del Libro giornale come CSV.
- Raggruppa le sue righe in transazioni per data e numero di transazione.
- Rinomina ogni conto con la mappatura del punto 3.
- Scrivi ogni gruppo come una transazione Beancount le cui scritture sommano a zero.
Se importi la cronologia, apri i conti all'inizio di quella cronologia invece che alla data di passaggio. Poi mantieni le asserzioni balance del 2026-01-01. Esse dimostrano che la cronologia convertita arriva agli stessi saldi riportati da QuickBooks.
6. Verificare rispetto a QuickBooks
Controlla il libro contabile, poi elenca ogni saldo:
bea --file main.bean check
bea --file main.bean query "SELECT account, sum(position) GROUP BY account ORDER BY account"bea check non segnala errori. La query restituisce quattro righe: Assets:AccountsReceivable a 3200.00 USD, Assets:Bank:Checking a 12450.00 USD, Equity:Opening-Balances a -13774.60 USD, e Liabilities:CreditCard:Visa a -1875.40 USD. Confronta ogni riga con il Bilancio di verifica di QuickBooks riga per riga, con gli accrediti come numeri negativi.
Non hai familiarità con la riga di comando? Installa bea con la guida rapida alla CLI.
7. Cosa non viene trasferito
Una migrazione del libro contabile sposta i saldi contabili e la cronologia. Non sposta le operazioni che QuickBooks gestisce attorno ad essi:
- Fatture e link di pagamento. Le fatture aperte rimangono come saldi A/R. Usa un servizio di fatturazione separato da ora in poi.
- Buste paga. I cicli di pagamento, i moduli fiscali e i registri dei dipendenti rimangono con il tuo fornitore di servizi per le buste paga.
- Dichiarazioni dell'imposta sulle vendite. Beancount registra la passività. La dichiarazione rimane un'attività separata.
- Allegati. Le ricevute e i documenti escono nella loro esportazione zip separata, non nei report.
- Regole dei feed bancari e cronologia delle riconciliazioni. Ricostruisci la categorizzazione come regole di importazione.
La pagina di confronto lo dice chiaramente: non scegliere Beancount presumendo che qualche plugin ricrei l'intera suite operativa di QuickBooks. Scegli Beancount quando il libro contabile stesso è il tuo sistema di registrazione di lungo periodo.
Gestisci una piccola impresa con Beancount? Vedi Beancount.io per le piccole imprese per libri contabili ospitati, sincronizzazione bancaria e collaborazione con il commercialista.