Una publicació etiquetades amb "transaccions financeres"

Les entrades de diari són l'estructura fonamental de la comptabilitat de doble partida, i a Beancount, cada transacció * que escrius és una entrada de diari. Aquesta guia explica l'essencial — dèbits i crèdits, entrades d'ajust i entrades d'inversió — i mostra com es mapen netament a la sintaxi de text pla de Beancount. Aprendràs com mantenir llibres precisos amb el mínim de cerimònia.

Un repàs ràpid: què és una entrada de diari?​

Una entrada de diari és el registre formal i datat d'una transacció financera. S'expressa en termes de dèbits i crèdits que mantenen l'equació comptable fonamental en equilibri:

$Actius = Passius + Patrimoni$

En un sistema de doble partida, cada transacció afecta almenys dos comptes, i el total de dèbits ha d'igualar el total de crèdits. Aquesta regla senzilla és la que fa que els informes financers posteriors, com l'estat de resultats i el balanç, siguin fiables i precisos.

Dèbits i crèdits en un minut​

Els conceptes de dèbits i crèdits poden ser confusos al principi, però es redueixen a poques regles simples. Pensa-ho d'aquesta manera: "d'on ve el valor?" (crèdit) i "on va el valor?" (dèbit).

Aquí tens una fitxa ràpida de com augmenten els cinc tipus principals de comptes:

Com es veu una entrada de diari a Beancount​

Beancount utilitza directives de text senzilles i llegibles per a registrar transaccions. Cada transacció ha d'equilibrar a zero per a cada mercaderia (p. ex., USD, EUR, acció AAPL). Beancount llançarà un error si no ho fa.

Aquí tens una transacció bàsica per comprar cafè:

2025-09-10 * "Coffee Bar" "Team coffee"
  Expenses:Food:Coffee          18.00 USD
  Assets:Bank:Checking         -18.00 USD

Observa com les dues anotacions (línies amb comptes) sumen zero: $18.00 + (-$18.00) = 0.

Pots afegir context potent directament a la narració mitjançant etiquetes (com #clientX) per a filtrar i enllaços (com ^INV-2025-001) per a connectar entrades relacionades.

Per exemple, així pots enllaçar una factura al seu pagament:

; Primer, registra la factura que vas enviar al client
2025-09-15 * "Acme Corp" "Invoice 2025-001 #clientX ^INV-2025-001"
  Assets:AccountsReceivable   1000.00 USD
  Income:Consulting         -1000.00 USD

; Més tard, registra el pagament i enllaça'l a la factura original
2025-09-28 * "Acme Corp" "Payment on ^INV-2025-001"
  Assets:Bank:Checking       1000.00 USD
  Assets:AccountsReceivable -1000.00 USD

L'etiqueta #clientX et permet filtrar fàcilment totes les transaccions d'aquest client, i l'enllaç ^INV-2025-001 crea una connexió entre les dues entrades que pots seguir en els informes.

Entrades de diari comunes (prètes per enganxar)​

Aquí tens diverses transaccions empresarials habituals formatades per a Beancount.

El propietari inverteix efectiu​

Un propietari aporta fons personals per iniciar l'empresa.

2025-01-01 * "Owner" "Initial capital contribution"
  Assets:Bank:Checking        10000.00 USD
  Equity:Owner-Capital      -10000.00 USD

Venda en efectiu amb impost de venda​

Un client paga en efectiu per un producte, incloent un impost de venda del 8 % que hauràs de remetre al govern més tard.

2025-01-05 * "Walk-in Customer" "Cash sale with 8% tax"
  Assets:Cash                   108.00 USD
  Income:Sales                -100.00 USD
  Liabilities:Tax:Sales         -8.00 USD

Venda a crèdit (factura) i cobrament​

Proporciones un servei i factures al client, i després reps el pagament més tard.

2025-01-10 * "Acme Corp" "Consulting invoice ^INV-2025-002"
  Assets:AccountsReceivable   2500.00 USD
  Income:Consulting         -2500.00 USD

2025-01-30 * "Acme Corp" "Payment on ^INV-2025-002"
  Assets:Bank:Checking       2500.00 USD
  Assets:AccountsReceivable -2500.00 USD

Despesa amb targeta de crèdit​

Compres subministraments d'oficina amb una targeta de crèdit de l'empresa.

2025-01-12 * "OfficeMax" "Supplies on credit card"
  Expenses:Office:Supplies       75.00 USD
  Liabilities:CreditCard        -75.00 USD

nòmina (model simple)​

Processes la nòmina, registrant la despesa salarial bruta, les retencions d'impostos dels empleats i el pagament net des del teu banc.

2025-01-31 * "Payroll" "January wages and withholdings"
  Expenses:Payroll:Wages      2000.00 USD
  Liabilities:Taxes:Withheld   -400.00 USD
  Assets:Bank:Checking       -1600.00 USD

Depreciació mensual​

Registres la despesa de depreciació mensual d'un actiu, com un portàtil.

2025-01-31 * "Depreciation" "Laptop, straight-line"
  Expenses:Depreciation          100.00 USD
  Assets:Equipment:AccumDepr    -100.00 USD

Despesa prepagada i amortització mensual​

Pagues una assegurança anual per avançat i després reconeixes una fracció mensual de la despesa.

; 1. Pagament de la pòlissa anual
2025-01-01 * "InsureCo" "Annual insurance premium"
  Assets:Prepaid:Insurance     1200.00 USD
  Assets:Bank:Checking       -1200.00 USD

; 2. Reconèixer una despesa d'un mes al final de gener
2025-01-31 * "InsureCo" "Amortize 1/12 of insurance"
  Expenses:Insurance             100.00 USD
  Assets:Prepaid:Insurance      -100.00 USD

Ingressos no guanyats i reconeixement mensual​

Un client paga per avançat una subscripció de 3 mesos. Registres l'efectiu i després reconeixes un mes d'ingressos.

; 1. El client paga per avançat el servei
2025-02-01 * "Subscriber" "3-month plan prepaid"
  Assets:Bank:Checking           300.00 USD
  Liabilities:Unearned:Subs     -300.00 USD

; 2. Reconèixer un mes d'ingressos després de prestar el servei
2025-02-28 * "Recognition" "Recognize month 1 of 3"
  Liabilities:Unearned:Subs      100.00 USD
  Income:Subscriptions          -100.00 USD

Provisió per deutes incobrables i baixa​

Estableixes una provisió per a factures potencialment incobrables i més tard baixes una factura específica.

; 1. Crear una provisió basada en el 2 % del comptes a cobrar
2025-03-31 * "Provision" "2% of A/R for doubtful accounts"
  Expenses:BadDebt               200.00 USD
  Assets:AllowanceForDoubtful   -200.00 USD

; 2. Baixa d'una factura específica que saps que no es pagarà
2025-04-15 * "Write-off" "Customer XYZ invoice"
  Assets:AllowanceForDoubtful    150.00 USD
  Assets:AccountsReceivable     -150.00 USD

Inventari periòdic i ajust de COGS​

Al final d'un període, calcules el Cost de Vendes (COGS) ajustant el teu compte d'inventari.

2025-03-31 * "COGS adjustment" "Periodic inventory method"
  Expenses:COGS                4500.00 USD
  Assets:Inventory           -4500.00 USD

Entrades d'ajust vs. entrades d'inversió​

Les entrades d'ajust es registren al final d'un període comptable (com un mes o trimestre) per alinear correctament ingressos i despeses al període en què realment es van guanyar o incorrer. Això inclou acumulacions, diferiments i estimacions com la depreciació.

Les entrades d'inversió són opcionalment registrades el primer dia d'un nou període i inverteixen exactament una entrada d'ajust específica del període anterior. El seu propòsit és simplificar la comptabilitat. En invertir una acumulació, pots registrar la transacció de caixa posterior d'una manera estàndard sense haver de recordar dividir-la contra el compte de passiu.

Exemple: acumulació i inversió de serveis públics​

Suposem que has de registrar la despesa de serveis públics de gener, però la factura no arribarà fins a febrer.

; 1. Acumular la despesa estimada al final de gener
2025-01-31 * "Accrual" "Estimate January utilities expense"
  Expenses:Utilities              500.00 USD
  Liabilities:Accrued:Utilities  -500.00 USD

; 2. (Opcional) Invertir l'acumulació el primer dia del període següent
2025-02-01 * "Reversal" "Undo January utilities accrual"
  Liabilities:Accrued:Utilities   500.00 USD
  Expenses:Utilities             -500.00 USD

; 3. Registrar el pagament real quan arribi al febrer
; La factura real és de 520 USD. Per causa de la inversió, pots
; registrar l'import complet al compte de despeses sense problemes.
; La despesa neta per al febrer serà 520 - 500 = 20 USD.
2025-02-10 * "City Utilities" "Payment for January bill"
  Expenses:Utilities             520.00 USD
  Assets:Bank:Checking          -520.00 USD

Nota: L'exemple a l'esquema mostra dividir el pagament final. El mètode d'entrada d'inversió és una alternativa que simplifica l'entrada de pagament final.

Llista de comprovació per a cada entrada de diari a Beancount​

Segueix aquests passos per assegurar que les teves entrades siguin netes i correctes:

1. Comença amb la data (AAAA-MM-DD) i un senyal de transacció (*).
2. Afegeix un beneficiari i una narració descriptiva. Utilitza #etiquetes i ^enllaços per a la capacitat de cerca.
3. Inclou almenys dues línies d'anotació que equilibrin a zero per a cada mercaderia.
4. Utilitza noms d'accounts adequats sota els cinc tipus: Assets, Liabilities, Equity, Income, Expenses.
5. Opcionalment, afegeix metadades com document: "invoices/INV-2025-001.pdf" per a traçabilitat.

Errors comuns (i com Beancount ajuda)​

• Anotacions desequilibrades: Si els teus dèbits i crèdits no sumen zero, Beancount rebutjarà l'entrada. Aquesta és una característica clau que evita errors. Pots deixar una quantitat en blanc i Beancount la calcularà automàticament.
• Signe incorrecte en un compte: És fàcil oblidar que Income, Equity i Liabilities augmenten amb crèdits (que solen ser nombres negatius a Beancount). Si ho fas malament, els teus informes semblaran estranys, però la regla d'equilibri encara ofereix una xarxa de seguretat.
• Enllaços perduts entre entrades: Oblidar enllaçar una factura al seu pagament dificulta el seguiment del que està pendent. Utilitzar ^enllaços de manera consistent resol això creant una pista auditable.

On anar a continuació​

• Llenguatge Beancount i regles d'equilibri: Aprofa't més a la documentació oficial.
• Full de trucs de sintaxi: Una referència pràctica per a totes les directives de Beancount.
• Introducció a dèbits/crèdits: Un bon punt de partida si ets nou en les regles comptables.
• Entrades d'ajust/inversió: Articles més detallats sobre la teoria comptable.

Apèndix: Mapeig de termes comptables → Beancount​

Aquesta guia ràpida de traducció t'ajuda a mapar instruccions comptables a la sintaxi de Beancount.

Amb aquests patrons i exemples, pots modelar netament gairebé qualsevol esdeveniment empresarial a Beancount, assegurant que els teus informes financers coincideixin sense cap sorpresa.