Tria una data de transició, exporta el balanç de comprovació de QuickBooks del dia anterior i obre el teu llibre major de Beancount amb un pad i un balance per cada compte del balanç de situació. Quan bea check passi i el saldo del patrimoni net coincideixi amb QuickBooks, la teva comptabilitat s'haurà traslladat. Tot el que passi després de la transició es registra a Beancount.
Aquesta guia funciona per a QuickBooks Online i QuickBooks Desktop. No depèn de cap importador de QuickBooks, perquè Beancount no n'inclou cap. Primer trasllades els saldos, després decideixes quanta història vols arrossegar.
Si encara estàs decidint si fer el canvi, llegeix primer Beancount vs QuickBooks.
1. Decideix la data de transició i què conserves
Tria el primer dia d'un any fiscal, com ara 2026-01-01. Una frontera d'any manté un any fiscal en un sol sistema. També significa que el teu primer compte de resultats a Beancount comença des de zero.
Decideix ara quanta història ha de contenir Beancount:
- Només saldos. Obre a la data de transició i conserva els informes de QuickBooks com a arxiu per als anys anteriors. Aquest és el camí més ràpid, i la resta d'aquesta guia ho assumeix.
- Resums anuals. Afegeix una entrada resum per cada any passat a partir del balanç de comprovació de cada any. Així els teus informes pluriennals funcionaran a Beancount.
- Història completa de transaccions. Converteix l'exportació del Llibre Major amb un script. Aquesta és la feina més gran, i la secció 5 explica què implica.
Acaba de conciliar cada compte bancari i de targeta a QuickBooks fins al dia abans de la transició. Un saldo no conciliat trasllada el seu error al teu nou llibre major.
2. Exporta des de QuickBooks
Necessites tres informes, tots amb data de tancament del dia abans de la transició (2025-12-31 en aquesta guia):
| Informe | Què et proporciona |
|---|---|
| Llista de comptes | El nom i el tipus de cada compte, per a la mapificació del pas 3 |
| Balanç de comprovació | El saldo final de cada compte, que es converteix en els teus saldos d'obertura |
| Llibre Major | Cada transacció, per a la història i per al teu arxiu |
QuickBooks Online. Ves a Reports, després a Standard reports, i obre cada informe pel seu nom. Selecciona Export/Print, després Export to Excel. La Llista de comptes és l'informe del pla de comptes. L'eina Export data a Settings, a la columna Tools, exporta un conjunt d'informes i llistes com a fitxers Excel en un sol fitxer zip. Intuit documenta tots dos camins a Export your QuickBooks Online data.
Aquestes exportacions de QuickBooks Online són fitxers Excel. Obre cada un en un full de càlcul i desa'n una còpia en CSV si un script l'ha de llegir.
Els Adjunts s'exporten per separat. A QuickBooks Online, ves a Settings, després a Attachments, selecciona els fitxers i tria Batch actions i després Export. Conserva el zip amb el teu arxiu.
QuickBooks Desktop. A Windows, obre cada informe des de Reports, després Reports Center. Selecciona Excel, després Create New Worksheet. La finestra següent pot desar un llibre d'Excel o un fitxer CSV directament, tal com es descriu a Export reports as Excel workbooks. Desktop també pot exportar llistes, inclòs el pla de comptes, com a fitxer IIF: File, després Utilities, després Export, després Lists to IIF Files. L'exportació IIF només cobreix llistes. Intuit afirma que pots importar transaccions però no exportar-les, tal com s'explica a Export, import, and edit IIF files.
Conserva les exportacions originals sense modificar. Són la teva evidència si més endavant es qüestiona algun número.
3. Mapifica els comptes a una jerarquia de Beancount
Beancount té cinc comptes arrel. Cada tipus de compte de QuickBooks encaixa sota un d'ells:
| Tipus de compte de QuickBooks | Compte de Beancount |
|---|---|
| Bank | Assets:Bank:Checking, Assets:Bank:Savings |
| Accounts receivable (A/R) | Assets:AccountsReceivable |
| Other Current Assets, Fixed Assets | Assets:Prepaid:…, Assets:Equipment:… |
| Credit Card | Liabilities:CreditCard:Visa |
| Accounts payable (A/P), Other Current Liabilities | Liabilities:AccountsPayable, Liabilities:SalesTax |
| Long Term Liabilities | Liabilities:Loans:… |
| Equity, Retained Earnings, Opening Balance Equity | Equity:Opening-Balances |
| Income, Other Income | Income:Sales, Income:Interest |
| Cost of Goods Sold | Expenses:COGS:… |
| Expenses, Other Expense | Expenses:Rent, Expenses:Software |
Els noms de compte comencen amb una lletra majúscula i no contenen espais, així que "Office Supplies" es converteix en Expenses:Office-Supplies. Els subcomptes de QuickBooks es converteixen en segments més profunds, com ara Expenses:Vehicle:Fuel.
Retained Earnings i Opening Balance Equity es col·lapsen en un sol compte Equity:Opening-Balances. Beancount calcula els guanys de l'any en curs a partir dels teus comptes d'ingressos i despeses, així que no cal arrossegar cap compte de resultats retinguts separat.
4. Obre el llibre major a la data de transició
Aquesta empresa d'exemple té un balanç de comprovació de quatre línies el 2025-12-31. Les línies d'ingressos i despeses ja estan incorporades a Retained Earnings. QuickBooks Online fa el mateix quan comença un any fiscal nou, tal com es descriu a View retained earnings account details.
| Compte | Deure | Haver |
|---|---|---|
| Checking | 12.450,00 | |
| Accounts Receivable (A/R) | 3.200,00 | |
| Visa credit card | 1.875,40 | |
| Retained Earnings | 13.774,60 | |
| Total | 15.650,00 | 15.650,00 |
Desa-ho com a 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 USDCada pad demana a Beancount que insereixi l'entrada que fa certa la següent afirmació balance. El costat compensador de cada pad va a Equity:Opening-Balances. Una afirmació balance es comprova a l'inici de la seva data, així que els pads es daten el dia abans de la transició.
Els deures es converteixen en números positius i els havers en negatius. Per això el saldo de Visa és -1875.40 USD.
L'última línia és la quadratura. El patrimoni net ha de sumar -13774.60 USD, el crèdit de Retained Earnings. Una xifra mal escrita d'un actiu o un passiu canvia el patrimoni net introduït pel pad, i aquesta afirmació falla.
Per a una empresa real, afegeix un open, un pad i un balance per cada compte del balanç de situació del balanç de comprovació. Divideix A/R i A/P en un subcompte per client o proveïdor si fas el seguiment de factures obertes per nom.
5. Incorpora la història
Després de la transició, registra l'activitat nova a Beancount. Els extractes bancaris i de targeta són la font principal. Converteix una exportació CSV del banc al navegador amb el CSV to Beancount converter, o fes servir la guia d'importació bancària per a la línia de comandes.
Els anys passats són opcionals. No hi ha importació amb un sol clic des d'una exportació del Llibre Major de QuickBooks. Traslladar aquesta història és un pas de mapificació manual o amb script:
- Desa l'exportació del Llibre Major com a CSV.
- Agrupa les seves files en transaccions per data i número de transacció.
- Reanomena cada compte amb la teva mapificació del pas 3.
- Escriu cada grup com una transacció de Beancount les anotacions de la qual sumin zero.
Si incorpores la història, obre els comptes a l'inici d'aquella història en lloc de a la data de transició. Llavors conserva les afirmacions balance del 2026-01-01. Demostren que la història convertida arriba als mateixos saldos que QuickBooks va reportar.
6. Verifica contra QuickBooks
Comprova el llibre major i després llista cada saldo:
bea --file main.bean check
bea --file main.bean query "SELECT account, sum(position) GROUP BY account ORDER BY account"bea check no reporta cap error. La consulta retorna quatre files: Assets:AccountsReceivable a 3200.00 USD, Assets:Bank:Checking a 12450.00 USD, Equity:Opening-Balances a -13774.60 USD, i Liabilities:CreditCard:Visa a -1875.40 USD. Compara cada fila amb el balanç de comprovació de QuickBooks línia per línia, amb els havers com a números negatius.
Ets nou a la línia de comandes? Instal·la bea amb la CLI quick start.
7. Què no es trasllada
Una migració de llibre major trasllada saldos i història comptables. No trasllada les operacions que QuickBooks gestiona al seu voltant:
- Factures i enllaços de pagament. Les factures obertes romanen com a saldos d'A/R. Fes servir un servei de facturació independent a partir d'ara.
- Nòmines. Les execucions de nòmina, els formularis d'impostos i els registres d'empleats es queden amb el teu proveïdor de nòmines.
- Declaracions d'impostos sobre vendes. Beancount registra el passiu. La declaració segueix sent una tasca a part.
- Adjunts. Els rebuts i documents surten en la seva pròpia exportació zip, no en els informes.
- Regles de connexions bancàries i historial de conciliació. Reconstrueix la categorització com a regles d'importació.
La pàgina de comparació ho diu clarament: no triïs Beancount assumint que uns quants complements recrearan tot el conjunt operatiu de QuickBooks. Tria'l quan el llibre major mateix sigui el teu sistema de registre de llarga durada.
Portes una petita empresa amb Beancount? Consulta Beancount.io for small business per a llibres major allotjats, sincronització bancària i col·laboració amb el comptable.