Copie uma estrutura de contas comprovada de um destes seis livros Beancount ativos, depois renomeie as contas e substitua os valores fictícios pelos seus. Cada livro incorporado é público, versionado no Git e validado com bea check. Para reconstruir o registro de uma empresa de capital aberto da mesma forma, consulte Modelar uma empresa de capital aberto no Beancount.
Começar a partir de um ficheiro descarregado
Pule o copiar-e-colar: os padrões doméstico, de envelopes e de freelancer vêm cada um como um livro inicial executável, com dados de exemplo fictícios.
- Escolha um padrão abaixo: doméstico para dinheiro e cartões, envelopes para metas de orçamento, freelancer para faturas.
- Baixe o arquivo pelo link ao lado do padrão escolhido.
- Valide o arquivo salvo com
bea --file <arquivo> check. Um livro limpo sai com código 0 debea check; erros são listados com saída de código diferente de zero. - Abra-o com
favae use o endereço exibido no seu navegador.
Finanças pessoais do dia a dia
Use uma conta de ativo por banco, um passivo por cartão de crédito e contas de despesa para as perguntas que você quer que seus relatórios respondam. O exemplo completo também mostra folha de pagamento, benefícios, transferências, conferências de saldo e posições de investimento.
Copie esta estrutura quando quiser um único conjunto de livros para dinheiro, cartões, receita e gastos comuns:
option "operating_currency" "USD"
2026-01-01 open Assets:Bank:Checking USD
2026-01-01 open Liabilities:CreditCard USD
2026-01-01 open Equity:Opening-Balances USD
2026-01-01 open Expenses:Food:Groceries USD
2026-01-01 * "Opening balance"
Assets:Bank:Checking 3,000.00 USD
Equity:Opening-Balances -3,000.00 USD
2026-01-18 * "Corner Market" "Weekly groceries"
Liabilities:CreditCard -71.90 USD
Expenses:Food:Groceries 71.90 USD
2026-01-25 * "Credit card" "Statement payment"
Liabilities:CreditCard 71.90 USD
Assets:Bank:Checking -71.90 USDA conta do cartão de crédito mantém a data da compra separada da data do pagamento em dinheiro. Adicione uma conferência de balance mensal a cada conta do mundo real, para que um erro de importação não possa se esconder.
Baixe este padrão como household-starter.bean, depois execute bea --file household-starter.bean check e fava household-starter.bean. O arquivo corresponde ao bloco acima: checking termina em 2928.10 USD, groceries em 71.90 USD, e o cartão em zero. Substitua Corner Market, a abertura de 3,000.00 e os valores de 71.90 pelo seu próprio banco, cartão e gastos.
Orçamentação por envelopes com transporte de saldo
Modele cada envelope como uma subconta de patrimônio sobreposta à conta bancária real. Alocar um salário move valor dentro do patrimônio líquido, enquanto uma compra registra tanto o movimento de caixa quanto a decisão orçamentária.
Copie a árvore Equity:Budget e mantenha o planejamento separado do dinheiro:
option "operating_currency" "USD"
2026-01-01 open Assets:Bank:Checking USD
2026-01-01 open Income:Salary USD
2026-01-01 open Expenses:Groceries USD
2026-01-01 open Equity:Budget:Unallocated USD
2026-01-01 open Equity:Budget:Groceries USD
2026-01-05 * "Acme Corp" "January salary"
Assets:Bank:Checking 4,100.00 USD
Income:Salary -4,100.00 USD
2026-01-05 * "Budget" "Fund groceries"
Equity:Budget:Unallocated -550.00 USD
Equity:Budget:Groceries 550.00 USD
2026-01-08 * "Whole Foods" "Weekly shop"
Assets:Bank:Checking -128.44 USD
Expenses:Groceries 128.44 USD
Equity:Budget:Groceries -128.44 USD
Equity:Budget:Unallocated 128.44 USDOs dois pares na compra se equilibram independentemente. Essa separação permite redefinir ou reatribuir um envelope sem alterar o saldo bancário conciliado. Para a exibição de meta-versus-realizado do Fava, use as diretivas de orçamento mais simples.
Baixe este padrão como envelope-budgeting-starter.bean, depois execute bea --file envelope-budgeting-starter.bean check e fava envelope-budgeting-starter.bean. O arquivo corresponde ao bloco acima: checking termina em 3971.56 USD, e o envelope Groceries contém 421.56 USD contra -421.56 USD em Unallocated. Substitua Acme Corp, o salário de 4,100.00 e a alocação de 550.00 pelo seu próprio pagamento e envelopes.
Faturação e contas a receber de freelancers
Registre uma fatura quando você auferir a receita, depois baixe a conta a receber quando o cliente pagar. Uma conta a receber separada por cliente torna faturas não pagas e parcialmente pagas visíveis como saldos comuns.
Copie a árvore de contas a receber e coloque o número da fatura em ambos os eventos:
option "operating_currency" "USD"
2026-01-01 open Assets:Bank:Business USD
2026-01-01 open Assets:Receivable:Northwind USD
2026-01-01 open Income:Consulting USD
2026-01-09 * "Northwind Traders" "January retainer"
invoice: "2026-001"
due: 2026-02-08
Assets:Receivable:Northwind 6,000.00 USD
Income:Consulting -6,000.00 USD
2026-02-05 * "Northwind Traders" "Payment — invoice 2026-001"
invoice: "2026-001"
Assets:Bank:Business 6,000.00 USD
Assets:Receivable:Northwind -6,000.00 USDAdicione imposto sobre vendas a um passivo, não à receita, e mova o caixa de imposto estimado para um ativo de reserva antes de pagá-lo. O livro ativo mostra ambos os padrões, pagamentos parciais, custos refaturados e uma baixa por inadimplência.
Baixe este padrão como freelance-starter.bean, depois execute bea --file freelance-starter.bean check e fava freelance-starter.bean. O arquivo corresponde ao bloco acima: Business termina em 6000.00 USD, Consulting em -6000.00 USD, e a conta a receber em zero. Substitua Northwind Traders, a fatura 2026-001 e os valores de 6,000.00 pelos seus próprios clientes e faturas.
Imóveis para arrendamento e capital do crédito hipotecário
Trate o imóvel como um ativo, a hipoteca como um passivo e o depósito de segurança de um inquilino como dinheiro que você deve devolver. Divida cada pagamento da hipoteca entre juros, principal e escrow, para que o balanço patrimonial e a demonstração de resultado contem verdades diferentes.
Copie os grupos de contas de imóvel, dívida e operacional antes de adicionar a atividade mensal:
option "operating_currency" "USD"
1970-01-01 commodity PROP123MAIN
2024-01-01 open Assets:RealEstate:Property PROP123MAIN
2024-01-01 open Assets:Bank:Checking USD
2024-01-01 open Assets:Bank:EscrowImpound USD
2024-01-01 open Liabilities:Mortgage USD
2024-01-01 open Income:RealEstate:Rent USD
2024-01-01 open Expenses:RealEstate:MortgageInterest USD
2024-03-15 * "Escrow" "Buy rental property"
Assets:RealEstate:Property 1 PROP123MAIN {400,000.00 USD}
Assets:Bank:Checking -80,000.00 USD
Liabilities:Mortgage -320,000.00 USD
2024-04-01 * "Bank" "Mortgage payment"
Expenses:RealEstate:MortgageInterest 1,866.67 USD
Liabilities:Mortgage 262.39 USD
Assets:Bank:EscrowImpound 566.67 USD
Assets:Bank:Checking -2,695.73 USDMantenha distintos o terreno, o valor depreciável da edificação, as benfeitorias de capital, a depreciação acumulada e a atividade de escrow. O guia de imóvel para aluguel explica como esses saldos alimentam os relatórios.
Lotes de criptomoedas e base de custo
Dê a cada compra um custo entre chaves e identifique o mesmo lote quando você vender. O Beancount então carrega a data de aquisição e a base de custo através de carteiras, exchanges e alienações tributáveis, em vez de reduzir um investimento a um único saldo combinado.
Copie a commodity, as contas de exchange e o lançamento explícito de ganho realizado:
option "operating_currency" "USD"
1970-01-01 commodity BTC
2024-01-01 open Assets:Crypto:Coinbase:BTC BTC
2024-01-01 open Assets:Crypto:Coinbase:USD USD
2024-01-01 open Expenses:Crypto:Fees:Trading USD
2024-01-01 open Income:Crypto:CapitalGains:ShortTerm USD
2024-02-15 * "Coinbase" "Buy 0.10 BTC"
Assets:Crypto:Coinbase:BTC 0.10 BTC {43,800.00 USD, 2024-02-15}
Assets:Crypto:Coinbase:USD -4,380.00 USD
2024-08-20 * "Coinbase" "Sell the February lot"
Assets:Crypto:Coinbase:BTC -0.10 BTC {43,800.00 USD, 2024-02-15}
Assets:Crypto:Coinbase:USD 5,900.00 USD
Expenses:Crypto:Fees:Trading 8.85 USD
Assets:Crypto:Coinbase:USD -8.85 USD
Income:Crypto:CapitalGains:ShortTerm -1,520.00 USDTransferências entre suas próprias carteiras preservam o lote em vez de criar receita. O livro ativo continua através de staking, mineração, finanças descentralizadas e NFTs; o guia de inventários explica os métodos de registro e a redução de lotes.
O exemplo de criptomoedas usa preços estáticos datados para que você possa reproduzir seus relatórios. Para suas próprias posições suportadas em um livro hospedado, configure Preços ao Vivo para manter cotações de avaliação automaticamente. Símbolos e moedas de cotação correspondentes importam; os feeds não alteram estes exemplos de transações.
Lotes de ações, dividendos e desdobramentos
Uma ação não é um número, é um lote: uma quantidade mantida a um custo conhecido, adquirida em uma data conhecida. Registre cada compra na corretora com um {custo, data} explícito, e uma venda posterior poderá nomear o lote exato que aliena, de modo que o Beancount calcule o ganho realizado e seu período de detenção em vez de fazer a média de dois lotes. Um dividendo permanece visível como receita em vez de desaparecer dentro de um preço de ação ajustado.
Copie o plano de contas da corretora, o lote datado e a venda de lote específico:
option "operating_currency" "USD"
option "booking_method" "STRICT"
1970-01-01 commodity ACME
2024-01-01 open Assets:Brokerage:Cash USD
2024-01-01 open Assets:Brokerage:ACME ACME
2024-01-01 open Equity:Opening USD
2024-01-01 open Income:Dividends:Qualified USD
2024-01-01 open Income:CapitalGains:LongTerm USD
2024-01-01 open Expenses:Brokerage:Commissions USD
2024-01-08 * "Broker" "Wire funding to taxable brokerage account"
Assets:Brokerage:Cash 50,000.00 USD
Equity:Opening -50,000.00 USD
2024-06-18 * "Broker" "Buy 150 ACME @ $68.20"
Assets:Brokerage:ACME 150 ACME {68.20 USD, 2024-06-18}
Expenses:Brokerage:Commissions 4.95 USD
Assets:Brokerage:Cash -10,234.95 USD
2025-03-14 * "Broker" "ACME quarterly cash dividend"
Assets:Brokerage:Cash 63.00 USD
Income:Dividends:Qualified -63.00 USD
2026-02-20 * "Broker" "Sell 60 ACME from the 2024 lot — long-term gain"
Assets:Brokerage:ACME -60 ACME {68.20 USD, 2024-06-18}
Assets:Brokerage:Cash 5,778.00 USD
Expenses:Brokerage:Commissions 4.95 USD
Assets:Brokerage:Cash -4.95 USD
Income:CapitalGains:LongTerm -1,686.00 USD
2026-02-21 balance Assets:Brokerage:ACME 90 ACME
2026-02-21 balance Assets:Brokerage:Cash 45,601.10 USDO lançamento de ganho é a aritmética, não um ajuste: 60 ações vendidas por 96.30 USD cada são 5,778.00 USD de receita contra 4,092.00 USD de base de custo, e a data de 2024-06-18 do lote é o que o torna de longo prazo. O livro ativo continua através de uma distribuição reinvestida de ETF, um desdobramento 4-para-1 que preserva a base de custo total, uma venda de curto prazo de um segundo lote e conferências de contagem de ações no fim do ano. option "booking_method" "STRICT" é o que transforma "vender 40 ACME" em um erro em vez de uma média silenciosa; o guia de opções cobre as alternativas.
O exemplo de ações usa símbolos fictícios como ACME e arquivos de preços estáticos. Não substitua um feed de ticker real por uma commodity fictícia. Escolha pares suportados para suas próprias posições com Preços ao Vivo, mantendo preços manuais para este exemplo reproduzível.