Tutorial de Beancount: instal·lació i primer llibre major

Preparat per prendre el control de les teves finances? Aquesta guia et posarà en marxa amb Beancount en qüestió de minuts. Aprendràs a crear el teu primer llibre major, configurar comptes essencials i registrar les teves primeres transaccions.

Explora el llibre major en directe →

Configuració inicial​

Creació del teu primer llibre major​

; Basic structure for a new ledger
2024-01-01 open Assets:Checking
2024-01-01 open Equity:Opening-Balances
 
2024-01-02 * "Initial Deposit"
  Assets:Checking           100.00 USD
  Equity:Opening-Balances

Configuració essencial​

option "title" "Personal Finance Ledger"
option "operating_currency" "USD"

Organització de fitxers​

Estructura recomanada​

; 1. Configuration Options
option "title" "Personal Ledger"
option "operating_currency" "USD"
 
; 2. Account Declarations
2024-01-01 open Assets:Checking    USD
2024-01-01 open Assets:Savings     USD
2024-01-01 open Expenses:Food      USD
2024-01-01 open Equity:Opening-Balances
 
; 3. Initial Balances
; Pad fills the gap up to Equity:Opening-Balances, so it must be dated
; before the assertion. Balance assertions are checked at the start of
; their day, so assert the next morning.
2024-01-01 pad Assets:Checking Equity:Opening-Balances
2024-01-02 balance Assets:Checking 1000.00 USD
 
; 4. Transactions
2024-01-15 * "Grocery Store" "Weekly groceries"
  Expenses:Food            50.00 USD
  Assets:Checking

Organització per seccions​

1. Comptes permanents

   2024-01-01 open Liabilities:Payables    USD
   2024-01-01 open Assets:Receivables      USD

2. Comptes bancaris

   2024-01-01 open Assets:Bank:Checking     USD
   2024-01-01 open Assets:Bank:Savings      USD
   2024-01-01 open Income:Bank:Interest     USD

3. Comptes d'inversió

   2024-01-01 open Assets:Investment:Cash    USD
   2024-01-01 open Assets:Investment:Stocks  VTSAX
   2024-01-01 open Income:Investment:Dividend USD

Validació i informes​

Validació bàsica​

# Check for errors (exits 0 when clean)
bea --file ledger.beancount check
 
# Browse balances, reports, and charts in the web interface
fava ledger.beancount

bea check és el validador: surt amb codi 0 quan el llibre major està net, i enumera tots els errors i surt amb codi no zero en cas contrari. Instal·la'l amb la guia ràpida de la CLI. Fava és la interfície web: executa-la i obre l'adreça http://localhost:5000 que s'imprimeix per veure el balanç de situació, el compte de resultats i els diaris de comptes.

Informes habituals​

Beancount 3 produeix informes mitjançant la interfície web de Fava, l'ordre única bea report, o consultes ad hoc amb bea query, que executa el Llenguatge de consultes de Beancount. Beancount 3 va eliminar les seves antigues ordres d'informes i de web; bea report i Fava les substitueixen.

# Balance sheet, in one command
bea --file ledger.beancount report balance-sheet
 
# Income statement, in one command
bea --file ledger.beancount report income-statement
 
# Balance-sheet numbers: balances by asset, liability, and equity account
bea --file ledger.beancount query "SELECT account, sum(position) AS balance WHERE account ~ '^(Assets|Liabilities|Equity)' GROUP BY account ORDER BY account"
 
# Income-statement numbers: totals by income and expense account
bea --file ledger.beancount query "SELECT account, sum(position) AS total WHERE account ~ '^(Income|Expenses)' GROUP BY account ORDER BY account"
 
# One account's journal, with a running balance
bea --file ledger.beancount query "SELECT date, narration, position, balance WHERE account = 'Assets:Checking'"

Gestió de saldos inicials​

Exemple de coixí (padding)​

2024-01-01 open Assets:Checking    USD
2024-01-01 open Equity:Opening-Balances
 
; Pad account to match a known balance
2024-01-01 pad Assets:Checking Equity:Opening-Balances
 
; Assert the known balance the next day: assertions are evaluated at the
; start of their date, and the pad transaction must fall before it
2024-01-02 balance Assets:Checking 1525.00 USD

Una afirmació de balance comprova el compte a l'inici de la seva data, per tant s'ha de datar després del pad (o de qualsevol transacció) que ha d'incloure. Datar el pad i el balance el mateix dia deixa el coixí sense utilitzar i l'afirmació curta — Beancount informa d'Unused Pad entry i Balance failed. El compte Equity:Opening-Balances s'ha d'obrir abans de ser compensat amb el coixí.

Tancament de comptes​

2024-01-01 open Assets:OldBank:Checking   USD
2024-06-30 close Assets:OldBank:Checking  ; Account closed

Des-duplicació de transaccions​

Gestió de transferències​

; Credit card payment - combined view
2024-01-15 * "Credit Card Payment"
  Assets:Checking            -500.00 USD
  Liabilities:CreditCard     500.00 USD
 
; Flag for pending match
2024-01-15 * "Pending CC Payment"
  ! Assets:Checking         -500.00 USD
  Liabilities:CreditCard    500.00 USD

Afirmacions de saldo​

; Regular balance checks prevent duplicates
2024-01-31 balance Assets:Checking    2150.25 USD
2024-01-31 balance Liabilities:CreditCard  -350.00 USD

Bones pràctiques​

1. Organització de fitxers

   • Mantingues un fitxer principal al principi
   • Utilitza encapçalaments de secció clars
   • Agrupa els comptes relacionats

2. Noms de comptes

   • Utilitza convencions de nomenclatura coherents
   • Inclou prefixos de país/institució
   • Mantingues una jerarquia lògica

3. Verificació de saldos

   • Afirmacions de saldo regulars
   • Coixins de comptes adequats
   • Seguiment de tancaments de comptes

4. Gestió de divises

   • Declara les divises d'operació
   • Utilitza codis de mercaderia coherents
   • Especifica restriccions de divisa

Passos següents​

Ara que tens un llibre major bàsic configurat:

1. Registra transaccions regulars: Comença amb les teves despeses i ingressos diaris
2. Configura les importacions de comptes bancaris: Utilitza importacions CSV o connexions bancàries per automatitzar l'entrada de dades. Enganxa una exportació d'extracte al convertidor CSV a Beancount per obtenir entrades equilibrades al teu navegador, o utilitza OFX i QIF a Beancount per a descàrregues .ofx, .qfx i .qif.
3. Copia un disseny provat: Descarrega un fitxer inicial executable de les seccions domèstic, pressupost per sobres o freelance dels exemples de llibres majors funcionals, després adapta els patrons de propietat i inversions de la mateixa galeria
4. Aprèn sintaxi avançada: Explora la referència de sintaxi per a escenaris més complexos
5. Genera els teus primers informes: Utilitza les funcions de la interfície d'usuari per crear informes financers i analitzar les teves despeses
6. Treballa des del terminal: Instal·la la línia d'ordres bea amb la guia ràpida de la CLI, després tanca un mes complet de principi a fi amb El teu primer mes amb bea

Referència ràpida​

Tipus de comptes habituals:

• Assets:Bank:Checking - El teu compte corrent
• Expenses:Food:Groceries - Despeses de queviures
• Income:Salary:Company - Ingressos laborals
• Liabilities:CreditCard:Visa - Deute de targeta de crèdit

Ordres essencials:

• bea --file ledger.beancount check - Valida el teu llibre major (surt amb codi no zero en cas d'errors)
• bea --file ledger.beancount report balance-sheet - Imprimeix un balanç de situació
• bea --file ledger.beancount query "SELECT ..." - Consulta saldos i transaccions
• fava ledger.beancount - Inicia la interfície web per a informes i gràfics

Aquestes directrius estableixen una base sòlida per gestionar les finances personals amb Beancount. Preparat per afegir la teva primera transacció? Consulta la nostra guia de transaccions amb la interfície d'usuari.