Uma postagem marcado com "Financial Transactions"

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:

$Ativos = Passivos + Patrimônio\ Líquido$

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:

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:

1. Comece com a data (AAAA-MM-DD) e um marcador de transação (*).
2. Adicione um beneficiário e uma narração descritiva. Use #tags e ^links para facilitar a busca.
3. Inclua ao menos duas linhas de lançamentos que equilibram a zero para cada commodity.
4. Use nomes de contas corretos nos cinco tipos: Assets, Liabilities, Equity, Income, Expenses.
5. 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 e Liabilities 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.

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.