Pular para o conteúdo principal

2 postagens marcado com "fechamento de mês"

Ver todas as tags

10 Passos Práticos para um Fechamento de Mês Rápido e Confiável no Beancount

· 7 min de leitura
Mike Thrift
Mike Thrift
Marketing Manager

Se a sua razão está em texto simples, o fechamento de mês pode ser rápido e auditável. O processo não precisa ser uma corrida frenética de planilhas e calculadoras. Este guia destila um processo limpo e repetível, adaptado ao Beancount e sua interface web, Fava, construído em torno de assertivas de saldo, importações inteligentes e verificações leves.

Aqui está a lista de verificação para um fechamento sem dores:

2025-09-02-month-end-close

  1. Reúna extratos e importe todas as transações brutas.
  2. Normalize pagadores, descrições e metadados.
  3. Reconcile every cash, bank, and credit account with balance assertions.
  4. Tie out transfers and inter‑account moves.
  5. Update prices for investments and verify valuations.
  6. Attach or source documents (receipts, invoices) in your ledger.
  7. Run queries and dashboards for P&L and variance checks.
  8. Post accruals and adjustments as needed.
  9. Validate the ledger with automated checks.
  10. Commit, tag, and archive the month.

1. Defina as Regras de Base (e Reutilize‑as)

Um fechamento consistente começa com uma base estável. Seu Plano de Contas e as opções chave do Beancount devem ser declarados centralmente e raramente alterados. Opções como operating_currency e o tratamento de documents garantem que seus relatórios e importações se comportem de forma previsível a cada execução.

Dica: Trate seu arquivo de opções como “infraestrutura”. Alterá‑lo pode mudar a forma como seus números são calculados. Versione‑o cuidadosamente no Git.


2. Importe Tudo — E Nunca Mais Digite Manualmente

Automatizar a importação de dados é o maior ganho de velocidade para fechar seus livros. Use as poderosas ferramentas de importação do Beancount e os importadores criados pela comunidade para puxar feeds bancários, arquivos CSV/OFX de cartões de crédito, dados de corretoras e relatórios de folha de pagamento.

O objetivo é um import de um único comando que gera lançamentos balanceados que você só precisa revisar e confirmar. Isso elimina a entrada manual de dados, a principal fonte de erros e atrasos.


3. Normalize Pagadores e Metadados Antecipadamente

Dados limpos são dados confiáveis. Padronize seus pagadores, narração e tags durante o processo de importação para que suas buscas, regras e relatórios permaneçam precisos mês após mês.

O sistema de plugins do Beancount permite adicionar transformações leves e validações enquanto seus arquivos são carregados. Isso é perfeito para impor verificações de consistência personalizadas ou usar o plugin interno noduplicates para sinalizar transações repetidas antes que se tornem um problema.


4. Reconcile com Assertivas balance

Para cada conta que possui extrato (corrente, poupança, cartões de crédito), use a diretiva balance do Beancount para afirmar o saldo de fechamento. Esta linha simples transforma a reconciliação de uma verificação manual em um teste preciso e automatizado.

; Asserts the balance is exactly 1234.56 at the start of the day
2025-09-01 balance Assets:Bank:Checking 1234.56 USD

Como os saldos são verificados no início do dia, é mais fácil usar o primeiro dia do mês seguinte para um extrato de fechamento de mês. Se o saldo calculado pelo Beancount discordar da sua assertiva, você receberá um erro preciso e uma data para iniciar a investigação. Sempre corrija a fonte da verdade (suas transações) primeiro; não “force” uma reconciliação.


5. Verifique Transferências Inter‑Conta

Garanta que toda transferência apareça nos dois lados da transação. Um pagamento da sua conta corrente para o cartão de crédito, por exemplo, deve ser refletido em ambas as contas. Transferências desalinhadas são uma fonte comum de dores de cabeça na reconciliação.

Use a diretiva pad apenas para definir saldos de abertura históricos quando você cria uma conta pela primeira vez. É uma ferramenta de configuração, não um apoio para consertar diferenças de fechamento.


6. Verifique Posições e Preços de Investimentos

Para obter uma visão precisa do seu patrimônio líquido, você precisa de valores de mercado atualizados para seus investimentos e moedas estrangeiras. Use a diretiva price do Beancount para registrar esses valores na data de fechamento.

2025-08-31 price VTI  290.14 USD
2025-08-31 price EUR 1.11 USD

Muitas ferramentas podem buscar esses preços automaticamente para você. Após atualizá‑los, execute novamente seu balanço patrimonial ou relatórios de patrimônio líquido para ver as mudanças de avaliação.


7. Anexe Recibos e Documentos Fonte

Mantenha um trilho de auditoria limpo vinculando transações aos seus documentos fonte. Use a opção documents no seu arquivo principal do Beancount para apontar para seu arquivo de recibos e faturas.

option "documents" "/path/to/Finance/Documents"

Se você nomear seus arquivos por data (ex.: 2025-08-13.vendor.receipt.pdf), o Beancount e o Fava podem descobrir e vinculá‑los automaticamente, facilitando a visualização de um recibo para qualquer transação com um único clique.


8. Revise o Mês com Fava e BQL

Um ciclo de feedback rápido é crítico. Use Fava para inspecionar visualmente suas finanças. Seus gráficos e relatórios são perfeitos para dividir despesas por categoria, verificar tendências de receita e identificar anomalias de relance.

Para verificações mais precisas, use a Beancount Query Language (BQL). Esta consulta, por exemplo, fornece um detalhamento classificado de todas as despesas de agosto de 2025:

SELECT
account,
ROUND(SUM(position), 2) AS total
WHERE
date >= 2025-08-01 AND date < 2025-09-01
AND account 'Expenses'
GROUP BY
account
ORDER BY
total DESC;

9. Lance Acréscimos e Ajustes

Se você usa contabilidade de competência, registre seus ajustes de fim de mês como transações explícitas e datadas. Isso pode incluir despesas acumuladas (como uma conta de utilidade que ainda não chegou), amortização de despesas pré‑pagas ou reconhecimento de receita. Mantenha‑os simples e bem documentados na narração para que sejam fáceis de entender em revisões futuras.


10. Valide, Tagueie e Arquive

Antes de finalizar o mês, execute uma verificação final de integridade estrutural:

bean-check your-ledger.beancount

Este comando capturará desequilíbrios, referências a contas que ainda não foram abertas e outros erros comuns. Corrija tudo o que ele apontar.

Uma vez tudo correto, confirme suas alterações no controle de versão (como Git) com uma mensagem clara e uma tag, por exemplo close-2025-08. Por fim, arquive seus extratos bancários e considere o mês fechado.


Um Script de Fechamento Simples que Você Pode Adaptar

Você pode automatizar a maioria desses passos com um simples script shell. Isso transforma seu fechamento em um único comando repetível.

#!/usr/bin/env bash
set -euo pipefail

# Example: ./close.sh 2025-08
MONTH=${1:?Please provide a month in YYYY-MM format}
LEDGER= /finance/ledger.beancount

# 1. Import new transactions
echo "Importing transactions for $MONTH..."
make import MONTH="$MONTH"

# 2. Update market prices for the last day of the month
PRICE_DATE=$(date -d "$MONTH-01 +1 month -1 day" +%F)
echo "Fetching prices for $PRICE_DATE..."
make prices DATE="$PRICE_DATE"

# 3. Validate the entire ledger
echo "Running bean-check..."
bean-check "$LEDGER"

# 4. Generate a key report (e.g., expense breakdown)
echo "Generating expense report for $MONTH..."
bean-query "$LEDGER" -f txt "
SELECT account, SUM(position)
WHERE date >= '${MONTH}-01' AND date < '${MONTH}-01' + 1 month
AND account 'Expenses'
GROUP BY account ORDER BY SUM(position) DESC;
" > "reports/${MONTH}-expenses.txt"

# 5. Commit and tag the close in Git
echo "Committing and tagging the close..."
git -C /finance add .
git -C /finance commit -m "Close ${MONTH}"
git -C /finance tag "close-${MONTH}"

echo "Month ${MONTH} is closed and tagged."

Por Que Isso Funciona

Este processo é rápido e confiável porque se baseia em alguns princípios fundamentais:

  • Assertivas, não Olhos: A diretiva balance transforma a reconciliação em uma verificação precisa e automatizada.
  • Entradas Determinísticas: Importadores automatizados e metadados normalizados tornam sua razão reproduzível e consistente.
  • Dados Exploráveis: Fava e BQL fornecem ferramentas poderosas para validar resultados e aprofundar anomalias instantaneamente.
  • Alterações Auditáveis: Ajustes são lançamentos em texto simples, facilitando a revisão e compreensão meses ou anos depois.

Um bom fechamento de mês é, em grande parte, logística. Com o Beancount, você pode transformá‑lo em um ritual curto e scriptável: importe, afirme, precifique, consulte e confirme. Mantenha o fluxo de trabalho estável e seu fechamento permanecerá rápido — mesmo à medida que sua vida financeira se torne mais complexa.

Lançamentos de Ajustes no Beancount: Seu Ajuste de Fim de Mês

· 5 min de leitura
Mike Thrift
Mike Thrift
Marketing Manager

A contabilidade não termina quando a última venda chega ao banco. Para obter uma visão real da saúde do seu negócio, você precisa realizar um ajuste de fim de mês. A cada fechamento de período, você fará lançamentos de ajustes — ajustes no diário que colocam corretamente as receitas e despesas na janela de tempo adequada e mantêm seu balanço patrimonial honesto.

Em um livro-razão Beancount de texto simples, esses lançamentos cruciais são transparentes, controlados por versão e fáceis de auditar, transformando uma tarefa tediosa em um processo claro e repetível.

2022-01-25-lançamentos-de-ajustes-no-beancount-seu-ajuste-de-fim-de-mes


Por que os Lançamentos de Ajustes Importam

Fazer esses ajustes é fundamental para uma contabilidade sólida. Eles garantem que suas demonstrações financeiras sejam precisas e confiáveis.

  • Precisão do Regime de Competência: Os lançamentos de ajustes são o motor da contabilidade de regime de competência. Eles movem a receita e os custos para o período em que foram realmente ganhos ou incorridos, independentemente de quando o dinheiro mudou de mãos. Isso satisfaz os princípios básicos de reconhecimento de receita e casamento que formam a base da contabilidade moderna (AccountingCoach.com).

  • KPIs Confiáveis: Os indicadores-chave de desempenho são tão bons quanto os dados por trás deles. Métricas como margem bruta, lucro líquido e previsões de fluxo de caixa só dizem a verdade depois que os diferimentos, acréscimos e estimativas são devidamente lançados (Corporate Finance Institute).

  • Trilha de Auditoria Limpa: Os ajustes explícitos de fim de mês criam um registro claro do seu raciocínio financeiro. Isso ajuda os auditores (e seu futuro eu) a rastrear facilmente o que mudou e porquê, criando confiança em seus números (Accountingverse).


Seis Categorias Comuns (com Trechos de Beancount)

Aqui estão os seis tipos mais comuns de lançamentos de ajustes, com exemplos de como registrá-los em seu livro-razão Beancount. Observe o uso de metadados como adj:"accrual" para tornar esses lançamentos fáceis de encontrar e analisar posteriormente.

1. Receita Acumulada

Isso é para receita que você ganhou, mas ainda não faturou ou recebeu o pagamento.

2025-07-31 * "Consultoria—Horas de julho"
Assets:AccountsReceivable 12000.00 USD
Income:Consulting
; adj:"accrual" period:"Jul-25"

2. Despesa Acumulada

Uma despesa que você incorreu, mas ainda não pagou, como uma conta de serviços públicos que chegará no próximo mês.

2025-07-31 * "Advogado—Honorários de julho"
Expenses:Legal 2500.00 USD
Liabilities:AccruedPayables
; adj:"accrual"

3. Receita Diferida (Não Realizada)

Isso se aplica quando um cliente paga antecipadamente. Você reconhece uma parte dessa receita à medida que ela é ganha ao longo do tempo.

2025-07-31 * "Pagamento antecipado anual de SaaS (reconhecer 1/12)"
Liabilities:UnearnedRevenue 833.33 USD
Income:SaaS
; adj:"deferral"

4. Despesa Pré-paga (Diferida)

Quando você paga por uma despesa antecipadamente (como uma apólice de seguro anual), você lança uma parte dela a cada mês.

2025-07-31 * "Seguro—Despesa de 1 mês do pré-pago"
Expenses:Insurance 400.00 USD
Assets:PrepaidInsurance
; adj:"deferral"

5. Depreciação e Amortização

Este lançamento aloca o custo de um ativo de longo prazo (como um computador ou veículo) ao longo de sua vida útil.

2025-07-31 * "Depreciação do Mac Studio"
Expenses:Depreciation 1250.00 USD
Assets:Computers:AccumDepr
; asset_id:"MAC-03" adj:"estimate"

6. Provisão para Devedores Duvidosos

Uma estimativa de contas a receber que você não espera receber, que é registrada como uma despesa de crédito incobrável.

2025-07-31 * "Provisão para devedores duvidosos (2% das contas a receber)"
Expenses:BadDebt 700.00 USD
Assets:AllowanceForBadDebt
; basis:"A/R" rate:0.02 adj:"estimate"

Um Fluxo de Trabalho Repetível

Para manter o fechamento do seu mês eficiente e livre de erros, adote um fluxo de trabalho consistente.

  • Use um arquivo separado. Mantenha todos os ajustes para um período em um só lugar, como adjustments-2025-07.bean. Em seu arquivo de livro-razão principal, use uma diretiva include para importá-lo por último. Isso garante que os ajustes sejam aplicados imediatamente antes de você gerar os relatórios finais.

  • Padronize seus metadados. Sempre use chaves e valores de metadados consistentes, como adj:"accrual|deferral|estimate" e period:"Jul-25". Isso torna a consulta e a revisão de tipos específicos de ajustes muito fáceis.

  • Execute uma verificação prévia. Antes de confirmar suas alterações no Git, execute bean-check no seu arquivo de ajustes para detectar erros de digitação ou lançamentos desbalanceados.

  • Execute uma verificação de sanidade de uma linha. Esta consulta confirma que todos os seus ajustes para o período se equilibram, dando-lhe confiança de que você não introduziu erros.

    bean-query main.bean "SELECT account, SUM(number) WHERE meta('adj') AND meta('period') = 'Jul-25' GROUP BY account"

Dicas Rápidas para Solução de Problemas 🤔

  • Seu saldo de Liabilities:UnearnedRevenue está subindo? Revise os marcos do seu contrato. Você pode estar reconhecendo a receita muito lentamente em comparação com o trabalho que está entregando.

  • Seu saldo de Assets:PrepaidInsurance está negativo? Você provavelmente está gastando mais rápido do que o cronograma do ativo permite. Verifique novamente seu cronograma de amortização.

  • Seus Dias de Vendas em Aberto (DSO) estão piorando após os acréscimos? Sua receita acumulada pode estar mascarando problemas subjacentes de cobrança. Combine este KPI com um relatório de envelhecimento de contas a receber para identificar clientes com pagamentos atrasados antes que se torne um problema de fluxo de caixa.


Considerações Finais

Os lançamentos de ajustes podem parecer tediosos, mas seu valor se torna cristalino quando você compara suas demonstrações de resultados "antes" e "depois" — a diferença costuma ser material. Com o Beancount, esses ajustes se tornam pequenos patches pesquisáveis que você pode automatizar e revisar como código.

Crie o hábito de fim de mês e seus números permanecerão tão precisos quanto sua engenharia.

Feliz balanceamento!