51 postagens marcado com "Beancount"

Funcionalidade Central e Filosofia do Beancount​

Beancount é um sistema de contabilidade de dupla entrada de código aberto que utiliza arquivos de texto simples para registrar transações. Em sua essência, o Beancount trata seu razão contábil como um conjunto de dados definido por uma gramática simples e rigorosa. Cada evento financeiro (transações, aberturas de contas, preços de commodities, etc.) é uma diretiva em um arquivo de texto, que o Beancount analisa e transforma em um banco de dados de lançamentos em memória. Este design impõe o princípio da dupla entrada: cada transação deve equilibrar débitos e créditos entre as contas. O resultado é um razão altamente transparente e auditável que você pode controlar por versão, inspecionar e consultar com facilidade.

Filosofia – correção e minimalismo: O design do Beancount prioriza a integridade dos dados e a simplicidade. Seu criador, Martin Blais, descreve o Beancount como “pessimista” ao assumir que o usuário cometerá erros e, portanto, impõe verificações e restrições adicionais. Por exemplo, o Beancount não permitirá que você remova ativos que nunca foram adicionados (evitando saldos negativos de estoque ou caixa) e pode garantir que cada conta seja aberta antes do uso. Ele não possui o conceito do Ledger de lançamentos “virtuais” ou automaticamente equilibrados – uma escolha intencional para forçar lançamentos totalmente equilibrados. O Beancount efetivamente “é rigoroso” na correção, com mais verificações cruzadas do que a contabilidade de dupla entrada básica oferece. Essa abordagem cautelosa agrada aos usuários que “não confiam muito em si mesmos” e desejam que o software detecte seus erros.

Opções mínimas, consistência máxima: Em contraste com a miríade de flags de linha de comando e opções de ajuste do Ledger, o Beancount opta pelo minimalismo. Existem pouquíssimas opções globais, e nenhuma que altere a semântica das transações fora do arquivo do razão. Toda a configuração que afeta a contabilidade (como métodos de base de custo de commodities ou premissas de lançamento) é feita no arquivo via diretivas ou plugins, garantindo que carregar o mesmo arquivo sempre produza os mesmos resultados, independentemente de como os relatórios são gerados. Este design evita a complexidade dos muitos "botões" do Ledger e as interações sutis entre eles. A filosofia do Beancount é que uma ferramenta contábil deve ser um pipeline estável e determinístico do arquivo de entrada para os relatórios. Ele consegue isso tratando o razão como um fluxo ordenado de diretivas que podem ser processadas programaticamente em sequência. Mesmo coisas que o Ledger trata como sintaxe especial (como saldos iniciais ou declarações de preço) são diretivas de primeira classe no modelo de dados do Beancount, o que torna o sistema altamente extensível.

Extensibilidade via plugins e linguagem de consulta: O Beancount é implementado em Python e fornece ganchos para injetar lógica personalizada no pipeline de processamento. Os usuários podem escrever plugins em Python que operam no fluxo de transações (por exemplo, para impor uma regra personalizada ou gerar lançamentos automáticos). Esses plugins são executados à medida que o arquivo é processado, estendendo efetivamente a funcionalidade central do Beancount sem a necessidade de modificar o código-fonte. O Beancount também inclui uma poderosa linguagem de consulta (inspirada em SQL) para analisar e segmentar o razão. A ferramenta bean-query trata o razão analisado como um banco de dados e permite que você execute consultas analíticas nele – por exemplo, somar despesas por categoria ou extrair todas as transações para um determinado beneficiário. No Beancount 3.x, essa capacidade de consulta foi movida para um pacote beanquery autônomo, mas da perspectiva do usuário, ainda oferece relatórios flexíveis via consultas tipo SQL.

Texto simples e controle de versão: Como uma ferramenta de contabilidade de texto simples, o Beancount enfatiza o controle do usuário e a longevidade dos dados. O razão é simplesmente um arquivo de texto .beancount que você pode editar em qualquer editor de texto. Isso significa que todo o seu histórico financeiro é armazenado em um formato legível por humanos, e você pode colocá-lo no Git ou em outro VCS para rastrear as mudanças ao longo do tempo. Os usuários frequentemente mantêm seu arquivo Beancount sob controle de versão para manter uma trilha de auditoria de cada edição (com mensagens de commit descrevendo as mudanças). Essa abordagem se alinha com a filosofia do Beancount de que os dados contábeis, especialmente finanças pessoais ou de pequenas empresas, devem ser transparentes e “à prova de futuro” – não bloqueados em um banco de dados proprietário. Nas próprias palavras de Martin Blais, o Beancount é um “trabalho de amor” construído para ser simples, durável e gratuito para a comunidade. Ele foi desenvolvido pela primeira vez por volta de 2007 e evoluiu através de grandes reescritas (v1 para v2, e agora v3 em 2024) para refinar seu design, preservando sua filosofia central de minimalismo e correção.

Ferramentas, Plugins e Extensões no Ecossistema Beancount​

O ecossistema Beancount desenvolveu um conjunto rico de ferramentas, plugins e extensões que aprimoram a funcionalidade central do livro-razão. Estes abrangem a importação de dados, edição de livros-razão, visualização de relatórios e adição de recursos contábeis especializados. Abaixo está uma visão geral dos principais componentes e complementos no mundo Beancount:

Utilitários de Importação de Dados (Importadores)​

Uma das necessidades mais importantes para o uso prático é a importação de transações de bancos, cartões de crédito e outras instituições financeiras. Beancount oferece uma estrutura de importação e scripts de importação contribuídos pela comunidade para este fim. No Beancount 2.x, o módulo integrado beancount.ingest (com comandos como bean-extract e bean-identify) era usado para definir plugins de importação em Python e aplicá-los a extratos baixados. No Beancount 3.x, isso foi substituído por um projeto externo chamado Beangulp. Beangulp é uma estrutura de importadores dedicada que evoluiu de beancount.ingest e agora é a forma recomendada para automatizar a importação de transações para o Beancount 3.0. Ele permite escrever scripts Python ou ferramentas de linha de comando que leem arquivos externos (como extratos CSV ou PDF) e geram lançamentos Beancount. Esta nova abordagem desvincula a lógica de importação do núcleo do Beancount – por exemplo, o antigo comando bean-extract foi removido na v3, e em vez disso, seus próprios scripts de importação produzem transações através da interface CLI do Beangulp.

Dezenas de importadores prontos existem para diferentes bancos e formatos, contribuídos pela comunidade. Existem scripts de importação para instituições em todo o mundo – desde Alipay e WeChat Pay na China, a vários bancos europeus (Commerzbank, ING, ABN AMRO, etc.), a bancos dos EUA como Chase e Amex. Muitos deles são coletados em repositórios públicos (frequentemente no GitHub) ou em pacotes como beancount-importers. Por exemplo, o projeto Tarioch Beancount Tools (tariochbctools) fornece importadores para bancos suíços e do Reino Unido e até mesmo lida com importações de transações de criptomoedas. Outro exemplo é o Lazy Beancount, que empacota um conjunto de importadores comuns (para Wise, Monzo, Revolut, IBKR, etc.) e fornece uma configuração baseada em Docker para fácil automação. Não importa qual banco ou serviço financeiro você use, é provável que alguém já tenha escrito um importador Beancount para ele – ou você pode escrever o seu próprio usando a estrutura do Beangulp. A flexibilidade do Python significa que os importadores podem lidar com a análise de arquivos CSV/Excel, downloads OFX/QIF, ou até mesmo com a extração de dados de APIs, e então emitir transações no formato Beancount padronizado.

Edição e Integração com Editores​

Como os livros-razão do Beancount são apenas texto, os usuários frequentemente aproveitam seus editores de texto ou IDEs favoritos para mantê-los. O ecossistema oferece plugins de suporte para editores para tornar essa experiência mais fluida. Existem extensões para muitos editores populares que adicionam realce de sintaxe, preenchimento automático de nomes de contas e verificação de erros em tempo real:

• Emacs Beancount-Mode: Um modo principal do Emacs (beancount-mode) está disponível para editar arquivos .beancount, oferecendo recursos como coloração de sintaxe e integração com o verificador do Beancount. Ele pode até mesmo executar bean-check em segundo plano para que erros no livro-razão (como uma transação não balanceada) sejam sinalizados enquanto você edita.
• Extensão VS Code: Uma extensão Beancount no VSCode Marketplace oferece conveniências semelhantes para usuários do Visual Studio Code. Ela suporta realce de sintaxe, alinhamento de valores, preenchimento automático para contas/beneficiários e até mesmo verificações de saldo em tempo real ao salvar o arquivo. Ela também pode se integrar com o Fava, permitindo que você inicie a interface web do Fava de dentro do VSCode.
• Plugins ou modos também existem para Vim, Atom e outros editores. Por exemplo, há uma gramática Tree-sitter para Beancount, que possibilita o realce de sintaxe em editores modernos e foi até mesmo adotada no componente de editor baseado na web do Fava. Em suma, qualquer que seja seu ambiente de edição, a comunidade provavelmente forneceu um plugin para tornar a edição de arquivos Beancount conveniente e livre de erros.

Para entrada rápida de transações fora dos editores tradicionais, também existem ferramentas como Bean-add e aplicativos móveis. Bean-add é uma ferramenta de linha de comando que permite adicionar uma nova transação via um prompt ou um comando de uma linha, lidando com sugestões de data e conta. Em dispositivos móveis, um projeto chamado Beancount Mobile fornece uma interface simples para inserir transações em movimento (por exemplo, registrando uma compra em dinheiro do seu telefone). Além disso, um Beancount Telegram Bot existe para capturar transações por meio de mensagens – você pode enviar uma mensagem com os detalhes da transação, e o bot a formata em seu arquivo de livro-razão.

Front-ends Web e Ferramentas de Visualização​

(Fava) A interface web do Fava oferece um painel interativo para o Beancount, apresentando relatórios como uma demonstração de resultados com visualizações (mostrada aqui como um treemap de despesas por categoria) juntamente com tabelas de contas e saldos.

O principal front-end para o Beancount é o Fava, uma interface web moderna. O Fava funciona como um aplicativo web local que lê seu arquivo Beancount e produz uma experiência interativa rica no seu navegador. Ele oferece um conjunto completo de relatórios: balanço patrimonial, demonstração de resultados, patrimônio líquido ao longo do tempo, participações de portfólio, gráficos de desempenho, orçamentos e muito mais – tudo pronto para uso. Os usuários frequentemente citam o Fava como uma das principais razões para escolher o Beancount em vez de outras ferramentas de contabilidade em texto simples. Com um único comando (fava ledger.beancount), você pode navegar pelas suas finanças com gráficos e tabelas em vez de texto. O Fava suporta recursos como: detalhamento de contas, filtragem de transações por beneficiário ou tag, um editor de consultas (para que você possa executar consultas Beancount e ver os resultados no navegador), e até mesmo um editor web integrado para seu livro-razão. É altamente utilizável, tornando a contabilidade em texto simples acessível para aqueles que preferem interfaces visuais.

Nos bastidores, o Fava é escrito em Python (Flask no backend) e JavaScript (Svelte no frontend). Ele tem seu próprio ciclo de lançamento e é ativamente mantido. Notavelmente, o Fava acompanhou o desenvolvimento do Beancount – por exemplo, o Fava 1.30 adicionou suporte para Beancount v3, passando a usar os novos pacotes beanquery e beangulp internamente. (Ele ainda suporta Beancount 2 para livros-razão mais antigos.) O foco do Fava na usabilidade inclui toques agradáveis como preenchimento automático no editor web, e uma UI elegante com modo escuro e gráficos responsivos. Há também uma ramificação chamada Fava-GTK, que empacota o Fava em um aplicativo de desktop para usuários GNOME/Linux que preferem uma sensação de aplicativo nativo.

Além do Fava, existem outras opções de visualização e análise. Como os dados do Beancount podem ser exportados ou consultados como tabelas, os usuários frequentemente utilizam ferramentas como notebooks Jupyter ou Pandas para análise personalizada. Por exemplo, um usuário descreve puxar dados do Beancount via interface de consulta para um Pandas DataFrame para preparar um relatório personalizado. Existem também scripts contribuídos pela comunidade para relatórios específicos – por exemplo, uma ferramenta de análise de alocação de portfólio ou um gráfico de controle de processo para gastos vs. patrimônio líquido. No entanto, para a maioria das pessoas, o Fava oferece poder de relatório mais do que suficiente sem precisar escrever código. Ele até suporta extensões: você pode inserir arquivos Python que adicionam novas páginas de relatório ou gráficos ao Fava. Uma extensão notável é o fava-envelope para orçamento por envelopes dentro do Fava. No geral, o Fava serve como o centro de visualização central do ecossistema Beancount.

Utilitários e Scripts de Linha de Comando​

Beancount vem com várias ferramentas de CLI (especialmente no ramo v2 mais antigo, algumas das quais foram reduzidas na v3). Essas ferramentas operam no seu arquivo de razão para verificá-lo ou gerar relatórios específicos em texto ou HTML:

• bean-check: um validador que verifica erros de sintaxe ou erros contábeis no arquivo. Executar bean-check myfile.beancount irá alertá-lo sobre qualquer desequilíbrio, conta ausente ou outros problemas, e não produzirá saída se o arquivo estiver livre de erros.
• bean-format: um formatador que organiza seu razão alinhando números em colunas organizadas, muito parecido com a execução de um formatador de código em código-fonte. Isso ajuda a manter o arquivo limpo e legível.
• bean-query: um shell interativo ou ferramenta de lote para executar a linguagem de consulta do Beancount no seu razão. Você pode usá-lo para produzir relatórios tabulares personalizados (por exemplo, bean-query myfile.beancount "SELECT account, sum(amount) WHERE ...").
• bean-report: um gerador de relatórios versátil (na v2) que pode gerar relatórios predefinidos (balanço patrimonial, demonstrativo de resultados, balancete de verificação, etc.) para o console ou para arquivos. Por exemplo, bean-report file.beancount balances imprimiria os saldos das contas. (Na prática, muitos desses relatórios de texto foram suplantados pela apresentação mais agradável do Fava.)
• bean-web / bean-bake: uma interface web mais antiga que serviria os relatórios em localhost ou os "assaria" como arquivos HTML estáticos. Estes eram principalmente usados antes de o Fava se tornar popular; o bean-web fornecia uma visualização web básica dos mesmos relatórios que o bean-report poderia gerar. No Beancount 3, o bean-web foi removido (já que o Fava é agora o frontend web recomendado, oferecendo uma experiência superior).
• bean-example: um utilitário para gerar um arquivo de razão de exemplo (útil para recém-chegados verem um modelo de lançamentos do Beancount).
• bean-doctor: uma ferramenta de depuração que pode diagnosticar problemas no seu razão ou ambiente.

Vale a pena notar que, a partir do Beancount v3, muitas dessas ferramentas foram movidas para fora do projeto principal. O pacote principal do Beancount foi otimizado, e ferramentas como o motor de consulta e os importadores foram divididas em pacotes separados (beanquery, beangulp, etc.) para facilitar a manutenção. Por exemplo, a funcionalidade do bean-query é agora fornecida pela ferramenta beanquery, que é instalada separadamente. Da perspectiva do usuário, a funcionalidade permanece disponível; apenas foi modularizada. A comunidade Arch Linux notou essa mudança ao atualizar o Fava: o pacote Fava adicionou dependências em beanquery e beangulp para suportar o Beancount 3.x. Essa abordagem modular também permite que outros na comunidade contribuam para essas ferramentas auxiliares de forma mais independente do ciclo de lançamento do Beancount.

Plugins e Extensões do Beancount​

Uma força notável do ecossistema Beancount é o sistema de plugins. Ao adicionar uma linha plugin "module.name" no seu arquivo Beancount, você pode incorporar lógica Python personalizada que é executada durante o processamento do livro-razão. A comunidade criou muitos plugins para estender as capacidades do Beancount:

• Qualidade de dados e regras: Exemplos incluem beancount-balexpr, que permite validar equações envolvendo múltiplas contas (por exemplo, Ativo A + Ativo B = Passivo X), e beancount-checkclosed, que insere automaticamente asserções de saldo ao fechar uma conta para garantir que ela zere. Há até um plugin para garantir que as transações no arquivo estejam ordenadas por data (autobean.sorted) para identificar lançamentos fora de ordem.
• Automação: O plugin beancount-asset-transfer pode gerar lançamentos de transferência de ativos entre contas (útil para movimentar ações entre corretoras, preservando o custo de aquisição). Outro, autobean.xcheck, faz uma verificação cruzada do seu livro-razão Beancount com extratos externos para identificar discrepâncias.
• Transações recorrentes e orçamentos: O plugin "repeat" ou interpolate de Akuukis permite definir transações recorrentes ou distribuir uma despesa anual ao longo dos meses. Para orçamento, a extensão fava-envelope (usada via Fava) suporta a metodologia de orçamento por envelopes em texto simples. Há também o MiniBudget de Frank Davies – uma pequena ferramenta autônoma inspirada no Beancount para auxiliar no orçamento pessoal ou para pequenas empresas.
• Impostos e relatórios: Alguns plugins auxiliam na contabilidade fiscal, como um que classifica automaticamente os ganhos de capital em curto vs. longo prazo. Outro (fincen_114 de Justus Pendleton) gera um relatório FBAR para contribuintes dos EUA com contas estrangeiras, ilustrando como os dados do Beancount podem ser aproveitados para relatórios regulatórios.
• Repositórios de plugins da comunidade: Existem conjuntos de plugins selecionados, como beancount-plugins (de Dave Stephens), focados em itens como lançamentos de depreciação, e beancount-plugins-zack (de Stefano Zacchiroli), que incluem auxiliares diversos, como diretivas de ordenação.

Além dos plugins, outras ferramentas utilitárias que orbitam o Beancount atendem a necessidades específicas. Por exemplo, beancount-black é um autoformatador semelhante ao formatador de código Black, mas para arquivos de livro-razão Beancount. Há um Beancount Bot (Telegram/Mattermost) para adicionar transações via chat, como mencionado, e um fluxo de trabalho Alfred para macOS para anexar rapidamente transações ao seu arquivo. Uma ferramenta chamada Pinto oferece uma CLI "turbinada" com entrada interativa (como um bean-add aprimorado). Para aqueles que estão migrando de outros sistemas, existem conversores (YNAB2Beancount, CSV2Beancount, GnuCash2Beancount, Ledger2Beancount) para ajudar a importar dados de outros lugares.

Em resumo, o ecossistema Beancount é bastante extenso. A Tabela 1 abaixo lista algumas das principais ferramentas e extensões com suas funções:

| Ferramenta/Extensão | Descrição

Comparação com Ledger, hledger e Sistemas Semelhantes​

Beancount pertence à família de ferramentas de contabilidade de dupla entrada em texto simples, entre as quais Ledger CLI (Ledger de John Wiegley) e hledger são proeminentes. Embora todos esses sistemas compartilhem a ideia central de arquivos de razão em texto simples e escrituração de dupla entrada, eles diferem em sintaxe, filosofia e maturidade do ecossistema. A tabela a seguir destaca as principais diferenças entre Beancount, Ledger e hledger:

Cenários de Uso para Beancount​

Beancount é versátil o suficiente para ser usado para controle de finanças pessoais, bem como (em alguns casos) para contabilidade de pequenas empresas. Sua abordagem central de dupla entrada é a mesma em ambos os cenários, mas a escala e as práticas específicas podem diferir.

Finanças Pessoais​

Muitos utilizadores do Beancount utilizam-no para gerir as suas finanças individuais ou domésticas. Uma configuração típica de finanças pessoais no Beancount pode incluir contas para depósitos à ordem e poupança, cartões de crédito, investimentos, empréstimos, categorias de rendimento (salário, juros, etc.) e categorias de despesas (renda, mercearia, entretenimento, etc.). Os utilizadores registam as transações diárias manualmente (introduzindo recibos, faturas, etc.) ou importando-as de extratos bancários utilizando as ferramentas de importação discutidas anteriormente. Os benefícios que o Beancount oferece às finanças pessoais incluem:

• Consolidação e Análise: Todas as suas transações podem residir num único ficheiro de texto (ou num conjunto de ficheiros) que representa anos de histórico financeiro. Isto facilita a análise de tendências a longo prazo. Com a linguagem de consulta do Beancount ou com o Fava, pode responder a perguntas como “Quanto gastei em viagens nos últimos 5 anos?” ou “Qual é a minha despesa média mensal com mercearia?” em segundos. Um utilizador notou que, após mudar para o Beancount, “a análise de dados financeiros (gastos, doações, impostos, etc.) é trivial” seja através do Fava ou consultando os dados e utilizando ferramentas como o Pandas. Em essência, o seu livro-razão torna-se uma base de dados financeira pessoal que pode consultar à vontade.
• Orçamentação e Planeamento: Embora o Beancount não imponha um sistema de orçamentação, pode implementar um. Alguns utilizadores fazem orçamentação por envelopes criando contas de orçamento ou utilizando o plugin fava-envelope. Outros simplesmente utilizam relatórios periódicos para comparar os gastos com os objetivos. Por ser texto simples, integrar o Beancount com ferramentas de orçamentação externas ou folhas de cálculo é simples (exportar dados ou utilizar saídas CSV de consultas).
• Rastreamento de Investimentos e Património Líquido: O Beancount destaca-se no rastreamento de investimentos graças ao seu robusto tratamento de bases de custo e preços de mercado. Pode registar compras/vendas de ações, criptomoedas, etc., com detalhes de custo, e depois utilizar diretivas Prices para acompanhar o valor de mercado. O Fava pode mostrar um gráfico de património líquido ao longo do tempo e uma discriminação do portfólio por classe de ativos. Isto é extremamente útil para a gestão de património pessoal – obtém informações semelhantes às fornecidas por ferramentas comerciais como o Mint ou o Personal Capital, mas totalmente sob o seu controlo. O manuseamento de múltiplas moedas também está integrado, por isso, se detiver moedas estrangeiras ou criptomoedas, o Beancount pode rastreá-las e convertê-las para relatórios.
• Reconciliação e Precisão: As finanças pessoais frequentemente envolvem a reconciliação com extratos bancários. Com o Beancount, pode-se reconciliar contas regularmente utilizando asserções de saldo ou a funcionalidade de documentos. Por exemplo, todos os meses pode adicionar uma entrada balance Assets:Bank:Checking <date> <balance> para confirmar que o seu livro-razão corresponde ao extrato bancário no final do mês. A ferramenta bean-check (ou a exibição de erros do Fava) irá alertá-lo se as coisas não estiverem alinhadas. Um utilizador menciona fazer uma reconciliação mensal de todas as contas, o que “ajuda a detetar qualquer atividade incomum” – uma boa prática de higiene financeira pessoal que o Beancount facilita.
• Automação: Indivíduos com conhecimentos tecnológicos automatizaram grandes partes do seu fluxo de trabalho de finanças pessoais com o Beancount. Utilizando importadores, cron jobs e talvez um pouco de Python, pode configurar o seu sistema para que, por exemplo, todos os dias as suas transações bancárias sejam obtidas (alguns utilizam OFX ou APIs) e anexadas ao seu ficheiro Beancount, categorizadas por regras. Com o tempo, o seu livro-razão torna-se maioritariamente autoatualizado, e só precisa de rever e ajustar conforme necessário. Um membro da comunidade no Hacker News partilhou que, após 3 anos, os seus livros Beancount estavam “95% automáticos”. Este nível de automação é possível devido à abertura de texto simples do Beancount e às suas capacidades de script.

Os utilizadores de finanças pessoais frequentemente escolhem o Beancount em vez de folhas de cálculo ou aplicações porque lhes dá total propriedade dos dados (sem dependência de um serviço na nuvem que possa ser descontinuado – uma preocupação, por exemplo, com a descontinuação do Mint) e porque a profundidade da análise é maior quando se tem todos os dados integrados. A curva de aprendizagem não é trivial – é preciso aprender contabilidade básica e a sintaxe do Beancount – mas recursos como a documentação oficial e tutoriais da comunidade ajudam os recém-chegados a começar. Uma vez configurado, muitos descobrem que ter uma imagem clara e fiável das suas finanças a todo o momento lhes traz paz de espírito.

Contabilidade para Pequenas Empresas​

Usar o Beancount para uma pequena empresa (ou organização sem fins lucrativos, clube, etc.) é menos comum do que para uso pessoal, mas é certamente possível e alguns o fizeram com sucesso. A estrutura de dupla entrada do Beancount é, de fato, o mesmo sistema que sustenta a contabilidade corporativa, apenas sem alguns dos recursos de nível superior que softwares de contabilidade dedicados fornecem (como módulos de faturamento ou integrações de folha de pagamento). Veja como o Beancount pode se encaixar no contexto de uma pequena empresa:

• Razão Geral e Demonstrações Financeiras: Uma pequena empresa pode tratar o arquivo Beancount como seu razão geral. Você teria contas de ativo para contas bancárias, contas a receber, talvez estoque; contas de passivo para cartões de crédito, empréstimos, contas a pagar; patrimônio líquido para capital do proprietário; contas de receita para vendas ou serviços; e contas de despesa para todas as despesas comerciais. Ao manter este razão, você pode produzir uma Demonstração de Resultados (Lucros e Perdas) e um Balanço Patrimonial a qualquer momento usando os relatórios ou consultas do Beancount. De fato, os relatórios integrados do Beancount ou o Fava podem gerar um balanço patrimonial e uma DRE em segundos que estão perfeitamente alinhados com os princípios contábeis. Isso pode ser suficiente para uma pequena operação avaliar a lucratividade, a posição financeira e o fluxo de caixa (com um pouco de consulta para o fluxo de caixa, já que as demonstrações de fluxo de caixa diretas não são integradas, mas podem ser derivadas).
• Faturas e C/R, C/P: O Beancount não possui um sistema de faturamento integrado; os usuários normalmente lidariam com o faturamento externamente (por exemplo, criar faturas no Word ou em um aplicativo de faturamento) e, em seguida, registrariam os resultados no Beancount. Por exemplo, ao emitir uma fatura, você registraria um lançamento debitando Contas a Receber e creditando Receita. Quando o pagamento chega, você debita Caixa/Banco e credita Contas a Receber. Dessa forma, você pode acompanhar as contas a receber pendentes verificando o saldo da conta de C/R. O mesmo se aplica às contas a pagar (C/P). Embora seja mais manual do que um software de contabilidade especializado (que pode enviar lembretes ou integrar-se com e-mails), é perfeitamente viável. Alguns usuários compartilharam modelos ou fluxos de trabalho sobre como gerenciam faturas com o Beancount e garantem que não percam faturas em aberto (por exemplo, usando metadados ou consultas personalizadas para listar faturas não pagas).
• Estoque ou Custo dos Produtos Vendidos: Para empresas que vendem produtos, o Beancount pode rastrear compras e vendas de estoque, mas requer lançamentos disciplinados. Você pode usar os recursos de Estoque e contabilidade de custos: a compra de estoque aumenta uma conta de ativo (com o custo anexado aos itens), a venda move o custo para uma despesa (CPV) e registra a receita. Como o Beancount insiste na correspondência de lotes, ele garantirá a redução adequada do estoque com o custo correto, o que pode realmente garantir que seus cálculos de lucro bruto sejam precisos se feitos corretamente. No entanto, não há rastreamento automático de SKU ou algo do tipo – tudo está no nível financeiro (quantidade e custo).
• Folha de Pagamento e Transações Complexas: O Beancount pode registrar transações de folha de pagamento (despesa de salário, retenções de impostos, etc.), mas o cálculo desses valores pode ser feito externamente ou por meio de outra ferramenta, e então apenas lançado no Beancount. Para uma empresa muito pequena (digamos, um ou dois funcionários), isso é gerenciável. Você, por exemplo, registraria um único lançamento contábil por período de pagamento que separa salários, impostos retidos, despesa de imposto do empregador, dinheiro pago, etc. Fazer isso manualmente é semelhante a como alguém faria em lançamentos contábeis do QuickBooks – requer conhecimento de quais contas afetar.
• Multiusuário e Auditoria: Um desafio em um ambiente de negócios é se várias pessoas precisam acessar os livros ou se um contador precisa revisá-los. Como o Beancount é um arquivo de texto, ele não é multiusuário em tempo real. No entanto, hospedar o arquivo em um repositório Git pode permitir a colaboração: cada pessoa pode editar e fazer commit, e as diferenças podem ser mescladas.
• Conformidade Regulatória: Para declaração de impostos ou conformidade, os dados do Beancount podem ser usados para gerar os relatórios necessários, mas isso pode exigir consultas personalizadas ou plugins. Vimos um exemplo de um plugin da comunidade para relatórios de conformidade do governo indiano e um para relatórios FBAR do FinCEN. Isso mostra que, com esforço, o Beancount pode ser adaptado para atender a requisitos de relatórios específicos. Pequenas empresas em jurisdições com requisitos simples (contabilidade de caixa ou regime de competência básico) podem certamente manter livros no Beancount e produzir demonstrações financeiras para declarações de impostos. No entanto, recursos como cronogramas de depreciação ou amortização podem exigir que você escreva seus próprios lançamentos ou use um plugin (os plugins de depreciação de Dave Stephens, por exemplo, ajudam a automatizar isso). Não há uma GUI para "clicar em depreciar ativo" como em alguns softwares de contabilidade; você codificaria a depreciação como transações (o que, de certa forma, a desmistifica – tudo é um lançamento que você pode inspecionar).

Na prática, muitos proprietários de pequenas empresas com orientação tecnológica têm usado o Beancount (ou Ledger/hledger) se preferem controle e transparência em vez da conveniência do QuickBooks. Uma discussão no Reddit observou que, para contabilidade padrão de pequenas empresas com um volume limitado de transações, o Beancount funciona bem. O fator limitante é geralmente o nível de conforto – se o proprietário da empresa (ou seu contador) se sente confortável com uma ferramenta baseada em texto. Uma vantagem é o custo: o Beancount é gratuito, enquanto o software de contabilidade pode ser caro para uma pequena empresa. Por outro lado, a falta de suporte oficial e a natureza "faça você mesmo" significam que é mais adequado para aqueles que são tanto o proprietário da empresa quanto um pouco inclinados tecnicamente. Para freelancers ou empresários individuais com habilidades de programação, o Beancount pode ser uma escolha atraente para gerenciar finanças sem depender de serviços de contabilidade em nuvem.

Abordagens híbridas também são possíveis: algumas pequenas empresas usam um sistema oficial para faturas ou folha de pagamento, mas importam periodicamente os dados para o Beancount para análise e arquivamento. Dessa forma, elas obtêm o melhor dos dois mundos – conformidade e facilidade para as operações diárias, além do poder do Beancount para uma visão consolidada.

Em resumo, o Beancount pode lidar com a contabilidade de pequenas empresas, desde que o usuário esteja disposto a gerenciar manualmente coisas que softwares comerciais automatizam. Ele garante um alto grau de transparência – você entende profundamente seus livros porque os está escrevendo – e para um usuário diligente, ele pode produzir livros impecáveis. Tanto usuários pessoais quanto empresariais se beneficiam dos pontos fortes do Beancount: um motor contábil confiável, trilha de auditoria completa e flexibilidade para se adaptar a cenários únicos (via scripts e plugins). Seja para rastrear um orçamento doméstico ou as finanças de uma startup, o Beancount oferece um conjunto de ferramentas para fazê-lo com precisão e abertura.

Comunidade e Atividade de Desenvolvimento​

Beancount possui uma comunidade dedicada e uma história de desenvolvimento que reflete sua natureza de código aberto, nicho, mas apaixonada. Abaixo estão os pontos chave sobre sua comunidade, mantenedores e projetos relacionados:

• Manutenção do Projeto: O autor principal do Beancount é Martin Blais, que iniciou o projeto por volta de 2007 e o conduziu por múltiplas versões. O desenvolvimento por muito tempo foi em grande parte um esforço de um homem só (além das contribuições da comunidade de patches). A filosofia de Martin era construir uma ferramenta contábil "útil para mim primeiro, bem como para outros, da maneira mais simples e durável". Essa motivação pessoal manteve o projeto funcionando como um trabalho de amor. A partir de 2025, Martin Blais ainda é o mantenedor principal (seu nome aparece nos commits e ele responde a perguntas na lista de discussão/rastreador de problemas), mas o ecossistema em torno do Beancount tem muitos outros contribuidores em seus respectivos projetos.

• GitHub e Repositórios: O código-fonte está hospedado no GitHub sob o repositório beancount/beancount. O projeto é licenciado sob GPL-2.0 e atraiu um número modesto de contribuidores ao longo dos anos. Em meados de 2024, o Beancount Versão 3 foi oficialmente lançado como a nova ramificação estável. Este lançamento envolveu a separação de alguns componentes: por exemplo, o repositório beangulp (para importadores) e o repositório beanquery (para a ferramenta de consulta) fazem parte da organização beancount no GitHub agora, mantidos de forma um tanto independente. O repositório principal do Beancount foca no motor contábil principal e no analisador de arquivos. A partir de 2025, o GitHub do Beancount mostra discussões ativas de problemas e algum desenvolvimento contínuo – embora não em alto volume, problemas e pull requests chegam gradualmente, e atualizações ocasionais são feitas para corrigir bugs ou refinar recursos.

• Desenvolvimento do Fava: Fava, a interface web, começou como um projeto separado (criado por Dominic Aumayr, que o registrou em 2016). Ele tem sua própria comunidade de contribuidores e também está no GitHub sob beancount/fava. Os mantenedores e contribuidores do Fava (por exemplo, Jakob Schnetz, Stefan Otte e outros nos últimos anos) têm melhorado ativamente a interface, com lançamentos a cada poucos meses. O chat Gitter do Fava (linkado na documentação do Fava) e o rastreador de problemas do GitHub são locais onde usuários e desenvolvedores discutem novos recursos ou bugs. O projeto acolhe contribuições, evidenciado por uma nota no CHANGELOG agradecendo a múltiplos membros da comunidade por seus PRs. O alinhamento próximo do Fava com o desenvolvimento do Beancount (como a rápida adição de suporte para Beancount v3 e nova sintaxe beanquery) indica boa colaboração entre os dois projetos.

• Listas de Discussão e Fóruns: Beancount tem uma lista de discussão oficial (anteriormente no Google Groups, intitulada "Beancount" ou às vezes discutida na lista geral do Ledger). Esta lista de discussão é um tesouro de conhecimento – usuários fazem perguntas sobre como modelar certos cenários, relatam bugs e compartilham dicas. Martin Blais é conhecido por responder na lista de discussão com explicações detalhadas. Além disso, a comunidade mais ampla de Contabilidade em Texto Simples se sobrepõe fortemente. A lista de discussão do Ledger CLI frequentemente também aborda perguntas sobre Beancount, e há um fórum em plaintextaccounting.org e um subreddit r/plaintextaccounting onde tópicos sobre Beancount surgem frequentemente. Usuários nessas plataformas discutem comparações, compartilham configurações pessoais e ajudam recém-chegados. O tom geral da comunidade é muito cooperativo – usuários do Beancount frequentemente ajudam usuários do Ledger e vice-versa, reconhecendo que todas essas ferramentas têm objetivos semelhantes.

• Grupos de Chat: Além das listas de discussão, existem canais de chat como o Slack/Discord de Contabilidade em Texto Simples (organizado pela comunidade) e o Gitter do Fava. Estes são menos formais, maneiras mais em tempo real de obter ajuda ou discutir recursos. Por exemplo, alguém pode entrar no Slack para perguntar se alguém tem um importador para um banco específico. Há também um canal Matrix/IRC (historicamente #ledger ou #beancount no IRC) onde alguns usuários de longa data ficam ociosos. Embora não tão populosos quanto as comunidades de software mainstream, esses canais têm pessoas experientes que frequentemente podem responder a perguntas contábeis obscuras.

• Contribuidores e Membros Chave da Comunidade: Alguns nomes se destacam na comunidade Beancount:

  • "Redstreet" (Red S): Um contribuidor prolífico que escreveu muitos plugins (como beancount-balexpr, sellgains e outros) e frequentemente oferece suporte. Ele também mantém um conjunto de scripts de importação e uma ferramenta chamada bean-download para buscar extratos.
  • Vasily M (Evernight): Autor de alguns frameworks de importação e plugins como beancount-valuation, e contribuições para o Fava relacionadas a investimentos.
  • Stefano Zacchiroli (zack): Um desenvolvedor Debian que criou o beancount-mode para Emacs e seu próprio repositório de plugins. Ele também defendeu a contabilidade em texto simples em ambientes acadêmicos.
  • Simon Michael: Embora seja principalmente o líder do hledger, ele mantém o plaintextaccounting.org que inclui Beancount. Essa polinização cruzada ajudou a levar o Beancount à atenção dos usuários de Ledger/hledger.
  • Frank hell (Tarioch): Contribuidor das Ferramentas Tarioch Beancount, um grande conjunto de importadores e buscadores de preços, especialmente para instituições europeias.
  • Siddhant Goel: Um membro da comunidade que escreve blogs sobre Beancount (por exemplo, seu guia sobre como migrar para a v3) e mantém alguns importadores. Suas postagens de blog ajudaram muitos novos usuários.

  Esses e muitos outros contribuem com código, documentação e ajuda em fóruns, tornando o ecossistema vibrante apesar de seu tamanho relativamente pequeno.

• Estatísticas do GitHub e Forks: O repositório do Beancount no GitHub acumulou algumas centenas de estrelas (indicando interesse) e forks. Forks notáveis do próprio Beancount são raros – não há um fork divergente bem conhecido que tente ser "Beancount, mas com o recurso X". Em vez disso, quando os usuários queriam algo diferente, eles escreviam um plugin ou usavam outra ferramenta (como hledger) em vez de fazer um fork do Beancount. Poderíamos considerar o hledger uma espécie de fork do Ledger (não do Beancount) e o próprio Beancount uma re-imaginação independente das ideias do Ledger, mas dentro do repositório do Beancount não há grandes projetos "ramificados". A comunidade geralmente se uniu em torno do repositório principal e o estendeu através da interface de plugins, em vez de fragmentar a base de código. Isso provavelmente ocorre porque Martin Blais estava aberto a contribuições externas (sua documentação até tem uma seção reconhecendo contribuições e módulos externos) e a arquitetura de plugins tornou desnecessário manter um fork para a maioria dos novos recursos.

• Recursos da Comunidade: Existem vários recursos de alta qualidade para aprender e usar Beancount criados pela comunidade:

  • A documentação do Beancount no GitHub Pages (e os Google Docs de origem que Martin mantém) – muito abrangente, incluindo teoria sobre contabilidade e como o Beancount a implementa.

  • Numerosas postagens de blog e notas pessoais – por exemplo, LWN.net teve um artigo "Contando feijões... com Beancount", e muitos blogs pessoais (conforme listado na seção "Blog Posts" do Awesome Beancount) compartilham experiências e dicas. Estes ajudam a construir conhecimento e atrair novos usuários.

  • Palestras e apresentações: Beancount foi apresentado em meetups e conferências (por exemplo, uma palestra PyMunich 2018 sobre como gerenciar finanças com Python/Beancount). Tais palestras introduzem a ferramenta a públicos mais amplos e frequentemente despertam interesse em fóruns como o Hacker News.

• Projetos Relacionados Notáveis: Além do Fava, alguns outros projetos relacionados ao Beancount têm suas próprias comunidades:

  • Site Plain Text Accounting – mantido por Simon Michael, ele agrega informações sobre todas essas ferramentas e possui um fórum onde as pessoas compartilham o uso de várias ferramentas, incluindo Beancount.
  • Integração de ferramentas financeiras: Alguns usuários integram Beancount com ferramentas de business intelligence ou bancos de dados. Por exemplo, um tópico do Google Groups detalha o uso de PostgreSQL com dados do Beancount via funções personalizadas. Embora não seja mainstream, isso mostra o espírito experimental da comunidade em expandir as capacidades do Beancount (por exemplo, para lidar com conjuntos de dados muito grandes ou consultas complexas além das integradas).

Em resumo, a comunidade do Beancount, embora menor do que as de grandes projetos de código aberto, é altamente engajada e conhecedora. O projeto desfruta de um fluxo constante de melhorias e canais de suporte muito úteis. O espírito colaborativo (compartilhamento de importadores, escrita de plugins, resposta a perguntas) significa que um recém-chegado em 2025 pode contar com um extenso trabalho anterior e a sabedoria da comunidade para configurar seu sistema contábil. O desenvolvimento é ativo no sentido do ecossistema – lançamentos do Fava, desenvolvimento de plugins, etc. – mesmo que as mudanças no núcleo sejam mais ocasionais. O crescimento do ecossistema (evidenciado pela lista Awesome Beancount de dezenas

Desenvolvimentos Recentes e Recursos Futuros​

Em 2025, o ecossistema Beancount testemunhou desenvolvimentos significativos nos últimos dois anos, e há discussões em andamento sobre aprimoramentos futuros. Aqui estão alguns desenvolvimentos recentes notáveis e um vislumbre do que pode estar por vir:

• Lançamento do Beancount 3.0 (2024): Após um longo período em que o Beancount 2.x foi o padrão, a versão 3 foi oficialmente lançada em meados de 2024. Este foi um marco importante porque a v3 representa uma simplificação e modernização da base de código. Martin Blais havia imaginado a v3 como uma oportunidade para “reorganizar e simplificar” ainda mais o sistema. Embora inicialmente se pensasse que seria uma grande reescrita, na prática a atualização para os usuários não foi muito disruptiva. As principais mudanças foram internas: um novo parser, algumas melhorias de desempenho e a extração de componentes opcionais do núcleo. O lançamento foi implementado gradualmente (a v3 estava em beta desde 2022, mas em julho de 2024 tornou-se a versão estável recomendada). Usuários como Siddhant Goel relataram que a migração de 2.x para 3.x foi “em grande parte sem intercorrências”, com apenas algumas mudanças no fluxo de trabalho.

• Modularização – ferramentas movidas para pacotes separados: Uma das grandes mudanças com o Beancount 3 é que muitas ferramentas que antes residiam no repositório monolítico foram separadas. Por exemplo, o bean-query agora é fornecido pelo pacote beanquery, e o beancount.ingest foi substituído pelo pacote beangulp. Comandos como bean-extract e bean-identify (para importações) foram removidos do núcleo do Beancount. Em vez disso, a filosofia é usar scripts autônomos para importação. Isso significa que, se você atualizar para a v3, você instalará o beangulp e executará scripts de importação (cada importador é basicamente um pequeno programa) em vez de ter um arquivo de configuração central bean-extract. Da mesma forma, as consultas são executadas via beanquery, que pode ser instalado e atualizado independentemente do núcleo do Beancount. Essa abordagem modular foi projetada para facilitar a manutenção e incentivar as contribuições da comunidade. Também reduziu o tamanho do núcleo do Beancount, de modo que o núcleo se concentra puramente na lógica de parsing e contabilidade, enquanto a funcionalidade auxiliar pode evoluir separadamente. Do ponto de vista do usuário, após a atualização, é preciso ajustar os comandos (por exemplo, usar bean-query do beanquery, ou usar o Fava que já abstrai isso). O changelog do Fava observa explicitamente essas mudanças: o Fava agora depende de beanquery e beangulp, e lida com fluxos de trabalho de importação de forma diferente para Beancount 3 vs 2.

• Melhorias de Desempenho: O desempenho foi uma das motivações para revisitar o design do Beancount. O plano da v3 (conforme descrito no documento “V3 goals” de Martin) incluía a otimização do parser e, possivelmente, tornar o processo de carregamento mais rápido e menos intensivo em memória. Em 2025, algumas dessas melhorias se materializaram. Anedoticamente, usuários com livros-razão muito grandes (dezenas de milhares de transações, ou muitas negociações de ações) relataram melhor desempenho com a versão mais recente. Por exemplo, um usuário que lidava com “transações de microinvestimento” e enfrentava problemas de desempenho observou essas preocupações no Google Group – esse tipo de feedback provavelmente informou a v3. O novo parser é mais eficiente e escrito de forma mais clara, o que poderia ser estendido no futuro. Além disso, o Fava 1.29 mudou para um mecanismo de monitoramento de arquivos mais eficiente (usando a biblioteca watchfiles) para melhorar a capacidade de resposta quando o livro-razão muda. Olhando para o futuro, a comunidade pode explorar o parsing incremental (apenas reprocessar as partes alteradas do arquivo em vez de tudo) para lidar com livros-razão grandes mais rapidamente – isso foi sugerido na documentação como a ideia de “servidor Beancount / escrituração incremental”.

• Aprimoramentos no Rastreamento de Investimentos: Tem havido um trabalho contínuo para melhorar os relatórios de investimentos e portfólio. Por exemplo, o tratamento do custo médio versus FIFO foi amplamente discutido. Embora o Beancount imponha a correspondência de lotes, alguns usuários preferem o custo médio para certas jurisdições. Existe uma proposta e discussão sobre tornar a escrituração do custo base mais flexível (possivelmente via um plugin ou opção). Em 2025, não há uma opção embutida para custo médio, mas a base na v3 (o redesenho da escrituração) facilita a implementação por plugins. Um plugin da comunidade “Gains Minimizer” foi lançado, que pode sugerir quais lotes vender para minimizar impostos, mostrando o tipo de ferramenta avançada que está sendo construída em torno de investimentos. O Fava também adicionou recursos como uma extensão de resumo de portfólio (com cálculos de taxa de retorno). Em termos de recursos futuros, pode-se esperar mais neste domínio: possivelmente sugestões automatizadas de rebalanceamento de portfólio ou análise de risco, provavelmente como ferramentas externas que leem dados do Beancount (já que os dados estão todos lá).

• Novos Plugins e Extensões: O ecossistema de plugins cresce continuamente. Adições notáveis recentes incluem:

  • Ferramentas de relatório de orçamento – por exemplo, um simples relatório de orçamento CLI se alguém não usar a interface do usuário do Fava.
  • Criptografia e segurança – a configuração fava-encrypt, permitindo que o Fava seja hospedado online com o livro-razão criptografado em repouso, foi introduzida, abordando a preocupação de auto-hospedar suas finanças.
  • Plugins de qualidade de vida – como autobean-format (um novo formatador que pode lidar com mais casos extremos analisando e reimprimindo o arquivo), e integração beancheck em editores (flymake para Emacs).

  Olhando para o futuro, a comunidade provavelmente continuará preenchendo lacunas por meio de plugins. Por exemplo, podemos ver mais plugins relacionados a impostos (alguns usuários compartilharam scripts para coisas como cálculo de wash sales ou relatórios fiscais locais específicos).

• Potenciais Recursos Futuros: Com base nas discussões no rastreador de problemas e na lista de e-mails, algumas ideias estão no horizonte (embora não garantidas):

  • Resolução de Tempo: Atualmente, o Beancount rastreia apenas datas (sem timestamps) para transações. Houve perguntas sobre a adição de tempo (para negociações de ações ou ordenação de transações do mesmo dia). Martin Blais decidiu explicitamente que timestamps sub-diários estavam fora do escopo para manter as coisas simples. É improvável que isso mude em breve – portanto, as próximas versões provavelmente não adicionarão resolução de tempo, mantendo a postura de que, se você precisar de tempo, você o incorpora na narração ou em uma conta.
  • Edição GUI Aprimorada: O Fava está continuamente melhorando suas capacidades de edição. Uma possibilidade é um editor web mais completo (com sugestão automática, talvez uma entrada baseada em formulário para novas transações). A base usando tree-sitter no editor do Fava foi lançada. Podemos ver o Fava se tornar não apenas um visualizador, mas um editor mais poderoso, reduzindo a necessidade de abrir um editor de texto para muitas tarefas.
  • Melhor suporte a múltiplos livros-razão: Alguns usuários mantêm vários arquivos Beancount (para diferentes entidades ou para separar finanças pessoais de negócios). Atualmente, incluir arquivos é possível, mas tinha limitações (plugins em arquivos incluídos, etc.). Um plugin recente autobean.include foi criado para incluir com segurança livros-razão externos. No futuro, podemos ver suporte de primeira classe para configurações de múltiplos arquivos – talvez um conceito de “projeto” Beancount com vários arquivos (isso é sugerido por recursos como a configuração beancount.mainBeanFile da extensão VSCode). Isso ajudaria aqueles que executam contabilidade de múltiplas entidades ou desejam modularizar seu livro-razão.
  • Computação em Tempo Real ou Incremental: À medida que os livros-razão crescem, a capacidade de recalcular relatórios rapidamente torna-se importante. Existe uma ideia de um servidor Beancount que permanece em execução e atualiza os resultados à medida que as transações mudam. Isso poderia se manifestar como uma otimização no Fava ou um

Uma ótima terapia para o seu negócio é um livro-razão calmo e equilibrado. As dicas a seguir condensam as orientações mais recentes para pequenas empresas em uma rotina amigável ao Beancount.

Manter um conjunto impecável de livros contábeis não se trata apenas de sobreviver à temporada de impostos; trata-se de entender a saúde financeira do seu negócio em tempo real. Para usuários de um sistema de contabilidade de texto simples como o Beancount, bons hábitos são o motor que transforma um livro-razão simples em uma ferramenta poderosa para insights e crescimento. As dez dicas a seguir foram elaboradas para refinar seu processo, economizar seu tempo e manter seus dados financeiros limpos, auditáveis e prontos para ação.

1. Separe o dinheiro da empresa do dinheiro pessoal​

Esta é a regra de ouro das finanças empresariais por um motivo. Manter uma conta corrente e um cartão de crédito dedicados à sua empresa é a maneira mais limpa de traçar uma linha entre sua vida profissional e pessoal. Isso simplifica drasticamente a preparação de impostos, fornece uma trilha de auditoria clara e ajuda a proteger seus ativos pessoais de responsabilidades comerciais. No Beancount, isso significa que suas transações são classificadas de forma organizada desde o início - sem mais tentar lembrar se aquela compra de café foi uma reunião com um cliente ou uma despesa pessoal.

2. Escolha o regime de caixa ou de competência desde o início e mantenha-o​

Seu método contábil determina quando você registra receitas e despesas. A Receita Federal permite que a maioria das pequenas empresas escolha entre o regime de caixa ou de competência.

• Regime de caixa: Você registra a receita quando o dinheiro entra em sua conta e as despesas quando o dinheiro sai dela. É simples e ideal para empresas com transações diretas e imediatas.
• Regime de competência: Você registra a receita quando a ganha (por exemplo, quando presta um serviço) e as despesas quando as incorre, independentemente de quando o dinheiro muda de mãos. Isso fornece uma imagem mais precisa da lucratividade, especialmente se você gerencia faturas ou solicitações de reembolso de seguro com pagamentos atrasados.

A chave é escolher um método desde o início e aplicá-lo consistentemente. Você pode até declarar sua escolha em seu livro-razão usando o bloco options do Beancount para formalizar a decisão.

3. Reconcilie com frequência​

A reconciliação é o processo de comparar as transações em seu livro-razão do Beancount com seus extratos bancários e de cartão de crédito oficiais. Realizar essa verificação em uma cadência regular - semanal ou mensalmente - é um hábito crucial. Permite que você capture taxas bancárias, identifique possíveis fraudes e identifique quaisquer erros de importação de dados antes que se transformem em uma grande dor de cabeça. Um comando rápido pode mostrar o saldo a ser verificado em relação ao seu extrato.

bean-balance books.bean "Assets:Bank" -e 2025-07-31

4. Automatize as importações sempre que possível​

Seu tempo é melhor gasto atendendo clientes do que digitando dados de transações manualmente. O ecossistema do Beancount brilha aqui. Use ferramentas como bean-extract para criar configurações que leiam arquivos CSV do seu banco, processador de pagamentos (como Stripe ou Square) ou sistema de EHR. Uma vez configurados, esses scripts podem converter automaticamente dados brutos em entradas formatadas do Beancount, reduzindo drasticamente os erros de digitação e liberando horas de trabalho administrativo.

5. Categorize imediatamente - não na época do imposto​

Procrastinar na categorização é uma receita para estresse e imprecisão. Quando uma transação entrar em seu livro-razão, atribua-a à conta correta imediatamente (por exemplo, Income:Therapy:SelfPay, Expenses:Software:EHR, Expenses:CEU). Fazer isso em tempo real garante que você se lembre corretamente do contexto de cada despesa. Um plano de contas bem definido torna esse processo rápido e consistente, transformando seu livro-razão em um relatório rico e em tempo real sobre as operações do seu negócio.

6. Salve cópias digitais de todos os recibos e EOB​

Recibos de papel desbotam e se perdem. Uma abordagem digital primeiro é mais resiliente e eficiente. Digitalize recibos de papel ou salve faturas em PDF e Explicações de Benefícios (EOBs) em uma pasta segura e organizada em seu computador. Com o Beancount, você pode vincular diretamente a esses arquivos de dentro do seu livro-razão usando metadados.

2025-07-15 * "Webinar CEU"
  Expenses:CEU            79.00 USD
  Assets:Bank:Practice
  document: "docs/ceu/2025-07-15-trauma-webinar.pdf"

Isso cria um registro incontestável e independente que é inestimável durante uma auditoria fiscal.

7. Monitore as tendências do fluxo de caixa, não apenas os saldos​

Saber o saldo bancário atual é bom; entender o fluxo de dinheiro que entra e sai do seu negócio é melhor. Use a poderosa linguagem de consulta do Beancount para analisar suas tendências financeiras. Mapeie sua receita mensal versus despesas, identifique seus serviços mais lucrativos ou preveja potenciais crises de caixa durante os meses mais lentos. Essa abordagem proativa, recomendada pelos principais guias de escrituração contábil, permite que você tome decisões estratégicas em vez de reagir a surpresas financeiras.

8. Faça backup e controle de versão do seu livro-razão​

Como seu livro-razão do Beancount é um arquivo de texto simples, você pode usar o Git - um sistema de controle de versão poderoso e gratuito - para gerenciá-lo. Ao manter seu livro-razão em um repositório Git privado (em um serviço como GitHub ou GitLab), você obtém dois benefícios críticos gratuitamente:

1. Um histórico completo: Você pode ver todas as alterações feitas em seu livro-razão.
2. Um backup externo: Seus dados estão protegidos contra falhas de hardware local.

Crie o hábito de "enviar" suas alterações após cada sessão de reconciliação.

9. Revise as demonstrações financeiras mensalmente​

Não espere seu contador lhe dizer como seu negócio está indo. No final de cada mês, use as ferramentas de relatórios do Beancount para gerar demonstrações financeiras importantes, como uma demonstração do resultado e um balanço patrimonial. Compare-as com o mês anterior ou o mesmo mês do ano passado. Essa revisão regular ajuda você a identificar vazamentos de gastos, avaliar seus preços e construir a alfabetização financeira necessária para responder a perguntas de credores ou investidores com confiança.

bean-report books.bean income_statement -e 2025-07-31

10. Orce para impostos durante todo o ano​

Para um profissional autônomo, o dia do imposto nunca deve ser uma surpresa. Trate sua futura conta de imposto como uma despesa recorrente. Crie contas de passivo no Beancount (por exemplo, Liabilities:Tax:Federal, Liabilities:Tax:State) e transfira regularmente uma porcentagem de cada pagamento que você recebe para esses depósitos virtuais. Quando chegar a hora de fazer seus pagamentos trimestrais estimados de impostos, o dinheiro estará reservado e aguardando, tornando o processo totalmente indolor.

Lista de verificação de início rápido​

• Abra contas bancárias separadas para a empresa.
• Escolha o regime de caixa ou de competência e registre-o em suas options.
• Crie scripts para importações CSV do seu banco e EHR com bean-extract.
• Marque cada transação com uma categoria ao chegar.
• Reconcilie semanalmente; faça backup para seu repositório Git privado depois.
• Execute demonstrações mensais e consultas de fluxo de caixa.
• Transfira uma reserva para impostos para uma conta poupança separada de alto rendimento.

Pronto para acalmar seus livros?

Instale o Beancount, confirme sua primeira entrada e deixe que esses dez hábitos forneçam a estrutura necessária para manter sua prática de terapia financeiramente sólida e rica em insights. Feliz escrituração contábil!

Terapia é sobre ouvir; contabilidade é sobre ouvir o seu dinheiro. Quando as anotações das sessões se acumulam e os reembolsos atrasam, um conjunto transparente de livros contábeis se torna a calma no caos.

Gerenciar um consultório particular significa usar dois chapéus: clínico e empresário. Enquanto sua experiência reside em fornecer cuidados, a saúde financeira do seu consultório depende de uma contabilidade clara e consistente. Para terapeutas, essa tarefa vem com seu próprio conjunto único de desafios.

Por que a Contabilidade para Terapia Parece Diferente​

O ritmo financeiro de um consultório de terapia raramente segue um padrão simples e previsível. Essa complexidade decorre de algumas áreas-chave que fazem com que os softwares de contabilidade padrão muitas vezes pareçam inadequados.

• Fluxo de caixa irregular. Seu fluxo de receita raramente é linear. O copagamento de um cliente pode cair na sua conta hoje, mas o reembolso do seguro correspondente pode levar semanas ou até meses para chegar. Adicione planos de pagamento com escala móvel e você estará gerenciando dinheiro que chega em prazos muito diferentes. Isso torna crucial entender a diferença entre quando você ganha dinheiro (contabilidade de regime de competência) versus quando você o recebe (contabilidade de regime de caixa).
• Uma sopa de taxas. As despesas de administrar um consultório moderno se acumulam rapidamente. De assinaturas de Registros Eletrônicos de Saúde (EHR) e taxas de processamento de pagamentos a seguro de responsabilidade civil e desenvolvimento profissional, inúmeros pequenos custos podem consumir silenciosamente suas margens de lucro se não forem acompanhados meticulosamente.
• Isento de imposto sobre vendas, mas com muita carga tributária. Embora a maioria dos serviços de saúde mental esteja isenta de imposto sobre vendas, você não está livre do imposto de renda. Como profissional autônomo, você é responsável por pagar impostos estimados trimestrais, que incluem imposto de renda e contribuições previdenciárias para cobrir a Seguridade Social e o Medicare.
• Sensibilidade à HIPAA. Seus dados financeiros estão interligados com Informações de Saúde Protegidas (PHI). Usar software em nuvem de terceiros para contabilidade pode expandir a "superfície de ataque" do seu consultório, criando outro vetor potencial para vazamentos de dados. Um sistema de contabilidade de texto simples como o Beancount mantém todos os seus dados em seu próprio computador, sob seu controle, reduzindo esse risco.

Um Plano de Sete Etapas com o Beancount​

O Beancount é um sistema de contabilidade poderoso e de código aberto que usa arquivos de texto simples. É gratuito, privado e flexível o suficiente para lidar com a paisagem financeira única de um consultório de terapia. Veja como começar.

• Separe os Fundos Pessoais e do Consultório​

Este é o primeiro passo não negociável das finanças empresariais. Abra uma conta corrente comercial dedicada e um cartão de crédito comercial. A partir de agora, todo pagamento de cliente vai para esta conta e todas as despesas comerciais - de taxas de licenciamento a material de escritório - são pagas com esses fundos. No Beancount, você pode designá-los facilmente, criando um limite claro: cada transação é pessoal ou relacionada ao consultório, eliminando as suposições. Por exemplo, sua nova conta se torna Assets:Bank:Practice.

• Crie um Plano de Contas Amigável para Terapeutas​

Um "plano de contas" é simplesmente uma lista de todas as categorias que você usa para organizar suas transações financeiras. Pense nisso como o sistema de arquivamento para o seu dinheiro. Você começará com os cinco principais tipos de conta: Ativo, Passivo, Patrimônio Líquido, Receitas e Despesas. Em seguida, você pode criar subcontas personalizadas especificamente para o seu consultório de terapia.

2025-07-23 open Income:Therapy:SelfPay       USD
2025-07-23 open Income:Therapy:Insurance      USD
2025-07-23 open Assets:AccountsReceivable       USD
2025-07-23 open Expenses:CEU                  USD
2025-07-23 open Expenses:Software:EHR        USD
2025-07-23 open Expenses:Licensing             USD

Essa estrutura permite que você veja exatamente de onde seu dinheiro está vindo (pagamento particular vs. seguro) e para onde está indo (educação continuada, software, etc.). Isso reflete os planos de contas de melhores práticas publicados para profissionais de saúde mental.

• Escolha o Regime de Caixa ou de Competência (e Siga-o)​

Você precisa decidir quando reconhecer suas receitas e despesas.

• Regime de Caixa: Você registra a receita quando recebe o dinheiro e as despesas quando as paga.
• Regime de Competência: Você registra a receita quando a ganha (por exemplo, quando uma sessão é concluída) e as despesas quando as incorre, independentemente de quando o dinheiro muda de mãos.

Por exemplo, se um cliente pagar antecipadamente $1000 por um pacote de cinco sessões, o regime de caixa registra a receita total de $1000 no dia do pagamento. O regime de competência registraria $200 de receita após cada sessão concluída, dando a você uma imagem mais precisa de seus ganhos mensais.

Regra geral: Consultório individual, poucas reivindicações de seguro → o regime de caixa é mais simples e frequentemente suficiente. Consultório em grupo, muitos reembolsos → o regime de competência oferece uma visão mais clara da lucratividade.

• Acompanhe Contas a Receber e Reembolsos​

Um dos maiores pontos fortes do Beancount é sua capacidade de rastrear o dinheiro que lhe é devido. Quando você envia uma solicitação de reembolso ao seguro, você ainda não foi pago, mas ganhou a receita. Você pode registrar isso em sua conta Assets:AccountsReceivable. Quando o pagamento chegar (muitas vezes por um valor menor do que o cobrado), você pode "liquidar" as contas a receber e contabilizar o desconto do seguro.

2025-07-10 * "Sessão CPT 90837 – pendente BlueCross"
  Assets:AccountsReceivable        150.00 USD
  Income:Therapy:Insurance

2025-07-25 * "Pagamento BlueCross CPT 90837"
  Assets:Bank:Practice           135.00 USD
  Expenses:InsuranceWriteOff      15.00 USD
  Assets:AccountsReceivable     -150.00 USD

Esse processo de duas etapas garante que você nunca perca o controle das reivindicações pendentes e tenha um registro preciso dos ajustes do seguro.

• Categorize as Despesas Dedutíveis Prontamente​

Manter o controle de suas despesas é fundamental para minimizar sua conta de impostos. O IRS permite que você deduza despesas que são "comuns e necessárias" para sua profissão. Para terapeutas, isso inclui cursos de educação continuada (CEU), supervisão obrigatória pelo estado, taxas de renovação de licença, seguro de responsabilidade civil e assinaturas de EHR. Ao categorizar essas despesas à medida que as incorre, você terá um total preciso do ano até a data pronto para suas estimativas trimestrais de impostos e declaração de fim de ano.

• Reconcilie Semanalmente​

A reconciliação é o processo de comparar as transações em seu livro razão Beancount com seus extratos bancários e de cartão de crédito. Confirma que seus registros estão precisos e completos. Uma verificação semanal rápida pode evitar que pequenos erros se tornem grandes dores de cabeça. Com o Beancount, alguns comandos simples em seu terminal são tudo o que você precisa.

# Verifica o saldo final da sua conta bancária profissional
bean-balance books.bean "Assets:Bank:Practice"

# Veja um resumo de suas fontes de renda
bean-query   books.bean "SELECT account, SUM(position) WHERE account ~ 'Income' GROUP BY account"

# Gera um demonstrativo de resultados para o ano até a data
bean-report  books.bean income_statement --end 2025-07-23

Este ciclo simples - categorizar, reconciliar e relatar - é a base de uma gestão financeira sólida para qualquer consultório particular.

• Automatize e Faça Backup​

Adote a automação para economizar tempo e reduzir erros.

• Use uma ferramenta de extração como bean-extract para converter automaticamente arquivos CSV do seu banco ou EHR em entradas de transação Beancount.
• Armazene PDFs de documentos importantes, como Explicação de Benefícios (EOBs) ou certificados CEU, em uma pasta dedicada e vincule-os diretamente à transação relevante em seu livro razão usando os metadados document:.
• Seu livro razão .bean é um arquivo de texto simples, tornando-o perfeito para controle de versão. Envie seu livro razão para um repositório Git privado (como no GitHub ou GitLab) todas as noites para um backup externo seguro.

Armadilhas Comuns (e Soluções Rápidas)​

Mesmo com um bom sistema, alguns erros comuns podem atrapalhar os terapeutas. Veja como identificá-los e corrigi-los.

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

• Abra uma conta bancária e cartão de crédito exclusivos para o consultório.
• Clone o repositório inicial do Beancount e crie seu plano de contas específico para terapia.
• Decida sobre uma base de caixa ou competência e anote-a em suas opções do Beancount.
• Escreva uma configuração de importador simples para seus downloads de CSV do banco, EHR ou seguro.
• Agende uma "Hora do Bean" recorrente (talvez nas tardes de sexta-feira) para seu fluxo de trabalho de importação → reconciliação → relatório.
• Configure backups externos automatizados para seus arquivos .bean e teste o processo de restauração trimestralmente.

Leitura Adicional​

• IRS Topic 513 — Work‑Related Education Expenses (para deduções de CEU)
• The Complete Guide to Bookkeeping for Therapists (visão geral do setor)

Pronto para silenciar o ruído financeiro? Instale o Beancount, registre sua primeira taxa de sessão e deixe a clareza da contabilidade de texto simples dar ao seu consultório o espaço mental e a estabilidade financeira que ele merece. Feliz contabilidade!

Quando suas margens vivem de centavos, a precisão supera a adivinhação.

Vender na Amazon é um jogo de volume e velocidade. Mas por trás da correria de vendas e remessas está uma teia complexa de taxas, devoluções, movimentos de estoque e obrigações fiscais. Softwares de contabilidade padrão geralmente lutam para capturar essa nuance, deixando os vendedores com uma imagem imprecisa de sua verdadeira lucratividade.

É aqui que um sistema de contabilidade em texto simples como o Beancount brilha. Ao lhe dar controle total sobre como você registra as transações, você pode construir uma fonte da verdade financeira que modela perfeitamente os desafios únicos do mercado da Amazon. Este guia fornece um fluxo de trabalho passo a passo para mantê-lo à frente de taxas, impostos e dores de cabeça com o estoque.

Por que a Contabilidade da Amazon é Diferente​

Se você já tentou reconciliar um pagamento da Amazon com seu extrato bancário, já sabe que não é simples. A realidade financeira de um negócio na Amazon está escondida atrás de camadas de abstração.

• Pagamentos quinzenais de montante fixo: A Amazon não envia a receita de cada venda. Em vez disso, ela envia um único depósito a cada duas semanas. Esse montante fixo é um valor líquido, com as vendas brutas reduzidas por taxas de referência, taxas de Logística da Amazon (FBA), custos de publicidade, devoluções e outras retenções. Para entender seu negócio, você deve dividir esse único número em suas partes constituintes. (doola: A Business-in-a-Box™)
• Estoque em todos os lugares: Seu estoque está constantemente em movimento - do seu fornecedor, para um centro de preparação, para vários centros de distribuição FBA em todo o país e, finalmente, para o cliente. Rastrear com precisão seu Custo das Mercadorias Vendidas (CMV) requer saber qual lote de estoque (a qual custo) foi usado para cada venda. (Bean Ninjas)
• Taxas de mercado e promoções: Uma parte significativa de sua receita é imediatamente consumida por taxas: taxas de referência, taxas de coleta e embalagem do FBA, taxas mensais de armazenamento e custos de publicidade. Rastrear cada uma dessas categorias de despesas separadamente é a única maneira de calcular sua margem bruta real e determinar a lucratividade real de um produto. (Profitwise Accounting)
• Colcha de retalhos de impostos sobre vendas: Embora as leis do Facilitador de Mercado da Amazon lidem com a cobrança e remessa de impostos sobre vendas na maioria dos estados, não é uma solução completa. Armazenar estoque em armazéns FBA pode criar "nexo" (uma presença comercial), potencialmente exigindo que você se registre e declare nesses estados, mesmo que nenhum imposto seja devido. Esta é uma área de conformidade complexa que exige rastreamento cuidadoso. (TaxDo)
• Limites mais baixos de 1099-K: Com o limite de relatório para o Formulário 1099-K caindo de US$20.000 para US$ 5.000 em 2024 (e definido para cair para apenas US$ 600 a partir de 2026), quase todos os vendedores sérios receberão um formulário da Amazon relatando seu volume bruto de transações para o IRS. Seus livros devem ser capazes de reconciliar perfeitamente com esse número. (IRS)

Projeto Beancount de Sete Etapas​

Este projeto aproveita a precisão do Beancount para enfrentar a complexidade da Amazon de frente.

1. Separe os Canais Antecipadamente​

Se você vende em várias plataformas, mantenha sua contabilidade para cada uma separada. Dentro de um único arquivo Beancount para sua entidade legal, crie contas dedicadas e hierárquicas para cada mercado. Essa estrutura simplifica as análises e torna a geração de cronogramas de impostos trivial.

2025-07-22 open Income:Amazon               USD
2025-07-22 open Expenses:Amazon:FBAFee      USD
2025-07-22 open Assets:Amazon:Payouts       USD

2. Decomponha Cada Pagamento​

Este é o hábito mais crítico. Nunca registre um depósito da Amazon como uma única linha de receita. Em vez disso, baixe o relatório de liquidação "Todas as Transações" do Seller Central para o período correspondente. Use este relatório para criar uma única transação Beancount que divide o pagamento em seus componentes.

O depósito que você recebe no banco é a entrada de balanceamento. As vendas brutas são creditadas em Income, enquanto todas as taxas e reembolsos são debitados de suas respectivas contas Expenses.

; pagamento quinzenal do relatório de liquidação
2025-07-14 * "Liquidação Amazon #4361"
  Assets:Bank:Operating            8432.17 USD
  Income:Amazon:Sales            -12274.50 USD
  Expenses:Amazon:FBAFee           2454.80 USD
  Expenses:Amazon:Adverts          1012.06 USD
  Expenses:Amazon:Refunds           375.47 USD
  Assets:Amazon:Reserve            -100.00 USD

3. Rastreie o Estoque e o CMV com Lotes​

O Beancount tem um sistema de primeira classe para rastrear o estoque chamado "lotes". Quando você compra estoque, você registra o número de unidades e seu custo específico. Quando uma unidade é vendida, você pode contabilizar esse custo exato, dando a você um cálculo perfeito para o Custo das Mercadorias Vendidas (CMV).

; Compra de 1.000 unidades de um fornecedor
2025-07-01 * "Pedido de Compra do Fornecedor PO-7421"
  Assets:Inventory:WidgetA     1000 WidgetA {@ 4.20 USD}
  Assets:Bank:Operating

; Posteriormente, registre o custo de uma única venda
2025-07-16 * "Venda FBA WidgetA | CMV"
  Expenses:COGS                1 WidgetA {4.20 USD}
  Assets:Inventory:WidgetA

4. Escolha o Regime de Competência para Clareza​

Para qualquer negócio baseado em estoque, o método de competência é superior. Uma abordagem de caixa mostraria uma despesa maciça no mês em que você compra o estoque e lucros artificialmente altos nos meses em que você o vende, distorcendo seu desempenho. A contabilidade de competência corresponde corretamente o custo das mercadorias vendidas (CMV) à receita dessa venda no mesmo período, fornecendo uma imagem muito mais clara do seu lucro bruto. (Bean Ninjas)

5. Automatize as Importações​

Inserir relatórios de liquidação manualmente é educativo no início, mas não é escalável. O ecossistema de texto simples se destaca na automação:

• Use bean-extract para extrair dados de CSVs formatados exportados por serviços como A2X.
• Escreva scripts Python simples para extrair dados diretamente da SP-API da Amazon.
• Use importadores existentes para extrair arquivos CSV bancários para reconciliar depósitos e taxas cobradas diretamente em cartões de crédito.

6. Reconcilie Semanalmente​

Crie o hábito de verificar seus números. Use as poderosas ferramentas de linha de comando do Beancount para validar rapidamente os saldos e revisar o desempenho.

# Verifique seus totais e valores de estoque atuais
bean-balance books.bean "Assets:Inventory" "2025-07-21"

# Gere uma demonstração de resultados para o último período
bean-report books.bean income_statement -e 2025-07-21

7. Arquive os Documentos de Origem​

Para cada transação importante, vincule ao documento de origem. Anexe o PDF oficial de liquidação da Amazon, a fatura do fornecedor para uma compra de estoque ou um recibo de envio usando a sintaxe de metadados do Beancount (document:). Isso cria um registro financeiro independente e pronto para auditoria.

Lista de Verificação de Impostos sobre Vendas e Conformidade​

• Leis do Facilitador de Mercado: Entenda que, embora a Amazon recolha o imposto sobre vendas em seu nome na maioria dos estados, armazenar estoque em estados como Califórnia, Texas ou Pensilvânia ainda pode criar nexo econômico, potencialmente exigindo que você registre sua empresa lá. (TaxGPT)
• Reconciliação 1099-K: Certifique-se de que o total que você registra em Income:Amazon:Sales para o ano corresponda ao valor bruto relatado em seu Formulário 1099-K ao centavo. Qualquer discrepância é uma bandeira de auditoria. (IRS)
• Imposto sobre Vendas Direto: Se você vende por meio de outros canais não cobertos por um facilitador, mantenha uma subárvore de contas Liabilities:SalesTaxPayable:State para rastrear os impostos que você deve diretamente.

Armadilhas Comuns (e Correções)​

• Armadilha: Registrar apenas o depósito líquido da Amazon.
  • Correção: Sempre decomponha os pagamentos usando o relatório de liquidação completo.
• Armadilha: Ignorar devoluções reembolsadas ou mercadorias danificadas.
  • Correção: Registre a despesa inicial do reembolso e o reembolso subsequente da Amazon como um crédito separado.
• Armadilha: Esquecer as reservas rotativas.
  • Correção: A Amazon geralmente retém um saldo de "reserva" dos pagamentos, especialmente para novas contas. Rastreie esse dinheiro que você deve em uma conta dedicada Assets:Amazon:Reserve.
• Armadilha: Incompatibilidade de aliases de SKU entre seu sistema e o da Amazon.
  • Correção: Normalize todos os códigos de SKU em seus scripts de importação para garantir que as pesquisas de CMV não falhem.

Lista de Tarefas de Início Rápido​

• Ative e baixe seu primeiro relatório de liquidação no Seller Central.
• Clone um repositório inicial do Beancount e crie um plano de contas específico para a Amazon.
• Escreva um pequeno script importador que converte um CSV de liquidação em uma transação Beancount (arquivo .txn).
• Agende um lembrete semanal para extrair novos relatórios e executar bean-check para garantir que seus arquivos sejam válidos.
• Revise sua demonstração de resultados mensalmente para tomar decisões baseadas em dados sobre gastos com anúncios, preços e estoque.

Leitura Adicional​

• Amazon Seller Central → Perguntas Frequentes sobre 1099-K
• Aviso do IRS 2024-85 sobre limites do Formulário 1099-K
• Guia de CMV do Bean Ninjas para vendedores da Amazon

Envie mais, se preocupe menos - mantenha seus beans balanceados. Boas vendas!

Livros-razão feitos à mão superam planilhas emaranhadas - especialmente quando cada centavo conta.

Para os artistas, fabricantes e curadores do Etsy, a paixão impulsiona o negócio. Mas, à medida que sua loja cresce, a clareza financeira se torna tão importante quanto a visão criativa. Conciliar taxas, rastrear custos de material e se preparar para impostos pode ser opressor, afastando você da bancada de trabalho.

E se você pudesse gerenciar as finanças da sua loja com o mesmo cuidado e precisão que você coloca em seus produtos? Este guia apresenta um fluxo de trabalho de contabilidade em texto simples usando o Beancount, um mecanismo de código aberto projetado para precisão e controle. É um método que ajuda você a dominar seus números para que possa se concentrar em seu ofício.

Por que a Contabilidade do Etsy é Diferente​

Uma loja Etsy tem uma impressão digital financeira única, com complexidades que os softwares de contabilidade genéricos geralmente ignoram.

• Taxas de marketplace em todos os lugares: Seu pagamento final é o que resta depois que o Etsy recebe sua parte. Taxas de listagem, taxas de transação, taxas de processamento de pagamento e custos de publicidade corroem cada venda. Sem rastreá-los individualmente, você não pode saber suas verdadeiras margens de lucro. (Bench)
• Imposto sobre vendas controlado pela plataforma: Em uma grande vitória para os vendedores, o Etsy agora calcula, coleta e repassa automaticamente o imposto sobre vendas em seu nome na maioria dos estados. No entanto, se você vende em outros canais ou tem presença física em determinados estados, você ainda pode ter suas próprias obrigações de imposto sobre vendas devido às regras de "nexo". (Bench)
• Cadência de pagamento flexível: Dependendo das suas configurações e histórico da conta, o Etsy pode depositar seus fundos diariamente, semanalmente, quinzenalmente ou mensalmente. Essa flexibilidade pode tornar o fluxo de caixa imprevisível, especialmente quando os fundos são mantidos em reserva ou atrasados. (Ajuda do Etsy)
• Limites mais baixos para o 1099-K: Os dias de passar despercebido pelo radar fiscal acabaram. O limite de relatório do IRS para o Formulário 1099-K, que relata suas vendas brutas, está definido em US$5.000 para 2024 e está planejado para cair para apenas US$ 600 até 2026. Isso significa que quase todas as lojas receberão um formulário do IRS e seus livros devem ser capazes de reconciliá-lo perfeitamente. (IRS)

Projeto Beancount em Sete Etapas Rápidas​

Este projeto em texto simples ajudará você a construir um sistema de contabilidade claro, preciso e sem estresse.

1. Separe os Canais desde o Início​

Se o Etsy não for seu único canal de vendas, crie contas de receita e despesas separadas para cada um. Essa simples separação no nível superior do seu plano de contas mantém suas análises limpas e facilita muito o período de impostos.

2025-07-22 open Income:Etsy               USD
2025-07-22 open Expenses:Etsy:ListingFee   USD
2025-07-22 open Assets:Etsy:Payout         USD

2. Detalhe Cada Pagamento​

Nunca registre um depósito do Etsy como uma única linha de receita. Em vez disso, baixe seu CSV da Conta de Pagamento mensal do seu Gerenciador de Loja. Use este relatório para criar uma única transação Beancount que "detalha" cada depósito em suas vendas brutas e componentes de taxas individuais.

; pagamento semanal do CSV da Conta de Pagamento do Etsy
2025-07-15 * "Depósito Etsy #2025-28"
  Assets:Bank:Operating             1842.77 USD
  Income:Etsy:Sales               -2100.00 USD
  Expenses:Etsy:TransactionFee        136.50 USD  ; 6.5 %
  Expenses:Etsy:PaymentProcessing      66.00 USD  ; 3 % + $0.25 por pedido
  Expenses:Etsy:ListingFee             14.00 USD  ; $0.20 x 70 renovações
  Assets:Etsy:Reserve                -75.73 USD

3. Rastreie o Inventário & CPV com Lotes​

Para vendedores de bens físicos, o recurso "lotes" do Beancount é um divisor de águas para rastrear o Custo das Mercadorias Vendidas (CPV). Quando você compra matérias-primas, você as registra como inventário a um custo específico. Quando você vende um produto acabado, você pode contabilizar o custo exato dos materiais usados.

; Compra de materiais a granel para inventário
2025-07-01 * "Compra de fio a granel | Fornecedor XYZ"
  Assets:Inventory:FioAzul        500 FioAzul {@ 3.45 USD}
  Assets:Bank:Operating

; Registre o CPV quando um item for vendido
2025-07-20 * "Cachecol Azul Vendido | Pedido #1234"
  Expenses:COGS                  1 FioAzul {3.45 USD}
  Assets:Inventory:FioAzul

4. Escolha seu Método de Contabilidade Cedo​

Você tem duas opções principais:

• Base de caixa: Simples e fácil. Você registra a receita quando o dinheiro chega ao seu banco e as despesas quando você as paga. Isso funciona bem para lojas pequenas e de hobby.
• Base de competência: Fornece uma imagem mais real da lucratividade. Você registra a receita quando faz a venda (não quando recebe o pagamento) e as despesas quando as incorre. Isso é melhor para lojas que compram suprimentos a granel ou vendem itens sob encomenda. (Bench)

5. Automatize as Importações​

Economize tempo automatizando a entrada de dados. O ecossistema de texto simples oferece várias opções:

• Use bean-extract com regras personalizadas para analisar os arquivos CSV do Etsy.
• Configure um importador CSV bancário para capturar cobranças de anúncios ou etiquetas de envio pagas com cartão de crédito.
• Para usuários avançados, escreva um script Python para extrair relatórios diretamente da API do Etsy.

6. Reconcilie Semanalmente​

Reserve alguns minutos a cada semana para verificar seus números. Use as ferramentas de linha de comando do Beancount para validar rapidamente seus saldos e detectar quaisquer problemas, como reservas liberadas, reembolsos ou ajustes de taxas antes do final do mês.

# Verifique o saldo da sua conta de reserva do Etsy
bean-balance books.bean "Assets:Etsy:Payout" "2025-07-21"

# Gere um demonstrativo de resultados para o último período
bean-report books.bean income_statement -e 2025-07-21

7. Anexe Documentos de Origem​

Crie um registro completamente independente e auditável vinculando aos documentos de origem diretamente nos metadados da sua transação. Isso é perfeito para recibos de fornecedores, PDFs de etiquetas de envio ou pedidos de compra.

2025-07-12 * "Etiqueta de envio do Etsy para o pedido #4321"
  Expenses:ShippingLabel         4.25 USD
  Assets:Bank:Operating
  document: "docs/labels/2025-07-12-order4321.pdf"

Conheça suas Taxas do Etsy (EUA)​

Para obter uma imagem real do seu lucro, rastreie cada tipo de taxa em sua própria conta de despesas:

• Taxa de listagem: $0.20 por item, que se renova automaticamente a cada 4 meses ou após uma venda. (Etsy)
• Taxa de transação: 6.5% do valor total do pedido (incluindo preço do item, frete e embalagem para presente). (Etsy)
• Taxa de processamento de pagamento: Varia de acordo com o país, mas para os EUA, normalmente é de 3% + $0.25 por pedido processado pelo Etsy Payments. (Ajuda do Etsy)
• Assinatura (Etsy Plus): $10/mês opcionais para ferramentas adicionais. (Bench)

Dicas de Imposto sobre Vendas e Conformidade​

• Embora o Etsy recolha o imposto sobre vendas para a maioria dos estados dos EUA, esteja ciente de que vender em outras plataformas ou ter uma oficina física pode criar obrigações fiscais adicionais ("nexo"). Acompanhe seus limites de vendas com cuidado. (Bench)
• Assim que os limites do 1099-K se aplicarem à sua loja, certifique-se de que o total de Income:Etsy:Sales no Beancount seja reconciliado com o valor bruto no formulário até o centavo. (IRS)

Armadilhas Comuns (e Correções)​

• Armadilha: Contabilidade de depósito líquido.
  • Correção: Sempre use o CSV de pagamento para dividir os depósitos em vendas brutas, taxas e reservas.
• Armadilha: Custos de inventário obsoletos.
  • Correção: Registre suas compras de suprimentos e materiais como inventário no momento em que você os compra. Não espere até que o produto acabado seja vendido.
• Armadilha: Pontos cegos de reembolso.
  • Correção: Ao emitir um reembolso, registre a despesa e também reverta a entrada original do CPV para mover o custo de volta para sua conta de inventário.
• Armadilha: Ignorar reservas retidas.
  • Correção: Abra uma conta Assets:Etsy:Reserve para rastrear o dinheiro que o Etsy está retendo. Isso mantém seus demonstrativos de fluxo de caixa honestos.

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

• No seu Gerenciador de Loja, configure extratos mensais e baixe seu primeiro CSV.
• Clone o repositório inicial do Beancount e esboce o plano de contas da sua loja.
• Decida sobre a contabilidade de caixa ou competência e comprometa-se com ela.
• Escreva um script importador básico ou arquivo de regras e agende uma sincronização semanal.
• Reconcilie seus pagamentos, níveis de inventário e saldo bancário todas as segundas-feiras.
• Gere um demonstrativo de resultados a cada mês e revise suas tendências de margem bruta.
• Faça backup de seus arquivos .bean usando o Git e uma solução de armazenamento externo.

Pronto para integrar a contabilidade ao seu fluxo de trabalho criativo? Instale o Beancount, confirme sua primeira entrada e deixe a clareza do texto simples liberar mais tempo na sua bancada de trabalho. Feliz contabilização!

No labirinto da gestão de finanças pessoais, o Beancount surge como um farol de clareza e precisão para a escrituração contábil em texto simples. Particularmente quando se trata de gerenciar contas a receber — dinheiro esperado de terceiros — o Beancount oferece uma abordagem estruturada para manter seus registros financeiros em ordem impecável. Este blog irá guiá-lo pelas complexidades do rastreamento de contas a receber, processamento de reembolsos e gerenciamento de transações não resolvidas com o Beancount. Quer você esteja devolvendo uma compra, emprestando dinheiro ou aguardando um reembolso, este post é o seu roteiro para a clareza financeira.

Entendendo Contas a Receber no Beancount:​

Contas a receber representam dinheiro que lhe é devido. Isso pode vir de uma variedade de cenários, como após uma devolução de compra aguardando um reembolso ou quando você empresta dinheiro a alguém. Por exemplo, considere que você devolveu uma pulseira de relógio para uma loja online como Amazon.com e está aguardando um reembolso. No Beancount, esta transação é registrada como dinheiro movendo-se de sua responsabilidade de cartão de crédito para seus ativos como contas a receber:

2023-10-31 * "Amazon.com" "[Return] Watch Strap"
    Liabilities:CreditCard:Chase                                 -12.00 USD
    Assets:Receivables

Gerenciando Reembolsos:​

Uma vez que o reembolso é processado e você recebe o dinheiro, outra transação é registrada para compensar o saldo em Contas a Receber. Isso garante que suas contas reflitam o dinheiro de volta em sua posse:

2023-11-01 * "Amazon.com" "[Refund] Watch Strap"
    Liabilities:CreditCard:Chase                                  12.00 USD
    Assets:Receivables

Ciclo Completo da Transação:​

Uma transação completa de entrada e saída envolvendo contas a receber combina ambas as transações acima e é apresentada da seguinte forma, demonstrando uma conta equilibrada após o reembolso:

2023-10-31 * "Amazon.com" "[Return] Watch Strap"
    Liabilities:CreditCard:Chase                                 -12.00 USD
    Assets:Receivables

2023-11-01 * "Amazon.com" "[Refund] Watch Strap"
    Liabilities:CreditCard:Chase                                  12.00 USD
    Assets:Receivables

Lidando com Transações Não Resolvidas:​

Para transações onde o reembolso ou pagamento ainda não foi recebido, o Beancount emprega a tag #UNRESOLVED. Esta tag ajuda a identificar e rastrear valores que ainda estão pendentes. Por exemplo:

2023-10-31 * "John Doe" "Lending Money" #UNRESOLVED
    Liabilities:CreditCard:Chase                                 -100.00 USD
    Assets:Receivables

Ao focar nas transações marcadas como #UNRESOLVED, você pode rapidamente verificar quais valores ainda precisam ser liquidados.

Mantendo um Saldo Zero:​

Em um livro-razão adequado, a soma de todas as transações na conta Assets:Receivables, excluindo aquelas marcadas com #UNRESOLVED, deve idealmente retornar a zero. Isso garante que todos os fundos esperados foram contabilizados, mantendo a integridade de seus registros financeiros.

Por exemplo, um livro-razão válido pode parecer assim, com uma transação não resolvida claramente marcada, aguardando encerramento:

2023-10-31 * "Amazon.com" "[Return] Watch Strap"
    Liabilities:CreditCard:Chase                                 -12.00 USD
    Assets:Receivables

2023-11-01 * "Amazon.com" "[Refund] Watch Strap"
    Liabilities:CreditCard:Chase                                  12.00 USD
    Assets:Receivables

2023-10-31 * "John Doe" "Lending Money" #UNRESOLVED
    Liabilities:CreditCard:Chase                                 -100.00 USD
    Assets:Receivables

Um livro-razão inválido é aquele onde uma transação faz com que a conta de Contas a Receber não zere, necessitando da tag #UNRESOLVED para correção.

Conclusão​

Navegar pelas contas a receber no Beancount não precisa ser assustador. Com uma compreensão clara de como registrar transações, gerenciar reembolsos e ficar de olho nas transações não resolvidas, você pode manter registros financeiros precisos e confiáveis. Adotar a abordagem estruturada do Beancount para a gestão de contas a receber não apenas simplifica seu rastreamento financeiro, mas também traz tranquilidade, sabendo que cada centavo é contabilizado. Então, por que não aproveitar o poder do Beancount para tornar sua gestão financeira tão tranquila

Como fundador, você assume todos os papéis: CEO, vendedor, gerente de produto e, sim, contador. Mas, à medida que seu negócio cresce, as horas gastas reconciliando transações começam a parecer menos com uma economia inteligente e mais com uma distração cara. Então, quando é o momento certo para entregar os livros?

A resposta não é sobre abrir mão do controle; é sobre tomar uma decisão baseada em dados. Veja como usar seu livro-razão Beancount para decidir se deve continuar fazendo você mesmo ou contratar um profissional.

Resumindo: Se você cobra R$425/hora pelo seu tempo e gasta apenas quatro horas por mês com contabilidade, esse trabalho está custando R$ 1700 em receita perdida. Um contador remoto típico começa em torno de R$ 1245/mês, além de liberar você para realmente fazer o negócio crescer. (Bench)

1. Coloque um Preço no Seu Próprio Tempo​

A métrica mais importante nesta decisão é o seu próprio custo de oportunidade. Cada hora que você gasta categorizando despesas é uma hora que você não está gastando em vendas, desenvolvimento de produtos ou estratégia.

A matemática é simples:

1. Acompanhe quantas horas você gasta em tarefas de contabilidade a cada mês (reconciliação, codificação, correção de erros).
2. Multiplique essas horas pela sua taxa de faturamento efetiva.
3. Compare esse valor com a taxa mensal de um contador externo (uma taxa inicial típica é em torno de R$ 1245/mês).

Se o custo do seu tempo for maior, você tem uma clara vantagem na delegação. Você pode até mesmo acompanhar isso diretamente no Beancount.

; Acompanhe o custo de oportunidade do seu tempo
2025-07-31 * "Tempo de contabilidade de julho"
  Expenses:Admin:BookkeepingTime      4.00 H   ; Sua unidade personalizada para horas
  Equity:OwnerTime                   -1700.00 BRL
  ; metadata: rate:425

Aqui, H é uma moeda personalizada para "Horas". Você pode registrar o tempo diretamente e usar um script ou uma diretiva price para atribuir seu valor em reais, tornando o custo do seu próprio trabalho uma parte explícita dos seus relatórios financeiros.

2. Conte os Custos Ocultos do DIY​

O custo do seu tempo não é o único fator. A contabilidade DIY carrega riscos que podem ser muito mais caros do que um honorário mensal.

• Erros Fiscais: Livros confusos são um pesadelo para os contadores. Um contador pode cobrar de R$750 a R$ 2000 por hora apenas para limpar seus registros antes mesmo de começar a declaração de imposto de renda (Bench).
• Deduções Perdidas & Multas da Receita Federal: Pequenos erros não intencionais - como classificar erroneamente uma despesa ou esquecer de registrar uma transação em dinheiro - podem se acumular ao longo do tempo, levando a multas, juros e uma conta de imposto mais alta (Bench).
• Burnout do Fundador: O desgaste mental da reconciliação noturna é real. Ele drena o foco e a energia que deveriam ser dedicados a atividades de alta alavancagem, como vendas e inovação de produtos (Bench).

Mitigação Beancount: Você pode reduzir erros adicionando um gancho Git pré-commit que se recusa a confirmar alterações se bean-check falhar ou se as transações não tiverem uma tag de categoria. Isso impõe disciplina, mesmo quando você está cansado.

3. Três Maneiras de um Contador (ou Disciplina Beancount) Economizar Dinheiro​

Se você contratar um profissional ou simplesmente aprimorar seu próprio processo, uma boa contabilidade se paga.

1. Declaração de Imposto de Renda Mais Limpa: Livros organizados e precisos significam menos horas de contador gastas em limpeza, o que se traduz diretamente em uma conta menor.
2. Visão em Tempo Real do Caixa: Saber sua posição exata de caixa ajuda a evitar taxas caras de cheque especial e a necessidade de financiamento de última hora com juros altos.
3. Amortecedor de Estresse: Operações financeiras estáveis e previsíveis reduzem o estresse do fundador, levando a uma melhor tomada de decisões e uma cultura empresarial mais saudável.

4. Quando Você Não Deve Contratar Ainda​

Contratar um contador nem sempre é a decisão certa. Em alguns casos, o DIY ainda é a escolha financeira mais inteligente.

• Você é pré-receita ou tem um fluxo de caixa muito baixo. Nesta fase, cada real deve ser direcionado para vendas e aquisição de clientes. Concentre-se em obter receita primeiro (Bench).
• Suas finanças são simples. Se você tem uma conta bancária, um feed do Stripe e menos de ~60 transações por mês, provavelmente pode gerenciar tudo no Beancount e Fava em menos de uma hora por semana.

5. A Opção Híbrida: Seu Livro-Razão Beancount “Pronto para o Contador”​

A melhor solução costuma ser híbrida. Use o Beancount para fazer o trabalho pesado sozinho, mas mantenha seus livros tão limpos que um profissional possa intervir para tarefas de alto valor.

• Automatize a Ingestão: Configure o bean-extract para ser executado todas as noites, puxando novas transações automaticamente.
• Padronize seu Plano de Contas: Use nomes de contas convencionais (Expenses:Software, Assets:Bank:Checking) para que qualquer profissional possa entender seu livro-razão instantaneamente.
• Anexe Documentos de Origem: Para cada despesa acima de R$ 375, use os metadados link: para anexar um PDF do recibo ou fatura.
• Siga uma Lista de Verificação de Fechamento Mensal:
  1. Reconcilie todas as contas bancárias e de cartão de crédito.
  2. Execute bean-check para garantir que não haja erros.
  3. Exporte extratos em PDF com bean-report balance_sheet e bean-report income_statement.
• Execute uma Transferência Trimestral: Forneça ao seu contador uma tag Git ou um arquivo simples (books-T3-2025.tar.gz). Eles podem verificar seu trabalho, adicionar lançamentos de ajustes complexos (como acréscimos e depreciação) e preparar pacotes de impostos.

Este modelo mantém seus custos baixos porque o profissional está tocando apenas em dados limpos e revisados, enquanto você ainda obtém o benefício de demonstrações financeiras de nível profissional.

6. Matriz de Decisão Rápida​

7. Próximos Passos​

1. Registre seu tempo. Para sua próxima sessão de contabilidade, acompanhe cada minuto que você gasta nela.
2. Faça as contas. Multiplique esse tempo pela sua taxa de faturamento e compare com as taxas de mercado acima.
3. Escolha seu caminho. Aperfeiçoe seu fluxo de trabalho Beancount usando o modelo híbrido ou comece a entrevistar contadores que se sintam confortáveis ​​trabalhando com um livro-razão de texto simples.

De qualquer forma, a contabilidade intencional é sempre mais barata do que improvisar. Com o Beancount como sua fonte imutável de verdade, você saberá exatamente quando a ajuda profissional se paga - e quando não.

Uma empresa próspera e uma carteira saudável compartilham uma característica: limites.

Para qualquer empresário, desde um freelancer autônomo até o fundador de uma startup em crescimento, uma das disciplinas financeiras mais críticas é a separação rigorosa das finanças empresariais e pessoais. Misturar fundos — usar sua conta empresarial para compras de supermercado ou pagar um fornecedor da empresa com seu cheque pessoal — cria um cenário financeiro confuso e opaco. Isso não apenas convida ao escrutínio das autoridades fiscais, mas também rouba insights claros sobre o desempenho real da sua empresa.

Felizmente, um sistema de contabilidade de texto simples como o Beancount fornece a estrutura perfeita para impor esses limites essenciais diretamente em seu livro-razão.

Por que a Separação Importa​

Deixar de separar suas finanças não é apenas um mau hábito; acarreta riscos significativos e mascara informações valiosas sobre os negócios.

• Clareza com a Receita Federal: A Receita Federal não está apenas sugerindo que você mantenha contas bancárias separadas; eles a recomendam fortemente. Quando os fundos empresariais e pessoais são misturados, torna-se difícil provar quais despesas são deduções comerciais legítimas. Essa ambiguidade pode levar a perguntas e complicações que é melhor evitar.
• Risco de Auditoria: Misturar transações é uma grande bandeira vermelha para os auditores. Se seus livros são uma bagunça emaranhada de atividades pessoais e empresariais, você corre o risco de ter deduções válidas rejeitadas ou até mesmo enfrentar penalidades. Um livro-razão limpo e separado demonstra profissionalismo e torna qualquer auditoria potencial mais tranquila e menos estressante.
• Insights Mais Claros: Como você pode saber sua verdadeira margem de lucro se o fluxo de caixa da sua empresa está obscurecido por gastos pessoais? Um livro-razão empresarial independente oferece uma visão sem filtros da saúde financeira da sua empresa. Você pode rastrear a receita com precisão, analisar despesas e calcular obrigações fiscais sem o "ruído" de sua vida financeira pessoal.

Principais Diferenças em Resumo​

O propósito, as regras e a estrutura da contabilidade empresarial e pessoal são fundamentalmente diferentes. Compreender esses contrastes é fundamental para manter registros precisos.

Um Plano de Quatro Etapas com o Beancount​

O Beancount simplifica a construção de uma parede firme entre seus dois mundos financeiros. Aqui está um fluxo de trabalho prático para fazer isso direito.

• 1 — Abrir Contas Dedicadas​

Antes mesmo de escrever sua primeira entrada no Beancount, abra uma conta corrente empresarial dedicada e um cartão de crédito empresarial. Essa separação física é a base de uma contabilidade limpa. Feito isso, espelhe essa estrutura em seu livro-razão do Beancount.

2025-07-23 open Assets:Bank:Business   USD
2025-07-23 open Assets:Bank:Personal   USD

Esta configuração simples garante que cada transação possa ser claramente atribuída às suas finanças empresariais ou pessoais desde o momento em que ocorre.

• 2 — Registrar Contribuições e Retiradas do Proprietário​

Como proprietário, você movimentará dinheiro entre seus fundos pessoais e a empresa. Estes não são receitas ou despesas. Em vez disso, eles são rastreados por meio de uma conta de Patrimônio Líquido.

• Contribuição: Quando você coloca seu próprio dinheiro na empresa para iniciá-la ou cobrir um déficit.
• Retirada: Quando você retira dinheiro da empresa para uso pessoal (é assim que muitos proprietários únicos se "pagam").

; Injeção de capital para iniciar o negócio
2025-07-23 * "Contribuição do Proprietário"
  Assets:Bank:Business    10,000.00 USD
  Equity:Owner:Contrib

; Retirando dinheiro para despesas pessoais
2025-08-05 * "Retirada do Proprietário para aluguel"
  Equity:Owner:Draw        2,500.00 USD
  Assets:Bank:Business

Ao registrar isso como transações de patrimônio líquido, você garante que elas não inflacionem incorretamente suas despesas comerciais ou reduzam seu lucro relatado.

• 3 — Lidar com Recibos Mistos Rapidamente​

Erros acontecem. Você pode acidentalmente usar seu cartão de crédito empresarial para pagar um jantar pessoal. A chave é corrigi-lo imediatamente em seu livro-razão. Não exclua a transação; reclassifique-a como uma retirada do proprietário.

2025-08-07 * "Compras pessoais com cartão da empresa"
  Equity:Owner:Draw           72.35 USD
  Assets:Bank:Business

Esta entrada reflete corretamente que os fundos da empresa foram usados para uma despesa pessoal, tratando-a como dinheiro que você retirou da empresa. Isso impede que você acidentalmente reivindique uma despesa pessoal não dedutível em seus impostos.

• 4 — Reconciliar e Revisar em um Cronograma​

A consistência é sua melhor defesa contra livros confusos. Reserve um tempo semanal ou mensalmente para reconciliar suas contas empresariais. Use as ferramentas do Beancount para garantir que seu livro-razão corresponda aos seus extratos bancários e para revisar o desempenho da sua empresa.

# Verifique o saldo bancário da sua empresa em relação ao seu extrato
bean-balance books.bean "Assets:Bank:Business"

# Gere um demonstrativo de resultados para analisar a lucratividade
bean-report  books.bean income_statement -e 2025-08-31

Esse hábito de revisão regular atende aos requisitos de manutenção de registros da Receita Federal e o mantém informado sobre a saúde financeira da sua empresa.

Considerações Fiscais​

• Impostos Estimados: Para evitar uma conta de imposto dolorosa, trate seus impostos futuros como uma despesa comercial contínua. Crie contas de passivo (Liabilities:Tax:Federal, Liabilities:Tax:State) e mova regularmente uma porcentagem definida de cada depósito para elas. Quando os pagamentos trimestrais forem devidos, o dinheiro já estará esperando.
• Custos Pessoais Não Dedutíveis: Lembre-se da regra da Receita Federal: as despesas comerciais devem ser "ordinárias e necessárias" para o seu trabalho. Suas refeições pessoais, custos de deslocamento e assinaturas não comerciais não se qualificam e devem ser mantidos totalmente fora da demonstração de lucros e perdas da sua empresa.

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

• Abra contas bancárias e de cartão de crédito exclusivas para empresas.
• Crie um plano de contas Beancount com Assets:Bank:Business, Equity:Owner:Contrib e Equity:Owner:Draw.
• Decida sobre sua base contábil (caixa ou competência) e anote-a em suas options do Beancount.
• Marque quaisquer cobranças pessoais acidentais em cartões de empresa como Equity:Owner:Draw imediatamente.
• Reconcilie semanalmente; faça backup do seu arquivo .bean em um repositório Git privado.
• Revise seu demonstrativo de resultados, balanço patrimonial e relatórios de fluxo de caixa todos os meses.

Conclusão: Dinheiro separado, livros-razão separados. O Beancount torna a parede entre suas finanças empresariais e pessoais explícita — e com controle de versão — para que sua empresa permaneça pronta para auditoria, enquanto seu hábito de café com leite não é da conta de ninguém além de você. Feliz contabilização!

Transações imobiliárias podem constituir a maior atividade financeira na vida de uma família. Este artigo explica como modelar imóveis no Beancount. Eu trato imóveis como um ativo e a valorização da casa como ganho não realizado. Além disso, a hipoteca é modelada como um passivo, e os juros são considerados uma despesa.

Vamos supor que o Sr. A comprou uma casa de luxo localizada na 123 ABC Street, XYZ City, CA, 12345 em 1º de janeiro de 2020, por um preço de 1 milhão. A taxa de juros é de 3,0%, o pagamento inicial é de 20%, e o valor do empréstimo é de 800.000.

Criar Contas​

Primeiramente, tratamos a casa como um Ativo. Como a casa está sendo listada como um Ativo, ela precisa receber uma unidade. Neste caso, a quantidade da unidade é apenas uma, é improvável que haja múltiplas, e mesmo que seja a enésima casa, gostaríamos de registrá-la em um Ativo separado. Ou seja, uma casa corresponde a um Ativo, e este Ativo tem uma unidade especial, seu valor só pode ser 1.

2019-12-31 commodity HOUSE.ABC
  name: "123 ABC Street, XYZ City, CA, 12345"

2019-12-31 open Assets:Property:US:CA:123ABC                        HOUSE.ABC
2019-12-31 open Liabilities:Bank:US:SomeBank:Mortgage:Loan          USD

Na primeira linha, definimos uma unidade de commodity representando a casa. Na quarta linha, definimos uma conta de Ativo, que detém a unidade de commodity previamente definida como a casa. Na quinta linha, definimos uma conta para o banco credor. Como é um passivo, ela se enquadra na categoria de Passivos.

Compra​

Com as contas configuradas como acima, o ato de comprar uma casa é equivalente a

empréstimo de dinheiro (dívida) + gasto de dinheiro (pagamento inicial) = 1 casa em ativo

A referência mais importante ao comprar uma propriedade é provavelmente a Declaração de Acordo do Comprador (Buyer’s Settlement Statement), que descreve claramente o fluxo de dinheiro.

2020-01-01 * "Buying the house"
    Assets:Property:US:CA:123ABC                  1 HOUSE.ABC {1,000,000 USD}
    Assets:Bank:US:SomeBankA                      -100,000 USD
    Assets:Bank:US:SomeBankB                      -101,000 USD
    Liabilities:Bank:US:SomeBank:Mortgage:Loan    -800,000.00 USD
    Expenses:Home:Insurance                       1,000 USD
    Expenses:Home:Mortgage:Loan:ClosingCost

Aqui, estamos detalhando a transação de compra da casa, onde o dinheiro sai de alguns bancos (usado para pagamento inicial e outras despesas), um empréstimo é feito (adicionando a passivos), e uma casa é adquirida (adicionada a ativos).

Pagar hipotecas​

Com base no registro de compra acima, atualmente devemos 800.000 USD. Devido aos juros, e considerando que todos os empréstimos nos EUA são amortizados igualmente em termos de principal e juros, o pagamento mensal inclui uma parte para juros e uma parte para o principal. Nas fases iniciais, os juros constituem a maior parte.

Para registrar o pagamento do empréstimo, tudo o que você precisa fazer é verificar o extrato do seu banco credor. Você só precisa saber quanto do principal está pagando a cada mês, e o restante são juros. Os juros são contabilizados como uma Despesa.

2020-02-01 * "Mortgage payment"
    Assets:Bank:US:SomeBank:Saving:Joint              -3,372.83 USD
    Liabilities:Bank:US:SomeBank:Mortgage:Loan         1,376.26 USD
    Expenses:Home:Mortgage:Loan:Interest

Esta entrada detalha o pagamento mensal da hipoteca, que é subtraído da sua conta poupança conjunta. O pagamento do principal reduz o passivo, enquanto a parte dos juros é tratada como uma despesa.

Valorização​

Se você deseja registrar a valorização da propriedade, algumas pessoas criam uma conta separada, registrando apenas a valorização da propriedade atual. Considerando que o valor da casa pode aumentar ou diminuir, essa valorização pode ser negativa. A vantagem disso é que no resumo dos seus ativos totais, essas duas contas serão incluídas, uma para o valor da casa no momento da transação, e outra para a valorização atual da casa, refletindo assim o preço em tempo real da casa.

Eu não adotei este método, principalmente pelos seguintes motivos:

1. O valor atual da casa só pode ser uma estimativa, apenas para referência, sem valor prático. Geralmente, só consigo a avaliação da propriedade em sites como Redfin ou Zillow, e pessoalmente não acho que tenha alto valor de referência. Também não considerei incorporar essas valorizações nos ativos totais em tempo real.
2. Pessoalmente, acho que antes da hipoteca ser quitada, se o fluxo de caixa da casa for negativo, até certo ponto, a propriedade ainda é um passivo. Portanto, incorporá-la aos ativos prematuramente lhe dará uma ilusão de ativos enriquecidos e valorização, e eu pessoalmente quero evitar essa ilusão.

O método que uso para registrar a valorização da propriedade, que também será discutido mais tarde sobre como modelar RSUs. Este método é usar uma unidade de moeda virtual. Assumindo que sua moeda base seja USD, podemos usar USD.UNVEST (parece que não há necessidade de criar uma nova Commodity para isso) para indicar que este ativo é calculado em uma moeda especial. O crescimento ou redução deste ativo não será registrado em USD. Desta forma, posso atingir meu objetivo original, ou seja, registrar a valorização da casa, e essa valorização não será incluída no balanço final (Balance Sheet).

2020-01-01 price HOUSE.ABC                          1,000,000 USD
2025-01-01 price HOUSE.ABC                          1,400,000 USD.UNVEST

Você só precisa precificar sua propriedade para USD.UNVEST regularmente.

Assim, na página de Commodities do Fava, você pode acompanhar a tendência do preço de referência da casa. Mas na página do Balanço Patrimonial, o preço da casa ainda é o preço da casa no momento da transação. Ou seja, seus ativos totais ainda são o dinheiro do seu pagamento inicial daquela época, mais o principal que você continua pagando. A mudança final deste ativo só deve ocorrer quando você compra uma casa.

Venda​

Como nenhuma propriedade foi vendida ainda e as várias taxas diversas no meio não estão claras, este é um cenário hipotético.

Suponha que, em 1º de janeiro de 2025, a propriedade tenha valorizado para $1.400.000, e alguns dados de referência são os seguintes:

A Pessoa A decide vender a propriedade, e o preço final de venda da casa

Olá a todos! Na postagem de blog de hoje, vamos mergulhar no mundo do Beancount, uma ferramenta de contabilidade de dupla entrada que é amada por muitos por sua simplicidade e poder. Mais especificamente, vamos falar sobre dois conceitos-chave: Contas a Receber e Contas a Pagar.

Compreender esses termos é crucial para usar o Beancount (ou qualquer sistema de contabilidade de dupla entrada) de forma eficaz. Mas não se preocupe se você é um iniciante - vamos detalhar tudo, passo a passo!

Contas a Receber e a Pagar: O Básico​

Em contabilidade, "contas a receber" e "contas a pagar" são termos usados para rastrear dinheiro que é devido. "Contas a receber" refere-se ao dinheiro que outros lhe devem, enquanto "contas a pagar" refere-se ao dinheiro que você deve a outros.

Vamos a um exemplo:

1. Contas a Receber (C/R): Suponha que você possua uma livraria e um cliente compre um livro a crédito. O dinheiro que ele lhe deve pelo livro é uma conta a receber.

2. Contas a Pagar (C/P): Por outro lado, imagine que você peça um novo conjunto de livros a uma editora, mas não pague por eles adiantado. O dinheiro que você deve à editora é uma conta a pagar.

No Beancount, estes são tipicamente rastreados através de contas correspondentes. O principal benefício aqui é que ele lhe fornece uma imagem clara e precisa de sua posição financeira a qualquer momento.

Configurando Contas a Receber e a Pagar no Beancount​

A estrutura do seu arquivo Beancount pode ser tão simples ou tão complexa quanto você precisar. Para contas a receber e a pagar, você provavelmente desejará criar contas separadas nas seções de Ativos e Passivos.

Aqui está um exemplo simples:

1970-01-01 open Assets:AccountsReceivable
1970-01-01 open Liabilities:AccountsPayable

Rastreando Transações​

Lado do Recebedor​

Após configurar suas contas, você pode rastrear transações que envolvem contas a receber e a pagar. Vejamos um exemplo:

2023-05-29 * "Sold books to customer on credit"
  Assets:AccountsReceivable  100 USD
  Income:BookSales          -100 USD

Aqui, você está adicionando $100 às suas contas a receber porque um cliente lhe deve esse valor. Simultaneamente, você está reduzindo sua receita pelo mesmo valor para manter o equilíbrio (já que você ainda não recebeu o dinheiro).

Quando o cliente finalmente pagar, você registrará assim:

2023-06-01 * "Received payment from customer"
  Assets:Banco:Poupança        100 USD
  Assets:AccountsReceivable -100 USD

Lado do Pagador​

O mesmo princípio se aplica às contas a pagar, mas com sinais invertidos:

2023-05-30 * "Bought books from publisher on credit"
  Liabilities:AccountsPayable  200 USD
  Expenses:BookPurchases     -200 USD

E quando você quitar sua dívida:

2023-06-02 * "Paid off debt to publisher"
  Liabilities:AccountsPayable -200 USD
  Assets:Banco:ContaCorrente        200 USD

Conclusão​

Contas a receber e a pagar estão no cerne de qualquer sistema contábil. Ao rastreá-las com precisão, você obtém uma compreensão abrangente de sua saúde financeira.

Este é apenas um ponto de partida, e o Beancount é capaz de muito mais. Espero que esta postagem de blog ajude a esclarecer esses conceitos importantes. Como sempre, boa contabilidade!