Salta al contingut principal

51 publicacions etiquetades amb "Beancount"

Veure totes les etiquetes

L'Ecosistema Beancount: Una Anàlisi Exhaustiva

· 45 minuts de lectura
Mike Thrift
Mike Thrift
Marketing Manager

Funcionalitat Central i Filosofia de Beancount

Beancount és un sistema de comptabilitat de partida doble de codi obert que utilitza fitxers de text pla per registrar transaccions. En el seu nucli, Beancount tracta el teu llibre major com un conjunt de dades definit per una gramàtica senzilla i estricta. Cada esdeveniment financer (transaccions, obertura de comptes, preus de mercaderies, etc.) és una directiva en un fitxer de text, que Beancount analitza i converteix en una base de dades en memòria d'assentaments. Aquest disseny aplica el principi de partida doble: cada transacció ha d'equilibrar dèbits i crèdits entre comptes. El resultat és un llibre major altament transparent i auditable que pots controlar per versions, inspeccionar i consultar amb facilitat.

2025-04-15-beancount-ecosystem

Filosofia – correcció i minimalisme: El disseny de Beancount prioritza la integritat de les dades i la simplicitat. El seu creador, Martin Blais, descriu Beancount com a "pessimista" en assumir que l'usuari comet errors i, per tant, imposa comprovacions i restriccions addicionals. Per exemple, Beancount no et permetrà eliminar actius que mai no s'han afegit (evitant saldos negatius d'existències o de caixa) i pot assegurar que cada compte s'obre abans d'utilitzar-lo. Manca el concepte de Ledger de registres "virtuals" o equilibrats automàticament – una elecció intencional per forçar assentaments totalment equilibrats. Beancount, de fet, "aplica una correcció estricta" amb més comprovacions creuades de les que proporciona la partida doble bàsica. Aquest enfocament cautelós atrau els usuaris que "no confien massa en si mateixos" i volen que el programari detecti els seus errors.

Opcions mínimes, màxima consistència: En contrast amb la multitud d'opcions de línia de comandes i d'ajust de Ledger, Beancount opta pel minimalisme. Hi ha molt poques opcions globals, i cap que canviï la semàntica de les transaccions fora del fitxer del llibre major. Tota la configuració que afecta la comptabilitat (com els mètodes de base de cost de mercaderies o els supòsits de registre) es fa dins del fitxer mitjançant directives o connectors, assegurant que carregar el mateix fitxer sempre produeix els mateixos resultats independentment de com es generin els informes. Aquest disseny evita la complexitat dels nombrosos ajustos de Ledger i les interaccions subtils entre ells. La filosofia de Beancount és que una eina de comptabilitat hauria de ser un pipeline estable i determinista des del fitxer d'entrada fins als informes. Ho aconsegueix tractant el llibre major com un flux ordenat de directives que es poden processar programàticament en seqüència. Fins i tot coses que Ledger tracta com a sintaxi especial (com els saldos d'obertura o les declaracions de preus) són directives de primera classe en el model de dades de Beancount, la qual cosa fa que el sistema sigui altament extensible.

Extensibilitat mitjançant connectors i llenguatge de consulta: Beancount està implementat en Python i proporciona ganxos per injectar lògica personalitzada al pipeline de processament. Els usuaris poden escriure connectors en Python que operen sobre el flux de transaccions (per exemple, per aplicar una regla personalitzada o generar assentaments automàtics). Aquests connectors s'executen a mesura que es processa el fitxer, estenent eficaçment la funcionalitat central de Beancount sense necessitat de modificar el codi font. Beancount també inclou un potent llenguatge de consulta (inspirat en SQL) per analitzar i desglossar el llibre major. L'eina bean-query tracta el llibre major analitzat com una base de dades i et permet executar consultes analítiques – per exemple, sumar despeses per categoria o extreure totes les transaccions per a un beneficiari determinat. A Beancount 3.x, aquesta capacitat de consulta es va traslladar a un paquet beanquery autònom, però des de la perspectiva de l'usuari encara proporciona informes flexibles mitjançant consultes tipus SQL.

Text pla i control de versions: Com a eina de comptabilitat de text pla, Beancount posa èmfasi en el control de l'usuari i la longevitat de les dades. El llibre major és simplement un fitxer de text .beancount que pots editar en qualsevol editor de text. Això significa que tot el teu historial financer s'emmagatzema en un format llegible per humans, i pots posar-lo a Git o un altre VCS per fer un seguiment dels canvis al llarg del temps. Els usuaris sovint mantenen el seu fitxer Beancount sota control de versions per mantenir un registre d'auditoria de cada edició (amb missatges de commit que descriuen els canvis). Aquest enfocament s'alinea amb la filosofia de Beancount que les dades comptables, especialment les finances personals o de petites empreses, han de ser transparents i "a prova de futur" – no bloquejades en una base de dades propietària. En paraules del mateix Martin Blais, Beancount és una "obra d'amor" construïda per ser senzill, durador i gratuït per a la comunitat. Va ser desenvolupat per primera vegada al voltant de 2007 i ha evolucionat a través de reescriptures importants (de la v1 a la v2, i ara la v3 el 2024) per refinar el seu disseny tot preservant la seva filosofia central de minimalisme i correcció.

Eines, Plugins i Extensions a l'Ecosistema Beancount

L'ecosistema Beancount ha desenvolupat un ric conjunt d'eines, plugins i extensions que milloren la funcionalitat bàsica del llibre major. Aquests inclouen la importació de dades, l'edició de llibres majors, la visualització d'informes i l'addició de funcions comptables especialitzades. A continuació es presenta una visió general dels components clau i complements en el món Beancount:

Utilitats d'Importació de Dades (Importadors)

Una de les necessitats més importants per a l'ús pràctic és la importació de transaccions de bancs, targetes de crèdit i altres institucions financeres. Beancount proporciona un marc d'importació i scripts d'importació contribuïts per la comunitat per a aquest propòsit. A Beancount 2.x, el mòdul integrat beancount.ingest (amb ordres com bean-extract i bean-identify) s'utilitzava per definir connectors d'importació en Python i aplicar-los als extractes descarregats. A Beancount 3.x, això ha estat substituït per un projecte extern anomenat Beangulp. Beangulp és un marc d'importadors dedicat que va evolucionar de beancount.ingest i ara és la manera recomanada per automatitzar la importació de transaccions per a Beancount 3.0. Permet escriure scripts de Python o eines de línia d'ordres que llegeixen fitxers externs (com ara extractes CSV o PDF) i generen entrades de Beancount. Aquest nou enfocament desacobla la lògica d'importació del nucli de Beancount – per exemple, l'antiga ordre bean-extract s'ha eliminat a la v3, i en el seu lloc, els vostres propis scripts d'importació produeixen transaccions a través de la interfície CLI de Beangulp.

Existeixen desenes d'importadors predefinits per a diferents bancs i formats, contribuïts per la comunitat. Hi ha scripts d'importació per a institucions de tot el món – des d'Alipay i WeChat Pay a la Xina, fins a diversos bancs europeus (Commerzbank, ING, ABN AMRO, etc.), fins a bancs dels EUA com Chase i Amex. Molts d'aquests es recopilen en repositoris públics (sovint a GitHub) o en paquets com beancount-importers. Per exemple, el projecte Tarioch Beancount Tools (tariochbctools) proporciona importadors per a bancs suïssos i del Regne Unit i fins i tot gestiona importacions de transaccions de criptomonedes. Un altre exemple és Lazy Beancount, que empaqueta un conjunt d'importadors comuns (per a Wise, Monzo, Revolut, IBKR, etc.) i proporciona una configuració basada en Docker per a una automatització senzilla. Independentment del banc o servei financer que utilitzeu, és probable que algú hagi escrit un importador de Beancount per a ell – o podeu escriure el vostre propi utilitzant el marc de Beangulp. La flexibilitat de Python significa que els importadors poden gestionar l'anàlisi de fitxers CSV/Excel, descàrregues OFX/QIF, o fins i tot el scraping d'APIs, i després emetre transaccions en format Beancount estandarditzat.

Edició i integració amb editors

Com que els llibres de Beancount són només text, els usuaris sovint aprofiten els seus editors de text o IDEs preferits per mantenir-los. L'ecosistema ofereix connectors de suport per a editors per fer aquesta experiència més fluida. Hi ha extensions per a molts editors populars que afegeixen ressaltat de sintaxi, autocompletat de noms de comptes i comprovació d'errors en temps real:

  • Emacs Beancount-Mode: Un mode principal d'Emacs (beancount-mode) està disponible per editar fitxers .beancount, oferint funcionalitats com el ressaltat de sintaxi i la integració amb el verificador de Beancount. Fins i tot pot executar bean-check en segon pla, de manera que els errors en el llibre (com una transacció desequilibrada) es senyalitzen a mesura que edites.
  • Extensió de VS Code: Una extensió de Beancount al Marketplace de VSCode proporciona comoditats similars per als usuaris de Visual Studio Code. Admet ressaltat de sintaxi, alineació d'imports, autocompletat per a comptes/beneficiaris i fins i tot comprovacions de saldo al moment quan deses el fitxer. També es pot integrar amb Fava, permetent-te iniciar la interfície web de Fava des de dins de VSCode.
  • També existeixen connectors o modes per a Vim, Atom i altres editors. Per exemple, hi ha una gramàtica Tree-sitter per a Beancount, que impulsa el ressaltat de sintaxi en editors moderns i fins i tot va ser adoptada en el component d'editor basat en web de Fava. En resum, sigui quin sigui el teu entorn d'edició, la comunitat probablement ha proporcionat un connector per fer que l'edició de fitxers Beancount sigui còmoda i sense errors.

Per a l'entrada ràpida de transaccions fora dels editors tradicionals, també hi ha eines com Bean-add i aplicacions mòbils. Bean-add és una eina de línia d'ordres que permet afegir una nova transacció mitjançant una sol·licitud o una línia única, gestionant suggeriments de data i compte. Al mòbil, un projecte anomenat Beancount Mobile proporciona una interfície senzilla per introduir transaccions en moviment (per exemple, registrant una compra en efectiu des del teu telèfon). A més, existeix un Bot de Telegram de Beancount per capturar transaccions mitjançant missatgeria: pots enviar un missatge amb els detalls de la transacció, i el bot el formata al teu fitxer de llibre.

Interfícies Web i Eines de Visualització

(Fava) La interfície web de Fava proporciona un panell interactiu per a Beancount, amb informes com un compte de pèrdues i guanys amb visualitzacions (mostrat aquí com un treemap de despeses per categoria) juntament amb taules de comptes i saldos.

La interfície principal per a Beancount és Fava, una interfície web moderna. Fava s'executa com una aplicació web local que llegeix el vostre fitxer de Beancount i produeix una experiència interactiva rica al vostre navegador. Ofereix un conjunt complet d'informes: balanç de situació, compte de pèrdues i guanys, patrimoni net al llarg del temps, participacions de cartera, gràfics de rendiment, pressupostos i més – tot de sèrie. Els usuaris sovint citen Fava com una raó important per triar Beancount per sobre d'altres eines de comptabilitat de text pla. Amb una sola ordre (fava ledger.beancount), podeu navegar per les vostres finances amb gràfics i taules en lloc de text. Fava admet característiques com: aprofundir en els comptes, filtrar transaccions per beneficiari o etiqueta, un editor de consultes (perquè pugueu executar consultes de Beancount i veure els resultats al navegador), i fins i tot un editor web integrat per al vostre llibre major. És altament usable, fent que la comptabilitat de text pla sigui accessible per a aquells que prefereixen interfícies visuals.

Sota el capó, Fava està escrit en Python (Flask al backend) i JavaScript (Svelte al frontend). Té el seu propi cicle de llançament i es manté activament. Cal destacar que Fava ha seguit el ritme del desenvolupament de Beancount – per exemple, Fava 1.30 va afegir suport per a Beancount v3, canviant per utilitzar els nous paquets beanquery i beangulp internament. (Encara admet Beancount 2 per a llibres majors antics.) L'enfocament de Fava en la usabilitat inclou detalls agradables com l'autocompletat a l'editor web, i una interfície d'usuari elegant amb mode fosc i gràfics responsius. També hi ha un spin-off anomenat Fava-GTK, que empaqueta Fava en una aplicació d'escriptori per a usuaris de GNOME/Linux que prefereixen una sensació d'aplicació nativa.

Més enllà de Fava, existeixen altres opcions de visualització i anàlisi. Com que les dades de Beancount es poden exportar o consultar com a taules, els usuaris sovint aprofiten eines com els quaderns Jupyter o Pandas per a anàlisis personalitzades. Per exemple, un usuari descriu com extreure dades de Beancount a través de la interfície de consulta a un DataFrame de Pandas per preparar un informe personalitzat. També hi ha scripts aportats per la comunitat per a informes específics – per exemple, una eina d'anàlisi d'assignació de cartera o un gràfic de control de procés per a la despesa vs. el patrimoni net. No obstant això, per a la majoria de la gent, Fava proporciona prou potència d'informes sense necessitat d'escriure codi. Fins i tot admet extensions: podeu afegir fitxers Python que afegeixin noves pàgines d'informes o gràfics a Fava. Una extensió notable és fava-envelope per a la pressupostació per sobres dins de Fava. En general, Fava serveix com a centre de visualització central de l'ecosistema Beancount.

Utilitats i Scripts de Línia d'Ordres

Beancount ve amb diverses eines de línia d'ordres (CLI) (especialment a la branca antiga v2, algunes de les quals es van retallar a la v3). Aquestes eines operen sobre el vostre fitxer de llibreta per comprovar-lo o generar informes específics en text o HTML:

  • bean-check: un validador que comprova errors de sintaxi o errors comptables al fitxer. Executar bean-check myfile.beancount us alertarà de qualsevol desequilibri, compte que falta o altres problemes, i no mostrarà res si el fitxer no té errors.
  • bean-format: un formatejador que endreça la vostra llibreta alineant els números en columnes netes, molt semblant a executar un formatejador de codi en el codi font. Això ajuda a mantenir el fitxer net i llegible.
  • bean-query: una eina interactiva de shell o per lots per executar el llenguatge de consulta de Beancount a la vostra llibreta. La podeu utilitzar per produir informes tabulars personalitzats (p. ex., bean-query myfile.beancount "SELECT account, sum(amount) WHERE ...").
  • bean-report: un generador d'informes versàtil (a la v2) que pot generar informes predefinits (balanç, compte de pèrdues i guanys, balanç de comprovació, etc.) a la consola o a fitxers. Per exemple, bean-report file.beancount balances imprimiria els saldos dels comptes. (A la pràctica, molts d'aquests informes de text han estat substituïts per la presentació més agradable de Fava.)
  • bean-web / bean-bake: una interfície web antiga que serviria els informes a localhost o els "cuinaria" com a fitxers HTML estàtics. Aquests s'utilitzaven principalment abans que Fava es popularitzés; bean-web proporcionava una vista web bàsica dels mateixos informes que bean-report podia generar. A Beancount 3, bean-web s'ha eliminat (ja que Fava és ara el frontend web recomanat, oferint una experiència superior).
  • bean-example: una utilitat per generar un fitxer de llibreta d'exemple (útil per als nouvinguts per veure una plantilla d'entrades de Beancount).
  • bean-doctor: una eina de depuració que pot diagnosticar problemes a la vostra llibreta o entorn.

Val la pena assenyalar que, a partir de Beancount v3, moltes d'aquestes eines es van traslladar fora del projecte principal. El paquet principal de Beancount es va optimitzar, i eines com el motor de consulta i els importadors es van dividir en paquets separats (beanquery, beangulp, etc.) per a un manteniment més fàcil. Per exemple, la funcionalitat de bean-query ara la proporciona l'eina beanquery, que s'instal·la per separat. Des de la perspectiva de l'usuari, la funcionalitat segueix estant disponible; simplement s'ha modularitzat. La comunitat d'Arch Linux va notar aquest canvi en actualitzar Fava: el paquet de Fava va afegir dependències de beanquery i beangulp per donar suport a Beancount 3.x. Aquest enfocament modular també permet a altres membres de la comunitat contribuir a aquestes eines auxiliars de manera més independent del cicle de llançament de Beancount.

Connectors i Extensions de Beancount

Una de les fortaleses destacades de l'ecosistema Beancount és el sistema de connectors. Afegint una línia plugin "module.name" al vostre fitxer Beancount, podeu incorporar lògica Python personalitzada que s'executa durant el processament del llibre major. La comunitat ha creat molts connectors per estendre les capacitats de Beancount:

  • Qualitat de les dades i regles: Alguns exemples inclouen beancount-balexpr, que us permet afirmar equacions que involucren múltiples comptes (p. ex., Actiu A + Actiu B = Passiu X), i beancount-checkclosed, que insereix automàticament assercions de saldo quan tanqueu un compte per assegurar-vos que el seu saldo final sigui zero. Fins i tot hi ha un connector per assegurar que les transaccions del fitxer estiguin ordenades per data (autobean.sorted) per detectar entrades desordenades.
  • Automatització: El connector beancount-asset-transfer pot generar assentaments de transferència en espècie entre comptes (útil per moure accions entre corredors preservant la base de cost). Un altre, autobean.xcheck, contrasta el vostre llibre major de Beancount amb extractes externs per detectar discrepàncies.
  • Transaccions recurrents i pressupostos: El connector de "repetició" o interpolació d'Akuukis permet definir transaccions recurrents o repartir una despesa anual al llarg dels mesos. Per a la pressupostació, l'extensió fava-envelope (utilitzada a través de Fava) admet la metodologia de pressupost per sobres en text pla. També hi ha MiniBudget de Frank Davies, una petita eina autònoma inspirada en Beancount per ajudar amb la pressupostació per a ús personal o de petita empresa.
  • Impostos i informes: Alguns connectors ajuden amb la comptabilitat fiscal, com un que classifica automàticament els guanys de capital en a curt vs. a llarg termini. Un altre (fincen_114 de Justus Pendleton) genera un informe FBAR per als contribuents dels EUA amb comptes estrangers, il·lustrant com les dades de Beancount es poden aprofitar per a informes reguladors.
  • Repositoris de connectors de la comunitat: Hi ha conjunts de connectors curats com beancount-plugins (de Dave Stephens) que se centren en coses com els assentaments d'amortització, i beancount-plugins-zack (de Stefano Zacchiroli) que inclouen ajudants diversos com directives d'ordenació.

A més dels connectors, altres eines d'utilitat que orbiten Beancount aborden necessitats específiques. Per exemple, beancount-black és un autoformatador similar al formatador de codi Black, però per a fitxers de llibre major de Beancount. Hi ha un Bot de Beancount (Telegram/Mattermost) per afegir transaccions via xat, com s'ha esmentat, i un flux de treball d'Alfred per a macOS per afegir ràpidament transaccions al vostre fitxer. Una eina anomenada Pinto ofereix una CLI "sobrecarregada" amb entrada interactiva (com un bean-add millorat). Per a aquells que migren d'altres sistemes, existeixen convertidors (YNAB2Beancount, CSV2Beancount, GnuCash2Beancount, Ledger2Beancount) per ajudar a importar dades d'altres llocs.

En resum, l'ecosistema Beancount és bastant extens. La Taula 1 a continuació enumera algunes de les principals eines i extensions amb els seus rols:

Eina/ExtensióDescripció
Fava (interfície web)Aplicació web completa per visualitzar i editar llibres de Beancount. Proporciona informes interactius (balanç, ingressos, etc.), gràfics i capacitats de consulta. Gran impuls a la usabilitat de Beancount.
Beangulp (framework d'importació)Framework d'importació autònom per a Beancount v3, que reemplaça l'antic mòdul d'ingestió. Ajuda a convertir extractes bancaris (CSV, PDF, etc.) en assentaments de Beancount utilitzant scripts de connectors.
Beanquery (eina de consulta)Motor de consulta tipus SQL autònom per a dades de Beancount. Reemplaça bean-query a la v3, permetent consultes avançades de transaccions i saldos mitjançant una sintaxi familiar SELECT-FROM-WHERE.
Bean-check / Bean-formatEines CLI principals per validar un fitxer Beancount (comprovar errors) i autoformatejar-lo per a la consistència. Útils per mantenir un llibre major correcte i net.
Connectors d'editor (Emacs, VSCode, Vim, etc.)Connectors/modes que afegeixen suport de sintaxi Beancount i linting en editors de text. Milloren l'experiència d'editar manualment fitxers .beancount amb funcions com l'autocompletar i el ressaltat d'errors en temps real.
Importadors de la comunitatCol·leccions de scripts d'importació bancària (molts a GitHub) que cobreixen bancs als EUA, la UE, Àsia i més. Permeten als usuaris importar automàticament transaccions de les seves institucions financeres a Beancount.
Connectors (extensions de llibre major)Connectors opcionals dins del fitxer per aplicar regles o afegir funcionalitats (p. ex., compartició de despeses, assentaments recurrents, assercions de saldo personalitzades). Escrites en Python i s'executen durant el processament del fitxer per a la personalització.
Convertidors (eines de migració)Utilitats per convertir dades d'altres formats a Beancount, p. ex., de GnuCash o Ledger CLI a format Beancount. Faciliten l'adopció de Beancount sense començar de zero.

Comparació amb Ledger, hledger i Sistemes Similars

Beancount pertany a la família d'eines de comptabilitat de partida doble en text pla, entre les quals destaquen Ledger CLI (Ledger de John Wiegley) i hledger. Tot i que tots aquests sistemes comparteixen la idea central dels fitxers de llibre major en text pla i la comptabilitat de partida doble, difereixen en la sintaxi, la filosofia i la maduresa de l'ecosistema. La següent taula destaca les diferències clau entre Beancount, Ledger i hledger:

AspecteBeancount (Python)Ledger CLI (C++)hledger (Haskell)
Sintaxi i Estructura de FitxersSintaxi estricta i estructurada definida per una gramàtica formal (BNF). Les transaccions tenen línies explícites data flag "Beneficiari" "Descripció" i assentaments amb quantitats; tots els comptes han de ser explícitament oberts/definits. Sense assentaments implícits; cada transacció ha de quadrar.Sintaxi més lliure. El beneficiari/descripció es troba típicament a la mateixa línia que la data. Permet un cert quadre implícit (per exemple, una transacció d'un sol assentament pot implicar un segon assentament a un compte per defecte). Els noms de compte es poden utilitzar sense declaració prèvia. Ofereix moltes opcions de línia de comandes que poden afectar l'anàlisi (per exemple, suposicions d'any, regles de fusió de mercaderies).Segueix en gran mesura la sintaxi de Ledger amb petites diferències. hledger és una reimplementació de les característiques principals de Ledger en Haskell, de manera que el format del diari és molt similar al de Ledger (amb algunes extensions i una anàlisi més estricta per defecte). Per exemple, hledger és una mica més estricte amb les dates i la sintaxi de mercaderies que Ledger, però no tan estricte com Beancount.
FilosofiaConservador i Pedant. Posa èmfasi en la detecció d'errors de l'usuari i el manteniment de la integritat de les dades per sobre de tot. Imposa moltes comprovacions (assertions de saldo, seguiment de lots) per defecte. Configuració mínima – enfocament de "una sola manera de fer-ho" per a la consistència. Dissenyat com una biblioteca amb connectors per a l'extensibilitat (tracta les dades del llibre major com un flux a processar, permetent lògica Python personalitzada).Optimista i Flexible. Confia en l'usuari per introduir les dades correctament; menys restriccions incorporades per defecte. Altament personalitzable amb dotzenes d'opcions i banderes de comandes per ajustar el comportament. Tendeix a ser una eina monolítica amb característiques incorporades (informes, gràfics) i utilitza un llenguatge de domini específic dins del llibre major per a coses com transaccions automatitzades i transaccions periòdiques. L'extensibilitat és típicament mitjançant scripts externs o el llenguatge de consulta incorporat en lloc d'API de connectors.Pragmàtic i Consistent. Pretén acostar l'enfocament de Ledger a un públic més ampli amb un comportament previsible. hledger per defecte és més consistent (sense suposicions de quadre sense comptes explícits) i té menys errors fàcils de cometre que els modes més permissius de Ledger. Té un subconjunt de les característiques de Ledger (algunes de les opcions més exòtiques de Ledger no són compatibles), però n'afegeix algunes de pròpies (com una interfície web i importació CSV incorporada). Posa èmfasi en l'estabilitat i la correcció, però sense un sistema de connectors com el de Beancount.
Transaccions i QuadrePartida doble estricta: cada transacció ha de tenir un total de dèbits i crèdits iguals. No permet entrades desquadrades ni marcadors de posició (sense "assentaments virtuals" que s'autoquadrin). També imposa la independència de l'ordre: el llibre major es pot ordenar per data arbitràriament perquè les assertions de saldo estan limitades per data, no depenent de l'ordre del fitxer. El seguiment de costos per a les mercaderies és rigorós – quan vens actius, has d'especificar lots o Beancount imposarà FIFO/LIFO de manera que no puguis treure alguna cosa que no vas afegir.Permet més indulgència en les transaccions. Ledger permet assentaments "virtuals" (utilitzant claudàtors [ ] o parèntesis) que no requereixen un compte de quadre explícit – sovint utilitzats per gestionar pressupostos o quadre implícit de patrimoni net. És possible a Ledger introduir una transacció incompleta (ometent un costat) i deixar que Ledger inferi l'import de quadre. A més, Ledger no imposa estrictament l'eliminació d'actius lot a lot; restarà sense problemes d'un saldo agregat de mercaderies fins i tot si no es van rastrejar lots específics. Això facilita, per exemple, fer comptabilitat de cost mitjà, però significa que Ledger no t'impedirà cometre errors com vendre més accions de les que tens en un lot determinat.
Inventari i Base de CostSeguiment precís de lots. Beancount adjunta informació de cost als lots de mercaderies (per exemple, compra de 10 accions a 100 $ cadascuna), i en reduir un inventari requereix fer coincidir un lot específic o utilitzar una estratègia definida. Assegura que els guanys de capital i les bases de cost es calculen correctament per disseny. El mètode de cost mitjà no és el predeterminat tret que escriguis lògica explícitament per a això, perquè Beancount tracta cada lot de manera diferent per preservar la precisió.Inventari més abstracte. Ledger tracta les quantitats de mercaderies de manera més fluida; per defecte, tots els lots es fusionen en els informes (només mostra les quantitats totals). Proporciona opcions per informar per lot o cost mitjà si cal, però això és una preocupació d'informes. Històricament, Ledger no utilitzava la informació de costos per imposar el quadre en transaccions multimercaderies, cosa que podia portar a càlculs erronis subtils de guanys de capital. No obstant això, la flexibilitat de Ledger permet als usuaris triar FIFO, LIFO, mitjana, etc., en el moment de l'informe mitjançant banderes de línia de comandes.
Informes i Interfície d'UsuariPrincipalment a través de Fava (interfície web) i bean-query/bean-report. Fava ofereix un tauler web polit amb gràfics i diagrames, fent que Beancount sigui molt fàcil d'utilitzar per a l'anàlisi. També admet informes textuals i consultes tipus SQL mitjançant bean-query. Sense TUI oficial (interfície de text), però la integració amb editors/IDEs omple aquesta bretxa.Informes principalment basats en CLI. Ledger té moltes ordres d'informe incorporades (saldo, registre, estadístiques, etc.) que generen text al terminal. Pot produir gràfics (ASCII o mitjançant gnuplot) i fins i tot té alguns complements per a informes HTML, però no té una interfície web oficial mantinguda com a part del projecte. (Hi ha hagut intents de tercers d'interfícies web per a Ledger, però cap tan prominent com Fava per a Beancount.) Per a una interfície d'usuari, els usuaris depenen del terminal o potser de GUI com Ledger-Live (un projecte separat).Ofereix tant CLI com una interfície web senzilla. hledger hereta els informes CLI de Ledger (amb ordres similars) i, a més, proporciona hledger-web, una interfície web bàsica per veure comptes i transaccions en un navegador. hledger-web no és tan ric en funcions com Fava, però ofereix una visió general de només lectura. hledger també té hledger-ui, una interfície basada en curses de terminal per a un ús interactiu.
Extensibilitat i ConnectorsAlta extensibilitat mitjançant Python. L'API de connectors permet executar codi Python arbitrari durant el processament del llibre major, cosa que significa que els usuaris poden implementar característiques personalitzades sense modificar el nucli. L'ecosistema de connectors (per a pressupostos, etc.) ho demostra. A més, es poden escriure scripts Python per utilitzar les biblioteques de Beancount per a informes personalitzats.Extensibilitat de nivell inferior. Ledger es pot estendre escrivint els teus propis scripts que analitzen la sortida de Ledger o utilitzant el seu llenguatge de consulta intern de maneres intel·ligents. També té característiques com transaccions automatitzades (regles que generen automàticament assentaments donats els disparadors al diari) i transaccions periòdiques, que són tipus d'extensibilitat incorporada dins del fitxer del llibre major. Però no ofereix una API per injectar codi arbitrari al motor comptable – no és una biblioteca de la mateixa manera (tot i que libledger existeix per a desenvolupadors de C++).Extensibilitat moderada. hledger omet deliberadament les característiques de transaccions automatitzades/periòdiques de Ledger per mantenir les coses més senzilles, però proporciona eines com hledger-import per a la conversió d'altres formats i permet complements. Estant escrit en Haskell, s'utilitza com a biblioteca en alguns projectes, però escriure connectors personalitzats no és tan senzill com l'enfocament de Beancount. En canvi, hledger se centra a cobrir necessitats comunes (informes, web, UI) dins del seu conjunt d'eines oficial.
Comunitat i DesenvolupamentActiva però impulsada principalment per un autor (Martin Blais) i un petit grup de col·laboradors. Les versions principals són poc freqüents (la v2 va ser estable durant ~6 anys, després la v3 el 2024). La comunitat contribueix mitjançant connectors i eines (Fava va ser originalment un projecte de tercers que es va integrar). La llista de correu de Beancount i GitHub estan actius amb discussions, i la base d'usuaris ha crescut gràcies a l'atractiu de Fava per als no desenvolupadors.Llarga història (Ledger data del 2003) i ús generalitzat entre enginyers. Originalment un projecte d'una sola persona (Wiegley), va veure molts col·laboradors al llarg del temps. El desenvolupament de Ledger s'ha alentit en els últims anys; és estable però amb menys característiques noves (l'enfocament s'ha desplaçat al manteniment). La llista de correu ledger-cli és un centre per a totes les discussions de comptabilitat en text pla (incloent Beancount i hledger). Existeixen moltes eines i scripts al voltant de Ledger, però l'ecosistema no està tan unificat (cap "GUI de Ledger" única, etc., tot i que existeixen múltiples esforços independents).Comunitat creixent, amb Simon Michael liderant el desenvolupament d'hledger. hledger té versions anuals i millores constants, sovint seguint els canvis de característiques de Ledger però també forjant el seu propi camí. Gaudeix de popularitat entre els usuaris que volen el poder de Ledger amb més predictibilitat. La comunitat tendeix a superposar-se amb la de Ledger (plaintextaccounting.org cobreix tots dos). L'ecosistema d'hledger inclou complements com hledger-flow (per a l'automatització del flux de treball) i es beneficia d'estar escrit en Haskell (atraient aquells d'aquesta comunitat).

En resum, Beancount es diferencia pel seu èmfasi en la rigorositat, l'extensibilitat basada en connectors i una interfície web fàcil d'utilitzar. Ledger continua sent l'eina clàssica i altament flexible afavorida pels puristes de la línia de comandes i aquells que necessiten la màxima velocitat (el motor C++ de Ledger és molt ràpid en fitxers enormes). hledger proporciona un punt intermedi – gran part de la funcionalitat de Ledger amb una mica més d'estructura i una interfície web oficialment compatible (encara que senzilla). Tots tres comparteixen els avantatges de la comptabilitat en text pla (auditabilitat, control de versions amb Git, dades planes), però l'ecosistema de Beancount (especialment amb Fava) l'ha fet, sens dubte, més accessible per a l'usuari mitjà en els últims anys. Per contra, els usuaris de Ledger/hledger de vegades prefereixen la seva relativa simplicitat en la configuració (no es necessita Python) i l'estabilitat provada a llarg termini. En última instància, triar entre ells es redueix a la preferència personal: aquells que valoren la correcció rigorosa i un ecosistema ric sovint s'inclinen cap a Beancount, mentre que aquells que volen eines lleugeres i centrades en el terminal podrien quedar-se amb Ledger o hledger.

Escenaris d'ús per a Beancount

Beancount és prou versàtil per ser utilitzat tant per al seguiment de finances personals com (en alguns casos) per a la comptabilitat per a petites empreses. El seu enfocament central de partida doble és el mateix en ambdós escenaris, però l'escala i les pràctiques específiques poden diferir.

Finances Personals

Molts usuaris de Beancount l'utilitzen per gestionar les seves finances personals o familiars. Una configuració típica de finances personals a Beancount podria incloure comptes per a comptes corrents i d'estalvi, targetes de crèdit, inversions, préstecs, categories d'ingressos (salari, interessos, etc.) i categories de despeses (lloguer, queviures, entreteniment, etc.). Els usuaris registren les transaccions diàries manualment (introduint rebuts, factures, etc.) o important-les des d'extractes bancaris utilitzant les eines d'importació esmentades anteriorment. Els beneficis que Beancount aporta a les finances personals inclouen:

  • Consolidació i Anàlisi: Totes les teves transaccions poden residir en un únic fitxer de text (o un conjunt de fitxers) que representi anys d'historial financer. Això facilita l'anàlisi de tendències a llarg termini. Amb el llenguatge de consulta de Beancount o amb Fava, pots respondre preguntes com "Quant vaig gastar en viatges en els últims 5 anys?" o "Quina és la meva factura mitjana mensual de queviures?" en segons. Un usuari va assenyalar que després de canviar a Beancount, “l'anàlisi de dades financeres (despeses, donacions, impostos, etc.) és trivial” ja sigui a través de Fava o consultant les dades i utilitzant eines com Pandas. En essència, el teu llibre major es converteix en una base de dades financera personal que pots consultar a voluntat.
  • Pressupost i Planificació: Tot i que Beancount no imposa un sistema de pressupostos, en pots implementar un. Alguns usuaris fan pressupostos per sobres creant comptes de pressupost o utilitzant el connector fava-envelope. Altres simplement utilitzen informes periòdics per comparar les despeses amb els objectius. Com que és text pla, integrar Beancount amb eines de pressupostos externes o fulls de càlcul és senzill (exportant dades o utilitzant sortides CSV de consultes).
  • Seguiment d'Inversions i Patrimoni Net: Beancount destaca en el seguiment d'inversions gràcies a la seva robusta gestió de bases de cost i preus de mercat. Pots registrar compres/vendes d'accions, criptomonedes, etc., amb detalls de cost, i després utilitzar directives Prices per fer un seguiment del valor de mercat. Fava pot mostrar un gràfic de patrimoni net al llarg del temps i un desglossament de la cartera per classe d'actiu. Això és enormement útil per a la gestió del patrimoni personal: obtens informació similar a la que proporcionen eines comercials com Mint o Personal Capital, però totalment sota el teu control. La gestió de múltiples divises també està integrada, de manera que si tens divises estrangeres o criptomonedes, Beancount pot fer-ne un seguiment i convertir-les per a la generació d'informes.
  • Reconciliació i Precisió: Les finances personals sovint impliquen la reconciliació amb els extractes bancaris. Amb Beancount, es poden conciliar comptes regularment utilitzant assercions de saldo o la funció de documents. Per exemple, cada mes podries afegir una entrada balance Assets:Bank:Checking <data> <saldo> per confirmar que el teu llibre major coincideix amb l'extracte del banc a finals de mes. L'eina bean-check (o la visualització d'errors de Fava) t'alertarà si les coses no coincideixen. Un usuari esmenta fer una reconciliació mensual de tots els comptes, la qual cosa “ajuda a detectar qualsevol activitat inusual” – una bona pràctica d'higiene financera personal que Beancount facilita.
  • Automatització: Persones amb coneixements tecnològics han automatitzat grans parts del seu flux de treball de finances personals amb Beancount. Utilitzant importadors, tasques cron i potser una mica de Python, pots configurar el teu sistema de manera que, per exemple, cada dia les teves transaccions bancàries es recuperin (alguns utilitzen OFX o APIs) i s'afegeixin al teu fitxer Beancount, categoritzades per regles. Amb el temps, el teu llibre major s'actualitza majoritàriament de forma automàtica, i només has de revisar i ajustar segons sigui necessari. Un membre de la comunitat a Hacker News va compartir que després de 3 anys, els seus llibres de Beancount eren “95% automàtics”. Aquest nivell d'automatització és possible gràcies a l'obertura de text pla de Beancount i les seves capacitats de scripting.

Els usuaris de finances personals sovint trien Beancount en lloc de fulls de càlcul o aplicacions perquè els dóna la propietat completa de les dades (sense dependència d'un servei al núvol que podria tancar – una preocupació, ja que Mint va ser descontinuat, per exemple) i perquè la profunditat de la informació és major quan tens totes les teves dades integrades. La corba d'aprenentatge no és trivial – cal aprendre comptabilitat bàsica i la sintaxi de Beancount – però recursos com la documentació oficial i els tutorials de la comunitat ajuden els nouvinguts a començar. Un cop configurat, molts troben que aporta tranquil·litat tenir una imatge clara i fiable de les seves finances en tot moment.

Comptabilitat per a Petites Empreses

Utilitzar Beancount per a una petita empresa (o organització sense ànim de lucre, club, etc.) és menys comú que per a ús personal, però és certament possible i alguns ho han fet amb èxit. El marc de partida doble de Beancount és, de fet, el mateix sistema que sustenta la comptabilitat corporativa, només sense algunes de les característiques de nivell superior que ofereix el programari de comptabilitat dedicat (com ara mòduls de facturació o integracions de nòmines). Així és com Beancount pot encaixar en un context de petita empresa:

  • Llibre Major i Estats Financers: Una petita empresa pot tractar el fitxer de Beancount com el seu llibre major. Tindries comptes d'actiu per a comptes bancaris, comptes a cobrar, potser inventari; comptes de passiu per a targetes de crèdit, préstecs, comptes a pagar; patrimoni net per al capital del propietari; comptes d'ingressos per a vendes o serveis; i comptes de despeses per a totes les despeses del negoci. En mantenir aquest llibre, pots produir un Compte de Resultats (Pèrdues i Guanys) i un Balanç de Situació en qualsevol moment utilitzant els informes o consultes de Beancount. De fet, els informes integrats de Beancount o Fava poden generar un balanç i un P&G en segons que estan perfectament d'acord amb els principis comptables. Això pot ser suficient per a una petita operació per avaluar la rendibilitat, la posició financera i el flux de caixa (amb una mica de consulta per al flux de caixa, ja que els estats de flux de caixa directes no estan integrats, però es poden derivar).
  • Factures i Comptes a Cobrar, Comptes a Pagar: Beancount no té un sistema de facturació integrat; els usuaris normalment gestionarien la facturació externament (per exemple, crear factures a Word o una aplicació de facturació) i després registrarien els resultats a Beancount. Per exemple, quan emets una factura, registraries un assentament carregant Comptes a Cobrar i abonant Ingressos. Quan arriba el pagament, carregues Efectiu/Banc i abones Comptes a Cobrar. D'aquesta manera, pots fer un seguiment dels comptes a cobrar pendents consultant el saldo del compte de Comptes a Cobrar. El mateix s'aplica a les factures (Comptes a Pagar). Tot i que és més manual que el programari de comptabilitat especialitzat (que podria enviar recordatoris o integrar-se amb correus electrònics), és perfectament factible. Alguns usuaris han compartit plantilles o fluxos de treball sobre com gestionen les factures amb Beancount i s'asseguren de no perdre factures obertes (per exemple, utilitzant metadades o consultes personalitzades per llistar factures impagades).
  • Inventari o Cost de les Mercaderies Venudes: Per a les empreses que venen productes, Beancount pot fer un seguiment de les compres i vendes d'inventari, però requereix assentaments disciplinats. Podries utilitzar les característiques d'Inventari i comptabilitat de costos: la compra d'inventari augmenta un compte d'actiu (amb el cost associat als articles), la venda mou el cost a una despesa (CMV) i registra ingressos. Com que Beancount insisteix en la coincidència de lots, forçarà la reducció adequada de l'inventari amb el cost correcte, la qual cosa pot assegurar que els teus càlculs de benefici brut siguin precisos si es fan correctament. No obstant això, no hi ha un seguiment automatitzat de SKU ni res semblant; tot és a nivell financer (quantitat i cost).
  • Nòmines i Transaccions Complexes: Beancount pot registrar transaccions de nòmines (despesa de salaris, retencions fiscals, etc.), però el càlcul d'aquestes xifres es podria fer externament o mitjançant una altra eina, i després simplement registrar-les a Beancount. Per a una empresa molt petita (per exemple, un o dos empleats), això és manejable. Per exemple, registraries un únic assentament comptable per període de pagament que desglossaria salaris, impostos retinguts, despeses d'impostos de l'empleador, efectiu pagat, etc. Fer això manualment és similar a com es faria en els assentaments de diari de QuickBooks; requereix coneixement de quins comptes s'han d'afectar.
  • Multi-usuari i Auditoria: Un repte en un entorn empresarial és si diverses persones necessiten accedir als llibres o si un comptable necessita revisar-los. Com que Beancount és un fitxer de text, no és multi-usuari en temps real. No obstant això, allotjar el fitxer en un repositori Git pot permetre la col·laboració: cada persona pot editar i fer commit, i les diferències es poden fusionar.
  • Compliment normatiu: Per a la presentació d'impostos o el compliment normatiu, les dades de Beancount es poden utilitzar per generar els informes necessaris, però pot requerir consultes personalitzades o connectors. Vam veure un exemple d'un connector de la comunitat per a informes de compliment del govern indi, i un altre per a informes FBAR de FinCEN. Això demostra que, amb esforç, Beancount es pot adaptar per complir requisits d'informació específics. Les petites empreses en jurisdiccions amb requisits senzills (comptabilitat de caixa o meritació bàsica) poden certament mantenir els llibres a Beancount i produir estats financers per a les declaracions d'impostos. No obstant això, característiques com les taules d'amortització o l'amortització podrien requerir que escriguis els teus propis assentaments o utilitzis un connector (els connectors d'amortització de Dave Stephens ajuden a automatitzar-ho, per exemple). No hi ha una interfície gràfica d'usuari per "fer clic a amortitzar actiu" com en alguns programaris de comptabilitat; codificaries l'amortització com a transaccions (la qual cosa, d'alguna manera, la desmitifica: tot és un assentament que pots inspeccionar).

A la pràctica, molts propietaris de petites empreses amb orientació tecnològica han utilitzat Beancount (o Ledger/hledger) si prefereixen el control i la transparència a la comoditat de QuickBooks. Una discussió a Reddit va assenyalar que per a la comptabilitat estàndard de petites empreses amb un volum limitat de transaccions, Beancount funciona bé. El factor limitant sol ser el nivell de comoditat: si el propietari del negoci (o el seu comptable) se sent còmode amb una eina basada en text. Un avantatge és el cost: Beancount és gratuït, mentre que el programari de comptabilitat pot ser costós per a una petita empresa. D'altra banda, la manca de suport oficial i la naturalesa "fes-ho tu mateix" significa que és més adequat per a aquells que són alhora propietaris del negoci i tenen certa inclinació tècnica. Per a autònoms o empresaris individuals amb habilitats de programació, Beancount pot ser una opció atractiva per gestionar les finances sense dependre dels serveis de comptabilitat al núvol.

També són possibles els enfocaments híbrids: algunes petites empreses utilitzen un sistema oficial per a factures o nòmines, però importen periòdicament les dades a Beancount per a anàlisi i arxivament. D'aquesta manera, obtenen el millor dels dos mons: compliment i facilitat per a les operacions diàries, a més de la potència de Beancount per a una visió consolidada.

En resum, Beancount pot gestionar la comptabilitat de petites empreses, sempre que l'usuari estigui disposat a gestionar manualment coses que el programari comercial automatitza. Assegura un alt grau de transparència —entens profundament els teus llibres perquè els estàs escrivint— i, per a un usuari diligent, pot produir llibres impecables. Tant els usuaris personals com els empresarials es beneficien dels punts forts principals de Beancount: un motor comptable fiable, un rastre d'auditoria complet i flexibilitat per adaptar-se a escenaris únics (mitjançant scripting i connectors). Ja sigui per fer un seguiment d'un pressupost domèstic o de les finances d'una startup, Beancount ofereix un conjunt d'eines per fer-ho amb precisió i obertura.

Comunitat i Activitat de Desenvolupament

Beancount té una comunitat dedicada i una història de desenvolupament que reflecteix la seva naturalesa de codi obert, de nínxol però apassionada. A continuació, es detallen els punts clau sobre la seva comunitat, mantenidors i projectes relacionats:

  • Manteniment del Projecte: L'autor principal de Beancount és Martin Blais, qui va iniciar el projecte al voltant del 2007 i l'ha guiat a través de múltiples versions. Durant molt de temps, el desenvolupament va ser en gran part un esforç d'una sola persona (a part de les contribucions de pegats de la comunitat). La filosofia de Martin era construir una eina de comptabilitat "útil per a mi primer, així com per als altres, de la manera més senzilla i duradora". Aquesta motivació personal va mantenir el projecte com una feina feta amb amor. A partir del 2025, Martin Blais segueix sent el mantenidor principal (el seu nom apareix als commits i respon preguntes a la llista de correu/seguiment de problemes), però l'ecosistema al voltant de Beancount té molts altres contribuïdors en els seus respectius projectes.

  • GitHub i Repositoris: El codi font s'allotja a GitHub sota el repositori beancount/beancount. El projecte té llicència GPL-2.0 i ha atret un nombre modest de contribuïdors al llarg dels anys. A mitjans del 2024, la versió 3 de Beancount va ser llançada oficialment com la nova branca estable. Aquesta versió va implicar la separació d'alguns components: per exemple, el repositori beangulp (per a importadors) i el repositori beanquery (per a l'eina de consulta) formen part ara de l'organització beancount de GitHub, mantinguts de manera una mica independent. El repositori principal de Beancount se centra en el motor de comptabilitat central i l'analitzador de fitxers. A partir del 2025, el GitHub de Beancount mostra discussions actives sobre problemes i un desenvolupament continu – tot i que no és de gran volum, els problemes i les sol·licituds de pull van arribant, i s'hi fan actualitzacions ocasionals per corregir errors o millorar funcions.

  • Desenvolupament de Fava: Fava, la interfície web, va començar com un projecte separat (creat per Dominic Aumayr, qui el va registrar el 2016). Té la seva pròpia comunitat de contribuïdors i també es troba a GitHub sota beancount/fava. Els mantenidors i contribuïdors de Fava (per exemple, Jakob Schnetz, Stefan Otte i altres en els darrers anys) han estat millorant activament la interfície, amb llançaments cada pocs mesos. El xat de Gitter de Fava (enllaçat a la documentació de Fava) i el seguiment de problemes de GitHub són llocs on usuaris i desenvolupadors discuteixen noves funcions o errors. El projecte dóna la benvinguda a les contribucions, com ho demostra una nota al CHANGELOG agraint a múltiples membres de la comunitat per les seves PRs. L'estreta alineació de Fava amb el desenvolupament de Beancount (com ara l'addició ràpida de suport per a Beancount v3 i la nova sintaxi de beanquery) indica una bona col·laboració entre els dos projectes.

  • Llistes de Correu i Fòrums: Beancount té una llista de correu oficial (anteriorment a Google Groups, titulada "Beancount" o de vegades discutida a la llista general de Ledger). Aquesta llista de correu és un tresor de coneixement – els usuaris fan preguntes sobre com modelar certs escenaris, informen d'errors i comparteixen consells. Martin Blais és conegut per respondre a la llista de correu amb explicacions detallades. A més, la comunitat més àmplia de Comptabilitat de Text Pla se superposa molt. La llista de correu de Ledger CLI sovint també atén preguntes sobre Beancount, i hi ha un fòrum a plaintextaccounting.org i un subreddit r/plaintextaccounting on els temes de Beancount sorgeixen amb freqüència. Els usuaris d'aquestes plataformes discuteixen comparacions, comparteixen configuracions personals i ajuden els nouvinguts. El to general de la comunitat és molt cooperatiu – els usuaris de Beancount sovint ajuden els usuaris de Ledger i viceversa, reconeixent que totes aquestes eines tenen objectius similars.

  • Grups de Xat: A més de les llistes de correu, hi ha canals de xat com el Slack/Discord de Plaintext Accounting (organitzat per la comunitat) i el Gitter de Fava. Aquests són maneres menys formals i més en temps real d'obtenir ajuda o discutir funcions. Per exemple, algú podria entrar al Slack per preguntar si algú té un importador per a un banc específic. També hi ha un canal de Matrix/IRC (històricament #ledger o #beancount a IRC) on alguns usuaris de llarga data estan inactius. Tot i que no són tan nombrosos com les comunitats de programari convencional, aquests canals tenen gent amb coneixements que sovint poden respondre preguntes de comptabilitat obscures.

  • Contribuïdors i Membres Clau de la Comunitat: Alguns noms destaquen a la comunitat de Beancount:

    • "Redstreet" (Red S): Un contribuïdor prolífic que ha escrit molts plugins (com beancount-balexpr, sellgains, i altres) i sovint proporciona suport. També manté un conjunt de scripts d'importació i una eina anomenada bean-download per obtenir extractes.
    • Vasily M (Evernight): Autor d'alguns frameworks d'importació i plugins

Desenvolupaments Recents i Futures Característiques

A partir de 2025, l'ecosistema Beancount ha experimentat desenvolupaments significatius en els darrers dos anys, i hi ha discussions en curs sobre futures millores. A continuació, es presenten alguns desenvolupaments recents destacats i un avanç del que podria venir:

  • Llançament de Beancount 3.0 (2024): Després d'un llarg període en què Beancount 2.x va ser l'estàndard, la versió 3 es va llançar oficialment a mitjans de 2024. Aquesta va ser una fita important perquè la v3 representa una simplificació i modernització del codi base. Martin Blais havia concebut la v3 com una oportunitat per a "reorganitzar i simplificar" el sistema encara més. Tot i que originalment es pensava que seria una reescriptura important, a la pràctica l'actualització per als usuaris no va ser massa disruptiva. Els canvis principals van ser interns: un nou analitzador (parser), algunes millores de rendiment i l'extracció de components opcionals del nucli. El llançament es va dur a terme gradualment (la v3 havia estat en beta des de 2022, però al juliol de 2024 es va convertir en la versió estable recomanada). Usuaris com Siddhant Goel van informar que la migració de 2.x a 3.x va ser "majoritàriament sense incidents" amb només uns pocs canvis en el flux de treball.

  • Modularització – eines traslladades a paquets separats: Un dels grans canvis amb Beancount 3 és que moltes eines que solien residir al repositori monolític es van separar. Per exemple, bean-query ara és proporcionat pel paquet beanquery, i beancount.ingest va ser reemplaçat pel paquet beangulp. Comandes com bean-extract i bean-identify (per a importacions) van ser eliminades del nucli de Beancount. En canvi, la filosofia és utilitzar scripts autònoms per a la importació. Això significa que si actualitzeu a la v3, instal·laríeu beangulp i executaríeu scripts d'importació (cada importador és bàsicament un petit programa) en lloc de tenir un fitxer de configuració central de bean-extract. De manera similar, les consultes s'executen mitjançant beanquery, que es pot instal·lar i actualitzar independentment del nucli de Beancount. Aquest enfocament modular va ser dissenyat per facilitar el manteniment i fomentar les contribucions de la comunitat. També va reduir el nucli de Beancount, de manera que el nucli se centra purament en l'anàlisi (parsing) i la lògica comptable, mentre que la funcionalitat auxiliar pot evolucionar per separat. Des de la perspectiva de l'usuari, després d'actualitzar, cal ajustar les comandes (p. ex., utilitzar bean-query de beanquery, o utilitzar Fava que ja ho abstrau). El registre de canvis de Fava assenyala explícitament aquests canvis: Fava ara depèn de beanquery i beangulp, i gestiona els fluxos de treball d'importació de manera diferent per a Beancount 3 vs 2.

  • Millores de Rendiment: El rendiment va ser una motivació per revisar el disseny de Beancount. El pla de la v3 (tal com es descriu al document "Objectius de la V3" de Martin) incloïa l'optimització de l'analitzador (parser) i, possiblement, fer el procés de càrrega més ràpid i menys intensiu en memòria. El 2025, algunes d'aquestes millores s'han materialitzat. De manera anecdòtica, els usuaris amb llibres majors molt grans (desenes de milers de transaccions, o moltes operacions de borsa) han informat d'un millor rendiment amb l'última versió. Per exemple, un usuari que gestionava "transaccions de microinversió" i que va tenir problemes de rendiment va assenyalar aquestes preocupacions al Grup de Google – aquest tipus de retroalimentació probablement va informar la v3. El nou analitzador (parser) és més eficient i està escrit d'una manera més clara, la qual cosa podria estendre's en el futur. A més, Fava 1.29 va passar a un mecanisme de vigilància de fitxers més eficient (utilitzant la biblioteca watchfiles) per millorar la capacitat de resposta quan el llibre major canvia. De cara al futur, la comunitat podria explorar l'anàlisi incremental (només reprocessar les parts modificades del fitxer en lloc de tot) per gestionar llibres majors grans més ràpidament – això es va insinuar a la documentació com la idea de "servidor Beancount / registre incremental".

  • Millores en el Seguiment d'Inversions: Hi ha hagut un treball continu per millorar la informació sobre inversions i carteres. Per exemple, es va discutir àmpliament la gestió del cost mitjà ponderat (average cost basis) vs. FIFO. Tot i que Beancount aplica la concordança de lots, alguns usuaris prefereixen el cost mitjà per a certes jurisdiccions. Existeix una proposta i discussió sobre fer el registre del cost base més flexible (possiblement mitjançant un plugin o una opció). El 2025, no hi ha un interruptor integrat per al cost mitjà, però la base de la v3 (el redisseny del registre) facilita la implementació per part dels plugins. Es va llançar un plugin de la comunitat anomenat "Gains Minimizer" que pot suggerir quins lots vendre per minimitzar els impostos, mostrant el tipus d'eines avançades que s'estan construint al voltant de les inversions. Fava també va afegir característiques com una extensió de resum de cartera (amb càlculs de taxa de rendiment). Pel que fa a les futures característiques, es pot esperar més en aquest àmbit: possiblement suggeriments de reequilibri de cartera automatitzats o anàlisi de riscos, probablement com a eines externes que llegeixen dades de Beancount (ja que totes les dades hi són).

  • Nous Plugins i Extensions: L'ecosistema de plugins creix contínuament

Deu consells de comptabilitat per a potenciar el teu flux de treball amb Beancount

· 7 minuts de lectura
Mike Thrift
Mike Thrift
Marketing Manager

Una bona teràpia per al teu negoci és un llibre major tranquil i equilibrat. Els següents consells resumeixen les darreres directrius per a petites empreses en una rutina compatible amb Beancount.

Mantenir un conjunt de llibres impecable no es tracta només de sobreviure a la temporada d'impostos; es tracta d'entendre la salut financera del teu negoci en temps real. Per als usuaris d'un sistema de comptabilitat de text pla com Beancount, els bons hàbits són el motor que transforma un simple llibre major en una eina poderosa per a la comprensió i el creixement. Els següents deu consells estan dissenyats per refinar el teu procés, estalviar-te temps i mantenir les teves dades financeres netes, auditables i llestes per a l'acció.

2024-09-12-bookkeeping-basics-for-therapists-with-beancount

1. Separa els diners empresarials i personals

Aquesta és la regla d'or de les finances empresarials per una raó. Mantenir un compte corrent i una targeta de crèdit dedicats a la teva pràctica és la manera més neta de traçar una línia entre la teva vida empresarial i personal. Simplifica dràsticament la preparació d'impostos, proporciona una pista d'auditoria clara i ajuda a protegir els teus actius personals de les responsabilitats empresarials. A Beancount, això significa que les teves transaccions estan ordenades des del principi: s'ha acabat intentar recordar si la compra d'aquell cafè va ser una reunió amb un client o una despesa personal.

2. Tria caixa o meritació aviat i mantén-t'hi

El teu mètode comptable determina quan registres els ingressos i les despeses. L'IRS permet a la majoria de les petites empreses triar entre el mètode de caixa o el de meritació.

  • Caixa: Registres els ingressos quan els diners arriben al teu compte i les despeses quan els diners en surten. És senzill i ideal per a empreses amb transaccions directes i immediates.
  • Meritació: Registres els ingressos quan els guanyes (per exemple, quan proporciones un servei) i les despeses quan les incorres, independentment de quan es produeixi el canvi de diners. Això proporciona una imatge més precisa de la rendibilitat, especialment si gestiones factures o reclamacions d'assegurances amb pagaments endarrerits.

La clau és triar un mètode aviat i aplicar-lo de manera consistent. Fins i tot pots declarar la teva elecció al teu llibre major utilitzant el bloc options de Beancount per formalitzar la decisió.

3. Concilia amb una cadència

La conciliació és el procés de fer coincidir les transaccions del teu llibre major de Beancount amb els teus extractes bancaris i de targetes de crèdit oficials. Realitzar aquesta comprovació amb una cadència regular, ja sigui setmanal o mensual, és un hàbit crucial. Et permet detectar comissions bancàries, detectar possibles fraus i identificar qualsevol error d'importació de dades abans que es converteixin en un maldecap important. Una ordre ràpida et pot mostrar el saldo per comprovar-lo amb el teu extracte.

bean-balance books.bean "Assets:Bank" -e 2025-07-31

4. Automatitza les importacions sempre que sigui possible

El teu temps és millor dedicat a atendre clients que a introduir manualment dades de transaccions. L'ecosistema de Beancount brilla aquí. Utilitza eines com bean-extract per crear configuracions que llegeixin fitxers CSV del teu banc, processador de pagaments (com Stripe o Square) o sistema EHR. Un cop configurades, aquestes seqüències de comandaments poden convertir automàticament dades en brut en entrades de Beancount formatades, reduint dràsticament els errors tipogràfics i alliberant hores de treball administratiu.

5. Categoritza immediatament, no en el moment dels impostos

Posposar la categorització és una recepta per a l'estrès i la inexactitud. Quan una transacció entra al teu llibre major, assigna-la al compte correcte immediatament (per exemple, Income:Therapy:SelfPay, Expenses:Software:EHR, Expenses:CEU). Fer-ho en temps real garanteix que recordis correctament el context de cada despesa. Un pla de comptes ben definit fa que aquest procés sigui ràpid i consistent, convertint el teu llibre major en un informe ric i en temps real sobre les operacions del teu negoci.

6. Desa còpies digitals de tots els rebuts i EOB

Els rebuts en paper s'esvaeixen i es perden. Un enfocament digital primer és més resistent i eficient. Escaneja els rebuts en paper o desa les factures en PDF i les Explicacions de Beneficis (EOB) en una carpeta segura i organitzada a l'ordinador. Amb Beancount, pots enllaçar directament a aquests fitxers des del teu llibre major utilitzant metadades.

2025-07-15 * "Webinar de CEU"
Expenses:CEU 79.00 USD
Assets:Bank:Practice
document: "docs/ceu/2025-07-15-trauma-webinar.pdf"

Això crea un registre impecable i autocontingut que és invaluable durant una auditoria fiscal.

7. Monitoritza les tendències del flux de caixa, no només els saldos

Conèixer el saldo bancari actual és bo; entendre el flux de diners que entra i surt del teu negoci és millor. Utilitza el potent llenguatge de consultes de Beancount per analitzar les teves tendències financeres. Representa gràficament els teus ingressos mensuals enfront de les despeses, identifica els teus serveis més rendibles o preveu possibles crisis de liquiditat durant els mesos més lents. Aquest enfocament proactiu, recomanat per les principals guies de comptabilitat, et permet prendre decisions estratègiques en lloc de reaccionar a sorpreses financeres.

8. Fes còpies de seguretat i controla les versions del teu llibre major

Com que el teu llibre major de Beancount és un fitxer de text senzill, pots utilitzar Git, un sistema de control de versions potent i gratuït, per gestionar-lo. Mantenint el teu llibre major en un repositori Git privat (en un servei com GitHub o GitLab), obtens dos beneficis crítics gratuïtament:

  1. Un historial complet: Pots veure tots els canvis que s'han fet al teu llibre major.
  2. Una còpia de seguretat fora del lloc: Les teves dades estan segures davant d'errors de maquinari local.

Fes un hàbit de "pujar" els teus canvis després de cada sessió de conciliació.

9. Revisa els estats financers mensualment

No esperis que el teu comptable et digui com va el teu negoci. Al final de cada mes, utilitza les eines d'informes de Beancount per generar estats financers clau com un compte de resultats i un balanç. Compara'ls amb el mes anterior o el mateix mes de l'any passat. Aquesta revisió regular t'ajuda a detectar fuites de despeses, avaluar els teus preus i a construir l'alfabetització financera necessària per respondre preguntes de prestadors o inversors amb confiança.

bean-report books.bean income_statement -e 2025-07-31

10. Pressuposta els impostos durant tot l'any

Per a un professional autònom, el dia dels impostos no hauria de ser mai una sorpresa. Tracta la teva futura factura d'impostos com una despesa recurrent. Crea comptes de passiu a Beancount (per exemple, Liabilities:Tax:Federal, Liabilities:Tax:State) i transfereix regularment un percentatge de cada pagament que rebis a aquests dipòsits virtuals. Quan arribi el moment de fer els teus pagaments d'impostos estimats trimestrals, els diners estaran reservats i esperant, fent que el procés sigui completament indolor.


Llista de comprovació d'inici ràpid

  • Obre comptes bancaris separats per a la teva pràctica.
  • Tria caixa o meritació i registra-ho a les teves options.
  • Automatitza les importacions de CSV del teu banc i EHR amb bean-extract.
  • Etiqueta cada transacció amb una categoria a l'arribada.
  • Concilia setmanalment; fes una còpia de seguretat al teu repositori Git privat després.
  • Executa informes mensuals i consultes de flux de caixa.
  • Transfereix un marge d'impostos a un compte d'estalvi d'alt rendiment separat.

A punt per calmar els teus llibres?

Instal·la Beancount, registra la teva primera entrada i deixa que aquests deu hàbits proporcionin l'estructura necessària per mantenir la teva pràctica de teràpia financerament sòlida i rica en informació. Feliç comptabilitat!

Conceptes bàsics de comptabilitat per a terapeutes amb Beancount

· 9 minuts de lectura
Mike Thrift
Mike Thrift
Marketing Manager

La teràpia consisteix a escoltar; la comptabilitat consisteix a escoltar els vostres diners. Quan les notes de sessió s'acumulen i els reemborsaments s'endarrereixen, un conjunt transparent de llibres esdevé la calma enmig del caos.

Gestionar una consulta privada significa portar dos barrets: el de clínic i el de propietari d'un negoci. Mentre que la vostra experiència rau en proporcionar atenció, la salut financera de la vostra consulta depèn d'una comptabilitat clara i coherent. Per als terapeutes, aquesta tasca presenta un conjunt únic de reptes.

2024-08-24-conceptes-bàsics-de-comptabilitat-per-a-terapeutes-amb-beancount

Per què la comptabilitat per a teràpia és diferent

El ritme financer d'una consulta de teràpia rarament segueix un patró simple i predictible. Aquesta complexitat prové d'unes quantes àrees clau que fan que el programari de comptabilitat estàndard sovint sembli inadequat.

  • Flux de caixa irregular. El vostre flux d'ingressos rarament és lineal. El copagament d'un client pot arribar al vostre compte avui, però el reemborsament corresponent de l'assegurança pot trigar setmanes o fins i tot mesos a arribar. Si hi afegim plans de pagament a escala variable, esteu gestionant diners en efectiu que arriben en terminis molt diferents. Això fa que sigui crucial entendre la diferència entre quan guanyeu diners (comptabilitat de meritació) i quan els rebeu (comptabilitat de caixa).
  • Una sopa de comissions. Les despeses de gestionar una consulta moderna s'acumulen ràpidament. Des de les subscripcions a la història clínica electrònica (HCE) i les comissions de processament de pagaments fins a l'assegurança de responsabilitat civil i el desenvolupament professional, nombrosos petits costos poden minvar silenciosament els vostres marges de benefici si no es controlen meticulosament.
  • Exempció d'impostos sobre les vendes, però amb un fort autoocupació. Tot i que la majoria dels serveis de salut mental estan exempts de l'impost sobre les vendes, no esteu exempts de l'IRS. Com a professional autònom, sou responsable de pagar impostos estimats trimestrals, que inclouen tant l'impost sobre la renda com els impostos sobre l'autoocupació (SECA) per cobrir la Seguretat Social i Medicare.
  • Sensibilitat HIPAA. Les vostres dades financeres estan entrellaçades amb la informació de salut protegida (PHI). L'ús de programari en núvol de tercers per a la comptabilitat pot ampliar la "superfície d'atac" de la vostra consulta, creant un altre vector potencial per a les fuites de dades. Un sistema de comptabilitat de text pla com Beancount manté totes les vostres dades al vostre propi ordinador, sota el vostre control, reduint aquest risc.

Un pla de set passos amb Beancount

Beancount és un sistema de comptabilitat potent i de codi obert que utilitza fitxers de text pla. És gratuït, privat i prou flexible per gestionar el paisatge financer únic d'una consulta de teràpia. A continuació s'explica com començar.

• Separeu els fons personals i els de la consulta

Aquest és el primer pas no negociable de les finances empresarials. Obriu un compte corrent comercial dedicat i una targeta de crèdit comercial. A partir d'ara, cada pagament del client entra en aquest compte i cada despesa comercial, des de les taxes de llicència fins al material d'oficina, es paga amb aquests fons. A Beancount, podeu designar-los fàcilment, creant un límit clar: cada transacció és personal o relacionada amb la consulta, eliminant les conjectures. Per exemple, el vostre nou compte esdevé Actius:Banc:Consulta.

• Creeu un pla de comptes adaptat als terapeutes

Un "pla de comptes" és simplement una llista de totes les categories que utilitzeu per organitzar les vostres transaccions financeres. Penseu-hi com el sistema d'arxivament dels vostres diners. Començareu amb els cinc tipus de comptes principals: Actius, Passius, Patrimoni, Ingressos i Despeses. A continuació, podeu crear subcomptes adaptats específicament a la vostra consulta de teràpia.

2025-07-23 open Ingressos:Terapia:PagamentDirecte       USD
2025-07-23 open Ingressos:Terapia:Assegurança USD
2025-07-23 open Actius:ComptesARebre USD
2025-07-23 open Despeses:FormacióContinuada USD
2025-07-23 open Despeses:Programari:HCE USD
2025-07-23 open Despeses:Llicències USD

Aquesta estructura us permet veure exactament d'on provenen els vostres diners (pagament directe vs. assegurança) i on van (formació continuada, programari, etc.). Això reflecteix els plans de comptes de millors pràctiques publicats per a professionals de la salut mental.

• Trieu caixa o meritació (i seguiu-ho)

Heu de decidir quan reconèixer els vostres ingressos i despeses.

  • Mètode de caixa: Registreu els ingressos quan rebeu els diners en efectiu i les despeses quan les pagueu.
  • Mètode de meritació: Registreu els ingressos quan els guanyeu (per exemple, quan es completa una sessió) i les despeses quan les incorreu, independentment de quan canviïn de mans els diners.

Per exemple, si un client paga per avançat 1000 $ per un paquet de cinc sessions, el mètode de caixa registra els 1000 $ d'ingressos complets el dia del pagament. El mètode de meritació registraria 200 $ d'ingressos després de cada sessió completada, donant-vos una imatge més precisa dels vostres guanys mensuals.

Regla general: Consulta individual, poques reclamacions d'assegurança → el mètode de caixa és més senzill i sovint suficient. Consulta en grup, molts reemborsaments → la meritació dóna una imatge més clara de la rendibilitat.

• Feu un seguiment dels comptes a cobrar i els reemborsaments

Un dels punts forts de Beancount és la seva capacitat de fer un seguiment dels diners que us deuen. Quan envieu una reclamació d'assegurança, encara no us han pagat, però heu guanyat els ingressos. Podeu registrar això al vostre compte Actius:ComptesARebre. Quan arribi el pagament (sovint per un import inferior al facturat), podeu "liquidar" el compte a cobrar i comptabilitzar la retallada de l'assegurança.

2025-07-10 * "Sessió CPT 90837 – pendent BlueCross"
Actius:ComptesARebre 150.00 USD
Ingressos:Terapia:Assegurança

2025-07-25 * "Pagament BlueCross CPT 90837"
Actius:Banc:Consulta 135.00 USD
Despeses:RetalladaAssegurança 15.00 USD
Actius:ComptesARebre -150.00 USD

Aquest procés de dos passos garanteix que mai no perdeu la pista de les reclamacions pendents i que tingueu un registre precís dels ajustos de l'assegurança.

• Categoritzeu les despeses deduïbles amb promptitud

Mantenir-se al dia de les vostres despeses és clau per minimitzar la vostra factura d'impostos. L'IRS us permet deduir les despeses que són "ordinàries i necessàries" per a la vostra professió. Per als terapeutes, això inclou cursos de formació continuada (FC), supervisió obligatòria per l'estat, taxes de renovació de llicències, assegurança de responsabilitat civil i subscripcions a HCE. En categoritzar aquestes despeses a mesura que les incorreu, tindreu un total exacte fins a la data, a punt per als vostres càlculs d'impostos trimestrals i la declaració de final d'any.

• Concilieu setmanalment

La conciliació és el procés de fer coincidir les transaccions del vostre llibre major de Beancount amb els vostres extractes bancaris i de targeta de crèdit. Confirma que els vostres registres són exactes i complets. Una revisió setmanal ràpida pot evitar que petits errors es converteixin en grans mals de cap. Amb Beancount, només necessiteu unes quantes ordres senzilles al vostre terminal.

# Comproveu el saldo final del vostre compte bancari de la consulta
bean-balance llibres.bean "Actius:Banc:Consulta"

# Vegeu un resum de les vostres fonts d'ingressos
bean-query llibres.bean "SELECT account, SUM(position) WHERE account ~ 'Ingressos' GROUP BY account"

# Genereu un compte de resultats per a l'any fins a la data
bean-report llibres.bean compte_de_resultats --end 2025-07-23

Aquest bucle senzill (categoritzar, conciliar i informar) és la base d'una bona gestió financera per a qualsevol consulta privada.

• Automatitzeu i feu còpies de seguretat

Adopteu l'automatització per estalviar temps i reduir errors.

  • Utilitzeu una eina d'extracció com bean-extract per convertir automàticament fitxers CSV del vostre banc o HCE en entrades de transaccions de Beancount.
  • Emmagatzemeu PDF de documents importants com ara explicacions de beneficis (EOB) o certificats de FC en una carpeta dedicada i enllaceu-los directament a la transacció rellevant del vostre llibre major mitjançant les metadades document:.
  • El vostre llibre major .bean és un fitxer de text senzill, cosa que el fa perfecte per al control de versions. Envieu el vostre llibre major a un repositori Git privat (com ara a GitHub o GitLab) cada nit per obtenir una còpia de seguretat segura fora del lloc.

Errors comuns (i solucions ràpides)

Fins i tot amb un bon sistema, uns quants errors comuns poden fer ensopegar els terapeutes. A continuació s'explica com detectar-los i solucionar-los.

ErrorSolució
Comptabilitat de dipòsit net (agrupa tots els ingressos/comissions)Dividiu cada xec d'assegurança en línies d'ingressos i retallada.
Oblidar les comissions per no presentacióPubliqueu una línia d'ingressos separada etiquetada noshow per a més claredat.
Barrejar costos de FC i de viatgeSepareu Despeses:FC vs. Despeses:Viatge—tots dos són deduïbles però es controlen de manera diferent.
Ignorar l'envelliment dels comptes a cobrarConsulteu Actius:ComptesARebre per data per perseguir reclamacions antigues.

Llista de comprovació d'inici ràpid

  • Obriu un compte bancari i una targeta de crèdit només per a la consulta.
  • Cloneu el repositori d'inici de Beancount i creeu el vostre pla de comptes específic per a teràpia.
  • Decidiu una base de caixa o de meritació i anoteu-ho a les vostres opcions de Beancount.
  • Escriviu una configuració d'importació senzilla per a les vostres descàrregues CSV del banc, HCE o assegurança.
  • Programeu una "hora Bean" recurrent (potser els divendres a la tarda) per al vostre flux de treball d'importació → conciliació → informe.
  • Configureu còpies de seguretat automatitzades fora del lloc per als vostres fitxers .bean i proveu el procés de restauració un cop per trimestre.

Lectures addicionals

A punt per silenciar el soroll financer? Instal·leu Beancount, registreu la vostra primera comissió de sessió i deixeu que la claredat de la comptabilitat de text pla doni a la vostra consulta l'espai mental i l'estabilitat financera que es mereix. Feliç "bean-keeping"!

Conceptes bàsics de comptabilitat per a venedors d'Amazon amb Beancount

· 8 minuts de lectura
Mike Thrift
Mike Thrift
Marketing Manager

Quan els vostres marges viuen de cèntims, la precisió supera les conjectures.

Vendre a Amazon és un joc de volum i velocitat. Però darrere de la pressa de vendes i enviaments hi ha una complexa xarxa de comissions, devolucions, moviments d'inventari i obligacions fiscals. El programari de comptabilitat estàndard sovint té dificultats per capturar aquest matís, deixant els venedors amb una imatge borrosa de la seva veritable rendibilitat.

2024-07-16-bookkeeping-basics-for-amazon-sellers-with-beancount

Aquí és on brilla un sistema de comptabilitat de text pla com Beancount. En donar-vos un control total sobre com registreu les transaccions, podeu construir una font de veritat financera que modeli perfectament els reptes únics del mercat d'Amazon. Aquesta guia proporciona un flux de treball pas a pas per mantenir-vos per davant de les comissions, els impostos i els mals de cap d'inventari.

Per què la comptabilitat d'Amazon és diferent

Si heu intentat conciliar un pagament d'Amazon amb el vostre extracte bancari, ja sabeu que no és senzill. La realitat financera d'un negoci d'Amazon s'amaga darrere de capes d'abstracció.

  • Pagaments globals quinzenals: Amazon no us envia els ingressos de cada venda. En canvi, envia un únic dipòsit cada dues setmanes. Aquesta suma global és una xifra neta, amb les vendes brutes reduïdes per les comissions de referència, les comissions FBA, els costos publicitaris, les devolucions i altres retencions. Per entendre el vostre negoci, heu de desglossar aquest únic número en les seves parts constituents. (doola: A Business-in-a-Box™)
  • Inventari a tot arreu: El vostre inventari està constantment en moviment: des del vostre proveïdor, a un centre de preparació, a diversos centres de compliment FBA a tot el país i, finalment, al client. El seguiment precís del vostre Cost de les Mercaderies Venudes (COGS) requereix saber quin lot d'inventari (a quin cost) es va utilitzar per a cada venda. (Bean Ninjas)
  • Comissions i promocions del mercat: Una part important dels vostres ingressos es consumeix immediatament per les comissions: comissions de referència, comissions de recollida i embalatge FBA, comissions d'emmagatzematge mensuals i costos publicitaris. El seguiment de cadascuna d'aquestes categories de despeses per separat és l'única manera de calcular el vostre marge brut real i determinar la rendibilitat real d'un producte. (Profitwise Accounting)
  • Mosaic d'impostos sobre les vendes: Tot i que les lleis del Facilitador del Mercat d'Amazon gestionen la recaptació i la remissió d'impostos sobre les vendes a la majoria dels estats, no és una solució completa. Emmagatzemar inventari en magatzems FBA pot crear "nexus" (una presència empresarial), que pot requerir que us registreu i presenteu la declaració en aquests estats, fins i tot si no es deu cap impost. Aquesta és una àrea de compliment complexa que exigeix un seguiment acurat. (TaxDo)
  • Llindars 1099-K més baixos: Amb el llindar d'informació del Formulari 1099-K baixant de 20.000 a5.000a 5.000 el 2024 (i previst que baixi a només 600 $ a partir del 2026), gairebé tots els venedors seriosos rebran un formulari d'Amazon que informa el seu volum de transaccions brutes a l'IRS. Els vostres llibres han de poder conciliar perfectament amb aquest número. (IRS)

Pla de set passos de Beancount

Aquest pla aprofita la precisió de Beancount per afrontar la complexitat d'Amazon de front.

1. Separeu els canals aviat

Si veneu en múltiples plataformes, mantingueu la vostra comptabilitat per a cadascuna per separat. Dins d'un únic fitxer Beancount per a la vostra entitat legal, creeu comptes jeràrquics dedicats per a cada mercat. Aquesta estructura simplifica l'anàlisi i fa que la generació de calendaris fiscals sigui trivial.

2025-07-22 open Income:Amazon               USD
2025-07-22 open Expenses:Amazon:FBAFee USD
2025-07-22 open Assets:Amazon:Payouts USD

2. Descomposeu cada pagament

Aquest és l'hàbit més crític. No reserveu mai un dipòsit d'Amazon com una sola línia d'ingressos. En canvi, descarregueu l'informe de liquidació "Totes les transaccions" de Seller Central per al període corresponent. Utilitzeu aquest informe per crear una única transacció Beancount que desglossa el pagament en els seus components.

El dipòsit que rebeu al banc és l'assentament de compensació. Les vendes brutes s'abonen a Income, mentre que totes les comissions i reemborsaments es carreguen als seus respectius comptes Expenses.

; pagament quinzenal de l'informe de liquidació
2025-07-14 * "Liquidació d'Amazon #4361"
Assets:Bank:Operating 8432.17 USD
Income:Amazon:Sales -12274.50 USD
Expenses:Amazon:FBAFee 2454.80 USD
Expenses:Amazon:Adverts 1012.06 USD
Expenses:Amazon:Refunds 375.47 USD
Assets:Amazon:Reserve -100.00 USD

3. Feu un seguiment de l'inventari i el COGS amb lots

Beancount té un sistema de primera classe per al seguiment d'inventari anomenat "lots". Quan compreu inventari, registreu el nombre d'unitats i el seu cost específic. Quan es ven una unitat, podeu carregar aquest cost exacte, donant-vos un càlcul perfecte del Cost de les Mercaderies Venudes (COGS).

; Compra 1.000 unitats d'un proveïdor
2025-07-01 * "Comanda de compra del proveïdor PO-7421"
Assets:Inventory:WidgetA 1000 WidgetA {@ 4.20 USD}
Assets:Bank:Operating

; Més tard, registreu el cost d'una sola venda
2025-07-16 * "Venda FBA WidgetA | COGS"
Expenses:COGS 1 WidgetA {4.20 USD}
Assets:Inventory:WidgetA

4. Trieu el mètode de meritació per a més claredat

Per a qualsevol negoci basat en inventari, el mètode de meritació és superior. Un enfocament basat en efectiu mostraria una despesa massiva el mes que compreu inventari i beneficis artificialment alts els mesos que el veneu, distorsionant el vostre rendiment. La comptabilitat de meritació coincideix correctament el cost de les mercaderies venudes (COGS) amb els ingressos d'aquesta venda en el mateix període, proporcionant una imatge molt més clara del vostre benefici brut. (Bean Ninjas)

5. Automatitzeu les importacions

Introduir manualment els informes de liquidació és educatiu al principi, però no s'escala. L'ecosistema de text pla destaca en l'automatització:

  • Utilitzeu bean-extract per extreure dades de CSV formatats exportats per serveis com A2X.
  • Escriviu scripts senzills de Python per extreure dades directament de l'SP-API d'Amazon.
  • Utilitzeu importadors existents per extreure fitxers CSV bancaris per conciliar dipòsits i comissions carregades directament a targetes de crèdit.

6. Concilieu setmanalment

Feu un hàbit de comprovar els vostres números. Utilitzeu les potents eines de línia d'ordres de Beancount per validar ràpidament els saldos i revisar el rendiment.

# Comproveu els vostres recomptes i valor d'inventari actuals
bean-balance books.bean "Assets:Inventory" "2025-07-21"

# Genereu un compte de resultats per al darrer període
bean-report books.bean income_statement -e 2025-07-21

7. Archiveu els documents font

Per a cada transacció important, enllaceu al document font. Adjunteu el PDF oficial de liquidació d'Amazon, la factura del proveïdor per a una compra d'inventari o un rebut d'enviament mitjançant la sintaxi de metadades de Beancount (document:). Això crea un registre financer autocontingut i llest per a auditoria.

Llista de comprovació d'impostos sobre les vendes i compliment

  • Lleis del Facilitador del Mercat: Enteneu que, tot i que Amazon recau l'impost sobre les vendes en nom vostre a la majoria dels estats, emmagatzemar inventari en estats com Califòrnia, Texas o Pennsilvània encara pot crear un nexe econòmic, que pot requerir que registreu la vostra empresa allà. (TaxGPT)
  • Conciliació 1099-K: Assegureu-vos que el total que registreu a Income:Amazon:Sales per a l'any coincideixi amb l'import brut informat al vostre Formulari 1099-K fins al cèntim. Qualsevol discrepància és una bandera d'auditoria. (IRS)
  • Impost sobre les vendes directe: Si veneu a través d'altres canals no coberts per un facilitador, mantingueu un subarbre de comptes Liabilities:SalesTaxPayable:State per fer un seguiment dels impostos que debeu directament.

Errors comuns (i solucions)

  • Error: Registrar només el dipòsit net d'Amazon.
    • Solució: Descomposeu sempre els pagaments utilitzant l'informe de liquidació complet.
  • Error: Ignorar les devolucions reemborsades o els béns danyats.
    • Solució: Registreu tant la despesa inicial del reemborsament com el reemborsament posterior d'Amazon com un crèdit separat.
  • Error: Oblidar-se de les reserves rotatives.
    • Solució: Amazon sovint reté un saldo de "reserva" dels pagaments, especialment per a comptes nous. Feu un seguiment d'aquests diners que se us deuen en un compte dedicat Assets:Amazon:Reserve.
  • Error: No coincidir els àlies SKU entre el vostre sistema i el d'Amazon.
    • Solució: Normalitzeu tots els codis SKU als vostres scripts d'importació per assegurar-vos que les cerques de COGS no fallin.

Tasques de començament ràpid

  • Habiliteu i descarregueu el vostre primer informe de liquidació a Seller Central.
  • Cloneu un repositori d'inici de Beancount i creeu un pla de comptes específic per a Amazon.
  • Escriviu un petit script d'importació que converteixi un CSV de liquidació en una transacció Beancount (fitxer .txn).
  • Programeu un recordatori setmanal per extreure nous informes i executeu bean-check per assegurar-vos que els vostres fitxers siguin vàlids.
  • Reviseu el vostre compte de resultats mensualment per prendre decisions basades en dades sobre la despesa publicitària, els preus i l'inventari.

Lectura addicional

Envieu més, preocupeu-vos menys: mantingueu els vostres beans equilibrats. Bones vendes!

Conceptes bàsics de comptabilitat per a venedors d'Etsy amb Beancount

· 8 minuts de lectura
Mike Thrift
Mike Thrift
Marketing Manager

Els llibres de comptes cosits a mà superen els fulls de càlcul enredats, especialment quan cada cèntim compta.

Per als artistes, fabricants i conservadors d'Etsy, la passió impulsa el negoci. Però a mesura que la vostra botiga creix, la claredat financera esdevé tan important com la visió creativa. Fer malabars amb les comissions, fer un seguiment dels costos dels materials i preparar-se per als impostos pot ser aclaparador i allunyar-vos del banc de treball.

2024-07-16-conceptes-bàsics-de-comptabilitat-per-a-venedors-d'etsy-amb-beancount

Què passaria si poguéssiu gestionar les finances de la vostra botiga amb la mateixa cura i precisió que poseu en els vostres productes? Aquesta guia presenta un flux de treball de comptabilitat de text pla mitjançant Beancount, un motor de codi obert dissenyat per a la precisió i el control. És un mètode que us ajuda a dominar els vostres números perquè pugueu centrar-vos en el vostre ofici.

Per què la comptabilitat d'Etsy és diferent

Una botiga Etsy té una empremta financera única, amb complexitats que el programari de comptabilitat genèric sovint no detecta.

  • Comissions de mercat a tot arreu: El vostre pagament final és el que queda després que Etsy prengui la seva part. Les comissions d'anunci, les comissions de transacció, les comissions de processament de pagaments i els costos de publicitat afecten cada venda. Sense fer-ne un seguiment individual, no podeu conèixer els vostres marges de benefici reals. (Bench)
  • Impost sobre les vendes controlat per la plataforma: En una gran victòria per als venedors, Etsy ara calcula, recapta i reemborsa automàticament l'impost sobre les vendes en nom vostre a la majoria dels estats. Tanmateix, si veneu en altres canals o teniu presència física en determinats estats, és possible que encara tingueu les vostres pròpies obligacions fiscals a causa de les regles de "nexus". (Bench)
  • Cadència de pagament flexible: Segons la vostra configuració i l'historial del compte, Etsy pot dipositar els vostres fons diàriament, setmanalment, quinzenalment o mensualment. Aquesta flexibilitat pot fer que el flux d'efectiu sembli impredictible, especialment quan els fons es mantenen en reserva o es retarden. (Ajuda d'Etsy)
  • Llindars 1099-K més baixos: Els dies de volar per sota del radar fiscal s'han acabat. El llindar d'informació de l'IRS per al formulari 1099-K, que informa de les vostres vendes brutes, s'estableix en 5.000 dòlars per al 2024 i es preveu que baixi a només 600 dòlars el 2026. Això significa que gairebé totes les botigues rebran un formulari de l'IRS i els vostres llibres han de poder conciliar-s'hi perfectament. (IRS)

Pla de Beancount en set passos ràpids

Aquest pla de text pla us ajudarà a construir un sistema de comptabilitat clar, precís i sense estrès.

1. Separeu els canals per endavant

Si Etsy no és el vostre únic canal de vendes, creeu comptes d'ingressos i despeses separats per a cadascun. Aquesta simple separació al nivell superior del vostre pla de comptes manté les vostres anàlisis netes i facilita molt el moment dels impostos.

2025-07-22 open Income:Etsy               USD
2025-07-22 open Expenses:Etsy:ListingFee USD
2025-07-22 open Assets:Etsy:Payout USD

2. Explota cada pagament

No registreu mai un dipòsit d'Etsy com una sola línia d'ingressos. En lloc d'això, descarregueu el vostre CSV del compte de pagament mensual del vostre Gestor de botiga. Utilitzeu aquest informe per crear una sola transacció Beancount que "exploti" cada dipòsit en les seves vendes brutes i els components de comissions individuals.

; pagament setmanal del CSV del compte de pagament d'Etsy
2025-07-15 * "Dipòsit d'Etsy #2025-28"
Assets:Bank:Operating 1842.77 USD
Income:Etsy:Sales -2100.00 USD
Expenses:Etsy:TransactionFee 136.50 USD ; 6.5 %
Expenses:Etsy:PaymentProcessing 66.00 USD ; 3 % + 0.25 $ per comanda
Expenses:Etsy:ListingFee 14.00 USD ; 0.20 $ x 70 renovacions
Assets:Etsy:Reserve -75.73 USD

3. Feu un seguiment de l'inventari i el CMV amb lots

Per als venedors de béns físics, la funció "lots" de Beancount és un canvi de joc per fer un seguiment del Cost de les Mercaderies Venudes (CMV). Quan compreu matèries primeres, les registreu com a inventari a un cost específic. Quan veneu un producte acabat, podeu descomptar el cost exacte dels materials utilitzats.

; Compra de materials a granel per a l'inventari
2025-07-01 * "Compra de fil a granel | Proveïdor XYZ"
Assets:Inventory:ScarfBlue 500 ScarfBlue {@ 3.45 USD}
Assets:Bank:Operating

; Registra el CMV quan es ven un article
2025-07-20 * "Bufanda blava venuda | Comanda #1234"
Expenses:COGS 1 ScarfBlue {3.45 USD}
Assets:Inventory:ScarfBlue

4. Trieu el vostre mètode comptable aviat

Teniu dues opcions principals:

  • Base de caixa: Simple i fàcil. Registreu els ingressos quan els diners arriben al vostre banc i les despeses quan les pagueu. Això funciona bé per a botigues petites a escala d'afició.
  • Base de meritació: Proporciona una imatge més real de la rendibilitat. Registreu els ingressos quan feu la venda (no quan us paguen) i les despeses quan les incorreu. Això és millor per a les botigues que compren subministraments a granel o venen articles fets a mida. (Bench)

5. Automatitzeu les importacions

Estalvieu temps automatitzant l'entrada de dades. L'ecosistema de text pla ofereix diverses opcions:

  • Utilitzeu bean-extract amb regles personalitzades per analitzar els fitxers CSV d'Etsy.
  • Configureu un importador CSV bancari per capturar càrrecs d'anuncis o etiquetes d'enviament pagades amb targeta de crèdit.
  • Per a usuaris avançats, escriviu un script de Python per obtenir informes directament de l'API d'Etsy.

6. Concilieu setmanalment

Reserveu uns minuts cada setmana per comprovar els vostres números. Utilitzeu les eines de línia d'ordres de Beancount per validar ràpidament els vostres saldos i detectar qualsevol problema com ara reserves alliberades, reemborsaments o ajustos de comissions abans que acabi el mes.

# Comproveu el saldo del vostre compte de reserva d'Etsy
bean-balance books.bean "Assets:Etsy:Payout" "2025-07-21"

# Genereu un compte de resultats per al darrer període
bean-report books.bean income_statement -e 2025-07-21

7. Adjunteu documents font

Creeu un registre completament autònom i auditable enllaçant directament amb els documents font a les metadades de la transacció. Això és perfecte per a rebuts de proveïdors, PDF d'etiquetes d'enviament o comandes de compra.

2025-07-12 * "Etiqueta d'enviament d'Etsy per a la comanda #4321"
Expenses:ShippingLabel 4.25 USD
Assets:Bank:Operating
document: "docs/labels/2025-07-12-order4321.pdf"

Conegueu les vostres comissions d'Etsy (EUA)

Per obtenir una imatge real del vostre benefici, feu un seguiment de cada tipus de comissió al seu propi compte de despeses:

  • Comissió d'anunci: 0.20 $ per article, que es renova automàticament cada 4 mesos o després d'una venda. (Etsy)
  • Comissió de transacció: 6.5 % de l'import total de la comanda (inclòs el preu de l'article, l'enviament i l'embolcall de regal). (Etsy)
  • Comissió de processament de pagaments: Varia segons el país, però per als EUA sol ser del 3 % + 0.25 $ per comanda processada a través d'Etsy Payments. (Ajuda d'Etsy)
  • Subscripció (Etsy Plus): 10 $/mes opcional per a eines addicionals. (Bench)

Consells sobre impostos sobre les vendes i compliment

  • Tot i que Etsy reemborsa l'impost sobre les vendes per a la majoria dels estats dels EUA, tingueu en compte que vendre en altres plataformes o tenir un taller físic pot crear obligacions fiscals addicionals ("nexus"). Feu un seguiment acurat dels vostres llindars de vendes. (Bench)
  • Un cop els llindars 1099-K s'apliquin a la vostra botiga, assegureu-vos que el total d'Income:Etsy:Sales a Beancount es conciliï amb l'import brut del formulari fins al cèntim. (IRS)

Errors comuns (i solucions)

  • Error: Comptabilitat de dipòsits nets.
    • Solució: Utilitzeu sempre el CSV de pagament per dividir els dipòsits en vendes brutes, comissions i reserves.
  • Error: Costos d'inventari obsolets.
    • Solució: Registreu les vostres compres de subministraments i materials com a inventari en el moment que els compreu. No espereu fins que es vengui el producte acabat.
  • Error: Punts cecs de reemborsament.
    • Solució: Quan emeteu un reemborsament, registreu la despesa i també invertiu l'entrada original del CMV per tornar a moure el cost al vostre compte d'inventari.
  • Error: Ignorar les reserves.
    • Solució: Obriu un compte Assets:Etsy:Reserve per fer un seguiment dels diners que Etsy té en reserva. Això manté els vostres estats de flux d'efectiu honestos.

Llista de comprovació d'inici ràpid

  • Al vostre Gestor de botiga, configureu els estats mensuals i descarregueu el vostre primer CSV.
  • Cloneu el repositori d'inici de Beancount i esbosseu el pla de comptes de la vostra botiga.
  • Decidiu la comptabilitat de caixa o de meritació i comprometeu-vos-hi.
  • Escriviu un script d'importació bàsic o un fitxer de regles i programeu una sincronització setmanal.
  • Concilieu els vostres pagaments, els nivells d'inventari i el saldo bancari cada dilluns.
  • Genereu un compte de resultats cada mes i reviseu les vostres tendències de marge brut.
  • Feu una còpia de seguretat dels vostres fitxers .bean mitjançant Git i una solució d'emmagatzematge fora del lloc.

A punt per cosir la comptabilitat al vostre flux de treball creatiu? Instal·leu Beancount, comprometeu la vostra primera entrada i deixeu que la claredat del text pla us alliberi més temps al banc de treball. Feliç manteniment de beans!

Navegant pels Comptes a Cobrar a Beancount

· 4 minuts de lectura
Mike Thrift
Mike Thrift
Marketing Manager

En el laberint de la gestió de finances personals, Beancount emergeix com un far de claredat i precisió per a la tinença de llibres en text pla. Particularment quan es tracta de gestionar els comptes a cobrar —diners esperats d'altres—, Beancount ofereix un enfocament estructurat per mantenir els teus registres financers en un ordre impecable. Aquest blog et guiarà a través de les complexitats del seguiment dels comptes a cobrar, el processament de reemborsaments i la gestió de transaccions no resoltes amb Beancount. Tant si estàs retornant una compra, prestant diners o esperant un reemborsament, aquesta publicació és el teu full de ruta cap a la claredat financera.

Comprenent els Comptes a Cobrar a Beancount:

2024-02-17-navigating-receivables-beancount-guide

Els comptes a cobrar representen diners que se't deuen. Això pot provenir de diverses situacions, com ara després d'una devolució de compra esperant un reemborsament o quan prestes diners a algú. Per exemple, considera que has retornat una corretja de rellotge a una botiga en línia com Amazon.com i estàs esperant un reemborsament. A Beancount, aquesta transacció es registra com a diners que es mouen del teu passiu de targeta de crèdit als teus actius com a comptes a cobrar:

2023-10-31 * "Amazon.com" "[Return] Watch Strap"
Passius:TargetaDeCrèdit:Chase -12.00 USD
Actius:ComptesACobrar

Gestió de Reemborsaments:

Un cop processat el reemborsament i rebis els diners, es registra una altra transacció per compensar el saldo de Comptes a Cobrar. Això assegura que els teus comptes reflecteixin els diners de nou en la teva possessió:

2023-11-01 * "Amazon.com" "[Refund] Watch Strap"
Passius:TargetaDeCrèdit:Chase 12.00 USD
Actius:ComptesACobrar

Cicle Complet de la Transacció:

Una transacció completa d'entrada i sortida que involucra comptes a cobrar combina ambdues transaccions anteriors i es mostra de la següent manera, demostrant un compte equilibrat després del reemborsament:

2023-10-31 * "Amazon.com" "[Return] Watch Strap"
Passius:TargetaDeCrèdit:Chase -12.00 USD
Actius:ComptesACobrar

2023-11-01 * "Amazon.com" "[Refund] Watch Strap"
Passius:TargetaDeCrèdit:Chase 12.00 USD
Actius:ComptesACobrar

Gestió de Transaccions Sense Resoldre:

Per a les transaccions on el reemborsament o el pagament encara no s'ha rebut, Beancount utilitza l'etiqueta #UNRESOLVED. Aquesta etiqueta ajuda a identificar i fer un seguiment dels imports que encara estan pendents. Per exemple:

2023-10-31 * "John Doe" "Lending Money" #UNRESOLVED
Passius:TargetaDeCrèdit:Chase -100.00 USD
Actius:ComptesACobrar

En centrar-te en les transaccions etiquetades com a #UNRESOLVED, pots determinar ràpidament quins imports encara estan pendents de liquidar.

Manteniment d'un Saldo Zero:

En un llibre major adequat, la suma de totes les transaccions sota el compte Actius:ComptesACobrar, excloent aquelles etiquetades amb #UNRESOLVED, hauria de tornar idealment a zero. Això assegura que tots els fons esperats s'han comptabilitzat, mantenint la integritat dels teus registres financers.

Per exemple, un llibre major vàlid podria tenir aquest aspecte, amb una transacció sense resoldre clarament marcada, esperant el seu tancament:

2023-10-31 * "Amazon.com" "[Return] Watch Strap"
Passius:TargetaDeCrèdit:Chase -12.00 USD
Actius:ComptesACobrar

2023-11-01 * "Amazon.com" "[Refund] Watch Strap"
Passius:TargetaDeCrèdit:Chase 12.00 USD
Actius:ComptesACobrar

2023-10-31 * "John Doe" "Lending Money" #UNRESOLVED
Passius:TargetaDeCrèdit:Chase -100.00 USD
Actius:ComptesACobrar

Un llibre major invàlid és aquell on una transacció fa que el compte de Comptes a Cobrar no es posi a zero, necessitant l'etiqueta #UNRESOLVED per a la correcció.

Conclusió

Navegar pels comptes a cobrar a Beancount no ha de ser intimidatori. Amb una comprensió clara de com registrar transaccions, gestionar reemborsaments i mantenir un ull en les transaccions sense resoldre, pots mantenir registres financers precisos i fiables. Adoptar l'enfocament estructurat de Beancount per a la gestió de comptes a cobrar no només simplifica el teu seguiment financer, sinó que també aporta tranquil·litat, sabent que cada cèntim està comptabilitzat. Així que, per què no aprofites el poder de Beancount per fer la teva gestió financera tan fluida

Bricolatge vs. contractar un comptable: un manual de Beancount per a fundadors preocupats pels costos

· 6 minuts de lectura
Mike Thrift
Mike Thrift
Marketing Manager

Com a fundador, porteu tots els barrets: CEO, venedor, gestor de productes i, sí, comptable. Però a mesura que el vostre negoci creix, les hores dedicades a conciliar transaccions comencen a semblar menys un estalvi intel·ligent i més una distracció costosa. Aleshores, quan és el moment adequat per lliurar els llibres?

La resposta no és renunciar al control; es tracta de prendre una decisió basada en dades. A continuació us expliquem com utilitzar el vostre llibre major de Beancount per decidir si voleu continuar fent-ho vosaltres mateixos o contractar un professional.

2023-09-03-bricolatge-vs-contractar-un-comptable-un-manual-de-beancount-per-a-fundadors-preocupats-pels-costos

TL;DR: Si factureu el vostre temps a 85 /horaidediqueunomeˊsquatrehoresalmesalacomptabilitat,aquestafeinauscosta340/hora i dediqueu només quatre hores al mes a la comptabilitat, aquesta feina us costa 340 en ingressos perduts. Un comptable remot típic comença al voltant de 249 $/mes, a més que us allibera per fer créixer el negoci. (Bench)

1. Poseu un preu al vostre temps

La mètrica més important en aquesta decisió és el vostre propi cost d'oportunitat. Cada hora que dediqueu a categoritzar despeses és una hora que no esteu dedicant a vendes, desenvolupament de productes o estratègia.

El càlcul és senzill:

  1. Feu un seguiment de quantes hores dediqueu a tasques de comptabilitat cada mes (conciliació, codificació, correcció d'errors).
  2. Multipliqueu aquestes hores per la vostra tarifa facturable efectiva.
  3. Compareu aquesta xifra amb la tarifa mensual d'un comptable extern (una tarifa inicial típica és d'uns 249 $/mes).

Si el cost del vostre temps és més alt, teniu una victòria de delegació òbvia. Fins i tot podeu fer un seguiment d'això directament a Beancount.

; Feu un seguiment del cost d'oportunitat del vostre temps
2025-07-31 * "Temps de comptabilitat de juliol"
Expenses:Admin:BookkeepingTime 4.00 H ; La vostra unitat personalitzada per a hores
Equity:OwnerTime -340.00 USD
; metadata: rate:85

Aquí, H és una moneda personalitzada per a "Hores". Podeu registrar el temps directament i utilitzar un script o una directiva price per assignar-li el valor en dòlars, fent que el cost de la vostra pròpia feina sigui una part explícita dels vostres informes financers.

2. Compteu els costos ocults del bricolatge

El cost del vostre temps no és l'únic factor. La comptabilitat de bricolatge comporta riscos que poden ser molt més cars que una quota mensual.

  • Errors fiscals: Els llibres desordenats són un malson per als assessors fiscals. Un CPA pot cobrar entre 150 i 400 $/hora només per netejar els vostres registres abans que puguin començar amb la declaració d'impostos (Bench).
  • Deduccions perdudes i multes de l'IRS: Els errors petits i no intencionats, com ara classificar malament una despesa o oblidar-se de registrar una transacció en efectiu, es poden acumular amb el temps, cosa que pot comportar sancions, interessos i una factura fiscal més alta (Bench).
  • Esgotament del fundador: L'arrossegament mental de la conciliació nocturna és real. Drena el focus i l'energia que s'haurien de dedicar a activitats d'alt rendiment com les vendes i la innovació de productes (Bench).

Mitigació de Beancount: Podeu reduir els errors afegint un hook pre-commit de Git que es nega a confirmar els canvis si bean-check falla o si les transaccions no tenen una etiqueta de categoria. Això imposa disciplina, fins i tot quan esteu cansats.

3. Tres maneres en què un comptable (o la disciplina de Beancount) estalvia diners

Tant si contracteu un professional com si simplement milloreu el vostre propi procés, una bona comptabilitat es paga sola.

  1. Declaració d'impostos més neta: Uns llibres organitzats i precisos signifiquen menys hores de CPA dedicades a la neteja, cosa que es tradueix directament en una factura més baixa.
  2. Visió en temps real de l'efectiu: Conèixer la vostra posició exacta d'efectiu us ajuda a evitar comissions per descobert costoses i la necessitat de finançament d'última hora amb interessos alts.
  3. Amortidor d'estrès: Les operacions financeres estables i previsibles redueixen l'estrès del fundador, cosa que condueix a una millor presa de decisions i una cultura empresarial més saludable.

4. Quan no heu de contractar encara

Contractar un comptable no sempre és el moviment correcte. En alguns casos, el bricolatge continua sent l'opció financera més intel·ligent.

  • Esteu pre-ingressos o teniu un flux d'efectiu molt reduït. En aquesta etapa, cada dòlar s'hauria de destinar a vendes i adquisició de clients. Centreu-vos primer a obtenir ingressos (Bench).
  • Les vostres finances són senzilles. Si teniu un compte bancari, un feed de Stripe i menys de ~60 transaccions al mes, probablement podeu gestionar-ho tot a Beancount i Fava en menys d'una hora a la setmana.

5. L'opció híbrida: el vostre llibre major de Beancount "a punt per al comptable"

La millor solució sovint és híbrida. Utilitzeu Beancount per fer la feina pesada vosaltres mateixos, però manteniu els vostres llibres tan nets que un professional pugui intervenir per a tasques d'alt valor.

  • Automatitzeu la ingestió: Configureu bean-extract perquè s'executi cada nit, extraient noves transaccions automàticament.
  • Estandarditzeu el vostre pla de comptes: Utilitzeu noms de compte convencionals (Expenses:Software, Assets:Bank:Checking) perquè qualsevol professional pugui entendre el vostre llibre major a l'instant.
  • Adjunteu documents font: Per a cada despesa superior a 75 $, utilitzeu metadades link: per adjuntar un PDF del rebut o factura.
  • Seguiu una llista de verificació de tancament mensual:
    1. Concilieu tots els comptes bancaris i de targetes de crèdit.
    2. Executeu bean-check per assegurar-vos que no hi hagi errors.
    3. Exporteu els estats de compte en PDF amb bean-report balance_sheet i bean-report income_statement.
  • Realitzeu un lliurament trimestral: Doneu al vostre comptable o CPA una etiqueta Git o un simple arxiu (books-Q3-2025.tar.gz). Poden verificar la vostra feina, afegir assentaments d'ajust complexos (com ara acumulacions i amortitzacions) i preparar paquets d'impostos.

Aquest model manté els vostres costos baixos perquè el professional només toca dades netes i revisades, mentre que vosaltres encara obteniu el benefici d'estats financers de nivell professional.

6. Matriu de decisió ràpida

SituacióContractar un professionalSeguir amb Beancount (bricolatge)
>60 Tx/mes, >$20k MRR
Factureu 100 $/hora o més, però dediqueu més de 3 hores/mes als llibres
En una crisi d'efectiu, <$5k MRR
Us encanten els fulls de càlcul i l'automatització

7. Passos següents

  1. Registreu el vostre temps. Per a la vostra propera sessió de comptabilitat, feu un seguiment de cada minut que hi dediqueu.
  2. Feu els números. Multipliqueu aquest temps per la vostra tarifa facturable i compareu-lo amb les tarifes de mercat anteriors.
  3. Trieu el vostre camí. Enduriu el vostre flux de treball de Beancount utilitzant el model híbrid o comenceu a entrevistar comptables que se sentin còmodes treballant des d'un llibre major de text pla.

De qualsevol manera, la comptabilitat intencionada sempre és més barata que improvisar. Amb Beancount com a font de veritat immutable, sabreu exactament quan l'ajuda professional es paga sola i quan no.

Comptabilitat empresarial vs. personal: Traçant una línia clara amb Beancount

· 6 minuts de lectura
Mike Thrift
Mike Thrift
Marketing Manager

Una empresa pròspera i una cartera sana comparteixen un tret: límits.

Per a qualsevol propietari d'un negoci, des d'un treballador autònom fins al fundador d'una startup en creixement, una de les disciplines financeres més crítiques és la separació estricta de les finances empresarials i personals. Barrejar fons (utilitzar el compte de l'empresa per a les compres o pagar un proveïdor de l'empresa des del vostre compte corrent personal) crea una imatge financera desordenada i opaca. Això no només convida a l'escrutini de les autoritats fiscals, sinó que també us priva d'una visió clara del rendiment real de la vostra empresa.

2023-08-12-business-vs-personal-bookkeeping-with-beancount

Afortunadament, un sistema de comptabilitat de text pla com Beancount proporciona el marc perfecte per fer complir aquests límits essencials directament al vostre llibre major.

Per què la separació és important

No separar les vostres finances no és només un mal hàbit; comporta riscos significatius i emmascara informació empresarial valuosa.

  • Claredat amb l'Agència Tributària: L'Agència Tributària no només suggereix que mantingueu comptes bancaris separats; ho recomana fermament. Quan els fons empresarials i personals es barregen, es fa difícil demostrar quines despeses són deduccions empresarials legítimes. Aquesta ambigüitat pot conduir a preguntes i complicacions que és millor evitar.
  • Risc d'auditoria: Barrejar transaccions és un senyal d'alerta important per als auditors. Si els vostres llibres són un embolic de l'activitat personal i empresarial, us arrisqueu a que es rebutgin deduccions vàlides o fins i tot a enfrontar-vos a sancions. Un llibre major net i separat demostra professionalitat i fa que qualsevol auditoria potencial sigui més suau i menys estressant.
  • Informació més clara: Com podeu saber el vostre veritable marge de benefici si el flux d'efectiu de la vostra empresa està enterbolit per les despeses personals? Un llibre major empresarial independent us ofereix una visió sense filtres de la salut financera de la vostra empresa. Podeu fer un seguiment precís dels ingressos, analitzar les despeses i calcular les obligacions fiscals sense el "soroll" de la vostra vida financera personal.

Diferències clau d'un cop d'ull

El propòsit, les regles i l'estructura de la comptabilitat empresarial i personal són fonamentalment diferents. Comprendre aquests contrastos és clau per mantenir registres precisos.

ÀreaLlibres empresarialsLlibres personals
PropòsitFer un seguiment dels ingressos, despeses, actius i passius per a decisions fiscals i de creixementGestionar el pressupost familiar i els objectius d'estalvi
Normes fiscalsHa de seguir el Model 130, 200 o 210; estàndards de deduïbilitat estrictesPoques obligacions formals més enllà del registre bàsic
ComptesCapital, creditors, deutors, IVA, nòminesCompte corrent, estalvis, inversions, préstecs
Pagament del propietariSalari (nòmina) o retirada del propietari a través del capitalN/A: les retirades personals financen les despeses de vida

Un pla de quatre passos amb Beancount

Beancount facilita la construcció d'un mur ferm entre els vostres dos mons financers. Aquí teniu un flux de treball pràctic per fer-ho bé.

• 1 — Obrir comptes dedicats

Abans d'escriure la vostra primera entrada a Beancount, obriu un compte corrent empresarial dedicat i una targeta de crèdit empresarial. Aquesta separació física és la base d'una comptabilitat neta. Un cop fet això, reflectiu aquesta estructura al vostre llibre major de Beancount.

2025-07-23 open Assets:Bank:Business   USD
2025-07-23 open Assets:Bank:Personal USD

Aquesta configuració senzilla garanteix que cada transacció es pugui assignar clarament a les vostres finances empresarials o personals des del moment en què es produeix.

• 2 — Registrar les aportacions i retirades del propietari

Com a propietari, moureu diners entre els vostres fons personals i l'empresa. Aquestes no són ingressos ni despeses. En canvi, es fan un seguiment a través d'un compte de capital.

  • Aportació: Quan poseu els vostres propis diners a l'empresa per iniciar-la o cobrir un dèficit.
  • Retirada: Quan traieu diners de l'empresa per a ús personal (així és com molts propietaris únics es "paguen" a si mateixos).
; Injecció de capital per iniciar l'empresa
2025-07-23 * "Aportació del propietari"
Assets:Bank:Business 10,000.00 USD
Equity:Owner:Contrib

; Retirar diners per a despeses personals
2025-08-05 * "Retirada del propietari per al lloguer"
Equity:Owner:Draw 2,500.00 USD
Assets:Bank:Business

En registrar-les com a transaccions de capital, us assegureu que no inflin incorrectament les vostres despeses empresarials ni redueixin el vostre benefici declarat.

• 3 — Gestionar els rebuts barrejats ràpidament

Els errors passen. Podeu utilitzar accidentalment la vostra targeta empresarial per pagar un sopar personal. La clau és corregir-ho immediatament al vostre llibre major. No suprimiu la transacció; reclassifiqueu-la com a retirada del propietari.

2025-08-07 * "Compres personals amb la targeta empresarial"
Equity:Owner:Draw 72.35 USD
Assets:Bank:Business

Aquesta entrada reflecteix correctament que els fons empresarials es van utilitzar per a una despesa personal, tractant-la com a diners que heu tret de l'empresa. Això us impedeix reclamar accidentalment una despesa personal no deduïble als vostres impostos.

• 4 — Conciliar i revisar segons un calendari

La coherència és la vostra millor defensa contra els llibres desordenats. Reserveu temps setmanalment o mensualment per conciliar els vostres comptes empresarials. Utilitzeu les eines de Beancount per assegurar-vos que el vostre llibre major coincideixi amb els vostres extractes bancaris i per revisar el rendiment de la vostra empresa.

# Comproveu el saldo bancari de la vostra empresa amb el vostre extracte
bean-balance books.bean "Assets:Bank:Business"

# Genereu un compte de resultats per revisar la rendibilitat
bean-report books.bean income_statement -e 2025-08-31

Aquest hàbit de revisió regular satisfà els requisits de registre de l'Agència Tributària i us manté informats sobre la salut financera de la vostra empresa.

Consideracions fiscals

  • Pagaments fraccionats: Per evitar una factura fiscal dolorosa, tracteu els vostres futurs impostos com una despesa empresarial contínua. Creeu comptes de passiu (Liabilities:Tax:Estatal, Liabilities:Tax:IRPF) i moveu regularment un percentatge fix de cada dipòsit a aquests comptes. Quan els pagaments trimestrals siguin deguts, els diners ja estaran esperant.
  • Costos personals no deduïbles: Recordeu la regla de l'Agència Tributària: les despeses empresarials han de ser "ordinàries i necessàries" per a la vostra feina. Els vostres àpats personals, els costos de desplaçament i les subscripcions no empresarials no qualifiquen i s'han de mantenir completament fora del compte de resultats de la vostra empresa.

Llista de comprovació d'inici ràpid

  • Obriu comptes bancaris i de crèdit només per a l'empresa.
  • Creeu un pla de comptes de Beancount amb Assets:Bank:Business, Equity:Owner:Contrib i Equity:Owner:Draw.
  • Decidiu la vostra base comptable (efectiu o meritació) i anoteu-la a les vostres options de Beancount.
  • Etiqueteu immediatament qualsevol càrrec personal accidental a les targetes empresarials com a Equity:Owner:Draw.
  • Conciliació setmanal; feu una còpia de seguretat del vostre fitxer .bean a un repositori Git privat remot.
  • Reviseu el vostre compte de resultats, balanç i informes de flux d'efectiu cada mes.

Conclusió: Diners separats, llibres majors separats. Beancount fa que el mur entre les vostres finances empresarials i personals sigui explícit (i controlat per versions) perquè la vostra empresa estigui sempre preparada per a una auditoria mentre que el vostre hàbit del cafè amb llet no sigui cosa de ningú més que vostra. Feliç registre de Beancount!

Modelització de Transaccions Immobiliàries a Beancount

· 4 minuts de lectura
Mike Thrift
Mike Thrift
Marketing Manager

Les transaccions immobiliàries poden constituir l'activitat financera més gran en la vida d'una família. Aquest article explica com modelar els béns immobles a Beancount. Tracto els béns immobles com un actiu i l'apreciació de la casa com un guany no realitzat. A més, la hipoteca es modela com un passiu i els interessos es consideren una despesa.

Suposem que el Sr. A va comprar una casa de luxe situada a 123 ABC Street, XYZ City, CA, 12345 l'1 de gener de 2020, per un preu d'1 milió. El tipus d'interès és del 3,0%, l'entrada és del 20% i l'import del préstec és de 800.000.

ConcepteImport
Import de la Hipoteca800,000
Tipus d'Interès3%
Període de la Hipoteca30 years
Cost Total de la Hipoteca1,478,219.62
Pagaments Mensuals4,106.17
Assegurança de la Llar1,300 per year (39,000 total)
Impost sobre la Propietat7,500 per year (225,000 total)
Amortització del Préstec2049 Dec
Total d'Interessos Pagats414,219.62

2023-06-09-tracking-real-estate

Captura de pantalla del detall de la hipoteca

Crear Comptes

En primer lloc, tractem la casa com un Actiu. Atès que la casa es llista com un Actiu, se li ha de donar una unitat. En aquest cas, la quantitat de la unitat és només una, és poc probable que n'hi hagi diverses, i fins i tot si és la n-èsima casa, voldríem registrar-la en un Actiu separat. És a dir, una casa correspon a un Actiu, i aquest Actiu té una unitat especial, el seu valor només pot ser 1.

2019-12-31 commodity HOUSE.ABC
name: "123 ABC Street, XYZ City, CA, 12345"

2019-12-31 open Assets:Property:US:CA:123ABC HOUSE.ABC
2019-12-31 open Liabilities:Bank:US:SomeBank:Mortgage:Loan USD

A la primera línia, hem definit una unitat de mercaderia que representa la casa. A la quarta línia, hem definit un compte d'Actiu, que conté la unitat de mercaderia prèviament definida com la casa. A la cinquena línia, hem definit un compte per al banc prestador. Com que és un passiu, s'inclou a la categoria de Passius.

Compra

Amb els comptes configurats com s'ha indicat anteriorment, l'acte de comprar una casa equival a

demanar diners prestats (deute) + gastar diners (entrada) = 1 casa en actiu

La referència més important en comprar una propietat és probablement la Declaració de Liquidació del Comprador, que descriu clarament el flux de diners.

2020-01-01 * "Buying the house"
Assets:Property:US:CA:123ABC 1 HOUSE.ABC {1,000,000 USD}
Assets:Bank:US:SomeBankA -100,000 USD
Assets:Bank:US:SomeBankB -101,000 USD
Liabilities:Bank:US:SomeBank:Mortgage:Loan -800,000.00 USD
Expenses:Home:Insurance 1,000 USD
Expenses:Home:Mortgage:Loan:ClosingCost

Aquí, estem detallant la transacció de compra de la casa, on els diners surten d'alguns bancs (utilitzats per a l'entrada i altres despeses), es contracta un préstec (afegint a passius) i s'adquireix una casa (afegida a actius).

Amortitzar hipoteques

Basant-nos en el registre de compra anterior, actualment devem 800.000 USD. A causa dels interessos, i considerant que tots els préstecs als EUA s'amortitzen per igual en termes de principal i interessos, el pagament mensual inclou una part per interessos i una part per principal. En les primeres etapes, els interessos constitueixen la majoria.

Per registrar l'amortització del préstec, tot el que heu de fer és consultar l'extracte del vostre banc de préstecs. Només heu de saber quant de principal esteu amortitzant cada mes, i la resta són interessos. Els interessos es comptabilitzen com una Despesa.

2020-02-01 * "Mortgage payment"
Assets:Bank:US:SomeBank:Saving:Joint -3,372.83 USD
Liabilities:Bank:US:SomeBank:Mortgage:Loan 1,376.26 USD
Expenses:Home:Mortgage:Loan:Interest

Aquesta entrada detalla el pagament mensual de la hipoteca que es resta del vostre compte d'estalvi conjunt. L'amortització del principal redueix el passiu, mentre que la part dels interessos es tracta com una despesa.

Apreciació

Si voleu registrar l'apreciació de la propietat, algunes persones creen un compte separat

Comprendre els Comptes a Cobrar i a Pagar a Beancount

· 3 minuts de lectura
Mike Thrift
Mike Thrift
Marketing Manager

Hola a tothom! En la publicació del blog d'avui, ens submergim en el món de Beancount, una eina de comptabilitat de partida doble estimada per molts per la seva simplicitat i potència. Més concretament, parlarem de dos conceptes clau: els Comptes a Cobrar i els Comptes a Pagar.

Comprendre aquests termes és crucial per utilitzar Beancount (o qualsevol sistema de comptabilitat de partida doble) de manera efectiva. Però no us preocupeu si sou principiants, ho desglossarem tot, pas a pas!

Comptes a Cobrar i a Pagar: Els Conceptes Bàsics

2023-05-30-receiveable-and-payable

En comptabilitat, "comptes a cobrar" i "comptes a pagar" són termes utilitzats per fer un seguiment dels diners deguts. Els "comptes a cobrar" es refereixen als diners que altres us deuen, mentre que els "comptes a pagar" es refereixen als diners que vosaltres deveu a altres.

Vegem un exemple:

  1. Comptes a Cobrar (C/C): Suposem que sou propietaris d'una llibreria i un client compra un llibre a crèdit. Els diners que us deuen pel llibre són un compte a cobrar.

  2. Comptes a Pagar (C/P): D'altra banda, imagineu que demaneu un nou lot de llibres a un editor, però no els pagueu per avançat. Els diners que deveu a l'editor són un compte a pagar.

A Beancount, aquests es registren normalment mitjançant comptes corresponents. El principal benefici aquí és que us proporciona una imatge clara i precisa de la vostra posició financera en qualsevol moment.

Configuració de Comptes a Cobrar i a Pagar a Beancount

L'estructura del vostre fitxer Beancount pot ser tan senzilla o complexa com necessiteu. Per als comptes a cobrar i a pagar, probablement voldreu crear comptes separats sota les seccions d'Actius i Passius.

Aquí teniu un exemple senzill:

1970-01-01 open Assets:AccountsReceivable
1970-01-01 open Liabilities:AccountsPayable

Seguiment de Transaccions

Costat del Cobrador

Després de configurar els vostres comptes, podeu fer un seguiment de les transaccions que involucren comptes a cobrar i a pagar. Vegem un exemple:

2023-05-29 * "Sold books to customer on credit"
Assets:AccountsReceivable 100 USD
Income:BookSales -100 USD

Aquí, esteu afegint 100 $ als vostres comptes a cobrar perquè un client us deu aquesta quantitat. Simultàniament, esteu reduint els vostres ingressos per la mateixa quantitat per mantenir l'equilibri (ja que encara no heu rebut els diners).

Quan el client finalment pagui, ho registrareu així:

2023-06-01 * "Received payment from customer"
Assets:Bank:Savings 100 USD
Assets:AccountsReceivable -100 USD

Costat del Pagador

El mateix principi s'aplica als comptes a pagar, però amb signes invertits:

2023-05-30 * "Bought books from publisher on credit"
Liabilities:AccountsPayable 200 USD
Expenses:BookPurchases -200 USD

I quan pagueu el vostre deute:

2023-06-02 * "Paid off debt to publisher"
Liabilities:AccountsPayable -200 USD
Assets:Bank:Checking 200 USD

Conclusió

Els comptes a cobrar i a pagar són el cor de qualsevol sistema comptable. En fer-ne un seguiment precís, obteniu una comprensió completa de la vostra salut financera.

Això és només un punt de partida, i Beancount és capaç de molt més. Espero que aquesta publicació del blog ajudi a aclarir aquests conceptes importants. Com sempre, feliç comptabilitat!