59 postagens marcado com "Beancount"

A amortização distribui os pagamentos em muitas parcelas ao longo do tempo. No beancount.io, você pode usar o plugin fava.plugins.amortize_over para conseguir isso.

Sem amortização, se você quiser segurar seu carro por 6 meses com um custo de US$ 600. Você teria que registrar isso como uma despesa única para uma data específica.

2017-06-01 open Assets:Bank:Checking
2017-06-01 open Assets:Prepaid-Expenses
2017-06-01 open Expenses:Insurance:Auto


2017-06-01 * "Pay car insurance"
    Assets:Bank:Checking       -600.00 USD
    Assets:Prepaid-Expenses

No entanto, com a amortização, você poderia alocar a despesa ao longo de seis meses colocando plugin "fava.plugins.amortize_over" no início do arquivo e usando amortize_months: 6 para a transação.

plugin "fava.plugins.amortize_over"

2020-06-01 open Assets:Bank:Checking
2020-06-01 open Assets:Prepaid-Expenses
2020-06-01 open Expenses:Insurance:Auto

2020-06-01 * "Amortize car insurance over six months"
    amortize_months: 6
    Assets:Prepaid-Expenses       -600.00 USD
    Expenses:Insurance:Auto

E então, no Diário, você verá que a transação é dividida em 6 lançamentos.

2020-11-01 * Amortize car insurance over six months (6/6) am
2020-10-01 * Amortize car insurance over six months (5/6) am
2020-09-01 * Amortize car insurance over six months (4/6) am
2020-08-01 * Amortize car insurance over six months (3/6) am
2020-07-01 * Amortize car insurance over six months (2/6) am
2020-06-01 * Amortize car insurance over six months (1/6) am

Manter um serviço online seguro e performático nunca é uma tarefa única. Requer esforço não apenas para desenvolver novos recursos, mas também para renovar funcionalidades existentes.

Software desatualizado coloca nossos clientes em risco de vulnerabilidades de segurança. Como reduzimos esse risco? Por um lado, trabalhamos proativamente com pesquisadores de segurança para encontrar e resolver problemas inesperados. Por outro lado, mesclamos periodicamente a versão mais recente do software upstream.

Hoje, temos o prazer de compartilhar algumas melhorias que fizemos para aprimorar o Beancount.io.

1. Atualizamos o servidor e aceleramos o serviço em até 30%. A disponibilidade do serviço também foi significativamente melhorada.
2. Atualizamos o software de código aberto Fava, licenciado pelo MIT, para a versão 1.17. Ele corrigiu vários bugs e adicionou muitos novos recursos.

Animado? Experimente agora em https://beancount.io/ledger/

Tem perguntas? Estaremos lá para você em https://t.me/beancount :)

Beancount.io tem o prazer de anunciar o novíssimo programa de recompensas para desenvolvedores em nossa comunidade! Um programa de Recompensa por Bugs de Segurança (Security Bug Bounty) é uma oferta aberta a indivíduos externos para receberem compensação por relatar bugs em beancount.io e no Beancount mobile de código aberto relacionados à segurança da funcionalidade principal.

Nenhuma tecnologia é perfeita, e acreditamos que trabalhar com desenvolvedores, engenheiros e tecnólogos em todo o mundo é crucial para identificar fraquezas em nosso projeto durante o desenvolvimento. Se você acredita ter encontrado um problema de segurança em nosso produto ou serviço, nós o encorajamos a nos notificar. Teremos prazer em trabalhar com você para resolver o problema prontamente.

Período da Campanha​

2020-10-15 17:00 PST a 2020-11-30 17:00 PST

Escopo​

Os seguintes componentes do Beancount estão incluídos na 1ª Etapa da Campanha de Recompensa por Bugs:

1. beancount.io/ledger : Seu gerenciador de finanças pessoais.
2. Beancount mobile de código aberto

Passos para participar e relatar bugs​

• Se NÃO estiver relacionado a informações de identificação pessoal (PII) e dados exatos do livro-razão (ledger). Forneça informações sobre os bugs através da solicitação de ISSUE no GitHub em https://github.com/puncsky/beancount-mobile/issues/:
  • Ativo. Escolha o repositório ao qual o bug está relacionado e crie uma “Nova Issue” nele.
  • Gravidade. Escolha o nível de vulnerabilidade de acordo com “Vulnerabilidades Qualificadas”.
  • Resumo — Adicione um resumo do bug.
  • Descrição — Quaisquer detalhes adicionais sobre este bug.
  • Passos — Passos para reproduzir.
  • Material de Apoio/Referências — Código-fonte para replicar, liste qualquer material adicional (por exemplo, capturas de tela, logs, etc.).
  • Impacto — Qual o impacto do bug encontrado, o que um atacante poderia conseguir?
  • Seu nome, país e ID do Telegram para contato.
• Se estiver relacionado a PII e dados exatos do livro-razão (ledger), entre em contato com puncsky no Telegram e envie as informações acima.
• A equipe Beancount.io revisará todos os bugs e fornecerá feedback o mais rápido possível através dos comentários na página com um bug específico ou via Telegram pessoalmente, se estiver relacionado a PII e dados exatos do livro-razão (ledger).
• A distribuição das recompensas será realizada em Presente Físico, Cartão Presente ou equivalente em USDT após o término da campanha, por volta de 01 de dezembro de 2020 PST.

Vulnerabilidades qualificadas​

Para se qualificar para a recompensa, o bug de segurança deve ser original e não relatado anteriormente.

Apenas os seguintes problemas de design ou implementação que afetam substancialmente a estabilidade ou segurança do Beancount.io são qualificados para a recompensa. Exemplos comuns incluem:

• Vazamento de PII e dados do livro-razão (ledger) enquanto a máquina host não está comprometida.
• Uma ação especial que faz com que todo o site ou aplicativo móvel seja suspenso ou trave.
• Um usuário impacta outro usuário sem concessão de acesso prévia.

Para cenários que não se enquadram em uma das categorias acima, ainda agradecemos os relatórios que nos ajudam a proteger nossa infraestrutura e nossos usuários e recompensamos esses relatórios em uma base caso a caso.

Vulnerabilidades Fora do Escopo​

Ao relatar vulnerabilidades, considere o cenário de ataque, a explorabilidade e o impacto de segurança do bug. Os seguintes problemas são considerados fora do escopo, e NÃO aceitaremos nenhum dos seguintes tipos de ataques:

• Ataques de negação de serviço (DoS)
• Ataques de phishing
• Ataques de engenharia social
• Download de arquivo refletido
• Divulgação de versão de software
• Problemas que exigem acesso físico direto
• Problemas que exigem interação do usuário extremamente improvável
• Falhas que afetam navegadores e plugins desatualizados
• Painéis de login publicamente acessíveis
• Injeção de CSV
• Enumeração de e-mail / oráculos de conta
• Fraquezas de CSP
• Falsificação de e-mail (Email Spoofing)
• Técnicas que permitem visualizar fotos de perfil de usuário (estas são consideradas públicas)

Recompensas​

O prêmio para o bug mais crítico que expõe PII e dados do livro-razão (ledger) é um AirPods Pro (nos EUA) ou equivalente em USDT.

O prêmio para um bug de segurança é um Cartão Presente Amazon de $20 ou equivalente em USDT.

Somos uma equipe pequena com um orçamento limitado e pudemos distribuir apenas

• 1 AirPods Pro para todos.
• 10 recompensas de $20 por mês, por até 3 meses. Se o número de casos reais exceder esse valor em um mês, enviaremos a recompensa restante no mês seguinte. ($600 no total para esta campanha)

Tem perguntas?​

Pergunte-nos em https://t.me/beancount

A privacidade é essencial para o nosso DNA, nossa cultura e nossos valores. Estamos comprometidos em proteger seus dados em todos os nossos sistemas.

E hoje, temos o prazer de abrir o código do Beancount mobile. Isso significa que o código está disponível publicamente, sendo escrutinado por pessoas. Esse nível de transparência garante tanto a segurança do aplicativo quanto a sua tranquilidade em relação ao que fazemos com seus dados.

O código aberto oferece aos nossos clientes mais escolhas no mercado e melhores soluções de várias maneiras. Construímos o Beancount.io sobre excelentes projetos de código aberto e esperamos abrir o código do maior número possível de módulos do nosso sistema no futuro. E o Beancount mobile é apenas o começo desta jornada :)

Temos o prazer de anunciar a versão 0.4.0 do aplicativo Beancount, que traz novos recursos e melhorias para aprimorar sua experiência de gestão financeira.

O Que Há de Novo​

📧 Assinatura de Relatórios por E-mail​

Mantenha-se atualizado sobre suas finanças com relatórios por e-mail personalizáveis. Escolha quais informações financeiras você deseja receber e com que frequência. Perfeito para:

• Revisões mensais de orçamento
• Resumos semanais de gastos
• Atualizações de saldo de conta

📢 Seção de Anúncios​

Nunca perca atualizações importantes! Nossa nova seção de anúncios mantém você informado sobre:

• Últimos recursos e melhorias
• Dicas para um melhor rastreamento financeiro
• Notícias e eventos da comunidade

Melhorias de Desempenho​

Como sempre, tornamos o aplicativo mais rápido e confiável, garantindo uma experiência fluida enquanto você gerencia suas finanças.

Compartilhe Suas Ideias​

Seu feedback impulsiona nosso desenvolvimento. Adora os novos recursos? Avalie-nos nas lojas de aplicativos e ajude a moldar o futuro do Beancount!

Precisa de Ajuda?​

Junte-se à nossa comunidade no Telegram para suporte, dicas e discussões sobre gestão de finanças pessoais com Beancount.

Temos o prazer de anunciar um marco importante na evolução do Beancount: o lançamento de nossos aplicativos móveis dedicados para as plataformas iOS e Android! Este lançamento atende diretamente a uma das solicitações mais frequentes de nossa comunidade – a capacidade de gerenciar seu livro-razão de forma eficiente em dispositivos móveis.

Principais Recursos​

• Entrada Rápida de Transações: Adicione novas transações de forma contínua em movimento
• Relatórios Financeiros Móveis: Acesse suas informações financeiras em qualquer lugar, a qualquer hora
• Edição Direta do Livro-Razão: Acesso total ao seu arquivo de livro-razão através de uma visualização web otimizada
• Sincronização Multiplataforma: Mantenha seus dados financeiros consistentes em todos os seus dispositivos

Desenvolvimento Impulsionado pela Comunidade​

Este lançamento marca apenas o início de nossa jornada móvel. Estamos comprometidos em evoluir esses aplicativos com base em suas necessidades e feedback. Junte-se à nossa vibrante comunidade no Telegram em https://t.me/beancount para discutir o Beancount, compartilhar sua experiência e ajudar a moldar recursos futuros.

Nossa Visão​

No Beancount, nossa missão é capacitar a todos para alcançar um melhor controle e compreensão financeira. Esses aplicativos móveis representam um passo significativo em direção a esse objetivo, com muitos outros recursos e ferramentas em nosso roteiro.

De todos os números que descrevem um negócio, um se destaca acima dos demais: o lucro líquido. É a medida definitiva de rentabilidade, o famoso "resultado final". Mas o que isso realmente significa e como você pode acompanhá-lo com precisão usando um sistema de contabilidade em texto simples como o Beancount?

Vamos analisar.

O Que o Lucro Líquido Realmente Significa​

Em sua essência, o lucro líquido é o dinheiro que sobra depois que você pagou absolutamente tudo o que é necessário para administrar o seu negócio. Isso inclui o custo das mercadorias vendidas (CMV), todas as despesas operacionais, juros sobre dívidas e impostos.

É o indicador mais claro da saúde financeira de uma empresa. É um número crítico para todos:

• Credores o analisam para avaliar sua capacidade de pagar empréstimos.
• Investidores o veem como a fonte de potenciais dividendos ou o capital disponível para crescimento.
• Fundadores dependem dele para entender sua pista financeira e fazer planos estratégicos de reinvestimento.

Um lucro líquido positivo significa que você é lucrativo. Um negativo significa que você está perdendo dinheiro. É simples assim.

A Fórmula Principal (Escolha o Nível de Detalhe Que Você Precisa)​

Você pode calcular o lucro líquido com vários graus de granularidade. A escolha depende de quão detalhada é a análise que você precisa.

• Fórmula Completa: Receita – CMV – Despesas Operacionais – Juros – Impostos = Lucro Líquido
• Fórmula Padrão: Receita – CMV – Despesas = Lucro Líquido
• Fórmula Rápida e Simples: Receitas Totais – Despesas Totais = Lucro Líquido

Uma Dica Rápida Sobre Custos: Qual é a diferença entre CMV e despesas operacionais? CMV (Custo das Mercadorias Vendidas) cobre os custos diretos vinculados à produção de seus bens ou serviços (por exemplo, matérias-primas, mão de obra direta). Despesas Operacionais cobrem todo o resto que mantém as coisas funcionando — salários, aluguel, assinaturas de software, seguros, etc.

Um Mini Exemplo​

Vamos tornar isso tangível. Imagine que uma pequena empresa de torrefação de café teve os seguintes resultados no mês passado.

Usando a fórmula completa, o cálculo é direto:

$Lucro;Líquido = R$ 60.000 - R$20.000 - R$ 18.000 - R$1.000 - R$ 1.000 = R$20.000$

A empresa gerou um lucro real de R$ 20.000 no mês.

Como Capturá-lo no Beancount​

A estrutura do Beancount é perfeita para isso. Ao organizar suas contas logicamente, calcular o lucro líquido se torna um subproduto automático de uma boa contabilidade.

• Marque toda a receita em uma conta pai Receitas, como Receitas:Vendas ou Receitas:Serviços.
• Divida suas despesas para distinguir entre custos diretos e indiretos. Use Despesas:CMV para custos diretos e subcontas como Despesas:Operacionais:Salários ou Despesas:Operacionais:Software para todo o resto.
• Lance juros e impostos em suas próprias contas (Despesas:Juros, Despesas:Impostos). Isso torna a análise futura, especialmente para a preparação de impostos, muito mais simples.
• Balanceie seus livros regularmente. A equação contábil fundamental, Ativos = Passivos + Patrimônio Líquido, deve sempre ser verdadeira.

No final de um período (por exemplo, um mês), você pode usar asserções balance para confirmar o estado de suas contas. Essas entradas não movimentam dinheiro; elas declaram qual deve ser o saldo e o bean-check relatará um erro se não for.

; 2025-07-31 Torrefação de Café Empreendimentos — Fechamento de julho
2025-07-31 balance Ativos:Banco:Operacional          42000.00 BRL
2025-07-31 balance Despesas:CMV                  20000.00 BRL
2025-07-31 balance Despesas:Operacionais                   18000.00 BRL
2025-07-31 balance Despesas:Juros               1000.00 BRL
2025-07-31 balance Despesas:Impostos                  1000.00 BRL
2025-07-31 balance Receitas:Vendas                  -60000.00 BRL

Consulta de Lucro Líquido em Uma Linha​

É aqui que a mágica acontece. Com um livro-razão bem estruturado, você pode calcular seu lucro líquido para qualquer período com um único comando.

bean-query books.beancount \
"SELECT period, sum(number) WHERE account =~ '^(Receitas|Despesas)' \
  AND year = 2025 GROUP BY month"

Esta consulta soma todos os valores em suas contas de Receitas e Despesas para 2025 e os agrupa por mês. No Beancount, a receita é representada por números negativos e as despesas por números positivos, portanto, o resultado será o negativo do seu lucro líquido.

Melhor ainda, você nem precisa executar esta consulta manualmente. O Fava, a interface web para o Beancount, plotará isso automaticamente para você na visualização Relatórios → Demonstrativo de Resultados.

Insights Rápidos Que Você Pode Automatizar​

Como seu livro-razão é apenas um arquivo de texto, você pode construir fluxos de trabalho automatizados poderosos em torno dele.

• Resumo Mensal por E-mail: Configure um trabalho cron para executar bean-report books.beancount income_statement > lucro-liquido.txt e, em seguida, envie o arquivo de texto resultante por e-mail para você mesmo no primeiro dia de cada mês.
• Alerta de Rentabilidade: Use um gancho de pré-commit do Git que execute uma consulta para verificar a rentabilidade do mês até a data. Você pode programá-lo para recusar o commit se o lucro líquido for negativo, forçando-o a reconhecer um mês de prejuízo.
• Modelagem de Cenários: Deseja testar seu negócio? Basta copiar books.beancount para cenarios/recessao.bean, reduzir suas entradas de Receitas em 20% e executar novamente sua consulta de lucro líquido para ver o impacto instantaneamente.

Principais Conclusões​

• O lucro líquido é o seu verdadeiro resultado final. O objetivo é mantê-lo positivo e entender sua tendência ao longo do tempo.
• O Beancount torna a matemática subjacente explícita, pesquisável e com controle de versão. Não há fórmulas ocultas.
• Com uma estrutura de contas disciplinada e uma única consulta, você sempre saberá se o seu negócio está realmente ganhando dinheiro.

Por Que a Contabilidade Moderna Importa​

Ainda gerencia seus investimentos com planilhas? Embora as planilhas sejam versáteis, elas podem se tornar complicadas e propensas a erros à medida que sua carteira de investimentos cresce. Apresentamos o Beancount.io – uma plataforma de rastreamento de investimentos sofisticada e fácil de usar, projetada especificamente para gerenciar carteiras de ações e criptomoedas. Construído com engenheiros e minimalistas financeiros em mente, o Beancount.io combina recursos poderosos com uma interface intuitiva para otimizar sua experiência de rastreamento de investimentos.

Contabilidade de Partidas Dobradas: A Base da Precisão​

Beancount.io é construído sobre os princípios da contabilidade de partidas dobradas – uma metodologia comprovada pelo tempo, usada por instituições financeiras em todo o mundo. Este sistema garante precisão matemática através de um conceito simples, mas poderoso: cada transação financeira deve equilibrar-se perfeitamente.

Na contabilidade de partidas dobradas, cada transação requer pelo menos duas entradas – um débito (+) e um crédito (-) – em diferentes contas. Este sistema de verificação integrado torna virtualmente impossível registrar transações desequilibradas, garantindo que seus registros financeiros permaneçam precisos e confiáveis.

1970-01-01 open Income:BeancountCorp
1970-01-01 open Assets:Cash
1970-01-01 open Expenses:Food
1970-01-01 open Assets:Receivables:Alice
1970-01-01 open Assets:Receivables:Bob
1970-01-01 open Assets:Receivables:Charlie
1970-01-01 open Liabilities:CreditCard

2019-05-31 * "BeancountCorp" "Salary of May 15th to May 31st"
  Income:BeancountCorp               -888 USD
  Assets:Cash                         888 USD

2019-07-12 * "Popeyes chicken sandwiches" "dinner with Alice, Bob, and Charlie"
  Expenses:Food 20 USD
  Assets:Receivables:Alice 20 USD
  Assets:Receivables:Bob 20 USD
  Assets:Receivables:Charlie 20 USD
  Liabilities:CreditCard -80 USD

Como você pode ver nos dois exemplos acima, toda transação deve satisfazer a equação contábil.

Assets = Liabilities + Equity(aka Net Assets)

Usamos a sintaxe Beancount de Martin Blais e o projeto web Fava de Jakob Schnitzer para construir este site. E ele irá alertá-lo se alguma transação tiver pernas que não somam zero.

Agora você entende como impomos a correção do livro-razão. Mas você pode perguntar o que são essas "contas"?

Compreendendo as Contas: A Analogia do Balde de Água​

Pense em suas contas financeiras como um sistema de baldes de água interconectados, onde o dinheiro flui como água entre eles. Essa analogia torna a contabilidade de partidas dobradas intuitiva: quando você transfere dinheiro de uma conta para outra, é como derramar água de um balde para outro – a quantidade total de água (dinheiro) no sistema permanece constante.

Beancount.io introduz cinco tipos de contas.

1. Receita — Seu valor é sempre negativo ou a débito. Isso ocorre porque você está ganhando dinheiro, e então o dinheiro está debitando da conta de "Receita" e creditando em seus "Ativos".
2. Despesas — Seu valor é sempre positivo ou a crédito. Isso ocorre porque você está gastando dinheiro, e o dinheiro está fluindo dos "Ativos" ou "Passivos" para as "Despesas".
3. Passivos — Seu valor é positivo ou zero. Suas dívidas de cartão de crédito são um bom exemplo, que aumentam e diminuem em ciclos.
4. Ativos — Seu valor é positivo ou zero. Seu dinheiro ou casas sempre valem alguns preços.
5. Patrimônio Líquido — Seus ativos líquidos. O sistema calculará automaticamente para você. Patrimônio Líquido = Ativos - Passivos e reflete o quão rico você é.

Agora você pode abrir suas contas personalizadas com as palavras-chave acima:

1970-01-01 open Assets:Cash
1970-01-01 open Assets:Stock:Robinhood
1970-01-01 open Assets:Crypto:Coinbase
1970-01-01 open Expenses:Transportation:Taxi
1970-01-01 open Equity:OpeningBalance

Rastreamento Avançado de Investimentos com Commodities​

Beancount.io se destaca no rastreamento de investimentos diversos, de ações a criptomoedas. Vamos explorar como ele lida com cenários de investimento complexos. Por exemplo, veja como você registraria a compra de 10 Bitcoins a US$ 100 cada em 2014:

2014-08-08 * "Buy 10 Bitcoin"
  Assets:Trade:Cash -1000.00 USD
  Assets:Trade:Positions  10 BTC {100.00 USD}

E então, três anos depois, você os vende (originalmente com custos de US$100 por unidade anotados com `{100.00 USD}`) ao preço de **US$ 10.000 por unidade** anotado com @ 10,000.00 USD.

2017-12-12 * "Sell 2 Bitcoin"
  Assets:Trade:Positions                   -2 BTC {100.00 USD} @ 10,000.00 USD
  Assets:Trade:Cash                          20,000.00 USD
  Income:Trade:PnL                          -19,800.00 USD

Ou a mesma transação com @@ 20,000.00 USD significa que ao preço de US$ 20.000 no total.

2017-12-12 * "Sell 2 Bitcoin"
  Assets:Trade:Positions                   -2 BTC {100.00 USD} @@ 20,000.00 USD
  Assets:Trade:Cash                          20,000.00 USD
  Income:Trade:PnL                          -19,800.00 USD

A soma de todas as pernas da transação, incluindo -2 BTC {100.00 USD}, ainda é, como sempre, zero.

A etiqueta de custos {100.00 USD} é importante porque você pode ter comprado a mesma commodity a custos diferentes.

100 BTC {10.00 USD, 2012-08-08}
10 BTC {100.00 USD, 2014-08-08}

Se você quiser simplificar o processo, pode configurar a conta no início com FIFO ou LIFO. FIFO significa 'primeiro a entrar, primeiro a sair', enquanto LIFO significa 'último a entrar, primeiro a sair'. Nos EUA, o IRS usa FIFO para calcular seu PnL e impostos de acordo.

1970-01-01 open Assets:Trade:Positions "FIFO"

E então, quando você o vende de forma abreviada como -2 BTC {}, o beancount aplicará a estratégia FIFO automaticamente e venderá a commodity mais antiga.

Começando com Beancount.io​

Beancount.io é uma plataforma moderna de gestão financeira baseada em nuvem que transforma seus registros de transações baseados em texto em demonstrações financeiras abrangentes, incluindo demonstrações de resultados, balanços patrimoniais e balancetes. Ao combinar a confiabilidade de arquivos de texto simples com poderosas ferramentas de visualização, o Beancount.io ajuda você a manter controle preciso sobre sua vida financeira, enquanto obtém insights valiosos sobre o desempenho de seus investimentos.

Comece sua jornada financeira com Beancount.io - Grátis durante nosso período promocional!

Você não pode dirigir um negócio se não sabe para onde o dinheiro vai. Livros precisos transformam suposições em insights. (Investopedia)

Todo empresário, freelancer ou fundador de startup eventualmente enfrenta a mesma realidade: o caos financeiro é um impedimento para o crescimento. Sem uma visão clara do seu fluxo de caixa, você está voando às cegas. Mas e se você pudesse gerenciar suas finanças com a mesma precisão e controle que aplica ao seu código? Apresentamos o Beancount, um sistema de contabilidade poderoso e de código aberto que funciona com arquivos de texto simples.

Este guia irá orientá-lo pelos fundamentos da contabilidade e mostrar como construir um fluxo de trabalho financeiro robusto, leve e transparente usando o Beancount.

O que é Contabilidade?​

Em sua essência, a contabilidade é o registro sistemático e contínuo de todas as transações financeiras que uma empresa realiza. É a disciplina diária de rastrear receitas, despesas, ativos (o que você possui) e passivos (o que você deve).

No mundo do Beancount, esses registros não ficam presos em softwares proprietários. Eles residem em arquivos de texto simples, legíveis por humanos. Essa abordagem permite que você controle a versão do seu histórico financeiro com ferramentas como o Git, assim como faria com um projeto de software. Cada lançamento é regido pela regra de equilíbrio de partidas dobradas, um sistema elegante que verifica automaticamente seu trabalho e garante que seus livros estejam sempre corretos. (beancount)

Por que isso Importa​

A contabilidade meticulosa não se trata apenas de organização administrativa; é uma vantagem estratégica.

• Confiança nos impostos: Quando chega a época do imposto de renda, registros organizados são seu melhor amigo. A Receita Federal exige documentação clara para receitas e deduções. Um livro-razão bem mantido significa que você pode declarar com confiança e encurtar drasticamente quaisquer possíveis auditorias. (Receita Federal)
• Decisões mais assertivas: Seus preços são altos o suficiente? Um contrato de serviço específico é realmente lucrativo? Os custos de assinatura estão saindo do controle? As demonstrações financeiras, como a demonstração do resultado e o balanço patrimonial, revelam vazamentos de preços, custos exorbitantes e problemas de fluxo de caixa, fornecendo aos gerentes e investidores os dados necessários para tomar decisões inteligentes. (Investopedia)
• Financiamento mais fácil: Credores e investidores não tomam decisões com base em intuições. Antes de transferir fundos, eles solicitarão demonstrações financeiras. Bons livros permitem que você gere um balanço patrimonial ou uma demonstração do resultado em segundos, demonstrando profissionalismo e saúde financeira. (Investopedia)
• Alertas de fraude e erro: A reconciliação rotineira de seus livros com os extratos bancários é sua primeira linha de defesa contra erros. Esse hábito simples ajuda você a detectar cobranças duplicadas, erros bancários ou atividades fraudulentas rapidamente, antes que se tornem problemas significativos. (Receita Federal)

Um Plano de Sete Etapas em Texto Simples​

Pronto para começar? Veja como construir seu sistema de contabilidade com Beancount do zero.

1. Separe Contas Comerciais e Pessoais​

Este é o primeiro passo não negociável. Abra uma conta corrente comercial dedicada e, se necessário, um cartão de crédito comercial. Misturar fundos cria um pesadelo para a contabilidade e pode confundir as linhas de responsabilidade entre você e sua empresa. A separação clara é essencial para deduções precisas e proteção legal. (SEBRAE)

No Beancount, você declara a existência dessas contas com uma diretiva open:

; Saldos de abertura para suas contas
2025-07-22 open Assets:Bank:Business   USD
2025-07-22 open Assets:Bank:Personal   USD

2. Escolha um Sistema de Contabilidade​

O Beancount usa o método de partidas dobradas, o padrão ouro da contabilidade há séculos. O princípio é simples: cada transação afeta pelo menos duas contas. Para cada débito de uma conta, deve haver um crédito correspondente em outra. A mágica deste sistema é que a soma de todas as suas contas deve sempre ser igual a zero. O Beancount aplica essa regra automaticamente, o que significa que um erro de digitação ou lógico irá levantar uma bandeira imediatamente. Você literalmente não pode ter livros desequilibrados. (beancount)

3. Decida sobre um Método Contábil​

Você tem duas opções principais aqui:

• Caixa: Você registra a receita quando recebe o dinheiro e as despesas quando as paga. É mais simples e reflete seu fluxo de caixa diretamente.
• Competência: Você registra a receita quando a ganha (por exemplo, quando uma fatura é enviada) e as despesas quando as incorre (por exemplo, quando recebe uma conta). Este método fornece uma imagem mais real da saúde financeira e do desempenho de uma empresa, especialmente para empresas em crescimento. (Investopedia - Contabilidade por Competência, Investopedia - Contabilidade de Caixa)

Aqui está um exemplo de uma transação por competência no Beancount. Você registra a receita quando a fatura é enviada, movendo o valor para Assets:AccountsReceivable. Quando o cliente paga, você move o dinheiro de AccountsReceivable para sua conta bancária.

; Exemplo de competência: fatura emitida, pagamento posterior
2025-07-22 * "Fatura de design #101"
  Assets:AccountsReceivable     3000.00 USD
  Income:Design

2025-08-15 * "Cliente paga fatura #101"
  Assets:Bank:Business          3000.00 USD
  Assets:AccountsReceivable

4. Monte seu Conjunto de Ferramentas​

A beleza do Beancount está em sua natureza minimalista e modular. Seu conjunto principal inclui:

• Editor + Git: Seu editor de texto favorito para registrar transações e o Git para controle de versão, fornecendo um histórico completo e auditável de cada alteração.
• bean-report / bean-balance / Fava: Ferramentas de linha de comando como bean-report e a impressionante interface web Fava fornecem demonstrações financeiras instantâneas, painéis e recursos poderosos de filtragem.
• Importadores: Um rico ecossistema de importadores construídos pela comunidade pode se conectar aos seus feeds bancários via CSV, Plaid ou APIs para serviços como Stripe e PayPal, automatizando grande parte da entrada de dados.

5. Categorize Cada Transação​

Um "plano de contas" bem organizado é a espinha dorsal de relatórios perspicazes. Defina categorias que façam sentido para o seu negócio, usando contas hierárquicas para granularidade. Em seguida, ao registrar as transações, categorize-as meticulosamente.

2025-07-30 * "Fatura mensal da AWS"
  Expenses:Hosting:AWS       124.50 USD
  Assets:Bank:Business
  tag: "ops"

Neste exemplo, a despesa é claramente arquivada em Expenses:Hosting:AWS. O uso de tag: "ops" também permite relatórios transversais, como visualizar todas as despesas operacionais, independentemente de sua categoria principal. (Receita Federal)

6. Armazene Documentos Originais com Segurança​

A Receita Federal aceita cópias digitais de recibos e faturas. Digitalize recibos em papel ou encaminhe faturas por e-mail para uma pasta dedicada no armazenamento em nuvem (como Google Drive ou Dropbox). Em seguida, vincule o arquivo diretamente à sua entrada Beancount usando metadados. Isso cria um registro hermético e independente.

; Imagem do recibo vinculada como metadados
2025-07-18 * "Almoço da equipe"
  Expenses:Meals              85.10 USD
  Assets:Bank:Business
  receipt: "recibos/2025-07-18-almoco-da-equipe.jpg"

7. Transforme a Contabilidade em um Hábito​

A consistência é fundamental. A procrastinação transforma a contabilidade em uma tarefa estressante e demorada. Reserve um bloco de tempo recorrente - um “Dia do Bean” semanal ou mensal - para importar transações, reconciliar contas e revisar seus relatórios financeiros. Essa rotina simples transforma a contabilidade de uma corrida trimestral em uma verificação rápida e eficiente da saúde do seu negócio. (Receita Federal)

Faça Você Mesmo vs Ajuda Profissional​

• Faça Você Mesmo: Para freelancers ou pequenas empresas com volume de transações previsível, uma abordagem “faça você mesmo” com o Beancount é incrivelmente eficaz. Ainda é aconselhável ter uma breve consulta única com um contador para validar seu plano de contas e garantir que você esteja no caminho certo.
• Revisão profissional: À medida que seu negócio cresce, as transações se tornam mais complexas ou o risco de conformidade aumenta, contratar um contador ou escritór contábil profissional para revisões periódicas é inestimável. Você pode continuar usando o Beancount como sua principal fonte de informações e simplesmente exportar os relatórios de que eles precisam.

Lista de Verificação de Início Rápido​

• Abra contas bancárias comerciais separadas.
• Clone o repositório inicial do Beancount e defina suas contas em accounts.bean.
• Escolha caixa ou competência e mantenha-se fiel a ele.
• Configure importadores para automatizar a entrada de dados do seu banco (CSV), Stripe, PayPal, etc.
• Marque e escreva narrações claras para cada transação.
• Reconcilie seu livro-razão com os extratos bancários semanalmente ou mensalmente.
• Gere relatórios mensais de receita, balanço patrimonial e fluxo de caixa usando o Fava ou o bean-report.
• Faça backup de seus arquivos .bean regularmente (Git + armazenamento externo).

Leitura Adicional​

• Receita Federal - Portal do Empreendedor
• Documentação do Beancount - Linguagem e Ferramentas de Linha de Comando

Pronto para começar? Instale o Beancount, registre sua primeira entrada e troque a névoa das planilhas pela clareza do texto simples. Feliz contabilização!