2 postagens marcado com "contabilidade de partida dobrada"

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.

Os impostos podem parecer uma fera especial e complicada no universo das finanças pessoais. Mas e se não fossem? E se você pudesse tratá‑los como qualquer outro fluxo de dinheiro no seu livro‑razão? Boa notícia: você pode. Ao tratar os impostos como movimentos simples de valor, seu livro‑razão Beancount permanecerá limpo, fácil de consultar e — o mais importante — compreensível.

A seguir, um padrão prático e direto que você pode inserir em um arquivo Beancount pessoal ou de pequeno negócio. É um sistema simples para lidar com holerites, pagamentos de impostos e até aquelas restituições incômodas que atravessam o ano novo. Vamos abordar as contas essenciais que você precisa, percorrer exemplos reais e mostrar as consultas exatas para obter as respostas que deseja.

Os Princípios Fundamentais​

Antes de mergulharmos no código, vamos concordar com algumas regras simples. Esses princípios mantêm tudo lógico e evitam dores de cabeça futuras.

• Separe “o que é” de “quando o dinheiro se move”. 🗓️
  Este é o conceito mais importante. Uma despesa de imposto pertence ao ano em que você recebeu a renda (por exemplo, 2024), mesmo que você quite a conta com o IRS em abril de 2025. Se você não separar o momento da despesa do momento do pagamento, seus relatórios anuais ficarão confusos e enganosos.

• Mantenha sua hierarquia de contas entediante e simples. 📁
  Nomeie suas contas de forma clara com base no tipo de imposto (por exemplo, IncomeTax, SocialSecurity). Isso torna suas consultas incrivelmente simples. Não sobrecarregue os nomes das contas com nomes de fornecedores ou números de formulários como “W‑2” ou “1099”; use metadados e tags para esses detalhes.

• Adote o regime de competência para ajustes de fim de ano. ⚖️
  Mesmo em um livro‑razão pessoal, usar uma entrada simples de competência no final do ano é a forma mais limpa de tornar seus relatórios precisos. Significa reconhecer a despesa ou restituição no ano correto, ainda que o dinheiro só se mova no próximo. É um pequeno passo extra que salva você de acrobacias mentais depois.

• Escreva para o seu eu futuro. 🧠
  Seu objetivo é clareza. Só adicione detalhes extras, como o ano fiscal, ao nome de uma conta se isso realmente facilitar suas consultas. Evite criar um novo conjunto de contas a cada ano (Expenses:Taxes:2024:Federal, Expenses:Taxes:2025:Federal etc.) a menos que tenha um motivo convincente. Uma estrutura plana costuma ser mais fácil de gerir.

Um Esqueleto de Contas Minimalista​

Aqui está um conjunto básico de contas para você começar. Essa estrutura é centrada nos EUA, mas você pode adaptar os nomes ao sistema fiscal do seu país. Basta inserir essas diretivas open no seu arquivo Beancount.

; --- Impostos Federais de Renda & Folha dos EUA ---
; Para valores retidos do seu holerite
2024-01-01 open Expenses:Taxes:Federal:IncomeTax:Withheld       USD
; Para pagamentos estimados ou contas do dia do imposto pagas diretamente
2024-01-01 open Expenses:Taxes:Federal:IncomeTax:Payments       USD
; Para restituições de imposto que você recebe
2024-01-01 open Expenses:Taxes:Federal:IncomeTax:Refunds        USD

; Suas contribuições ao FICA
2024-01-01 open Expenses:Taxes:Federal:SocialSecurity           USD
2024-01-01 open Expenses:Taxes:Federal:Medicare                 USD

; --- Outros Impostos Comuns ---
; Para impostos sobre vendas/uso que você paga nas compras
2024-01-01 open Expenses:Taxes:Sales                            USD

; --- Contas para Ajustes de Fim de Ano (Opcional, mas Recomendado!) ---
; Conta temporária de passagem para impostos devidos mas ainda não pagos
2024-01-01 open Liabilities:AccruedTaxes:Federal:Income         USD
; Conta temporária de passagem para restituição a receber
2024-01-01 open Assets:Tax:Receivable                           USD

Esta configuração separa impostos retidos de pagamentos diretos e restituições, facilitando a visualização de onde seu dinheiro foi. As contas Liabilities e Assets são nossa arma secreta para manter a precisão dos relatórios de fim de ano.

Exemplo 1: O Holerite​

Vamos registrar um holerite típico onde os impostos são retidos automaticamente. O segredo é registrar primeiro o salário bruto, depois mostrar como ele foi dividido entre impostos e o dinheiro que realmente chegou à sua conta bancária.

2025-07-15 * "Employer Inc." "Salary for first half of July"
  Income:Work:Salary                                  -6,000.00 USD
  Expenses:Taxes:Federal:IncomeTax:Withheld             1,200.00 USD
  Expenses:Taxes:Federal:SocialSecurity                   372.00 USD
  Expenses:Taxes:Federal:Medicare                          87.00 USD
  Assets:Cash:Checking                                  4,341.00 USD

Esta única transação conta toda a história:

• Você recebeu $6.000 de renda bruta.
• $1.200 foram enviados ao IRS como imposto de renda federal.
• $372 foram para a Seguridade Social e$87 para o Medicare.
• Os $4.341 restantes são o que você recebeu em mãos.

Dica de especialista: Você pode anexar metadados do seu contracheque (como pay_period_end: "2025-07-15") à transação para criar uma trilha de auditoria fácil.

Exemplo 2: Declarando a Sua Declaração (O Problema do Ano Cruzado)​

Aqui está o cenário que confunde as pessoas: é abril de 2025 e você está declarando seus impostos de 2024. Descobre que, depois de toda a retenção, ainda deve $3.000 a mais.

Como registrar isso? Você quer que a despesa seja contabilizada em 2024, mas que o pagamento em dinheiro ocorra em 2025. Veja duas formas excelentes de lidar com isso.

Opção A: Acumulação Manual em Dois Passos​

Este método é puro Beancount, sem plugins. É um processo claro em duas etapas.

Passo 1: Reconheça a despesa no final do ano fiscal.
No último dia de 2024, crie uma entrada de “ajuste”. Nenhum dinheiro se move ainda; você apenas reconhece a despesa e a estaciona em uma conta de passivo temporária.

2024-12-31 * "Federal income tax true-up for 2024"
  Expenses:Taxes:Federal:IncomeTax:Payments             3,000.00 USD
  Liabilities:AccruedTaxes:Federal:Income             -3,000.00 USD

Agora, sua demonstração de resultados de 2024 mostra corretamente essa despesa de $3.000.

Passo 2: Registre o pagamento em dinheiro quando ele acontecer.
Em abril de 2025, quando você realmente envia o dinheiro ao IRS, elimina o passivo.

2025-04-15 * "IRS" "Payment for 2024 tax return"
  Liabilities:AccruedTaxes:Federal:Income              3,000.00 USD
  Assets:Cash:Checking                                -3,000.00 USD

Seus relatórios de 2024 ficam corretos e seu fluxo de caixa de 2025 também. Perfeito! O mesmo padrão funciona ao contrário para uma restituição — basta usar Assets:Tax:Receivable em vez da conta de passivo.

Opção B: Automatize com um Plugin​

Se preferir manter o pagamento em uma única transação, um plugin da comunidade chamado beancount_reds_plugins.effective_date pode ajudar. Ele permite atribuir uma “data efetiva” diferente a um item de linha.

Primeiro, habilite o plugin no seu arquivo principal Beancount:
plugin "beancount_reds_plugins.effective_date"

Depois, escreva uma única transação. O plugin a dividirá nos bastidores para que seus relatórios fiquem corretos.

; Uma única entrada; o plugin cuida do resto
2025-04-15 * "IRS" "Payment for 2024 tax return"
  Assets:Cash:Checking                                 -3,000.00 USD
  Expenses:Taxes:Federal:IncomeTax:Payments             3,000.00 USD
    effective_date: 2024-12-31

Aqui, a parte em dinheiro é registrada em 15 de abril de 2025, mas a parte da despesa é retroativamente aplicada a 31 de dezembro de 2024. O resultado é o mesmo da Opção A, com um fluxo de trabalho diferente.

E os Impostos sobre Vendas?​

Para a maioria dos livros‑razão pessoais, o imposto sobre vendas é simples. Se você não o reivindica de volta, basta separá‑lo como sua própria despesa durante a compra.

2025-07-19 * "Local Grocery Store"
  Expenses:Groceries                                      12.32 USD
  Expenses:Taxes:Sales                                     1.28 USD
  Assets:Cash:Checking                                   -13.60 USD

Isso permite acompanhar facilmente quanto você está gastando em imposto sobre vendas ao longo do ano. Se você administra um negócio que lida com IVA, usaria um sistema mais formal com contas a pagar e a receber, mas o princípio é o mesmo.

Consultas que Você Realmente Executará​

O objetivo dessa estrutura é facilitar a obtenção de respostas. Aqui estão algumas consultas BQL para visualizar seu panorama fiscal.

1. Qual foi o total de imposto de renda federal em 2024?

SELECT cost(sum(position))
WHERE account   "Expenses:Taxes:Federal:IncomeTax"
  AND date >= 2024-01-01 AND date < 2025-01-01;

2. Como esse total se divide entre retenções, pagamentos e restituições?

SELECT account, cost(sum(position))
WHERE account   "Expenses:Taxes:Federal:IncomeTax"
  AND date >= 2024-01-01 AND date < 2025-01-01
GROUP BY account
ORDER BY account;

3. Tenho dívidas fiscais ou recebíveis pendentes? (Útil para conferir seu trabalho!)

SELECT account, units(sum(position))
WHERE account   "Liabilities:AccruedTaxes" OR account   "Assets:Tax"
GROUP BY account
ORDER BY account;

Se essa consulta retornar saldos diferentes de zero, significa que você tem acumulações ainda não quitadas.

Perguntas‑Frequentes Rápidas​

• Preciso realmente de contas por ano como Expenses:Taxes:2024?
  Provavelmente não. O método de competência (ou o plugin) mantém a estrutura de contas plana limpa e legível. Crie contas por ano somente se isso facilitar suas consultas específicas.

• O Beancount pode calcular meus impostos por mim?
  Não diretamente, mas pode preparar os dados. Usuários avançados escrevem scripts que enviam os resultados das consultas BQL para softwares de cálculo fiscal, o que é ótimo para estimar sua obrigação ao longo do ano.

• Isso é aconselhamento fiscal?
  Não. Este é um padrão de contabilidade para organizar seus dados. A contabilidade está correta, mas você deve sempre consultar um profissional de impostos para obter orientações específicas ao seu caso.

Seu Checklist Pronto‑para‑Uso​

Pronto para começar?

1. ✅ Adicione o esqueleto de contas ao seu arquivo Beancount (e adapte os nomes ao seu país).
2. ✅ Registre os holerites começando pelo salário bruto e separando as postagens de imposto.
3. ✅ No fim do ano, acumule ajustes de pagamentos ou restituições usando contas de passivo/ativo (ou use o plugin effective_date).
4. ✅ Acompanhe restituições como recebíveis e liquide‑as quando o dinheiro chegar.
5. ✅ Execute as consultas BQL acima para validar seus totais antes de declarar.

Mantenha tudo entediante, mantenha tudo consistente, e sua temporada de impostos finalmente será apenas mais um capítulo da sua história financeira — não um mistério a ser resolvido.