Awesome Beancount

Una guia curada de l'ecosistema Beancount. Beancount és un potent sistema de comptabilitat de codi obert que utilitza un format senzill basat en text per gestionar les teves finances amb el rigor de la comptabilitat per partida doble. Aquesta pàgina combina llistes seleccionades per la comunitat i visions generals de l'ecosistema en un recurs complet.

Per què comptabilitat en text pla?​

La comptabilitat en text pla (PTA, de l'anglès Plain Text Accounting) és una metodologia per gestionar les finances utilitzant fitxers de text simples i potents eines de línia de comandes. Aquest enfocament et dona la propietat total de les teves dades, en garanteix la longevitat i ofereix una flexibilitat inigualable per a l'automatització i l'anàlisi.

• Centre Oficial de PTA: Plain Text Accounting
• Una introducció suau: Accounting for the simple minds with plain text accounting
• D'aplicacions web a la línia de comandes: Command line accounting: From mint.com to Ledger

L'ecosistema Beancount​

L'ecosistema Beancount és una col·lecció d'eines, connectors (plugins) i recursos construïts al voltant d'un motor central. Cada component té un paper específic en la creació d'un flux de treball de gestió financera complet.

1. Motor principal i recursos oficials​

Aquests són els elements fundacionals de Beancount, mantinguts pel creador i els col·laboradors oficials.

2. Interfícies d'usuari​

Aquestes eines proporcionen interfícies visuals per explorar i editar les teves dades financeres.

3. Importació de transaccions​

La importació és el procés de convertir dades d'institucions financeres (com fitxers CSV o PDF bancaris) en assentaments de Beancount.

Importadors de la comunitat (per país)​

Una gran col·lecció de scripts per a bancs i serveis específics, mantinguts per la comunitat.

• Xina
  • Alipay / 支付宝: deb-sig/double-entry-generator, wzyboy/importer
  • China Merchants Bank (CMB): Targeta de dèbit, Targeta de crèdit
  • WeChat Pay / 微信支付: deb-sig/double-entry-generator
• França
  • Caisse d'Epargne: beancount-ce
  • Boursorama, Amex: Beancount-myTools
• Alemanya
  • Commerzbank: beancount-commerzbank
  • Deutsche Kredit Bank (DKB): beancount-dkb
  • ING: beancount-ing
  • N26: beancount-n26
  • Volksbank & GLS-Bank: beancount-importer-volksbank
• Índia
  • SBI, BOI, Paytm, HSBC, ICICI: beancount-importers-india
• Països Baixos
  • ABN AMRO: beancount-abnamro
• Suïssa
  • General: tariochbctools (BCGE, Neon, Raiffeisen, ZKB, Fidelity)
  • Finpension: drnuke-bean
  • PostFinance: tariochbctools, drnuke-bean
• Regne Unit
  • Monzo, Revolut, Wise: Evernight/beancount-importers
  • Revolut, Wise: tariochbctools
• EUA
  • Amex, Chase, Citi, Schwab: mterwill/gist
  • Capital One: mtlynch/beancount-capitalone
  • Chase: mtlynch/beancount-chase-bank, ArthurFDLR/beancount-chase
  • Clipper: beancount-clipper
  • Mercury: mtlynch/beancount-mercury
• Blockchain
  • tariochbctools

4. Suport per a editors i eines​

Eines que integren Beancount al vostre entorn de desenvolupament per agilitzar l'edició i el manteniment.

• Suport per a IDE: Connectors que proporcionen ressaltat de sintaxi, autocompletat i verificació de saldos en temps real.
  • VSCode
  • Emacs
  • Vim
  • Zed
  • Sublime Text
  • Atom
  • Beancount Language Server (per a qualsevol editor compatible amb LSP)
• Automatització i utilitats:
  • bean-add: Afegeix transaccions de forma interactiva des de la línia d'ordres.
  • beancount-black: Un formatador de codi d'opinió fixa per a fitxers Beancount.
  • beancount-categorizer: Categoritza automàticament les transaccions amb regles regex.
  • beanahead: Administra i projecta transaccions futures.
• Eines de migració de dades: Utilitats per convertir dades d'altres sistemes de comptabilitat.
  • Des de GnuCash: henriquebastos/gc-to-bc, dtrai2/gc-to-bc
  • Des de Ledger/hledger: travisdahlke/gist, zacchiro/ledger2beancount
  • Des de YNAB: hoostus/beancount-ynab

5. Connectors (Extensions del llibre major)​

Mòduls Python integrats que s'executen durant el processament per aplicar regles personalitzades, automatitzar transaccions o afegir noves funcions.

• Pressupostos:
  • fava-envelope: Una extensió de Fava per a pressupostos basats en sobres.
• Automatització i comprovacions:
  • autobean.share: Divisió de despeses i gestió de deutes.
  • autobean.sorted: Garanteix que les transaccions estiguin ordenades cronològicament.
  • beancount-checkclosed: Comprova automàticament si hi ha un saldo zero en els comptes tancats.
• Manipulació de dades:
  • autobean.narration: Genera automàticament les narracions de les transaccions.
  • beancount-lazy-plugins.filter_map: Aplica operacions a un grup filtrat de transaccions.

6. Fonts de preus​

Scripts que obtenen preus històrics i actuals de matèries primeres, accions i divises per fer el seguiment dels valors d'inversió.

• beancount-exchangerates: Per a monedes fiduciàries mitjançant APIs com frankfurter.dev.
• pricehist: Un extractor de preus multifont.
• beancount-cryptoassets: Per obtenir preus de criptomonedes.
• tariochbctools: Inclou una font de preus per a Interactive Brokers.

Aprenentatge i comunitat​

Llibres i guies detallades​

• Tracking Personal Finances using Python: Un llibre que ofereix una guia completa per construir un sistema de finances personals amb Beancount. (Lloc web)
• Sèrie de blogs en xinès (BYVoid): Part 1: Per què?, Part 2: Dèbits i crèdits

Articles de blog seleccionats​

• Anglès
  • Counting beans - and more - with Beancount
  • Managing Personal Finances using Python
  • No-Bullshit Beancount Introduction
• Francès
  • Beancount ou la comptabilité pour les hackers
• Xinès
  • Beancount —— 命令行复式簿记

Comunitat​

• Llista de correu: Google Groups (Fòrum de discussió principal)
• Xat en viu (IRC): #beancount a web.libera.chat
• Telegram (xinès): t.me/beancount_zh

Serveis comercials i aplicacions​

Per a usuaris que volen la potència de Beancount sense gestionar la infraestructura ells mateixos.