Lançamentos Contábeis Beancount: Como Fazer, Definições e Exemplos

Toda transação financeira que sua empresa realiza precisa ser registrada — e no mundo da contabilidade em texto simples, isso começa com os lançamentos contábeis. Se você está usando o Beancount, entender os lançamentos contábeis é fundamental para construir registros financeiros precisos, auditáveis e claros.

Este guia irá te guiar por:

• O que é um lançamento contábil
• Por que os lançamentos contábeis são importantes
• Como escrevê-los na sintaxe Beancount
• Como usá-los de forma eficaz
• Exemplos de transações do mundo real (pagamentos de clientes, compras, empréstimos, etc.)

🧾 O que é um Lançamento Contábil no Beancount?

No Beancount, um lançamento contábil é uma transação datada escrita em um formato de texto simples e legível por humanos. Cada lançamento segue os princípios da contabilidade de partidas dobradas — você registra de onde o dinheiro vem (crédito) e para onde ele vai (débito), garantindo que seus livros sempre se equilibrem.

Exemplo:

2024-06-01 * "Client payment for invoice #123"
  Assets:Bank:Checking     600.00 USD
  Income:Sales

• O * indica uma transação compensada.
• A descrição mostra o contexto para o lançamento.
• Assets:Bank:Checking é debitado.
• Income:Sales é creditado (valor implícito).

Cada lançamento reside dentro de um arquivo .beancount — apenas um arquivo de texto que você pode controlar a versão, fazer backup e até mesmo editar no Vim ou VSCode.

📒 Por que os Lançamentos Contábeis são Importantes

Os lançamentos contábeis são a unidade atômica do seu livro-razão.

Eles:

• Alimentam seu Razão Geral e Saldos de Contas
• Geram todos os relatórios: Demonstrações de Resultados, Balanços Patrimoniais, Fluxos de Caixa
• Permitem que você rastreie cada dólar, linha por linha, até sua origem

Com as ferramentas certas, você verá essas transações renderizadas em uma interface de usuário — categorizadas, pesquisáveis e filtráveis. Mas tudo começa com aquele simples lançamento em texto simples.

📚 Como a Contabilidade de Partidas Dobradas Funciona no Beancount

Beancount impõe a contabilidade de partidas dobradas. Toda transação deve ser equilibrada: total de débitos = total de créditos.

Regra rápida:

• Debite ativos e despesas (você ganha dinheiro ou incorre em um custo)
• Credite receitas e passivos (você ganha dinheiro ou assume uma dívida)

Exemplo – Compra de Material de Escritório:

2024-06-02 * "Bought printer ink"
  Expenses:OfficeSupplies   100.00 USD
  Assets:Bank:Checking

🧠 Visualizando Lançamentos

Depois de salvar, na navegação lateral esquerda de https://beancount.io/ledger/0/income_statement/ você verá ...

• Visualização de Diário: Veja transações com pesquisa, tags e filtragem
• Menu Suspenso de Filtro de Conta: Veja saldos contínuos e lançamentos por conta
• Demonstração de Resultados: Soma das suas contas Income:* e Expenses:*
• Balanço Patrimonial: Seus ativos menos passivos

Fava ajuda a transformar seus lançamentos brutos do Beancount em relatórios acionáveis — com configuração de banco de dados zero.

💡 Exemplos Comuns de Lançamentos Contábeis

✅ Você recebe de um cliente

2024-06-05 * "Payment for invoice #456"
  Assets:Bank:Checking     1,200.00 USD
  Income:Consulting

Opcional: Se você usa Contas a Receber:

2024-05-20 * "Invoice #456 sent"
  Assets:AccountsReceivable   1,200.00 USD
  Income:Consulting

2024-06-05 * "Payment for invoice #456"
  Assets:Bank:Checking        1,200.00 USD
  Assets:AccountsReceivable  -1,200.00 USD

🖨️ Você compra material de escritório

2024-06-07 * "Staples run"
  Expenses:OfficeSupplies     85.00 USD
  Assets:Bank:Checking

🏦 Você faz um pagamento de empréstimo

Digamos que você pague $1.000, com $200 de juros e $800 para o principal:

2024-06-10 * "Loan repayment"
  Liabilities:Loan           -800.00 USD
  Expenses:LoanInterest       200.00 USD
  Assets:Bank:Checking      -1,000.00 USD

🔒 Lançamentos de Encerramento no Fim do Ano

Para "encerrar os livros", você geralmente transfere todas as contas de Receita e Despesas para o Patrimônio Líquido.

2024-12-31 close Income:*
2024-12-31 close Expenses:*

Ou, manualmente:

2024-12-31 * "Close books"
  Equity:RetainedEarnings     45,000.00 USD
  Income:Consulting          -45,000.00 USD

🛠️ Lançamentos de Ajuste

Se você está usando a contabilidade de regime de competência, você vai querer adicionar lançamentos de ajuste — para despesas pré-pagas, receitas acumuladas, etc.

Exemplo: Assinatura de software mensal de $100 paga anualmente

2024-01-01 * "Annual software payment"
  Assets:Prepaid             1,200.00 USD
  Assets:Bank:Checking      -1,200.00 USD

2024-01-31 * "Monthly amortization"
  Expenses:Software           100.00 USD
  Assets:Prepaid             -100.00 USD

Automatize com scripts ou ferramentas Beancount disponíveis.

🧰 Beancount: Leve, Auditável, Poderoso

Beancount não é apenas uma ferramenta contábil — é uma ideia: verdade financeira transparente e em texto simples. É um sistema de escrituração moderna que é:

• Fácil de controlar a versão (Git!)
• Totalmente portátil (sem banco de dados proprietário)
• Ótimo para desenvolvedores, freelancers e pequenas empresas

Pronto para Começar?

Comece seu arquivo Beancount com:

option "title" "My Business Ledger"
option "operating_currency" "USD"

2024-01-01 open Assets:Bank:Checking USD
2024-01-01 open Income:Sales USD
2024-01-01 open Expenses:OfficeSupplies USD
2024-01-01 open Equity:OpeningBalances USD

2024-01-01 * "Initial balance"
  Assets:Bank:Checking     10,000.00 USD
  Equity:OpeningBalances

Em seguida, carregue seu arquivo com sua ferramenta de visualização preferida para ver a mágica.

Quer um começo mais fácil? Experimente modelos, importadores ou ferramentas da comunidade como bean-extract.

Com o Beancount, seus livros são finalmente seus — simples, programáveis e à prova de auditoria.

Me avise se você gostaria de uma versão em PDF para download ou variações dos exemplos específicas para pequenas empresas.