FAQ do Beancount: Perguntas sobre Contabilidade em Texto Simples

Cerca de cinco conceitos, não um diploma. Você precisa dos cinco tipos de conta (ativos, passivos, patrimônio líquido, receitas, despesas), da ideia de que toda transação move valor entre pelo menos duas delas, e da regra de que uma transação deve equilibrar. O Beancount impõe o resto para você — ele se recusa a carregar um arquivo cujas transações não fechem, então o software pega os erros que um iniciante cometeria silenciosamente.

Comece com a Introdução ao Beancount, mantenha o Glossário aberto em uma aba e adicione suas primeiras transações no Guia de Início Rápido.

O Beancount não usa as palavras "débito" e "crédito" — ele usa números com sinal que devem somar zero. Dinheiro saindo de uma conta é negativo, dinheiro chegando é positivo, e uma transação é válida quando seus lançamentos se cancelam. Esta é a mesma contabilidade de partidas dobradas que os contadores fazem, com o vocabulário que confunde novatos removido.

Se você usou software de contabilidade tradicional, a tradução é: um débito é um número positivo e um crédito é um número negativo. Veja a referência de Sintaxe da Linguagem para como os lançamentos são escritos, ou Débitos e Créditos Explicados para o contexto contábil em português claro.

Porque o dinheiro sempre vem de algum lugar, e a soma zero é o que transforma esse fato em uma verificação de erro. Se você gasta R$ 40 em mantimentos, esse dinheiro saiu de uma conta bancária — registrar ambas as metades significa que as duas devem se cancelar, e qualquer erro de digitação em qualquer um dos valores faz o arquivo falhar ao carregar em vez de produzir silenciosamente um saldo errado.

É por isso que um razão em texto simples é mais confiável do que uma planilha de despesas: a própria estrutura é autoverificadora. Uma asserção de saldo é o mecanismo relacionado que verifica seu razão contra a realidade.

Registre uma transação na sua data de início que mova o saldo atual de cada conta de Equity:Opening-Balances (Patrimônio Líquido:Saldos Iniciais), e depois adicione uma asserção balance para fixá-lo. Você não precisa reconstruir seu histórico financeiro — escolha uma data de início, pegue os saldos como eles estão naquele dia e vá em frente a partir daí.

O Guia de Início Rápido mostra um exemplo completo de saldo inicial.

Comece amplo e divida apenas quando uma divisão mais fina mudaria uma decisão. Cerca de vinte contas é suficiente para começar; se você se pegar pensando se "Despesas:Alimentação" deve separar supermercado de restaurantes, o teste útil é se você realmente faria algo diferente sabendo da divisão.

Renomear e dividir depois é um localizar-e-substituir em um arquivo de texto, então o custo de começar simples é baixo. Os nomes das contas se aninham, então você pode começar com uma categoria ampla e dividi-la em subcontas depois sem reescrever o histórico — veja Como Projetar um Plano de Contas se quiser uma estrutura para copiar.

Uma planilha não pode lhe dizer quando está errada. A contabilidade em texto simples impõe partidas dobradas, então toda transação é autoverificadora, e o arquivo permanece pesquisável, comparável com diff e programável enquanto arquivos de texto existirem. Você também obtém um histórico de versão real: git log em seu razão mostra exatamente o que mudou, quando e por quê.

A diferença prática aparece com várias contas, moedas ou investimentos, onde uma planilha de entrada única se desvia silenciosamente da realidade. Veja Contabilidade Transparente e Auditável.

Se você só quer saber quanto gastou em café, sim — uma planilha é suficiente. As partidas dobradas mostram seu valor no momento em que você tem várias contas, uma hipoteca, uma corretora ou mais de uma moeda, porque essas são exatamente as situações em que o rastreamento de entrada única perde dinheiro sem lhe contar.

Uma maneira útil de pensar sobre isso: partidas dobradas são uma soma de verificação para suas finanças. Veja a Introdução para o argumento mais completo.

Não. Fava é uma interface web completa sobre o mesmo arquivo de texto — balanços patrimoniais, demonstrações de resultados, gráficos e entrada de transações — e o Beancount.io o executa para você com seu razão na nuvem. O arquivo de texto permanece a fonte da verdade, então você pode usar a interface web no dia a dia e recorrer ao terminal apenas quando quiser.

Veja Recursos da Interface para o que a interface pode fazer, ou experimente a demonstração ao vivo.

A maioria das pessoas importa 80–95% das transações e insere o restante manualmente. Em ordem aproximada de confiabilidade: um download OFX/QFX direto do seu banco, uma exportação CSV mais regras de importação, uma conexão de agregador e — apenas como último recurso — um extrato PDF convertido para CSV. A sincronização bancária do Beancount.io lida com a conexão e categorização para você.

Espere escrever ou ajustar uma regra por instituição: as exportações CSV dos bancos são notoriamente inconsistentes, e um nome de comerciante contendo uma vírgula sem escape é um problema real e comum. Veja Importação Inteligente para o caminho automatizado.

Para um arquivo avulso, dois conversores gratuitos no navegador fazem a parte mecânica sem enviar nada: CSV para Beancount para exportações de planilhas, e OFX & QIF para Beancount para os downloads .ofx, .qfx, .qbo e .qif que os bancos oferecem quando não oferecem CSV algum.

Os importadores desduplicam contra entradas já existentes em seu razão, combinando por data, valor e beneficiário, e sinalizam qualquer coisa ambígua para você confirmar, em vez de adivinhar. O fluxo de trabalho usual marca importações incertas como pendentes para que você as revise antes que se tornem parte do registro permanente.

A outra metade da resposta são as transferências: dinheiro movendo-se entre duas contas que você possui aparece nas exportações de ambos os bancos. Registre-a uma vez como uma única transação com dois lançamentos.

OFX torna isso mais fácil que CSV: cada transação carrega um FITID que o banco mantém estável entre downloads, então um importador pode fazer a correspondência por identidade em vez de inferência — o conversor OFX o preserva como um campo de metadados id:.

Não — e para muitas pessoas esta é a razão para usar contabilidade em texto simples. Você pode exportar OFX ou CSV do seu banco e nunca entregar credenciais a um agregador. Se preferir sincronização automatizada, o Beancount.io usa um agregador sancionado pelo banco, em vez de armazenar sua senha de banco online.

Leia os detalhes na página de segurança.

Adicione uma asserção balance com o saldo final e a data do extrato. O Beancount se recusará a carregar o arquivo se seu razão discordar do banco, o que transforma a conciliação de uma comparação manual em algo que o software verifica toda vez que é executado.

Uma cadência mensal é suficiente para a maioria das pessoas. Veja Filtragem e Pesquisa para localizar uma discrepância.

Nativamente, e esta é uma de suas maiores vantagens sobre aplicativos financeiros de consumo. Cada valor carrega sua moeda, as contas podem conter várias ao mesmo tempo, e as conversões são registradas explicitamente com @ para um preço ou {} para um custo, de modo que uma mudança na taxa de câmbio nunca reescreve silenciosamente seu histórico.

Nada é convertido nas suas costas — você sempre vê tanto a moeda original quanto o valor convertido. Veja Sintaxe da Linguagem, Precisão e Tolerâncias e Contabilidade Multimoeda para o lado contábil.

Registre compras com um custo entre chaves — 10 AAPL {150.00 USD} — e o Beancount rastreia cada lote separadamente. Quando você vende, você diz qual lote está reduzindo, e o ganho de capital surge da aritmética automaticamente, em vez de ser algo que você calcula manualmente.

O Beancount suporta métodos de registro STRICT (RÍGIDO), FIFO, LIFO e NONE. O registro por custo médio é interpretado, mas não está totalmente implementado — se sua jurisdição fiscal exigir custo médio, planeje rastreá-lo com um plugin ou lotes explícitos. Veja Gerenciamento de Inventário.

Exatamente como qualquer outra commodity: uma criptomoeda é uma unidade com um custo, então a mesma lógica de lote e registro se aplica. Uma troca de um token por outro é uma única transação que reduz um lote e abre outro, que também é como você obtém o ganho realizado que a maioria das autoridades fiscais exige ser relatado.

Veja Rastreamento de Portfólio de Criptomoedas e os modelos de criptomoedas prontos.

Empresas o usam, incluindo companhias com centenas de milhares de transações. Ele lida com contabilidade de competência, estruturas multi-entidade e os relatórios que um contador espera. Os limites honestos são que não há edição concorrente multiusuário, nenhuma interface de faturamento integrada e nenhum fluxo de trabalho de aprovação de contas a pagar — é um razão, não um ERP.

Veja Configurações Específicas por Setor e a vitrine Razão Aberto de livros reais de empresas.

Mantenha-os separados — seja como árvores de contas de nível superior distintas em um arquivo ou como dois arquivos combinados com include. Misturá-los torna a demonstração de resultados da empresa sem sentido e dificulta a época do imposto de renda, e separá-los não custa nada no início.

Dois arquivos geralmente é a escolha mais limpa assim que a empresa tem sua própria conta bancária. Veja Suporte a Múltiplos Arquivos.

Modele os recebíveis como uma conta de ativo e os pagáveis como um passivo, então registre a fatura quando você a emitir e o pagamento quando ele chegar — isso é contabilidade de competência, e o Beancount a suporta diretamente. O que ele não tem é uma interface de faturamento: ele rastreia o que lhe é devido, não gera ou envia a fatura.

Veja Modelos de Relatórios Financeiros para o lado dos relatórios, Configurações Específicas por Setor para exemplos práticos, e Entendendo Contas a Receber para os conceitos.

Exporte os relatórios em vez do razão. Seu contador quase certamente não quer um arquivo de texto — eles querem uma demonstração de resultados, um balanço patrimonial e uma lista de transações, que você pode produzir como CSV ou PDF pela interface web ou com uma consulta.

Veja os Guias de Preparação de Impostos, Modelos de Relatórios Financeiros e Consultas com SQL para extrair exatamente os números que eles pedem.

Todos os três são sistemas de partidas dobradas em texto simples com formatos de arquivo semelhantes. Ledger é o original e o analisador mais permissivo; hledger é uma reimplementação em Haskell conhecida por regras de importação CSV amigáveis e documentação; Beancount tem o analisador mais estrito e o suporte mais forte para investimentos, lotes e múltiplas moedas, além de uma API de plugins em Python.

O rigor é a verdadeira troca: Beancount se recusa a carregar um arquivo que considera ambíguo, o que pega erros cedo ao custo de ser mais exigente. Veja Beancount vs Ledger CLI e Beancount vs hledger.

Não nativamente — esta é uma lacuna genuína, não um recurso oculto. O orçamento embutido do Beancount é limitado, e as pessoas que querem um comportamento estrito de envelope normalmente usam um plugin da comunidade ou modelam envelopes como contas.

Se orçamento por envelopes é a principal coisa que você quer, leia Beancount vs YNAB antes de mudar. Para o que funciona hoje, veja Orçamento no Beancount.

Sim. A diretiva document vincula um arquivo a uma conta e data, e a interface web permite que você faça upload e navegue por esses documentos junto com as transações às quais pertencem. Os recibos permanecem como arquivos comuns no disco, então são tão portáteis quanto o próprio razão.

Veja Recursos da Interface.

Sim — o Beancount.io publica aplicativos iOS e Android para visualizar seu razão e capturar transações em qualquer lugar, que é a lacuna que a maioria das configurações de texto simples deixa aberta.

Para captura rápida sem um aplicativo, muitas pessoas registram uma anotação aproximada e a conciliam no razão depois.

Uma década de finanças pessoais tem alguns megabytes e carrega em bem menos de um segundo. O Beancount recalcula os saldos a partir do histórico completo de transações a cada carregamento, e isso permanece rápido até centenas de milhares de entradas; depois disso, dividir por ano com include mantém as coisas confortáveis.

Veja Suporte a Múltiplos Arquivos para como dividir um razão em crescimento.