Connectors natius essencials de Beancount que hauríeu de conèixer

Actualitzat el 15 de setembre de 2026.

El poder de Beancount no rau només en el seu format de text pla, sinó en la seva extensibilitat mitjançant connectors. Els connectors natius són mòduls integrats que milloren la funcionalitat de Beancount, automatitzen tasques tedioses i apliquen bones pràctiques comptables. En aquesta guia completa, explorarem tots els connectors natius disponibles a Beancount i com utilitzar-los de manera efectiva.

Per a la sintaxi de directives sobre les quals operen aquests connectors, vegeu la referència de sintaxi de Beancount. Per a fluxos de treball reals de la comunitat que combinen connectors amb importadors i Fava, vegeu la mostra de la comunitat. Les opcions de llibre major que interactuen amb els connectors es troben a la configuració d'opcions.

Què són els connectors de Beancount?​

Els connectors de Beancount són mòduls de Python que processen les entrades del vostre llibre major per afegir automatització, validació o capacitats de transformació. S'executen durant la fase de càrrega del vostre fitxer de llibre major i poden:

• Automatitzar tasques repetitives (per exemple, crear declaracions de comptes)
• Validar la integritat de les dades (per exemple, comprovar si hi ha transaccions duplicades)
• Transformar entrades (per exemple, generar entrades de preu a partir de transaccions)
• Aplicar regles comptables (per exemple, una sola mercaderia per compte)

Com utilitzar els connectors​

Per habilitar un connector al vostre fitxer de Beancount, afegiu una directiva plugin a la part superior del vostre llibre major:

plugin "beancount.plugins.auto_accounts"
plugin "beancount.plugins.implicit_prices"

Alguns connectors accepten opcions de configuració:

; @m49-fragment dateless
plugin "beancount.plugins.check_commodity" "{'Assets:Trading': '.*'}"

Categories de connectors natius​

Els connectors natius de Beancount es classifiquen en quatre categories principals:

1. Connectors d'automatització​

2. Connectors de validació​

3. Connectors de transformació​

4. Meta-connectors​

1. Connectors d'automatització​

Aquests connectors automatitzen tasques comptables repetitives, estalviant-vos temps i reduint errors manuals.

auto_accounts - Declaracions automàtiques de comptes​

Què fa: Insereix automàticament directives Open per als comptes que apareixen en transaccions però que no han estat declarats explícitament.

Per què utilitzar-lo: Elimina la necessitat de declarar manualment cada compte abans d'utilitzar-lo. Perfecte per començar ràpidament o per a usuaris que prefereixen un mínim de text predefinit.

Exemple:

plugin "beancount.plugins.auto_accounts"
 
2026-01-01 * "Cafeteria"
  Expenses:Food:Coffee        4.50 USD
  Assets:Cash                -4.50 USD

Sense el connector, hauríeu d'afegir manualment:

2025-12-01 Expenses:Food:Coffee
2025-12-01 Assets:Cash

Quan utilitzar-lo: Ideal per a principiants o per a aquells que volen un llibre major menys verbós. No obstant això, les declaracions explícites de comptes poden ajudar a detectar errors de tecleig.

close_tree - Tancament automàtic de jerarquia de comptes​

Què fa: Quan tanqueu un compte pare, aquest connector tanca automàticament tots els seus comptes descendents.

Per què utilitzar-lo: Manté la consistència en la vostra jerarquia de comptes. Si tanqueu Actius:Inversions, tots els subcomptes com Actius:Inversions:Accions i Actius:Inversions:Obligacions es tancaran automàticament.

Exemple:

plugin "beancount.plugins.close_tree"
 
2025-06-30 Assets:Investments
 
; Aquests es tancaran automàticament:
; Actius:Inversions:Accions
; Actius:Inversions:Obligacions
; Actius:Inversions:Immobiliari

Quan utilitzar-lo: Quan reestructureu la vostra jerarquia de comptes o tanqueu categories senceres de comptes.

implicit_prices - Generació automàtica d'entrades de preu​

Què fa: Sintetitza directives Price a partir de partides de transacció que inclouen costos (@) o preus (@@).

Per què utilitzar-lo: Omple automàticament la vostra base de dades de preus a partir de les vostres transaccions, permetent un informe de valor de mercat precís sense entrades de preu manuals.

Exemple:

plugin "beancount.plugins.implicit_prices"
 
2026-01-02 * "Compra d'accions d'AAPL"
  Assets:Investments:Stocks    10 AAPL @ 150.00 USD
  Assets:Cash                 -1500.00 USD

Això genera automàticament:

2026-01-02 preu AAPL  150.00 USD

Quan utilitzar-lo: Essencial per al seguiment d'inversions i la comptabilitat amb múltiples monedes on voleu un historial de preus automàtic.

2. Connectors de validació​

Aquests connectors apliquen integritat de dades i bones pràctiques comptables, detectant errors abans que esdevinguin problemes.

noduplicates - Detecció de transaccions duplicades​

Què fa: Comprova que no hi hagi dues transaccions idèntiques calculant i comparant resums de dades de les transaccions.

Per què utilitzar-lo: Prevé entrades duplicades accidentals, especialment quan importeu transaccions de múltiples fonts.

Exemple:

; @m49-fragment expected-failure
plugin "beancount.plugins.noduplicates"
 
2026-01-02 * "Pagament del lloguer"
  Expenses:Rent              1200.00 USD
  Assets:Checking           -1200.00 USD
 
; Això provocaria un error:
2026-01-02 * "Pagament del lloguer"
  Expenses:Rent              1200.00 USD
  Assets:Checking           -1200.00 USD

Quan utilitzar-lo: Sempre recomanat, especialment si importeu de declaracions bancàries o utilitzeu múltiples fonts de dades.

check_commodity - Validació de declaracions de mercaderia​

Què fa: Garanteix que totes les mercaderies utilitzades al vostre llibre major tinguin directives Commodity corresponents.

Per què utilitzar-lo: Aplica declaracions explícites de mercaderies, ajudant-vos a mantenir una llista neta d'actius i monedes.

Exemple:

; @m49-fragment expected-failure
plugin "beancount.plugins.check_commodity"
 
2015-01-01 mercaderia USD
2020-01-01 mercaderia AAPL
 
; Això provocaria un error sense una declaració de mercaderia:
2026-01-02 * "Compra de Bitcoin"
  Assets:Crypto              0.5 BTC @ 45000 USD
  Assets:Cash             -22500.00 USD

Quan utilitzar-lo: Recomanat per mantenir un seguiment estricte de mercaderies i prevenir errors de tecleig en símbols de cotització.

check_average_cost - Validació del cost mitjà​

Què fa: Verifica que el cost mitjà es preservi correctament en les transaccions, especialment quan s'utilitza el mètode de comptabilització del cost mitjà.

Per què utilitzar-lo: Assegura que la vostra comptabilitat de costos es mantingui precisa per a informes fiscals i càlculs de guanys de capital.

Quan utilitzar-lo: Crític per a carteres d'inversió i qualsevol escenari on el seguiment precís del cost sigui important.

check_closing - Validació de tancament de saldo​

Què fa: Expandeix les metadades closing en comprovacions de saldo, assegurant que les posicions siguin zero després de tancar operacions.

Per què utilitzar-lo: Confirma que quan veneu una posició sencera, el saldo sigui realment zero (sense accions fraccionàries restants).

Exemple:

plugin "beancount.plugins.check_closing"
 
2026-01-02 * "Tanca tota la posició d'AAPL" #closing
  Assets:Investments:Stocks   -100 AAPL {150.00 USD}
  Assets:Cash                15500.00 USD
  Income:Investments:Gains    -500.00 USD

L'etiqueta #closing indica al connector que verifiqui que la vostra posició d'AAPL sigui zero després d'aquesta transacció.

Quan utilitzar-lo: Quan veneu posicions senceres per assegurar-vos que no quedi res.

coherent_cost - Comprovació de coherència de moneda/cost​

Què fa: Valida que les monedes no s'utilitzin de manera incoherent — tant amb com sense anotacions de cost.

Per què utilitzar-lo: Prevé barrejar monedes simples (com 100 USD) amb monedes amb cost (com 100 USD {1.2 CAD}), que pot causar errors comptables.

Quan utilitzar-lo: Recomanat per a llibres majors amb múltiples monedes per mantenir la consistència.

leafonly - Aplicació de comptes fulla​

Què fa: Garanteix que només els comptes fulla (comptes sense fills) rebin partides.

Per què utilitzar-lo: Aplica una jerarquia de comptes neta on els comptes resum com Despeses:Alimentació no tinguin partides directes, només els seus fills com Despeses:Alimentació:Queviures i Despeses:Alimentació:Restaurants.

Exemple:

; @m49-fragment expected-failure
plugin "beancount.plugins.leafonly"
 
; Això provocaria un error:
2026-01-02 * "Compra de queviures"
  Expenses:Food              50.00 USD  ; Error: S'ha de registrar a un compte fulla
  Assets:Cash                   -50.00 USD
 
; Manera correcta:
2026-01-02 * "Compra de queviures"
  Expenses:Food:Groceries    50.00 USD  ; Correcte: Registre a compte fulla
  Assets:Cash                   -50.00 USD

Quan utilitzar-lo: Quan voleu mantenir una comptabilitat jeràrquica estricta amb una categorització clara.

nounused - Detecció de comptes no utilitzats​

Què fa: Identifica comptes que es van obrir però que mai s'han utilitzat en cap transacció.

Per què utilitzar-lo: Us ajuda a netejar les vostres declaracions de comptes i identificar possibles errors de tecleig o comptes abandonats.

Quan utilitzar-lo: Periòdicament, per auditar i netejar la vostra estructura de comptes.

onecommodity - Una sola mercaderia per compte​

Què fa: Aplica que cada compte només contingui un tipus de mercaderia.

Per què utilitzar-lo: Prevé barrejar diferents actius al mateix compte, que generalment és una bona pràctica comptable.

Exemple:

; @m49-fragment expected-failure
plugin "beancount.plugins.onecommodity"
 
2026-01-02 * "Compra d'accions"
  Assets:Investments         10 AAPL @ 150 USD
  Assets:Cash           -1500.00 USD
 
; Això provocaria un error:
2026-01-03 * "Compra de més accions"
  Assets:Investments         5 GOOGL @ 140 USD  ; Error: Mercaderia diferent
  Assets:Cash            -700.00 USD

Quan utilitzar-lo: Quan preferiu una separació estricta de comptes (un compte per acció/actiu).

sellgains - Validació de guanys de capital​

Què fa: Comprova els guanys de capital declarats contra els guanys calculats a partir de la venda de lots, assegurant que els vostres càlculs de guanys o pèrdues siguin precisos.

Per què utilitzar-lo: Detecta errors en els càlculs manuals de guanys de capital, crucial per a informes fiscals precisos.

Exemple:

plugin "beancount.plugins.sellgains"
 
2026-01-02 * "Venda d'accions d'AAPL"
  Assets:Investments:Stocks   -10 AAPL {140.00 USD}
  Assets:Cash                1500.00 USD
  Income:Investments:Gains   -100.00 USD  ; El connector valida que això és correcte

El connector verificarà: Ingressos de la venda (1500) - Cost mitjà (1400) = Guanys (100)

Quan utilitzar-lo: Essencial per a qualsevol persona que operi amb accions, cripto o altres actius on els guanys de capital siguin importants.

unique_prices - Comprovació d'unicitat de preus​

Què fa: Assegura que només hi hagi una entrada de preu per mercaderia i data.

Per què utilitzar-lo: Prevé dades de preu conflictives que podrien portar a valoracions incorrectes.

Quan utilitzar-lo: Recomanat quan introduïu preus manualment o importeu de múltiples fonts de preus.

check_drained - Validació de comptes buidats​

Què fa: Marca comptes que encara mantenen un saldo (incloent monedes sense preu o lots restants) quan s'esperava que estiguessin buits després de transferències o tancaments.

Per què utilitzar-lo: Detecta saldos residuals que les assertions de balance i les etiquetes #closing poden passar per alt — especialment útil després de moviments amb múltiples mercaderies.

Estat (comprovat el 15 de setembre de 2026): Present a l'arbre de Beancount 3.x a beancount/plugins/check_drained.py a la línia actual de PyPI (3.2.3).

Quan utilitzar-lo: Després de grans reorganitzacions de cartera o quan tanqueu comptes de corredor.

3. Connectors de transformació​

Aquests connectors modifiquen o milloren les dades del vostre llibre major de maneres útils.

currency_accounts - Comptes de comerç de moneda​

Què fa: Implementa comptes de comerç de moneda per fer un seguiment explícit de conversions de divises.

Per què utilitzar-lo: Proporciona un seguiment detallat de les transaccions de conversió de moneda, útil per a normes comptables que ho requereixin.

Quan utilitzar-lo: Quan necessiteu fer un seguiment dels guanys/pèrdues de canvi de manera separada o complir requisits comptables específics.

commodity_attr - Validació d'atributs de mercaderia​

Què fa: Valida que les directives de mercaderia tinguin els atributs requerits (com export, name, etc.).

Per què utilitzar-lo: Assegura que les vostres metadades de mercaderies siguin completes i consistents.

Quan utilitzar-lo: Quan mantingueu metadades de mercaderies detallades per a informes o exportacions.

4. Meta-connectors​

Aquests connectors són col·leccions d'altres connectors per a més comoditat.

auto - Tots els connectors automàtics​

Què fa: Habilita una col·lecció de connectors "permissius" o automàtics en una sola directiva.

Quan utilitzar-lo: Configuració ràpida per a usuaris que volen màxima automatització amb configuració mínima.

pedantic - Tots els connectors de validació​

Què fa: Habilita tots els connectors de validació estrictes alhora.

Per què utilitzar-lo: Aplica la màxima integritat de dades i rigor comptable. Excel·lent per a llibres majors de producció o quan la precisió és primordial.

Exemple:

plugin "beancount.plugins.pedantic"
 
; Això és equivalent a habilitar:
; - check_commodity
; - check_average_cost
; - coherent_cost
; - leafonly
; - noduplicates
; - nounused
; - onecommodity
; - sellgains
; - unique_prices

Quan utilitzar-lo: Per a llibres majors de producció on voleu una validació màxima i esteu disposats a mantenir pràctiques comptables més estrictes.

Configuracions de connectors recomanades​

Per a principiants​

plugin "beancount.plugins.auto_accounts"
plugin "beancount.plugins.noduplicates"
plugin "beancount.plugins.implicit_prices"

Aquest conjunt mínim proporciona automatització mentre prevé errors comuns.

Per a inversors​

plugin "beancount.plugins.auto_accounts"
plugin "beancount.plugins.implicit_prices"
plugin "beancount.plugins.sellgains"
plugin "beancount.plugins.check_average_cost"
plugin "beancount.plugins.unique_prices"

Se centra en el seguiment d'inversions i la precisió dels guanys de capital.

Per a comptabilitat estricta​

plugin "beancount.plugins.pedantic"
plugin "beancount.plugins.sellgains"
plugin "beancount.plugins.check_closing"

Validació màxima per a entorns de producció.

Configuració predeterminada a Beancount.io​

A Beancount.io, incloem el connector auto_accounts per defecte en tots els fitxers de llibre major nous:

plugin "beancount.plugins.auto_accounts"

Això proporciona un bon equilibri entre facilitat d'ús i funcionalitat per començar ràpidament.

Estat dels connectors comprovat el 15 de setembre de 2026​

Contra l'arbre beancount/plugins actual de Beancount 3.2.3 (PyPI, 15 de setembre de 2026):

Res d'aquest conjunt natiu no s'ha eliminat entre l'esborrany original d'aquesta guia i la data anterior. Els connectors de la comunitat (no natius) encara pertanyen a la llista de connectors d'Awesome Beancount i a la mostra de la comunitat — tracteu els repositoris de tercers com a versions independents, i comproveu la darrera versió de cada repositori abans d'habilitar-los en un llibre major de producció.

Bones pràctiques​

1. Comenceu amb un mínim, afegiu segons calgui: Comenceu amb auto_accounts i noduplicates, després afegiu connectors de validació a mesura que el vostre llibre major maduri.

2. Proveu els connectors individualment: Quan afegiu múltiples connectors, habiliteu-los un a un per entendre els seus efectes.

3. Llegiu els missatges d'error amb atenció: Els errors dels connectors sovint apunten a problemes comptables reals que cal solucionar.

4. Utilitzeu pedantic per a producció: Un cop establert el vostre flux de treball, considereu habilitar la validació estricta.

5. Combineu amb connectors personalitzats: Els connectors natius funcionen juntament amb connectors personalitzats com el connector de previsió per a una funcionalitat màxima.

Més enllà dels connectors natius​

Mentre que els connectors natius proporcionen funcionalitat bàsica, l'ecosistema de Beancount inclou molts connectors desenvolupats per la comunitat per a necessitats especialitzades:

• fava.plugins.forecast - Per a la previsió de transaccions recurrents
• fava.plugins.link_documents - Per enllaçar transaccions a fitxers de rebuts
• Importadors personalitzats per a formats CSV específics de bancs
• Calculadores i informes específics per a impostos

Exploreu l'ecosistema de Beancount per a més opcions, i la mostra de la comunitat per veure com la gent combina connectors natius amb importadors i Fava.

Conclusió​

Els connectors natius de Beancount transformen la comptabilitat en text pla d'un procés manual a un sistema de gestió financera automatitzat, validat i robust. En entendre i aprofitar aquestes eines integrades, podeu:

• ✅ Automatitzar tasques comptables tedioses
• ✅ Detectar errors abans que esdevinguin problemes
• ✅ Mantenir una integritat de dades estricta
• ✅ Generar informes financers precisos
• ✅ Centrar-vos en els coneixements financers en lloc de l'entrada de dades

Comenceu a experimentar amb aquests connectors al vostre llibre major avui mateix. Comenceu amb auto_accounts i implicit_prices, després afegiu gradualment connectors de validació a mesura que les vostres pràctiques comptables madurin.

Preparat per provar aquests connectors? Aneu a Beancount.io i comenceu a utilitzar-los al vostre fitxer de llibre major avui!

Fonts​

• Referència de l'API de connectors de Beancount
• Guia de scripts i connectors de Beancount
• Connectors i opcions de Beancount per Bryan Alves
• Repositori de GitHub de Beancount

Teniu preguntes sobre els connectors de Beancount? Uniu-vos a la discussió al nostre fòrum de la comunitat o consulteu la nostra documentació.

Exploreu un llibre major d'exemple amb criptomoneda en viu: