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