75 entrades etiquetades amb "Financial Management"

En la publicació del blog d'avui, desglossarem un llibre major de Beancount per a empreses, cosa que us ajudarà a entendre les complexitats d'aquest sistema de comptabilitat de partida doble en text pla.

Comencem amb el codi:

1970-01-01 open Assets:Bank:Mercury
1970-01-01 open Assets:Crypto

1970-01-01 open Equity:Bank:Chase

1970-01-01 open Income:Stripe
1970-01-01 open Income:Crypto:ETH

1970-01-01 open Expenses:COGS
1970-01-01 open Expenses:COGS:Contabo
1970-01-01 open Expenses:COGS:AmazonWebServices

1970-01-01 open Expenses:BusinessExpenses
1970-01-01 open Expenses:BusinessExpenses:ChatGPT

2023-05-14 * "CONTABO.COM" "Mercury Checking ••1234"
  Expenses:COGS:Contabo                               17.49 USD
  Assets:Bank:Mercury                                -17.49 USD

2023-05-11 * "Amazon Web Services" "Mercury Checking ••1234"
  Expenses:COGS:AmazonWebServices                  14490.33 USD
  Assets:Bank:Mercury                             -14490.33 USD

2023-03-01 * "STRIPE" "Mercury Checking ••1234"
  Income:Stripe                                   -21230.75 USD
  Assets:Bank:Mercury                              21230.75 USD

2023-05-18 * "customer_182734" "0x5190E84918FD67706A9DFDb337d5744dF4EE5f3f"
  Assets:Crypto                                         -19 ETH {1,856.20 USD}
  Income:Crypto:ETH                                      19 ETH @@ 35267.8 USD

Entenent el Codi​

1. Obertura de Comptes: El codi comença obrint una sèrie de comptes l'1 de gener de 1970. Aquests inclouen una combinació de comptes d'actiu (Assets:Bank:Mercury i Assets:Crypto), un compte de patrimoni net (Equity:Bank:Chase), comptes d'ingressos (Income:Stripe i Income:Crypto:ETH), i comptes de despeses (Expenses:COGS, Expenses:COGS:AmazonWebServices, Expenses:BusinessExpenses, i Expenses:BusinessExpenses:ChatGPT).

2. Transaccions: Després, es procedeix a registrar una sèrie de transaccions entre el 01-03-2023 i el 18-05-2023.

   • La transacció del 14-05-2023 representa un pagament de 17.49 USD a CONTABO.COM des de Mercury Checking ••1234. Això es registra com una despesa (Expenses:COGS:Contabo) i una deducció corresponent del compte Assets:Bank:Mercury.

   • De manera similar, la transacció de l'11-05-2023 representa un pagament de 14490.33 USD a Amazon Web Services des del mateix compte bancari. Això es registra sota Expenses:COGS:AmazonWebServices.

   • La transacció del 01-03-2023 mostra ingressos de STRIPE dipositats a Mercury Checking ••1234, amb un total de 21230.75 USD. Això es registra com a ingrés (Income:Stripe) i una addició al compte bancari (Assets:Bank:Mercury).

   • L'última transacció del 18-05-2023 representa una transacció de criptomoneda que implica 19 ETH d'un client. Això es fa un seguiment sota Assets:Crypto i Income:Crypto:ETH. El {1,856.20 USD} mostra el preu de l'ETH en el moment de la transacció, mentre que el @@ 35267.8 USD especifica el valor total de la transacció de 19 ETH.

En totes les transaccions, es manté el principi de la comptabilitat de partida doble, assegurant que l'equació Actius = Passius + Patrimoni Net sempre es compleixi.

Reflexions Finals​

Aquest llibre major de Beancount proporciona un sistema senzill però robust per fer un seguiment de les transaccions financeres. Com es veu en la transacció final, Beancount és prou flexible per comptabilitzar actius no tradicionals com la criptomoneda, cosa que és un testimoni de la seva utilitat en el nostre paisatge financer cada vegada més digital.

Esperem que aquesta desglossament us ajudi a entendre millor l'estructura i les capacitats de Beancount, tant si sou un comptable experimentat com un principiant que intenta fer un seguiment de les vostres finances personals. Estigueu atents a la nostra propera publicació del blog, on aprofundirem en operacions avançades de Beancount.

Una plantilla de text pla, un flux de treball repetible i una sola consulta per a "Qui em deu diners encara?"

Facturar pot semblar una feina pesada, atrapada entre la feina que heu acabat i el pagament que esteu esperant. Però un bon procés de facturació és la columna vertebral d'un flux de caixa saludable. Té una doble funció: indica clarament als vostres clients què deuen i quan, i alimenta el vostre sistema de comptabilitat amb els fets inqüestionables que necessita.

Tot i que les aplicacions SaaS dedicades poden enviar PDF elegants i automatitzats, sovint tenen quotes mensuals i bloquegen les vostres dades en un silo propietari. Un enfocament lleuger de text pla utilitzant Beancount ofereix una alternativa potent. Podeu convertir cada factura en un conjunt clar d'entrades comptables, donant-vos tots els avantatges del control de versions, metadades potents i consultes instantànies, sense necessitat de subscripció.

La Factura Mínima Viable (Camps que No Heu de Saltar Mai)​

Abans de tocar el vostre llibre major, necessiteu una factura professional. El format pot ser simple, però el contingut ha de ser precís. Aquests camps, prestats de la pràctica provada de les petites empreses, no són negociables.

• Dades del venedor: El nom de la vostra empresa i l'adreça física.
• Dades del client: El nom del vostre client i (idealment) la seva adreça.
• Número de factura: Un ID únic i seqüencial que no es reutilitza mai. FAC-045 segueix FAC-044.
• Dates d'emissió i venciment: Indiqueu clarament quan es va emetre la factura i quan s'espera el pagament.
• Línies d'articles: Una descripció clara dels serveis o productes, juntament amb la quantitat, la tarifa i el total de la línia.
• Subtotal, impostos i total: Mostreu els càlculs perquè el client els pugui seguir fàcilment.
• Notes opcionals: Un lloc per a un agraïment, instruccions de transferència o un número de comanda de compra proporcionat pel client.

Per començar, hem creat un conjunt de plantilles llestes per editar que inclouen tots aquests camps. Les versions de full de càlcul fins i tot precalculen els totals per a vosaltres.

Note: Invoice templates are coming soon! In the meantime, you can create your own using the fields listed above in Google Docs, Word, Sheets, Excel, or any other document format.

Registreu la Factura al Vostre Llibre Major​

Un cop hàgiu enviat el PDF de la factura al vostre client, heu de registrar-la a Beancount. Aquest és un pas crucial que reconeix els ingressos quan es guanyen, no només quan es paguen. El procés implica dues transaccions diferents.

1. Quan emeteu la factura:

Creeu una transacció que mogui l'import total del vostre compte Ingressos a Actius:FacturesPendentsDeCobrar. Això crea un rebut digital als vostres llibres.

; 2025‑07‑21 Factura #045  Sprint de disseny web per a Acme Corp.
2025-07-21 * "Acme Corp" "FAC-045 Sprint de disseny web"
  Actius:FacturesPendentsDeCobrar    3500.00 USD  ; venciment:2025-08-04
  Ingressos:Disseny:Web
  id_factura: "FAC-045"
  correu_contacte: "[email protected]"
  enllaç: "docs/factures/2025-07-21_Acme_FAC-045.pdf"

Aquí, debiteu FacturesPendentsDeCobrar i acrediteu el vostre compte Ingressos. Fixeu-vos en les metadades riques: la data de venciment, un id_factura únic i fins i tot un enllaç: directe al PDF que heu enviat.

2. Quan el client paga:

Quan els diners arriben al vostre compte bancari, registreu una segona transacció per "tancar" el rebut. Això mou el saldo de FacturesPendentsDeCobrar al vostre compte corrent.

2025-08-01 * "Acme Corp" "Pagament FAC-045"
  Actius:Banc:CompteCorrent          3500.00 USD
  Actius:FacturesPendentsDeCobrar
  id_factura: "FAC-045"

El saldo de FAC-045 a Actius:FacturesPendentsDeCobrar ara és zero, i els vostres llibres estan perfectament equilibrats.

Adjunteu el PDF: La clau de metadades enllaç: és especialment potent quan s'utilitza amb Fava, la interfície web de Beancount. Fava representarà un enllaç clicable directament a la vista de transaccions, de manera que el document font no està mai a més d'un clic de distància. Aquest flux de treball es va preveure ja el 2016 en una sol·licitud de funció (GitHub).

Una Consulta per Llistar Totes les Factures Pendents​

Llavors, qui us deu diners encara? Amb aquest sistema, no cal que busqueu entre correus electrònics o fulls de càlcul. Només necessiteu una consulta senzilla.

Deseu el següent com a fitxer anomenat factures-pendents.sql:

SELECT
  meta('id_factura') AS id,
  beneficiari,
  narració,
  data,
  number(saldo) AS pendent
WHERE
  compte = "Actius:FacturesPendentsDeCobrar"
  AND saldo != 0
ORDER BY
  data;

Ara, executeu-lo des de la vostra línia d'ordres:

bean-query llibres.beancount factures-pendents.sql

En segons, obtindreu un informe d'envelliment net i actualitzat de totes les factures pendents, que mostra l'ID de la factura, el client, la data d'emissió i l'import degut. No es requereix cap programari addicional.

Automatitzeu la Feina Pesada​

La bellesa del text pla és la capacitat d'escriure scripts. Podeu automatitzar les parts tedioses d'aquest flux de treball.

• Plantilla + Pandoc = PDF: Mantingueu la vostra plantilla de factura en Markdown. Un petit script de Python pot omplir les variables (nom del client, línies d'articles, número de factura) i l'eina de línia d'ordres Pandoc pot convertir-la instantàniament a un PDF professional.
• Hook Pre-commit de Git: Si emmagatzemeu el vostre llibre major a Git, un simple hook pre-commit pot executar comprovacions abans de desar la vostra feina. Pot verificar que cada nou id_factura sigui únic, que els assentaments de la transacció estiguin equilibrats a zero i que el fitxer al qual es fa referència a les metadades enllaç: existeixi realment.
• Treball Cron: Configureu una tasca programada (un treball cron) per executar la vostra consulta factures-pendents.sql cada nit i enviar-vos el resum per correu electrònic. Començareu cada dia sabent exactament qui necessita un toc amable.

Una Advertència Realista​

Beancount és una eina de comptabilitat, no un servei de facturació. No enviarà automàticament recordatoris de pagament als vostres clients ni processarà els seus pagaments amb targeta de crèdit. El flux de treball és: creeu i envieu la factura utilitzant el mètode que trieu (com les plantilles anteriors) i, a continuació, registreu les entrades comptables al vostre llibre major.

Per a la majoria de professionals independents i petites botigues, aquest pas manual és un petit preu a pagar per un sistema de comptabilitat a prova de bales, auditable i gratuït que posseïu i controleu completament (beancount.io).

Passos Següents​

A punt per prendre el control de la vostra facturació? Aquí teniu com començar.

1. Baixeu una plantilla i utilitzeu-la per crear la vostra propera factura real, assegurant-vos d'utilitzar un número de factura seqüencial.
2. Emmagatzemeu els vostres PDF enviats en una carpeta dedicada com docs/factures/ i utilitzeu la clau de metadades enllaç: a la vostra transacció Beancount per fer-hi referència.
3. Deseu la consulta factures-pendents.sql i feu que executar-la formi part de la vostra revisió financera setmanal.

La comptabilitat de text pla no vol dir renunciar a la pulcritud ni al control; només vol dir que la base de dades es pot cercar amb grep. Amb una plantilla senzilla i els fragments anteriors, cobrareu més ràpid i mantindreu els vostres llibres impecables.

Molts dels nostres clients ens han estat preguntant des del febrer com afegir múltiples fitxers a un sol llibre major. Necessiten l'estructura de fitxers per arxivar o categoritzar transaccions. Així que, finalment, després d'un parell de mesos de feina, ens complau anunciar que la característica s'ha llançat de forma gratuïta.

Aquí teniu com utilitzar-ho:

Fitxer > crear un fitxer nou​

Aneu a la pestanya de l'editor de fitxers a la barra lateral de navegació esquerra. I després, seguiu el desplegable "Fitxer" i feu clic a "Crear un fitxer nou".

Posa nom al teu nou fitxer​

Dona al teu fitxer un nom de fitxer vàlid i desa'l. Tots els noms de fitxer han d'acabar amb ".bean".

Inclou el fitxer​

Aquí hi ha un pas crucial, has d'incloure el fitxer recentment creat a main.bean.

Per exemple, si has afegit stock.bean, llavors especifica include "stock.bean" a main.bean.

Actualitza i navega al fitxer​

Actualitza la pàgina i veuràs que el fitxer apareix al desplegable "Fitxer".

Canvia el nom o elimina el fitxer​

Un cop hagis navegat al fitxer, podràs canviar-li el nom o eliminar-lo al desplegable "Edita".

Tens problemes?​

Fes preguntes a https://t.me/beancount.

Estem emocionats d'anunciar una fita important en l'evolució de Beancount: el llançament de les nostres aplicacions mòbils dedicades tant per a plataformes iOS com Android! Aquesta versió aborda directament una de les peticions més freqüents de la nostra comunitat: la capacitat de gestionar el vostre llibre major de manera eficient en dispositius mòbils.

Característiques clau​

• Entrada ràpida de transaccions: Afegiu noves transaccions sense problemes en moviment
• Informes financers mòbils: Accediu a les vostres dades financeres en qualsevol lloc i en qualsevol moment
• Edició directa del llibre major: Accés complet al vostre fitxer de llibre major mitjançant una vista web optimitzada
• Sincronització multiplataforma: Mantingueu les vostres dades financeres coherents en tots els vostres dispositius

Desenvolupament impulsat per la comunitat​

Aquesta versió marca només el començament del nostre viatge mòbil. Estem compromesos a evolucionar aquestes aplicacions basant-nos en les vostres necessitats i comentaris. Uniu-vos a la nostra vibrant comunitat a Telegram a https://t.me/beancount per discutir Beancount, compartir la vostra experiència i ajudar a donar forma a futures funcions.

La nostra visió​

A Beancount, la nostra missió és capacitar a tothom per aconseguir un millor control i comprensió financera. Aquestes aplicacions mòbils representen un pas significatiu cap a aquest objectiu, amb moltes més funcions i eines emocionants en la nostra fulla de ruta.

No podeu dirigir un negoci si no sabeu on van els diners. Uns llibres precisos converteixen les conjectures en coneixement. (Investopedia)

Tot propietari d'un negoci, autònom o fundador d'una startup s'enfronta finalment a la mateixa realitat: el caos financer és un obstacle per al creixement. Sense una imatge clara del vostre flux d'efectiu, esteu volant a cegues. Però què passaria si poguéssiu gestionar les vostres finances amb la mateixa precisió i control que apliqueu al vostre codi? Us presentem Beancount, un potent sistema de comptabilitat de codi obert que funciona amb fitxers de text pla.

Aquesta guia us guiarà pels fonaments de la comptabilitat i us mostrarà com construir un flux de treball financer robust, lleuger i transparent utilitzant Beancount.

Què és la Comptabilitat?​

En essència, la comptabilitat és el registre sistemàtic i continu de totes les transaccions financeres que realitza una empresa. És la disciplina diària de fer un seguiment dels ingressos, les despeses, els actius (el que posseïu) i els passius (el que deveu).

En el món de Beancount, aquests registres no estan tancats en un programari propietari. Residen en fitxers de text pla simples i llegibles per humans. Aquest enfocament us permet controlar les versions del vostre historial financer amb eines com Git, tal com ho faríeu amb un projecte de programari. Cada entrada es regeix per la regla de l'equilibri per partida doble, un sistema elegant que comprova automàticament la vostra feina i garanteix que els vostres llibres siguin sempre correctes. (beancount)

Per què és Important?​

Una comptabilitat meticulosa no és només una qüestió d'ordre administratiu; és un avantatge estratègic.

• Confiança fiscal: Quan arriba la temporada d'impostos, uns registres nets són el vostre millor amic. L'Agència Tributària requereix documentació clara dels ingressos i les deduccions. Un llibre major ben mantingut significa que podeu presentar la declaració amb confiança i escurçar dràsticament qualsevol possible auditoria. (Agència Tributària)
• Decisions més encertades: Els vostres preus són prou alts? Un contracte de servei específic és realment rendible? Els costos de subscripció s'estan disparant? Els estats financers, com el compte de resultats i el balanç, revelen fuites de preus, costos descontrolats i problemes de flux d'efectiu, proporcionant als gestors i inversors les dades que necessiten per prendre decisions intel·ligents. (Investopedia)
• Finançament més fàcil: Els prestadors i inversors no prenen decisions basades en intuïcions. Abans de transferir fons, us demanaran estats financers. Uns bons llibres us permeten generar un balanç o un compte de resultats en segons, demostrant professionalitat i salut financera. (Investopedia)
• Alertes de frau i errors: La conciliació rutinària dels vostres llibres amb els extractes bancaris és la vostra primera línia de defensa contra els errors. Aquest hàbit senzill us ajuda a detectar càrrecs duplicats, errors bancaris o activitats fraudulentes ràpidament, abans que es converteixin en problemes importants. (Agència Tributària)

Un Pla de Set Passos en Text Pla​

A punt per començar? Aquí teniu com construir el vostre sistema de comptabilitat basat en Beancount des de zero.

1. Separeu els Comptes Empresarials i Personals​

Aquest és el primer pas innegociable. Obriu un compte corrent empresarial dedicat i, si cal, una targeta de crèdit empresarial. Barrejar fons crea un malson per a la comptabilitat i pot difuminar les línies de responsabilitat entre vosaltres i la vostra empresa. Una separació neta és essencial per a deduccions precises i protecció legal. (Direcció General de Comerç Interior)

In Beancount, you declare the existence of these accounts with an open directive:

; Saldos d'obertura dels vostres comptes
2025-07-22 open Assets:Bank:Business   USD
2025-07-22 open Assets:Bank:Personal   USD

2. Trieu un Sistema de Comptabilitat​

Beancount utilitza el mètode de partida doble, l'estàndard d'or de la comptabilitat durant segles. El principi és simple: cada transacció afecta almenys dos comptes. Per a cada dèbit d'un compte, hi ha d'haver un crèdit corresponent a un altre. La màgia d'aquest sistema és que la suma de tots els vostres comptes sempre ha d'equilibrar-se a zero. Beancount aplica aquesta regla automàticament, cosa que significa que un error tipogràfic o lògic generarà immediatament una alerta. Literalment, no podeu tenir llibres desequilibrats. (beancount)

3. Decidiu un Mètode Comptable​

Teniu dues opcions principals aquí:

• Base de caixa: Registreu els ingressos quan rebeu els diners i les despeses quan els pagueu. És més senzill i reflecteix directament el vostre flux d'efectiu.
• Base de meritació: Registreu els ingressos quan els guanyeu (per exemple, quan s'envia una factura) i les despeses quan les incorreu (per exemple, quan rebeu una factura). Aquest mètode proporciona una imatge més fidel de la salut i el rendiment financer d'una empresa, especialment per a les empreses en creixement. (Investopedia)

Aquí teniu un exemple d'una transacció de meritació a Beancount. Registreu els ingressos quan s'envia la factura, movent el valor a Assets:AccountsReceivable. Quan el client paga, moveu els diners de AccountsReceivable al vostre compte bancari.

; Exemple de meritació: factura emesa, pagament posterior
2025-07-22 * "Factura de disseny #101"
  Assets:AccountsReceivable     3000.00 USD
  Income:Design

2025-08-15 * "El client paga la factura #101"
  Assets:Bank:Business          3000.00 USD
  Assets:AccountsReceivable

4. Reuniu el Vostre Conjunt d'Eines​

La bellesa de Beancount rau en la seva naturalesa minimalista i modular. El vostre conjunt bàsic d'eines inclou:

• Editor + Git: El vostre editor de text preferit per registrar les transaccions i Git per al control de versions, cosa que us proporciona un historial complet i auditable de tots els canvis.
• bean-report / bean-balance / Fava: Eines de línia d'ordres com bean-report i la impressionant interfície web Fava us proporcionen estats financers instantanis, quadres de comandament i potents capacitats de filtratge.
• Importadors: Un ric ecosistema d'importadors creats per la comunitat es pot connectar als vostres canals bancaris mitjançant CSV, Plaid o API per a serveis com Stripe i PayPal, automatitzant gran part de l'entrada de dades.

5. Categoritzeu Cada Transacció​

Un "pla de comptes" ben organitzat és l'eix central d'uns informes perspicaços. Definiu categories que tinguin sentit per al vostre negoci, utilitzant comptes jeràrquics per a la granularitat. Després, a mesura que registreu les transaccions, categoritzeu-les meticulosament.

2025-07-30 * "Factura mensual d'AWS"
  Expenses:Hosting:AWS       124.50 USD
  Assets:Bank:Business
  tag: "ops"

En aquest exemple, la despesa està clarament arxivada a Expenses:Hosting:AWS. L'ús de tag: "ops" també permet informes transversals, com ara visualitzar totes les despeses operatives independentment de la seva categoria principal. (Agència Tributària)

6. Emmagatzemeu els Documents Font de Forma Segura​

L'Agència Tributària accepta còpies digitals de rebuts i factures. Escanegeu els rebuts en paper o reenvieu les factures per correu electrònic a una carpeta dedicada a l'emmagatzematge al núvol (com Google Drive o Dropbox). Després, enllaceu directament al fitxer a la vostra entrada de Beancount utilitzant metadades. Això crea un registre hermètic i autocontingut.

; Imatge del rebut enllaçada com a metadades
2025-07-18 * "Dinar d'equip"
  Expenses:Meals              85.10 USD
  Assets:Bank:Business
  receipt: "receipts/2025-07-18-team-lunch.jpg"

7. Convertiu la Comptabilitat en un Hàbit​

La constància és clau. La procrastinació converteix la comptabilitat en una tasca estressant i que requereix molt de temps. Reserveu un bloc de temps recurrent (un "Dia Bean" setmanal o mensual) per importar transaccions, conciliar comptes i revisar els vostres informes financers. Aquesta rutina senzilla transforma la comptabilitat d'una cursa trimestral en una revisió ràpida i empoderadora de la salut del vostre negoci. (Agència Tributària)

Bricolatge vs Ajuda Professional​

• Bricolatge: Per a autònoms o petites empreses amb un volum de transaccions previsible, un enfocament de bricolatge amb Beancount és increïblement eficaç. Encara és aconsellable tenir una breu consulta puntual amb un assessor fiscal per validar el vostre pla de comptes i assegurar-vos que esteu en el camí correcte.
• Revisió professional: A mesura que el vostre negoci creix, les transaccions es tornen més complexes o el risc de compliment augmenta, contractar un comptable o assessor professional per a revisions periòdiques és invaluable. Podeu continuar utilitzant Beancount com a font principal de veritat i simplement exportar els informes que necessiten.

Llista de Comprovació d'Inici Ràpid​

• Obriu comptes bancaris empresarials separats.
• Cloneu el repositori d'inici de Beancount i definiu els vostres comptes a accounts.bean.
• Trieu la base de caixa o de meritació i seguiu-la.
• Configureu importadors per automatitzar l'entrada de dades del vostre banc (CSV), Stripe, PayPal, etc.
• Etiqueteu i escriviu narracions clares per a cada transacció.
• Conciliau el vostre llibre major amb els extractes bancaris setmanalment o mensualment.
• Genereu informes mensuals d'ingressos, balanç i flux d'efectiu utilitzant Fava o bean-report.
• Feu una còpia de seguretat dels vostres fitxers .bean regularment (Git + emmagatzematge extern).

Lectures Adicionals​

• Agència Tributària - Informació per a Autònoms
• Documentació de Beancount - Llenguatge i Eines de Línia d'Ordres

A punt per començar? Instal·leu Beancount, registreu la vostra primera entrada i canvieu la boira dels fulls de càlcul per la claredat del text pla. Feliç "bean-keeping"!