40 postagens marcado com "contabilidade"

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

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!

Temos o prazer de anunciar que, a partir de 1º de maio de 2023, reintroduziremos o plano gratuito para novos clientes. Esta decisão surge após a realização de melhorias significativas em nossa plataforma e a otimização de nossos recursos, a fim de melhor atender a todos os nossos clientes, tanto os gratuitos quanto os pagos.

O plano gratuito sempre foi uma parte essencial de nossa visão de fornecer um serviço acessível e fácil de usar para todos. Acreditamos que as mudanças que fizemos nos últimos meses nos permitirão oferecer uma experiência ainda melhor para nossos usuários, mantendo a qualidade do serviço para nossos clientes do plano Pro.

Novos clientes que se registrarem após 1º de maio de 2023 terão acesso ao plano Gratuito.

Seu apoio e lealdade foram fundamentais para tornar financeiramente possível esta reintrodução do plano gratuito. É através de suas contribuições que pudemos investir em nossa infraestrutura e sistemas de suporte, garantindo que possamos continuar a oferecer o serviço de alta qualidade que você espera, ao mesmo tempo em que expandimos o acesso à nossa plataforma para novos usuários. Seu compromisso com nossa visão nos ajudou a crescer e evoluir, e somos verdadeiramente gratos por sua parceria contínua. Juntos, estamos construindo uma comunidade próspera e capacitando usuários de todas as esferas da vida a alcançar seus objetivos.

Se você tiver alguma dúvida ou preocupação, não hesite em nos contatar. Estamos sempre aqui para ouvir seu feedback e resolver quaisquer problemas que você possa ter. Agradecemos seu apoio contínuo e esperamos fornecer o melhor serviço possível.

Exemplo de Nome de Conta​

Assets:US:BofA:Checking

Tipos de Conta​

Assets          +
Liabilities     -
Income          -
Expenses        +
Equity          -

Commodities​

CNY, EUR, CAD, AUD
GOOG, AAPL, RBF1005
HOME_MAYST, AIRMILES
HOURS

Diretivas​

Sintaxe geral

YYYY-MM-DD <Directive> <Parameters...>

Abertura e Fechamento de Contas​

2001-05-29 open Expenses:Restaurant
2001-05-29 open Assets:Checking     USD,EUR  ; Restrições de moeda

2015-04-23 close Assets:Checking

Declaração de Commodities (Opcional)​

1998-07-22 commodity AAPL
  nome: "Apple Computer Inc."

Preços​

2015-04-30 price AAPL   125.15 CNY
2015-05-30 price AAPL   130.28 CNY

Notas​

2013-03-20 note Assets:Checking "Ligado para perguntar sobre o reembolso"

Documentos​

2013-03-20 document Assets:Checking "caminho/para/extrato.pdf"

Transações​

2015-05-30 * "Alguma narração sobre esta transação"
  Liabilities:CreditCard   -101.23 CNY
  Expenses:Restaurant       101.23 CNY

2015-05-30 ! "Cable Co" "Phone Bill" #tag ˆlink
  id: "TW378743437"               ; Metadados
  Expenses:Home:Phone  87.45 CNY
  Assets:Checking                 ; Você pode deixar um valor de fora

Lançamentos​

  ...    123.45 USD                             Simples
  ...        10 GOOG {502.12 USD}               Com custo por unidade
  ...        10 GOOG {{5021.20 USD}}            Com custo total
  ...        10 GOOG {502.12 # 9.95 USD}        Com ambos os custos
  ...   1000.00 USD   @ 1.10 CAD                Com preço por unidade
  ...        10 GOOG {502.12 USD} @ 1.10 CAD    Com custo e preço
  ...        10 GOOG {502.12 USD, 2014-05-12}   Com data
  ! ...   123.45 USD ...                        Com sinalizador

Asserções de Saldo e Preenchimento​

; Afirma o valor apenas para a moeda fornecida:
2015-06-01 balance Liabilities:CreditCard  -634.30 CNY

; Inserção automática de transação para cumprir a seguinte asserção:
2015-06-01pad Assets:Checking Equity:Opening-Balances

Eventos​

2015-06-01 event "localização" "Nova Iorque, EUA"
2015-06-30 event "endereço" "123 May Street"

Opções​

option "title" "Meu Livro Razão Pessoal"

Outros​

pushtag #trip-to-peru
...
poptag  #trip-to-peru
; Comentários começam com um ponto e vírgula

Descubra a Magia da Contabilidade em Texto Simples com Beancount

Introdução​

Bem-vindo a um mundo onde a contabilidade não é mais uma tarefa assustadora. Hoje, apresentamos o Beancount, uma ferramenta de contabilidade em texto simples poderosa, flexível e intuitiva. O Beancount permite que você assuma o controle de suas finanças, fornecendo uma abordagem transparente e direta para gerenciar seu dinheiro.

Neste guia abrangente, vamos nos aprofundar nos conceitos básicos do Beancount, explicar seus conceitos centrais e guiá-lo por seus recursos simples, mas poderosos. Ao final deste blog, você terá uma compreensão sólida do Beancount e estará pronto para começar a usá-lo para organizar e analisar sua vida financeira.

O que é Beancount?​

Beancount é um sistema de contabilidade em texto simples de código aberto criado por Martin Blais. Inspirado no sistema Ledger de John Wiegley, o Beancount visa fornecer um método robusto e confiável para gerenciar finanças pessoais e de pequenas empresas usando arquivos de texto simples. Com o Beancount, você pode rastrear suas receitas, despesas, investimentos e muito mais com facilidade.

Por que Beancount?​

A contabilidade em texto simples oferece várias vantagens sobre os sistemas de contabilidade tradicionais baseados em planilhas ou software:

• Transparência: Os arquivos Beancount são legíveis por humanos, tornando fácil entender e auditar seus dados financeiros.
• Flexibilidade: O Beancount pode ser facilmente personalizado para atender às suas necessidades específicas, e você pode usar seu editor de texto e sistema de controle de versão favoritos para gerenciar seus dados financeiros.
• Portabilidade: Seus dados financeiros podem ser acessados em qualquer dispositivo, e é fácil transferir entre sistemas ou compartilhar com outras pessoas.
• À prova de futuro: Arquivos de texto simples são universalmente compatíveis, garantindo que seus dados financeiros permanecerão acessíveis, mesmo com a evolução da tecnologia.

Conceitos Centrais do Beancount​

Para usar o Beancount de forma eficaz, é crucial entender seus conceitos centrais:

• Transações: Eventos financeiros, como receitas, despesas ou transferências entre contas, são registrados como transações.
• Contas: As transações envolvem uma ou mais contas, como ativos, passivos, receitas ou despesas.
• Contabilidade de partidas dobradas: O Beancount impõe a contabilidade de partidas dobradas, garantindo que cada transação tenha débitos e créditos equilibrados.
• Diretivas: O Beancount usa um conjunto de diretivas para definir transações, aberturas de contas e outros eventos financeiros.

Começando com Beancount​

Para começar a usar o Beancount, siga estes passos simples:

• Instale o Beancount: Instale o Beancount em seu sistema usando as instruções de instalação fornecidas para seu sistema operacional.
• Crie seu arquivo Beancount: Crie um novo arquivo de texto simples com a extensão .beancount (por exemplo, minhas_financas.beancount).
• Defina suas contas: Use a diretiva "open" para definir as contas que você usará em suas transações.
• Registre transações: Use a diretiva "txn" para registrar suas transações financeiras.

Ou simplesmente cadastre-se em https://beancount.io. Aqui estão alguns exemplos de contabilidade em texto simples -

Exemplo 1: Transação Básica

2023-04-01 open Assets:Checking
2023-04-01 open Expenses:Groceries

2023-04-10 txn "Grocery Store" "Buying groceries"
  Assets:Checking         -50.00 USD
  Expenses:Groceries       50.00 USD

Neste exemplo, abrimos duas contas, Assets:Checking e Expenses:Groceries. Em 10 de abril de 2023, registramos uma transação de compra de mantimentos no valor de US$50. A transação reduz o saldo de Assets:Checking em US$ 50 (débito) e aumenta o saldo de Expenses:Groceries em US$ 50 (crédito).

Exemplo 2: Transação de Receita e Despesa

2023-04-01 open Assets:Checking
2023-04-01 open Income:Salary
2023-04-01 open Expenses:Rent

2023-04-05 txn "Employer" "Salary payment"
  Assets:Checking       2000.00 USD
  Income:Salary        -2000.00 USD

2023-04-06 txn "Landlord" "Monthly rent payment"
  Assets:Checking       -1000.00 USD
  Expenses:Rent          1000.00 USD

Neste exemplo, abrimos três contas: Assets:Checking, Income:Salary e Expenses:Rent. Em 5 de abril de 2023, registramos uma transação de pagamento de salário de US$2000. A transação aumenta o saldo de Assets:Checking em US$ 2000 (crédito) e diminui o saldo de Income:Salary em US$2000 (débito). Em 6 de abril de 2023, registramos uma transação de pagamento de aluguel de US$ 1000. A transação reduz o saldo de Assets:Checking em US$1000 (débito) e aumenta o saldo de Expenses:Rent em US$ 1000 (crédito).

Exemplo 3: Transferência Entre Contas

2023-04-01 open Assets:Checking
2023-04-01 open Assets:Savings

2023-04-15 txn "Bank" "Transfer from Checking to Savings"
  Assets:Checking       -500.00 USD
  Assets:Savings         500.00 USD

Neste exemplo, abrimos duas contas: Assets:Checking e Assets:Savings. Em 15 de abril de 2023, registramos uma transação para transferir US$500 da conta corrente para a conta poupança. A transação reduz o saldo de Assets:Checking em US$ 500 (débito) e aumenta o saldo de Assets:Savings em US$ 500 (crédito).

Esses exemplos ilustram os conceitos básicos do sistema de contabilidade de partidas dobradas do Beancount. Ao registrar corretamente as transações, os usuários podem manter registros precisos de suas atividades financeiras e gerar relatórios para obter insights sobre sua situação financeira.

Gerando Relatórios e Analisando Dados​

O Beancount vem com um conjunto de ferramentas poderosas para gerar relatórios financeiros, incluindo balanços patrimoniais, demonstrações de resultados e muito mais. Você também pode usar o Fava, uma interface de usuário baseada na web para o Beancount, para visualizar e interagir com seus dados financeiros. O https://beancount.io é construído sobre o Fava com licença MIT.

Conclusão​

Abrace o poder e a simplicidade da contabilidade em texto simples com o Beancount. Ao entender seus conceitos centrais e seguir os passos descritos neste guia, você estará no caminho certo para gerenciar suas finanças pessoais ou de pequenas empresas com facilidade e precisão. À medida que você se sentir mais confortável com o Beancount, poderá explorar recursos avançados e personalizações para adaptar o sistema às suas necessidades exclusivas.

Seja para rastrear seus gastos, planejar o futuro ou obter insights sobre seus hábitos financeiros, o Beancount oferece a flexibilidade e a transparência necessárias para atingir seus objetivos. Com sua abordagem amigável, o Beancount tem o potencial de revolucionar a maneira como você gerencia suas finanças e capacitá-lo a assumir o controle de seu futuro financeiro.

Agora que você tem uma base sólida em Beancount, é hora de embarcar em sua jornada de contabilidade em texto simples. Diga adeus às planilhas complicadas e ao software confuso, e dê as boas-vindas ao mundo do Beancount. Boa contabilidade!

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

Neste guia, mostraremos como:

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

Por que Personalizar o Fava?​

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

Problemas que isso resolve:​

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

✨ Links Personalizados na Barra Lateral​

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

Adicione estas linhas ao seu arquivo Beancount:

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

O que Eles Fazem:​

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

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

🔍 Consultas SQL Personalizadas​

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

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

Análise:​

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

Casos de uso:​

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

🛠 Dica Profissional: Combine Links + Consultas​

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

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

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

Considerações Finais​

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

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

Pronto para assumir o controle?

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

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

Existe um plugin para o Beancount prever transações recorrentes futuras. Como aplicá-lo no beancount.io? Insira o seguinte conteúdo no seu arquivo de razão.

; import the plugin
plugin "fava.plugins.forecast"

; add a monthly HOA fee
2022-05-30 # "HOA fee [MONTHLY]"
  Expenses:Hoa                                      1024.00 USD
  Assets:Checking                                  -1024.00 USD

E então, você verá a previsão no gráfico de Lucro Líquido.

A tag [MONTHLY] acima significa que ela se repetirá para sempre. Se você tiver mais condições para aplicar, tente [MONTHLY UNTIL 2022-06-01], [MONTHLY REPEAT 5 TIMES], [YEARLY REPEAT 5 TIMES], ou [WEEKLY SKIP 1 TIME REPEAT 5 TIMES].

Um modelo em texto simples, um fluxo de trabalho repetível e uma única consulta para “Quem ainda me deve?”

O faturamento pode parecer uma tarefa árdua, presa entre o trabalho que você concluiu e o pagamento que está aguardando. Mas um bom processo de faturamento é a espinha dorsal de um fluxo de caixa saudável. Ele tem dupla função: informa claramente aos seus clientes o que eles devem e quando, e alimenta seu sistema de contabilidade com os fatos incontestáveis de que ele precisa.

Embora aplicativos SaaS dedicados possam enviar PDFs sofisticados e automatizados, eles geralmente vêm com taxas mensais e bloqueiam seus dados em um silo proprietário. Uma abordagem leve em texto simples usando o Beancount oferece uma alternativa poderosa. Você pode transformar cada fatura em um conjunto claro de lançamentos contábeis, dando a você todos os benefícios do controle de versão, metadados poderosos e consultas instantâneas - sem necessidade de assinatura.

A Fatura Minimamente Viável (Campos que Você Nunca Deve Ignorar)​

Antes de tocar em seu livro-razão, você precisa de uma fatura profissional. O formato pode ser simples, mas o conteúdo deve ser preciso. Esses campos, emprestados da prática comprovada de pequenas empresas, são inegociáveis.

• Detalhes do vendedor: Nome da sua empresa e endereço físico.
• Detalhes do cliente: Nome do seu cliente e (idealmente) o endereço dele.
• Número da fatura: Um ID sequencial exclusivo que nunca é reutilizado. FAT-045 segue FAT-044.
• Datas de emissão e vencimento: Indique claramente quando a fatura foi emitida e quando o pagamento é esperado.
• Itens da linha: Uma descrição clara dos serviços ou produtos, juntamente com a quantidade, taxa e o total da linha.
• Subtotal, imposto e total: Mostre a matemática para que o cliente possa acompanhá-la facilmente.
• Observações opcionais: Um local para um agradecimento, instruções de transferência bancária ou um número de ordem de compra fornecido pelo cliente.

Para você começar, criamos um conjunto de modelos prontos para editar que incluem todos esses campos. As versões de planilha até pré-calculam os totais para você.

Obtenha nossos modelos aqui: beancount.io/invoice‑templates (Disponível nos formatos Google Docs, Word, Planilhas, Excel e PDF)

Registre a Fatura em Seu Livro-Razão​

Depois de enviar o PDF da fatura para o seu cliente, você deve registrá-la no Beancount. Esta é uma etapa crucial que reconhece a receita quando ela é ganha, não apenas quando é paga. O processo envolve duas transações distintas.

1. Quando você emite a fatura:

Você cria uma transação que move o valor total da sua conta Receita para Ativo:Contas a Receber. Isso cria um IOU digital em seus livros.

; 2025‑07‑21 Fatura #045  Sprint de design web para Acme Corp.
2025-07-21 * "Acme Corp" "FAT-045 Sprint de design web"
  Ativo:ContasReceber          3500.00 USD  ; vencimento:2025-08-04
  Receita:Design:Web
  id_fatura: "FAT-045"
  email_contato: "ap@acme.example"
  link: "docs/faturas/2025-07-21_Acme_FAT-045.pdf"

Aqui, você debita Contas a Receber e credita sua conta Receita. Observe os metadados ricos: a data de vencimento, um id_fatura exclusivo e até um link: direto para o PDF que você enviou.

2. Quando o cliente paga:

Quando o dinheiro chega à sua conta bancária, você registra uma segunda transação para "fechar" o IOU. Isso move o saldo de Contas a Receber para sua conta corrente.

2025-08-01 * "Acme Corp" "Pagamento FAT-045"
  Ativo:Banco:ContaCorrente               3500.00 USD
  Ativo:ContasReceber
  id_fatura: "FAT-045"

O saldo para FAT-045 em Ativo:Contas a Receber agora é zero e seus livros estão perfeitamente balanceados.

Anexe o PDF: A chave de metadados link: é especialmente poderosa quando usada com o Fava, a interface web do Beancount. O Fava renderizará um link clicável diretamente na visualização da transação, para que o documento de origem nunca esteja a mais de um clique de distância. Este fluxo de trabalho foi previsto já em 2016 em uma solicitação de recurso (GitHub).

Uma Consulta para Listar Todas as Faturas em Aberto​

Então, quem ainda lhe deve dinheiro? Com este sistema, você não precisa procurar em e-mails ou planilhas. Você só precisa de uma consulta simples.

Salve o seguinte como um arquivo chamado faturas-em-aberto.sql:

SELECT
  meta('id_fatura') AS id,
  beneficiario,
  descricao,
  data,
  number(saldo) AS pendente
WHERE
  conta = "Ativo:ContasReceber"
  AND saldo != 0
ORDER BY
  data;

Agora, execute-o na sua linha de comando:

bean-query books.beancount faturas-em-aberto.sql

Em segundos, você obterá um relatório de envelhecimento limpo e atualizado de todas as faturas pendentes, mostrando o ID da fatura, cliente, data de emissão e valor devido. Nenhum software extra necessário.

Automatize o Trabalho Pesado​

A beleza do texto simples é a capacidade de script. Você pode automatizar as partes tediosas deste fluxo de trabalho.

• Modelo + Pandoc = PDF: Mantenha seu modelo de fatura em Markdown. Um pequeno script Python pode preencher as variáveis (nome do cliente, itens de linha, número da fatura) e a ferramenta de linha de comando Pandoc pode convertê-lo instantaneamente em um PDF profissional.
• Git Pre-commit Hook: Se você armazena seu livro-razão no Git, um gancho de pré-commit simples pode executar verificações antes de salvar seu trabalho. Ele pode verificar se cada novo id_fatura é único, se os lançamentos da transação estão zerados e se o arquivo referenciado nos metadados link: realmente existe.
• Cron Job: Configure uma tarefa agendada (um cron job) para executar sua consulta faturas-em-aberto.sql todas as noites e enviar o resumo por e-mail para você. Você começará cada dia sabendo exatamente quem precisa de um lembrete amigável.

Uma Ressalva Realista​

O Beancount é uma ferramenta de contabilidade, não um serviço de faturamento. Ele não enviará lembretes de pagamento automaticamente para seus clientes nem processará os pagamentos com cartão de crédito. O fluxo de trabalho é: você cria e envia a fatura usando o método escolhido (como os modelos acima) e, em seguida, registra os lançamentos contábeis em seu livro-razão.

Para a maioria dos freelancers e pequenas empresas, esta etapa manual é um pequeno preço a pagar por um sistema de contabilidade à prova de balas, auditável e gratuito que você possui e controla completamente (beancount.io).

Próximos Passos​

Pronto para assumir o controle do seu faturamento? Veja como começar.

1. Baixe um modelo e use-o para criar sua próxima fatura real, certificando-se de usar um número de fatura sequencial.
2. Armazene seus PDFs enviados em uma pasta dedicada como docs/faturas/ e use a chave de metadados link: em sua transação Beancount para referenciá-los.
3. Salve a consulta faturas-em-aberto.sql e torne sua execução parte da sua revisão financeira semanal.

A contabilidade em texto simples não significa abrir mão do refinamento ou do controle - significa apenas que o banco de dados pode ser pesquisado com grep. Com um modelo simples e os trechos acima, você receberá mais rápido e manterá seus livros imaculados.