Entendendo Lançamentos Contábeis no Beancount
Os lançamentos contábeis são a espinha dorsal da contabilidade de partida dobrada e, no Beancount, cada transação *
que você escreve é um lançamento contábil. Este guia explica o essencial — débitos e créditos, lançamentos de ajuste e lançamentos de reversão — e mostra como eles se mapeiam de forma limpa para a sintaxe em texto puro do Beancount. Você aprenderá a manter livros precisos com o mínimo de cerimônia.
Um Relembrete Rápido: O Que É um Lançamento Contábil?
Um lançamento contábil é o registro formal e datado de uma transação financeira. Ele é expresso em termos de débitos e créditos que mantêm a equação contábil fundamental em equilíbrio:
Em um sistema de partida dobrada, toda transação afeta ao menos duas contas, e o total de débitos deve ser igual ao total de créditos. Essa regra simples é o que torna relatórios financeiros subsequentes, como a Demonstração de Resultados e o Balanço Patrimonial, confiáveis e precisos.
Débitos e Créditos em Um Minuto
Os conceitos de débitos e créditos podem ser confusos a princípio, mas resumem‑se a algumas regras simples. Pense da seguinte forma: “de onde veio o valor?” (crédito) e “para onde foi o valor?” (débito).
Aqui está um cheat sheet de como eles aumentam os cinco tipos principais de contas:
Tipo de Conta | Aumenta com |
---|---|
Ativos | Débito |
Despesas | Débito |
Passivos | Crédito |
Patrimônio Líquido | Crédito |
Receitas | Crédito |
Como um Lançamento Contábil Se Parece no Beancount
O Beancount usa diretivas de texto simples e legíveis por humanos para registrar transações. Cada transação deve equilibrar a zero para cada commodity (ex.: USD, EUR, ação AAPL). O Beancount lançará um erro se não o fizer.
Aqui está uma transação básica para comprar café:
2025-09-10 * "Coffee Bar" "Team coffee"
Expenses:Food:Coffee 18.00 USD
Assets:Bank:Checking -18.00 USD
Observe como as duas linhas de lançamentos (linhas com contas) somam zero: $18.00 + (-$18.00) = 0
.
Você pode adicionar contexto poderoso diretamente na narração usando tags (como #clienteX
) para filtragem e links (como ^INV-2025-001
) para conectar entradas relacionadas.
Por exemplo, veja como você pode vincular uma fatura ao seu pagamento:
; Primeiro, registre a fatura que você enviou ao cliente
2025-09-15 * "Acme Corp" "Fatura 2025-001 #clienteX ^INV-2025-001"
Assets:AccountsReceivable 1000.00 USD
Income:Consulting -1000.00 USD
; Depois, registre o pagamento e vincule‑o de volta à fatura original
2025-09-28 * "Acme Corp" "Pagamento em ^INV-2025-001"
Assets:Bank:Checking 1000.00 USD
Assets:AccountsReceivable -1000.00 USD
A tag #clienteX
permite filtrar facilmente todas as transações desse cliente, e o link ^INV-2025-001
cria uma conexão entre as duas entradas que pode ser seguida nos relatórios.
Lançamentos Contábeis Comuns (Prontos para Copiar)
A seguir, vários tipos de transações empresariais formatados para o Beancount.
Sócio Investindo Dinheiro
Um sócio contribui com recursos pessoais para iniciar o negócio.
2025-01-01 * "Owner" "Contribuição de capital inicial"
Assets:Bank:Checking 10000.00 USD
Equity:Owner-Capital -10000.00 USD
Venda à Vista com Imposto Sobre Vendas
Um cliente paga em dinheiro por um produto, incluindo 8 % de imposto que você deverá recolher ao governo posteriormente.
2025-01-05 * "Cliente Presencial" "Venda à vista com 8% de imposto"
Assets:Cash 108.00 USD
Income:Sales -100.00 USD
Liabilities:Tax:Sales -8.00 USD
Venda a Crédito (Fatura) e Cobrança
Você presta um serviço e fatura o cliente, depois recebe o pagamento.
2025-01-10 * "Acme Corp" "Fatura de consultoria ^INV-2025-002"
Assets:AccountsReceivable 2500.00 USD
Income:Consulting -2500.00 USD
2025-01-30 * "Acme Corp" "Pagamento em ^INV-2025-002"
Assets:Bank:Checking 2500.00 USD
Assets:AccountsReceivable -2500.00 USD
Despesa no Cartão de Crédito
Você compra material de escritório usando o cartão de crédito da empresa.
2025-01-12 * "OfficeMax" "Materiais no cartão de crédito"
Expenses:Office:Supplies 75.00 USD
Liabilities:CreditCard -75.00 USD
Folha de Pagamento (Modelo Simples)
Você processa a folha, registrando a despesa bruta de salários, as retenções de impostos dos funcionários e o pagamento líquido do banco.
2025-01-31 * "Folha de Pagamento" "Salários e retenções de janeiro"
Expenses:Payroll:Wages 2000.00 USD
Liabilities:Taxes:Withheld -400.00 USD
Assets:Bank:Checking -1600.00 USD
Depreciação Mensal
Você registra a despesa de depreciação mensal de um ativo, como um laptop.
2025-01-31 * "Depreciação" "Laptop, linha reta"
Expenses:Depreciation 100.00 USD
Assets:Equipment:AccumDepr -100.00 USD
Despesa Antecipada & Amortização Mensal
Você paga o seguro anual adiantado e depois reconhece a despesa de um mês.
; 1. Pagamento da apólice anual
2025-01-01 * "InsureCo" "Prêmio de seguro anual"
Assets:Prepaid:Insurance 1200.00 USD
Assets:Bank:Checking -1200.00 USD
; 2. Reconhecimento de um mês de despesa ao final de janeiro
2025-01-31 * "InsureCo" "Amortizar 1/12 do seguro"
Expenses:Insurance 100.00 USD
Assets:Prepaid:Insurance -100.00 USD
Receita Não Realizada & Reconhecimento Mensal
Um cliente paga antecipadamente por uma assinatura de 3 meses. Você registra o caixa e depois reconhece um mês de receita.
; 1. Cliente paga antecipadamente pelo serviço
2025-02-01 * "Assinante" "Plano de 3 meses pago antecipadamente"
Assets:Bank:Checking 300.00 USD
Liabilities:Unearned:Subs -300.00 USD
; 2. Reconhecer um mês de receita após a entrega do serviço
2025-02-28 * "Reconhecimento" "Reconhecer mês 1 de 3"
Liabilities:Unearned:Subs 100.00 USD
Income:Subscriptions -100.00 USD
Provisão para Devedores Duvidosos e Baixa
Você cria uma provisão para faturas potencialmente incobráveis e depois baixa uma fatura específica.
; 1. Criar provisão de 2 % das contas a receber
2025-03-31 * "Provisão" "2% de A/R para contas duvidosas"
Expenses:BadDebt 200.00 USD
Assets:AllowanceForDoubtful -200.00 USD
; 2. Baixar fatura específica que sabe que não será paga
2025-04-15 * "Baixa" "Fatura do cliente XYZ"
Assets:AllowanceForDoubtful 150.00 USD
Assets:AccountsReceivable -150.00 USD
Inventário Periódico & Ajuste de COGS
Ao final de um período, você calcula o Custo das Mercadorias Vendidas (COGS) ajustando a conta de inventário.
2025-03-31 * "Ajuste de COGS" "Método de inventário periódico"
Expenses:COGS 4500.00 USD
Assets:Inventory -4500.00 USD
Lançamentos de Ajuste vs. Lançamentos de Reversão
Lançamentos de ajuste são registrados ao final de um período contábil (como mês ou trimestre) para alinhar receitas e despesas ao período em que foram realmente auferidas ou incorridas. Isso inclui accruals, deferrals e estimativas como depreciação.
Lançamentos de reversão são opcionais e feitos no primeiro dia de um novo período, revertendo exatamente um lançamento de ajuste específico do período anterior. Seu objetivo é simplificar a escrituração. Ao reverter um accrual, você pode registrar a transação de caixa subsequente de forma padrão, sem precisar lembrar de dividir contra a conta de passivo.
Exemplo: Acumular e Reverter Despesas de Utilidades
Suponha que você precise registrar a despesa de utilidades de janeiro, mas a conta só chegará em fevereiro.
; 1. Acumular a despesa estimada ao final de janeiro
2025-01-31 * "Acúmulo" "Estimativa da despesa de utilidades de janeiro"
Expenses:Utilities 500.00 USD
Liabilities:Accrued:Utilities -500.00 USD
; 2. (Opcional) Reverter o acúmulo no primeiro dia do próximo período
2025-02-01 * "Reversão" "Desfazer acúmulo de utilidades de janeiro"
Liabilities:Accrued:Utilities 500.00 USD
Expenses:Utilities -500.00 USD
; 3. Registrar o pagamento real quando chegar em fevereiro
; A conta real é de $520. Por causa da reversão, você pode
; lançar o valor total na conta de despesa sem problemas.
; A despesa líquida de fev será $520 - $500 = $20.
2025-02-10 * "City Utilities" "Pagamento da conta de janeiro"
Expenses:Utilities 520.00 USD
Assets:Bank:Checking -520.00 USD
Nota: O exemplo no esboço mostra a divisão do pagamento final. O método de lançamento de reversão é uma alternativa que simplifica o lançamento final.
Checklist para Cada Lançamento no Beancount
Siga estes passos para garantir que seus lançamentos estejam limpos e corretos:
- Comece com a data (AAAA-MM-DD) e um marcador de transação (
*
). - Adicione um beneficiário e uma narração descritiva. Use
#tags
e^links
para facilitar a busca. - Inclua ao menos duas linhas de lançamentos que equilibram a zero para cada commodity.
- Use nomes de contas corretos nos cinco tipos:
Assets
,Liabilities
,Equity
,Income
,Expenses
. - Opcionalmente, adicione metadados como
document: "invoices/INV-2025-001.pdf"
para rastreabilidade.
Armadilhas Comuns (e Como o Beancount Ajuda)
- Lançamentos Desbalanceados: Se seus débitos e créditos não somarem zero, o Beancount rejeitará a entrada. Essa é uma funcionalidade central que impede erros. Você pode deixar um valor em branco e o Beancount o calculará automaticamente.
- Sinal Errado em uma Conta: É fácil esquecer que
Income
,Equity
eLiabilities
aumentam com créditos (geralmente números negativos no Beancount). Se errar, seus relatórios ficarão estranhos, mas a regra de balanceamento ainda fornece uma rede de segurança. - Links Ausentes Entre Entradas: Esquecer de vincular uma fatura ao seu pagamento dificulta o acompanhamento do que está pendente. Usar
^links
de forma consistente resolve isso ao criar um rastro auditável.
Próximos Passos
- Linguagem Beancount & Regras de Balanceamento: Aprofunde-se na documentação oficial.
- Cheat Sheet de Sintaxe: Uma referência prática para todas as diretivas do Beancount.
- Introdução a Débitos/Créditos: Um ótimo ponto de partida se você é novo nas regras contábeis.
- Lançamentos de Ajuste/Reversão: Artigos mais detalhados sobre a teoria contábil.
Apêndice: Mapa de Termos Contábeis → Beancount
Este guia rápido de tradução pode ajudá‑lo a mapear instruções contábeis para a sintaxe do Beancount.
Instrução Contábil | Ação no Beancount |
---|---|
Debitar uma despesa | Valor positivo em uma conta Expenses: |
Creditar um passivo | Valor negativo em uma conta Liabilities: |
Acumular receita | Assets:AccountsReceivable + Income:* - |
Diferir receita | Assets:Bank:* + Liabilities:Unearned:* - |
Reconhecer receita diferida | Liabilities:Unearned:* + Income:* - |
Com esses padrões e exemplos, você pode modelar de forma limpa quase qualquer evento de negócio no Beancount, garantindo que seus relatórios financeiros estejam alinhados sem surpresas.