Pular para o conteúdo principal

3 postagens marcado com "relatórios financeiros"

Ver todas as tags

Despesas Acumuladas no Beancount: Um Guia Prático (com exemplos de ledger copy-paste)

· 8 min de leitura
Mike Thrift
Mike Thrift
Marketing Manager

Despesas acumuladas parecem abstratas até que os fechamentos de fim de mês comecem a se acumular. Elas são um alicerce da contabilidade de competência correta, garantindo que seus relatórios financeiros reflitam a realidade econômica, não apenas quando o dinheiro troca de mãos. Aqui está um passo‑a‑passo claro, focado no Beancount, do que são, por que importam e exatamente como lançá‑las, revertê‑las e relatá‑las no seu ledger de texto simples.

TL;DR ⚡

  • Despesas acumuladas são custos que você incorreu neste período, mas ainda não pagou. Elas são registradas como passivo até que o dinheiro saia.
  • No Beancount, isso é simples: você debita uma conta Expenses: e credita uma conta Liabilities:Accrued:. Depois, limpa o passivo quando paga.
  • Para relatar, você pode ver o que deve em uma data específica executando um bean-query com CLOSE ON e CLEAR para obter um instantâneo limpo do balanço patrimonial.

2025-08-24-accrued-expenses-in-beancount-a-practical-guide

O que é uma Despesa Acumulada?

Uma despesa acumulada é um custo que a empresa já incorreu, mas ainda não pagou. Ela é registrada quando o serviço é recebido ou o custo é incorrido, mesmo que a fatura ainda não tenha chegado ou o pagamento ainda não seja devido. Essa prática segue o princípio da competência da contabilidade de competência, que determina que as despesas devem ser registradas no mesmo período das receitas que ajudaram a gerar.

Exemplos comuns incluem:

  • Salários de funcionários ao final de um mês, mas pagos no próximo.
  • Utilidades (energia, água) usadas em dezembro, mas que só serão faturadas em janeiro.
  • Juros de um empréstimo que se acumularam ao longo do mês, mas ainda não foram retirados da sua conta.

Ao registrar esses custos quando ocorrem, você obtém uma imagem muito mais fiel do desempenho financeiro da sua empresa naquele período.

Como o Beancount Enxerga Isso (em 30 segundos)

Beancount é um sistema de contabilidade de texto simples e de partida dobrada. Tudo é uma diretiva ou transação datada em um arquivo de texto. O sistema se baseia em cinco tipos de contas principais: Assets, Liabilities, Equity, Income e Expenses.

As entradas são sempre ordenadas por data. Um detalhe importante é que as asserções balance são verificadas antes das transações do mesmo dia serem processadas. Isso é crucial ao colocar verificações e lançamentos de reversão.

Por fim, a linguagem bean-query oferece uma forma poderosa, semelhante ao SQL, de gerar relatórios. Com operadores como OPEN ON, CLOSE ON e CLEAR, você pode criar visualizações precisas “as‑of” para demonstrações financeiras.

Seu Plano de Contas (Sugestão)

Um plano de contas limpo e hierárquico é seu melhor amigo. Para despesas acumuladas, a estrutura é direta. Você precisará de:

  • Uma conta de despesa: por exemplo, Expenses:Utilities, Expenses:Payroll:Wages
  • Uma conta de passivo correspondente: por exemplo, Liabilities:Accrued:Utilities, Liabilities:Accrued:Payroll
  • Sua conta de caixa: por exemplo, Assets:Bank:Checking

Beancount impõe os cinco tipos de conta de nível superior. Manter os nomes das contas organizados facilita consultas e relatórios futuros.

O Padrão Central (Sem Plugin, Sem Mágica)

Esta é a forma mais direta de lidar com acumulações no Beancount. Envolve duas etapas: acumular a despesa no fim do mês e limpar o passivo quando pagar.

Etapa 1: Acumular a Despesa no Fim do Mês

No último dia do período, registre a despesa e crie o passivo.

2025-02-28 * "Acumular eletricidade de fevereiro" #accrual
Expenses:Utilities 120.00 USD
Liabilities:Accrued:Utilities

Etapa 2: Limpar a Acumulação Quando Pagar

Quando a conta chega e você paga, não toca novamente a conta de despesa. Em vez disso, debita a conta de passivo para zerá‑la.

2025-03-05 * "Pagar eletricidade de fev – City Power"
Liabilities:Accrued:Utilities 120.00 USD
Assets:Bank:Checking

Esta é a abordagem mais limpa para equipes pequenas. Ela coloca a despesa corretamente em fevereiro e garante que você não a contabilize duas vezes em março. Observe que, no Beancount, deixar um valor em branco permite que o sistema balanceie a transação automaticamente.

Alternativa: Lançamento de Reversão no Dia 1

Se você prefere o estilo clássico de “auto‑reversão”, pode postar o oposto do lançamento de acumulação no primeiro dia do mês seguinte. Depois, registra a fatura real do fornecedor na conta de despesa como de costume.

Etapa 1: Acumular no Fim do Mês (igual ao anterior)

2025-02-28 * "Acumular eletricidade de fevereiro" #accrual
Expenses:Utilities 120.00 USD
Liabilities:Accrued:Utilities

Etapa 2: Reverter no Primeiro Dia do Mês Seguinte

2025-03-01 * "Reverter acumulação de eletricidade de fev" #reversal
Liabilities:Accrued:Utilities 120.00 USD
Expenses:Utilities

Etapa 3: Registrar o Pagamento Normalmente

2025-03-05 * "City Power – fatura de fevereiro"
Expenses:Utilities 120.00 USD
Assets:Bank:Checking

Atenção às verificações: Lembre‑se de que as asserções balance são avaliadas antes das transações do mesmo dia. Se quiser conferir o saldo da conta Liabilities:Accrued:Utilities, coloque a asserção em 2025-02-28 para confirmar a acumulação ou em 2025-03-01 depois da reversão para confirmar que está zero. Colocá‑la antes da reversão em 2025-03-01 causará uma falha falsa.

Seis Acumulações Comuns (Padrões Copy‑Paste) 📋

Aqui estão alguns exemplos prontos para uso das acumulações mais frequentes em negócios.

1. Aluguel Ainda Não Faturado

2025-01-31 * "Acumular aluguel de janeiro" #accrual
Expenses:Rent 3000.00 USD
Liabilities:Accrued:Rent

2. Salários Ganhos mas Não Pagos

2025-03-31 * "Acumular salários de março" #accrual
Expenses:Payroll:Wages 8500.00 USD
Liabilities:Accrued:Payroll

3. Pagamento de Férias (PTO) Ganho

2025-03-31 * "Acumular PTO ganho em março" #accrual
Expenses:Payroll:PTO 900.00 USD
Liabilities:Accrued:Payroll

4. Juros Acumulados sobre um Empréstimo

2025-02-29 * "Acumular juros mensais do empréstimo" #accrual
Expenses:Interest 210.00 USD
Liabilities:Accrued:Interest

5. Honorários Profissionais (Auditoria/Legal)

2025-12-31 * "Acumular honorários de auditoria de fim de ano" #accrual
Expenses:Professional:Audit 4200.00 USD
Liabilities:Accrued:Professional

6. Utilidades Usadas mas Não Faturadas

2025-04-30 * "Acumular utilidades de abril" #accrual
Expenses:Utilities 95.00 USD
Liabilities:Accrued:Utilities

Relatórios: “O que devo em determinada data?”

bean-query é sua ferramenta para obter respostas. Veja como obter um instantâneo adequado do balanço patrimonial das suas despesas acumuladas.

Obter Todos os Saldo de Passivos Acumulados no Final do Período

Esta consulta devolve o saldo de cada conta de passivo acumulado em 31 de março de 2025.

bean-query main.beancount '
SELECT account, UNITS(SUM(position)) AS balance
FROM OPEN ON 2025-01-01 CLOSE ON 2025-04-01 CLEAR
WHERE account "^Liabilities:Accrued"
GROUP BY 1
ORDER BY 1;
'
  • OPEN ON define os saldos iniciais no início do período.
  • CLOSE ON trunca as transações antes desta data (é exclusivo). Por isso usamos 2025-04-01 para obter dados até e incluindo 2025-03-31.
  • CLEAR zera Receitas e Despesas, proporcionando uma visão limpa do balanço (Ativos, Passivos, Patrimônio Líquido).

Ver um Registro de Todos os Lançamentos de Acumulação

Se quiser ver o histórico bruto das transações nas suas contas de acumulação:

bean-query main.beancount '
SELECT date, payee, narration, position
WHERE account "^Liabilities:Accrued"
ORDER BY date;
'

Obter um Total Único de Todas as Acumulações

Para um resumo rápido do total que você deve:

bean-query main.beancount '
SELECT UNITS(SUM(position)) AS total_accruals
FROM OPEN ON 2025-01-01 CLOSE ON 2025-04-01 CLEAR
WHERE account "^Liabilities:Accrued";
'

Controles & “Pegadinhas” Específicas do Beancount

  • Timing das Asserções de Saldo: Como mencionado, as asserções verificam o saldo no início do dia. 2025-03-01 balance ... roda antes de qualquer transação em 2025-03-01. Planeje‑se adequadamente.
  • Nomeação e Hierarquia: Uma árvore organizada como Liabilities:Accrued:* não serve apenas à estética. Ela simplifica suas consultas e torna seus relatórios instantaneamente compreensíveis.
  • Uso Cauteloso do Pad: A diretiva pad pode corrigir saldos de abertura, mas evite usá‑la para “consertar” acumulações recorrentes. Entradas explícitas garantem trilha de auditoria clara.
  • Relatórios “As‑Of”: Para instantâneos de balanço, prefira sempre OPEN ... CLOSE ... CLEAR no bean-query. Isso impede que contas de receita e despesa contaminem seus totais de passivo.

Pré‑pago vs. Acumulado (Contraste Rápido)

É fácil confundir os dois. Eles são imagens‑espelho:

  • Despesa Acumulada: Serviço consumido agora, dinheiro pago depois. Cria um passivo.
  • Despesa Pré‑paga: Dinheiro pago agora, serviço consumido depois. Cria um ativo.

A lógica contábil é a mesma no Beancount; apenas as contas mudam (Assets:Prepaid:* vs. Liabilities:Accrued:*).

Modelo Pronto (Início do Arquivo)

Aqui estão as diretivas open que você precisará para os exemplos usados neste post. Adicione‑as ao topo do seu arquivo de ledger uma única vez.

; --- Accounts (open once) ---
2025-01-01 open Assets:Bank:Checking
2025-01-01 open Expenses:Utilities
2025-01-01 open Expenses:Payroll:Wages
2025-01-01 open Expenses:Interest
2025-01-01 open Expenses:Professional:Audit
2025-01-01 open Liabilities:Accrued:Utilities
2025-01-01 open Liabilities:Accrued:Payroll
2025-01-01 open Liabilities:Accrued:Interest
2025-01-01 open Liabilities:Accrued:Professional

Notas Finais

Se você mantém seus livros em caixa, não lançará acumulações — as despesas são registradas apenas quando pagas. Se operar em competência, usar os padrões acima é essencial para combinar custos ao período em que o serviço foi consumido.

Os exemplos aqui fornecem orientação educativa geral. Consulte sempre seu contador para tratamentos específicos de setor, especialmente em relação a bônus, impostos sobre folha de pagamento e limites de capitalização.

O Livro-Razão Verde: Rastreando ESG com Beancount

· 7 min de leitura
Mike Thrift
Mike Thrift
Marketing Manager

No mundo de hoje, as métricas de Ambiental, Social e Governança (ESG) não são mais apenas chavões; são indicadores essenciais da saúde e viabilidade futura de uma empresa. Mas como integrar esses insights cruciais de sustentabilidade com a contabilidade financeira tradicional? Apresentamos o Beancount, um livro-razão de contabilidade de dupla entrada em texto simples e de código aberto que oferece uma solução surpreendentemente poderosa e flexível para preencher essa lacuna.

Imagine transformar sua relatoria de sustentabilidade fragmentada em um sistema otimizado e automatizado que rastreia tudo, desde emissões de carbono até a diversidade de fornecedores, tudo dentro do seu fluxo de trabalho financeiro existente. O Beancount torna isso possível ao tratar os dados ESG como "cidadãos de primeira classe ao lado das transações financeiras".

2025-06-22-esg-tracking

Modelagem de Dados ESG: O Jeito Beancount

A flexibilidade inerente do Beancount é seu superpoder quando se trata de ESG. Em vez de planilhas isoladas, você pode incorporar métricas de sustentabilidade diretamente em sua estrutura financeira usando algumas técnicas-chave:

  • Contas Dedicadas e Commodities: Pense na sua pegada ambiental como outra moeda. Você pode criar contas como Metrics:Emissions:CO2e para rastrear emissões de carbono. Essas emissões podem até ser tratadas como uma commodity (por exemplo, uma unidade de CO2 equivalente, tCO2e), permitindo que você registre quantidades específicas em suas transações. Por exemplo, a compra de um voo poderia creditar uma conta Emissions:CO2e com +0.3 tCO2e juntamente com o custo monetário.
  • Tags de Metadados Personalizadas: Os metadados chave-valor do Beancount são perfeitos para adicionar contexto. Você pode marcar uma transação com CO2e: 0.3 t ou Scope: 3 para indicar seu impacto de carbono ou escopo do Protocolo GEE. Isso vincula os gastos financeiros diretamente às suas consequências ambientais, fornecendo uma imagem mais rica e completa.
  • Tags Estruturadas para Categorias: Alinhar-se com padrões como o Protocolo de Gases de Efeito Estufa (GHGP) é crucial. Você pode usar tags consistentes ou convenções de nomenclatura de contas, como Metrics:Emissions:Scope1, Metrics:Emissions:Scope2 e Metrics:Emissions:Scope3 para categorizar e relatar facilmente as emissões diretas, relacionadas à energia e da cadeia de valor.

Essa abordagem adaptável significa que, à medida que os padrões ESG evoluem, você pode ajustar a estrutura do seu livro-razão sem uma reformulação completa.


Beancount vs. Ferramentas ESG Especializadas: Uma Escolha Estratégica

Enquanto plataformas ESG dedicadas como Persefoni ou SAP Green Ledger oferecem soluções altamente automatizadas e construídas para um propósito específico, o Beancount apresenta uma alternativa atraente, particularmente para aqueles que buscam transparência e controle.

RecursoBeancount (Texto Simples)SaaS Especializado (por exemplo, Persefoni, Plan A)Integração ERP Empresarial (por exemplo, SAP Green Ledger)
Modelagem de DadosContas e metadados definidos pelo usuário; flexível, mas requer estruturação manual.Esquemas pré-definidos; entrada guiada para atividades e conversão automatizada para emissões.Emissões mapeadas diretamente para transações ERP e dados mestres.
Fatores de EmissãoFornecidos pelo usuário ou integrados via scripts personalizados; requer atualizações manuais.Bibliotecas de fatores de emissão integradas e atualizadas regularmente; cálculos automáticos.Integrado com dados corporativos e fatores padrão para precisão de nível de auditoria.
Integração de DadosArquitetura aberta via scripts Python/APIs personalizados; requer desenvolvimento para importações automatizadas.Muitos conectores pré-construídos para fontes de dados externas (serviços públicos, ERPs, sistemas de viagem).Integração nativa com processos de negócios centrais e fluxos de dados dentro do ERP.
Relatórios e AuditoriaConsultas personalizadas e relatórios Fava; altamente personalizável, mas requer design do usuário. Controle de versão (Git) para trilha de auditoria transparente.Dashboards ricos, relatórios pré-construídos para padrões (GEE, TCFD, CDP). Logs de auditoria na plataforma e bloqueio de período.Relatórios integrados dentro do ERP; projetado para dados auditáveis de "garantia razoável".
Custo e AcessibilidadeGratuito e de código aberto; requer conhecimento de Beancount/scripting.SaaS comercial com custos de assinatura; menor sobrecarga técnica.Software empresarial com custos de licenciamento e implementação potencialmente altos; requer expertise específica em ERP.

Beancount é uma potência DIY: Ele oferece flexibilidade e transparência incomparáveis, tornando-o ideal para indivíduos ou pequenas organizações tecnicamente experientes. Você possui seus dados completamente, evitando a dependência de fornecedor.

Ferramentas especializadas oferecem soluções prontas para uso: Elas se destacam na coleta automatizada de dados, bancos de dados de fatores de emissão integrados e relatórios de conformidade prontos, muitas vezes com um custo mais alto e menos flexibilidade.

Uma abordagem híbrida também é viável: use o Beancount para rastreamento interno detalhado e reconciliação, e então exporte dados resumidos para uma plataforma externa para relatórios de alto nível para as partes interessadas.


Aplicações no Mundo Real: ESG em Ação com Beancount

A versatilidade do Beancount o torna adequado para vários casos de uso chave de ESG:

  • Rastreamento de Emissões de Escopo 3: As emissões mais desafiadoras de rastrear (da sua cadeia de valor) podem ser integradas ao vincular dados de emissões de fornecedores a transações de compra. O Beancount fornece uma trilha de auditoria clara para esses números complexos, permitindo uma melhor análise e a identificação precisa das fontes de dados.
  • Auditorias e Asseguração de Sustentabilidade: Assim como os dados financeiros, os números de ESG precisam ser verificáveis. O Beancount permite vincular cada entrada de ESG a documentos-fonte (por exemplo, contas de serviços públicos, declarações de verificação de terceiros), fornecendo uma trilha de auditoria meticulosa para transparência e asseguração.
  • Relatórios de Conformidade com EU CSRD/ESRS: Para empresas que enfrentam regulamentações rigorosas como a CSRD, o Beancount pode servir como um repositório central para divulgações quantitativas. Embora não formate automaticamente relatórios em XBRL, ele fornece os dados granulares e auditáveis necessários para gerar números prontos para conformidade.
  • Análise de Pegada de Carbono e Contabilidade Gerencial: Trate o carbono como outra dimensão da contabilidade gerencial. Ao alocar emissões a centros de lucro ou códigos de produto, você pode calcular métricas como "emissões por dólar de receita" e identificar pontos críticos de carbono, impulsionando decisões de sustentabilidade mais informadas.

Melhores Práticas para o Seu Razão Contábil ESG do Beancount

Para maximizar a eficácia do Beancount para ESG, considere estas melhores práticas:

  1. Crie um Plano de Contas Claro para ESG: Estruture suas contas ESG de forma cuidadosa (por exemplo, Metrics:Emissions:Scope1:Fuel), assim como suas contas financeiras.
  2. Use Metadados Consistentemente: Aproveite as tags (por exemplo, Scope: 3, FactorSource: EPA2024) para um contexto consistente e consultas mais fáceis.
  3. Equilibre Granularidade com Gerenciabilidade: Concentre-se em métricas materiais para evitar sobrecarregar seu razão contábil com detalhes desnecessários.
  4. Automatize com Cautela: Use scripts Python para importação e validação de dados, mas garanta uma verificação de erros robusta e documentação clara de seus processos de automação.
  5. Aproveite o Controle de Versão: Use Git para rastrear cada alteração em seu razão contábil, fornecendo um histórico transparente e auditável de seus dados ESG.
  6. Conecte-se a Documentos e Evidências: Vincule arquivos de origem (por exemplo, PDFs de contas de serviços públicos) a lançamentos contábeis para fácil verificação durante auditorias.
  7. Utilize Fava para Insights: Configure Fava para exibir gráficos e relatórios ESG personalizados, tornando seus dados de sustentabilidade acionáveis e acessíveis a partes interessadas não técnicas.
  8. Mantenha-se Atualizado sobre os Padrões: A relatoria ESG é dinâmica; esteja preparado para adaptar sua estrutura Beancount à medida que novas regulamentações e estruturas surgirem.

O Futuro é Verde, e em Texto Simples

Embora o Beancount atualmente não possua inteligência ESG nativa ou relatórios plug-and-play, sua natureza de código aberto apresenta imensas oportunidades de aprimoramento. Plugins impulsionados pela comunidade para contabilidade de carbono, modelos padronizados de razão ESG e uma melhor integração com APIs de fatores de emissão poderiam impulsionar significativamente suas capacidades.

À medida que o mundo corporativo adota cada vez mais "razões verdes", o Beancount está pronto como uma solução flexível, transparente e auditável. Ao integrar dados ESG com o mesmo rigor que os dados financeiros, o Beancount capacita as organizações a não apenas atender às demandas de conformidade, mas também a impulsionar iniciativas de sustentabilidade significativas.

Você está pronto para trazer seus dados ESG para a revolução do texto simples?

Aprimorando Sua Experiência Beancount com Links e Consultas Personalizadas

· 4 min de leitura
Mike Thrift
Mike Thrift
Marketing Manager

Beancount, o sistema de contabilidade de dupla entrada amado por desenvolvedores e entusiastas de finanças, é poderoso em sua simplicidade. Mas para aqueles que desejam mais controle e navegação mais rápida dentro do Fava, a interface web do Beancount, links personalizados na barra lateral e consultas SQL podem levar seu fluxo de trabalho para o próximo nível.

Neste guia, mostraremos como:

  • Adicionar links de acesso rápido à barra lateral do Fava
  • Usar consultas SQL para filtragem e análise avançadas
  • Personalizar seu fluxo de trabalho para revisões mensais ou detecção de anomalias

Por que Personalizar o Fava?

O Fava já é uma interface bonita para visualizar seu livro-razão Beancount, mas à medida que seu diário cresce, também cresce a necessidade de atalhos melhores e consultas mais inteligentes.

Problemas que isso resolve:

  • Navegar por intervalos de tempo repetidamente
  • Filtrar transações em contas aninhadas
  • Identificar saldos negativos ou anomalias mais rapidamente

Vamos começar a melhorar seu fluxo de trabalho diário com atalhos simples na barra lateral. Esses links aparecem na barra lateral esquerda do Fava e podem levá-lo diretamente a visualizações filtradas, como as transações deste mês ou a receita do mês passado.

Adicione estas linhas ao seu arquivo Beancount:

2021-01-01 custom "fava-sidebar-link" "Current Month" "/jump?time=month"
2021-01-01 custom "fava-sidebar-link" "Last Month" "/jump?time=month-1"
2021-01-01 custom "fava-sidebar-link" "Clear All" "/jump?account=&time=&filter="

O que Eles Fazem:

  • Mês Atual: Abre a visualização de transações filtrada para o mês atual.
  • Mês Passado: Salta instantaneamente para o mês anterior — ótimo para revisões de fim de mês.
  • Limpar Tudo: Reinicia os filtros, mostrando todas as entradas novamente.

Esses atalhos eliminam a entrada manual de tempo e tornam sua experiência com o Fava mais fluida e personalizada.

🔍 Consultas SQL Personalizadas

Para uma visão mais aprofundada, a interface SQL do Fava é incrivelmente poderosa. Aqui está uma consulta que encontra todos os saldos negativos em contas que correspondem a um padrão — perfeita para sinalizar transações incomuns ou problemáticas.

SELECT account, units(sum(position)), sum(position)
WHERE number(units(position)) < 0
AND account ~ '.*:BCM:.*'
AND date >= DATE(2021,12,9)
AND date < DATE(2022,1,9)

Análise:

  • account ~ '.*:BCM:.*': Filtra contas que contêm :BCM: em seu nome.
  • number(units(position)) < 0: Sinaliza saldos negativos (por exemplo, orçamentos excedidos).
  • Filtros de data restringem o resultado a uma janela específica de 1 mês.

Casos de uso:

  • Identificar erros como despesas duplicadas ou lançamentos incorretos
  • Auditar um fornecedor ou categoria específica
  • Extrair rapidamente insights acionáveis para orçamentação

Embora o Fava não permita links diretos para consultas personalizadas, você pode criar um hábito de revisão mensal ao:

  • Usar o link “Mês Atual” para iniciar sua revisão
  • Abrir sua aba de consultas salvas em outro painel
  • Revisar ambos simultaneamente — filtre primeiro, depois aprofunde-se

Essa combinação ajuda você a detectar anomalias antes que elas se agravem e a garantir que seu livro-razão permaneça limpo.

Considerações Finais

Beancount é minimalista por design, mas pequenas melhorias como estas trazem grandes ganhos de eficiência. Esteja você revisando seu orçamento, depurando saldos estranhos ou simplesmente economizando cliques, links personalizados e consultas SQL lhe dão mais poder e menos atrito.

Bônus: Se você estiver usando os relatórios personalizados do Fava, você pode até construir painéis completos adaptados aos seus rituais de finanças pessoais.

Pronto para assumir o controle?

Comece pequeno: adicione o link “Mês Atual”. Em seguida, crie suas próprias consultas. Seu eu futuro agradecerá.

Quer mais dicas como esta? Assine nossa newsletter ou explore mais receitas Beancount em Beancount.io.