# Migrare da QuickBooks a Beancount: una guida al passaggio

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](/compare/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](https://quickbooks.intuit.com/learn-support/en-us/help-article/list-management/export-reports-lists-data-quickbooks-online/L1xleDrLp_US_en_US).

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](https://quickbooks.intuit.com/learn-support/en-us/help-article/export-reports/export-reports-excel-workbooks-quickbooks-desktop/L4cLJEeXt_US_en_US). 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](https://quickbooks.intuit.com/learn-support/en-us/help-article/import-export-data-files/export-import-edit-iif-files/L56LT9Z0Q_US_en_US).

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](https://quickbooks.intuit.com/learn-support/en-us/help-article/financial-reports/view-retained-earnings-account-details/L7d6Ugx58_US_en_US).

| 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`:

```beancount
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 USD
```

Ogni `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](/tools/csv-to-beancount), oppure usa la [guida all'importazione bancaria](https://beancount.io/it/docs/Solutions/import-bank-exports-cli) 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:

1. Salva l'esportazione del Libro giornale come CSV.
2. Raggruppa le sue righe in transazioni per data e numero di transazione.
3. Rinomina ogni conto con la mappatura del punto 3.
4. 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:

```bash
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](https://beancount.io/it/docs/Basics/bea-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](/for-small-business) per libri contabili ospitati, sincronizzazione bancaria e collaborazione con il commercialista.
