Introducció a Beancount.io

Aquesta guia sintetitza les millors pràctiques per a la comptabilitat en text pla utilitzant la potent eina de comptabilitat en text pla de codi obert, Beancount. Cobreix la filosofia fonamental, la sintaxi bàsica a avançada, estudis de casos pràctics per a actius complexos i estratègies de gestió de llibres majors a llarg termini.

Part 1: El "Per què" - Fonaments de la Comptabilitat Intel·ligent

Abans d'endinsar-nos en el "com", és crucial entendre el "per què". Una comptabilitat eficaç és la base de la gestió financera personal i un pas necessari cap a la claredat i la llibertat financera.

Més enllà del Seguiment de Despeses: El Camí cap a la Claredat Financera

Les aplicacions senzilles de seguiment de despeses t'indiquen on van els teus diners. Un sistema comptable sòlid t'indica això i molt més: proporciona una imatge completa de la teva salut financera, inclòs el teu patrimoni net, el flux de caixa i el rendiment de les teves inversions. L'objectiu principal és l'observabilitat: obtenir una comprensió clara i basada en dades de la teva vida financera, que et permeti prendre decisions informades, avaluar el risc i treballar cap a objectius a llarg termini com la jubilació.

Per Què la Partida Doble? El Poder d'un Sistema Equilibrat

A diferència de la comptabilitat de partida simple (una simple llista de despeses), el mètode de la partida doble registra cada transacció com un flux de valor entre almenys dos comptes. El seu principi bàsic és l'equació comptable fonamental:

$\text{Actius} = \text{Passius} + \text{Patrimoni Net}$

Aquest sistema garanteix que els teus llibres estiguin sempre equilibrats, reduint dràsticament els errors. Proporciona una imatge financera completa generant informes essencials com un Balanç (el que tens i el que deus) i un Compte de Resultats (el que has guanyat i gastat).

Part 2: Començant amb Beancount

Beancount és una potent eina basada en Python per a la comptabilitat en text pla.

La Teva Primera Mirada amb Fava a Beancount.io

Beancount.io proporciona un entorn potent que combina el motor de Beancount amb una aplicació mòbil (iOS, Android) i una aplicació web - Fava, una fantàstica interfície basada en web per visualitzar el teu llibre major. No cal instal·lar res. Quan utilitzes la plataforma, interactues directament amb un editor de text per al teu fitxer de llibre major (per exemple, main.bean) i veus els informes generats per Fava actualitzar-se en temps real.

Fava agafa el text pla que escrius i el converteix en gràfics interactius, estats financers i llistes de transaccions filtrables, donant-te una visió clara dels teus informes financers.

Els Cinc Tipus de Compte Principals

Beancount utilitza cinc tipus de compte de nivell superior, que formen l'estructura del teu llibre major:

Tipus de Compte	Descripció	Saldo Típic
Actius	El que posseeixes (efectiu, comptes bancaris, inversions, propietats).	Positiu
Passius	El que deus (deute de targeta de crèdit, préstecs, hipoteques).	Negatiu
Ingressos	D'on provenen els diners (sou, bonificacions, interessos).	Negatiu
Despeses	On van els diners (menjar, lloguer, viatges, impostos).	Positiu
Patrimoni	El teu patrimoni net; utilitzat per als saldos inicials.	Negatiu

L'Equació de Beancount

Beancount imposa la seva pròpia versió de l'equació comptable on la suma de tots els apunts a través de tot el teu llibre major és igual a zero:

$\text{Actius} + \text{Despeses} + \text{Passius} + \text{Ingressos} + \text{Patrimoni} = 0$

Aquesta és la raó per la qual, per convenció, els comptes d'Ingressos, Passius i Patrimoni tenen valors negatius: són les fonts de fons que augmenten els teus Actius i Despeses.

Part 3: El Llenguatge de Beancount - Sintaxi Bàsica

Totes les entrades a Beancount són directives que comencen amb una data.

Definició de Comptes (open) i Mercaderies

Abans de poder utilitzar un compte, l'has de declarar amb la directiva open. També pots especificar opcionalment les monedes o "mercaderies" que contindrà.

; AAAA-MM-DD open Compte:Nom [Mercaderia1, Mercaderia2, ...]
2020-01-01 open Actius:Banc:US:Chase:Checking      USD
2020-01-01 open Passius:TargetaCrèdit:US:Discover USD
2020-01-01 open Despeses:Menjar:Queviures
2020-01-01 open Ingressos:Sou:Google

Les mercaderies poden ser monedes del món real (per exemple, USD, JPY) o qualsevol unitat personalitzada que defineixis, com ara milles aèries (MILES_UA) o símbols borsaris (HOOL).

Registrant la Teva Primera Transacció (*)

Les transaccions són l'entrada més comuna. Comencen amb una data, una bandera (* per a una transacció completa o ! per a una d'incompleta), un pagador opcional i una descripció. Cada línia que segueix (amb una sangria de dos espais) és un "apunt" a un compte.

; AAAA-MM-DD * "Pagador" "Descripció"
;   Compte1      Import Mercaderia
;   Compte2     -Import Mercaderia

2024-07-28 * "Trader Joe's" "Queviures setmanals"
  Despeses:Menjar:Queviures     125.50 USD
  Passius:TargetaCrèdit:US:Discover  -125.50 USD

Per comoditat, si una transacció només té dos apunts, pots ometre l'import a la segona línia i Beancount el calcularà automàticament.

2024-07-28 * "Trader Joe's" "Queviures setmanals"
  Despeses:Menjar:Queviures     125.50 USD
  Passius:TargetaCrèdit:US:Discover

Equilibri a Nivell de Transacció: Més important encara per a l'ús diari, cada transacció individual també s'ha d'equilibrar: la suma de tots els apunts dins d'una sola transacció ha de ser igual a zero. Si una transacció no s'equilibra, Beancount mostrarà un error com aquest:

Gestionant Transaccions Multidivisa (@ i @@)

Beancount destaca en la comptabilitat multidivisa.

• Utilitza @ per especificar un preu de conversió per unitat.
• Utilitza @@ per especificar el cost total de la conversió.

; Comprant un vol en EUR amb una targeta USD
2024-08-01 * "Lufthansa" "Vol a Berlín"
  Despeses:Viatges:Vols      500.00 EUR @@ 545.00 USD  ; 500 EUR em van costar 545 USD en total
  Passius:TargetaCrèdit:US:Discover  -545.00 USD

Part 4: Garantint la Precisió - L'Art de la Reconciliació

Una pràctica clau per mantenir un llibre major precís és la reconciliació regular. Això implica comparar els saldos al teu llibre major de Beancount amb els extractes oficials de les teves institucions financeres.

Automatitzant Comprovacions amb Assercions de Saldo (balance)

La directiva balance és la teva eina principal per a les comprovacions automatitzades. Afirmes que en una data determinada, un compte tenia un saldo específic. Beancount generarà un error si el seu saldo calculat no coincideix amb la teva afirmació. Això és valuós per localitzar errors ràpidament.

Nota: L'asserció de saldo comprova l'estat del compte al principi del dia especificat (abans de qualsevol transacció d'aquell dia).

; Del teu extracte mensual de la targeta de crèdit
2024-08-01 balance Passius:TargetaCrèdit:US:Discover  -1432.78 USD

Enllaçant Documents de Suport (document)

Pots enllaçar a fitxers externs com extractes bancaris o rebuts, creant un rastre auditable. Fava fa que aquests enllaços es puguin fer clic.

2024-08-01 document Passius:TargetaCrèdit:US:Discover "statements/discover-2024-07.pdf"

Corregint Errors i Inicialitzant Saldos

Quan comences el teu llibre major o trobes una discrepància que no pots rastrejar, has de fer un ajust. La pràctica estàndard és utilitzar un compte especial de Patrimoni.

; Inicialitzant un compte d'efectiu quan comences el teu llibre major
2020-01-01 * "Saldo Inicial" "Configurant el compte d'efectiu"
  Actius:Efectiu:Cartera           200.00 USD
  Patrimoni:Saldos-Inicials     -200.00 USD

El compte Patrimoni:Saldos-Inicials conté imports que entren al teu llibre major de fonts desconegudes o externes.

Per a solucions ràpides on la discrepància exacta no és important, la directiva pad pot ajustar automàticament el saldo d'un compte per complir amb una asserció de balance posterior, reservant la diferència a un compte de patrimoni. Utilitza això amb precaució, ja que pot amagar problemes més grans. Els ajustos explícits són generalment més segurs.

Part 5: Patrons de Transacció Avançats i Realistes

Seguiment de Deutes: Gestionant Comptes a Cobrar i a Pagar

La comptabilitat per partida doble és perfecta per fer el seguiment dels diners que et deuen (Actius:ComptesACobrar) o que deus tu (Passius:ComptesAPagar).

Exemple: Pagues un sopar de grup de 90 $, i el teu amic Bob et deu la seva part de 45$.

1. Registra la despesa inicial i el compte a cobrar:

   2024-08-05 * "Restaurant" "Sopar amb Bob"
     Despeses:Menjar:Restaurant          45.00 USD  ; La teva part
     Actius:ComptesACobrar:Bob            45.00 USD  ; Bob et deu
     Actius:Banc:US:Chase:Checking    -90.00 USD

2. Quan Bob et torna els diners:

   2024-08-06 * "Bob" "Em va tornar els diners del sopar"
     Actius:Banc:US:Chase:Checking     45.00 USD
     Actius:ComptesACobrar:Bob           -45.00 USD

El compte Actius:ComptesACobrar:Bob ara és zero, i els teus llibres estan perfectament equilibrats.

Actius vs. Despeses: Una Compra de Cotxe i la Depreciació

Una compra gran com un cotxe no és una simple despesa; és l'adquisició d'un actiu que perd valor amb el temps (depreciació).

1. Registra la compra com un actiu:

   2023-01-15 * "Concessionari Toyota" "Compra d'un cotxe nou"
     Actius:Cotxe:ToyotaCamry         30000.00 USD
     Actius:Banc:US:Chase:Checking -30000.00 USD

2. Registra la depreciació anual: Assumeix que estimes que el cotxe perd 3.000 $ de valor cada any. Al final de l'any, registra això com una despesa.

   2023-12-31 * "Depreciació" "Depreciació anual del valor del cotxe"
     Despeses:Depreciació:Cotxe      3000.00 USD
     Actius:Cotxe:ToyotaCamry        -3000.00 USD

Després d'aquesta entrada, el teu compte Actius:Cotxe:ToyotaCamry reflecteix correctament el nou valor del cotxe (27.000 $), i has comptabilitzat correctament el cost d'ús com una despesa per a aquest any.

Part 6: Anàlisi Profunda - Modelant Actius Complexos del Món Real

Cas Pràctic 1: Comptabilització de Béns Immobles

Una casa sol ser el teu actiu i passiu més gran. Aquí t'expliquem com modelar-lo.

1. Crea Comptes i una Mercaderia Personalitzada:

   2022-01-01 commodity CASA_123PRINCIPAL
     name: "Propietat al Carrer Principal 123"
   2022-01-01 open Actius:Propietat:Casa:123Principal        CASA_123PRINCIPAL
   2022-01-01 open Passius:Hipoteca:PréstecHabitatge       USD
   2022-01-01 open Despeses:Casa:Interessos
   2022-01-01 open Despeses:Casa:ImpostSobrelaPropietat

2. Registra la Compra: Digamos que compres una casa de 500.000 $amb un pagament inicial de 100.000$ i un préstec de 400.000 $.

   2022-03-15 * "Companyia de Liquidació" "Compra del Carrer Principal 123"
     Actius:Propietat:Casa:123Principal          1 CASA_123PRINCIPAL {500000.00 USD}
     Actius:Banc:PagamentInicial          -100000.00 USD
     Passius:Hipoteca:PréstecHabitatge    -400000.00 USD

3. Registra els Pagaments Mensuals de la Hipoteca: El teu pagament mensual consisteix en principal (redueix el passiu) i interessos (una despesa).

   2022-04-01 * "Banc Hipotecari" "Pagament Mensual de la Hipoteca"
     Passius:Hipoteca:PréstecHabitatge      800.00 USD   ; Principal
     Despeses:Casa:Interessos            1200.00 USD   ; Interessos
     Actius:Banc:US:Chase:Checking    -2000.00 USD

4. Seguiment de l'Apreciació (Guanys No Realitzats): El valor de mercat d'una casa canvia. Per fer el seguiment d'això sense afectar el teu patrimoni net oficial (ja que el guany no es realitza fins que vens), pots utilitzar una directiva de preu amb una moneda "virtual".

   ; El preu de compra és la base de cost real
   2022-03-15 price CASA_123PRINCIPAL   500000.00 USD
   
   ; Una estimació de mercat actualitzada és un guany no realitzat
   2024-01-01 price CASA_123PRINCIPAL   550000.00 USD.NO_REALITZAT

Això et permet veure el valor estimat als gràfics de Fava sense inflar incorrectament el teu balanç.

Cas Pràctic 2: Seguiment de les Unitats d'Accions Restringides (RSU)

Les RSU són una forma comuna de compensació en accions. La comptabilització d'elles implica el seguiment de la concessió inicial, els esdeveniments de consolidació i la retenció d'impostos.

1. Configuració Inicial: Crea mercaderies per a les accions consolidades (HOOL) i no consolidades (HOOL.NO_CONSOL) juntament amb els comptes necessaris.

   2021-01-01 commodity HOOL
   2021-01-01 commodity HOOL.NO_CONSOL
   2021-01-01 open Actius:Corretatge:Etrade:HOOL           HOOL
   2021-01-01 open Actius:Concessió:NoConsolidat                 HOOL.NO_CONSOL
   2021-01-01 open Ingressos:Sou:Hooli:RSU
   2021-01-01 open Despeses:Impostos:Federal

2. Registra la Concessió Inicial: Aquesta transacció mostra la concessió total que es mou a un compte d'actius no consolidat.

   2021-02-01 * "Hooli" "Concessió Inicial d'RSU"
     Actius:Concessió:NoConsolidat        1000 HOOL.NO_CONSOL
     Ingressos:Concessió:Premis         -1000 HOOL.NO_CONSOL

3. Registra un Esdeveniment de Consolidació: Aquesta és la transacció clau. Quan les accions es consoliden, reconeixes els ingressos, pagues impostos (sovint venent algunes accions) i rebeixes les accions netes. Assumeix que 100 accions es consoliden a 150 $/acció.

   2022-02-01 * "Hooli" "Esdeveniment de Consolidació d'RSU"
     ; Reconeix els ingressos totals de 100 * 150 $ = 15.000 $
     Ingressos:Sou:Hooli:RSU                   -15000.00 USD
   
     ; Mostra els impostos pagats d'aquests ingressos
     Despeses:Impostos:Federal                      4000.00 USD
     Despeses:Impostos:Estatal                        1000.00 USD
   
     ; Rebeixes les accions netes (assumeix 60 accions) a la seva base de cost
     Actius:Corretatge:Etrade:HOOL                  60 HOOL {150.00 USD}
   
     ; Les altres 40 accions es van vendre per cobrir 6000 $ en impostos.
     ; Aquesta transacció equilibra els ingressos, els impostos i les accions rebesudes.
     ; També hem de mostrar la reducció d'accions no consolidades.
     Actius:Concessió:NoConsolidat                       -100 HOOL.NO_CONSOL
     Despeses:Concessió:Consolidat                        100 HOOL.NO_CONSOL

Aquesta única transacció equilibrada modela correctament tot l'esdeveniment: la concessió no consolidada es redueix, es reconeixen els ingressos, es paguen els impostos i les accions consolidades netes apareixen al teu compte de corretatge amb la base de cost correcta per als càlculs futurs de guanys de capital.

Part 7: Gestió de Projectes per al Teu Llibre Major

A mesura que el teu llibre major creix, l'organització esdevé clau.

Utilitzant el Control de Versions (Git) per Protegir les Teves Dades

Com que el teu llibre major és un fitxer de text, és perfecte per al control de versions amb Git. Això et proporciona un historial complet de tots els canvis, protegint-te de supressions o errors accidentals. Avís: Les teves dades financeres són altament sensibles. Utilitza un repositori privat en serveis com GitHub/GitLab, o allotja el teu propi.

Organitzant amb Etiquetes (#) i Enllaços (^)

Beancount proporciona dues maneres d'agrupar transaccions més enllà dels comptes:

• Etiquetes (#): Utilitza-les per a esdeveniments o projectes. Pots filtrar totes les transaccions relacionades amb un viatge específic, per exemple. 2024-07-20 * "Hotel" "Viena" #viatge-europa-2024
• Enllaços (^): Utilitza'ls per connectar transaccions relacionades financerament que es produeixen en diferents moments, com ara una retirada d'efectiu i la comissió bancària associada.

Una Estratègia Escalable per Estructurar els Teus Fitxers (include)

Un sol fitxer massiu és difícil de gestionar. Utilitza la directiva include per dividir el teu llibre major en diversos fitxers. main.bean:

; Fitxer principal del llibre major

; Opcions globals
option "title" "El meu llibre major personal"
option "operating_currency" "USD"

; Inclou declaracions de comptes i altres fitxers
include "accounts.bean"
include "years/2023.bean"
include "years/2024.bean"
include "events/trip-europe-2024.bean"

Una estratègia organitzativa robusta, per ordre de precedència:

1. Per Esdeveniment: Crea un fitxer separat per a un esdeveniment important i autocontingut (per exemple, viatge-europa-2024.bean).
2. Per Categoria/Pagador: Per a transaccions altament regulars i recurrents com ara factures de serveis públics o sous, agrupa-les al seu propi fitxer (per exemple, lloguer-recurrent.bean).
3. Per Compte: Per a transaccions estretament vinculades a un compte específic (interessos, comissions, pagaments de targetes de crèdit), considera un fitxer específic del compte.
4. Per Data: Per a totes les altres transaccions generals, una simple divisió per any (2024.bean) o mes (2024/07.bean) és eficaç.

Part 8: Conclusió

Beancount ofereix una corba d'aprenentatge pronunciada, però recompensa l'esforç amb un poder, una flexibilitat i un control incomparables sobre les teves dades financeres. En adoptar els principis de la comptabilitat per partida doble i les eines pràctiques que Beancount proporciona, pots passar del simple seguiment de despeses a un sistema complet, precís i perspicaç de gestió financera personal. El teu llibre major es converteix en un actiu permanent, privat i valuós per comprendre el teu passat i planificar el teu futur.

Començant amb Beancount.io

Beancount.io és una plataforma moderna de gestió financera basada en el núvol que transforma els teus registres de transaccions basats en text en estats financers complets, incloent-hi comptes de resultats, balanços i saldos de comprovació. En combinar la fiabilitat dels fitxers de text pla amb potents eines de visualització, Beancount.io t'ajuda a mantenir un control precís sobre la teva vida financera alhora que obtens informació valuosa sobre el rendiment de la teva inversió.

Comença el teu viatge financer amb Beancount.io - Gratuït durant el nostre període promocional!