FAQ do Beancount: Perguntas de Contabilidade em Texto Puro

Cerca de cinco conceitos, não um diploma. Você precisa dos cinco tipos de contas (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 aplica o resto para você — ele sinaliza qualquer transação cujos números não batam como erro em vez de aceitá-la silenciosamente, então o software detecta os erros que um iniciante de outra forma perderia.

Comece com a Introdução ao Beancount, mantenha o Glossário aberto em uma aba, e adicione suas primeiras transações no 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 entrando é positivo, e uma transação é válida quando seus lançamentos se cancelam. Isso é a mesma contabilidade de partidas dobradas que os contadores fazem, com o vocabulário que confunde iniciantes 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. Consulte a referência de Sintaxe da Linguagem para saber como os lançamentos são escritos, ou Débitos e Créditos Explicados para o contexto contábil em linguagem simples.

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 $40 em mantimentos, esse dinheiro saiu de uma conta bancária — registrar as duas partes significa que elas devem se cancelar, e qualquer erro de digitação em qualquer um dos valores é sinalizado como erro em vez de produzir silenciosamente um saldo errado.

É por isso que um livro-razão em texto puro é mais confiável do que uma planilha de despesas: a estrutura em si é autoverificável. Uma afirmação de saldo é o mecanismo relacionado que verifica seu livro-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, depois adicione uma afirmação de balance para fixá-lo. Você não precisa reconstruir seu histórico financeiro — escolha uma data de início, considere os saldos como estão nesse dia, e siga em frente a partir daí.

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

Comece genérico 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 se perguntando se "Despesas:Alimentação" deve separar mantimentos de restaurantes, o teste útil é se você realmente faria algo diferente sabendo a divisão.

Renomear e dividir depois é uma busca e substituição em um arquivo de texto, então o custo de começar simples é baixo. Os nomes de contas 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 dizer quando está errada. A contabilidade em texto puro aplica partidas dobradas, então toda transação é autoverificável, e o arquivo permanece pesquisável, comparável e scriptável enquanto arquivos de texto existirem. Você também tem histórico de versão real: git log no seu livro-razão mostra exatamente o que mudou, quando e por quê.

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

Se você só quer saber quanto gastou em café, sim — uma planilha é suficiente. Partidas dobradas valem a pena 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 onde o rastreamento de entrada única perde dinheiro sem te avisar.

Uma maneira útil de pensar: partidas dobradas são uma soma de verificação para suas finanças. Veja a Introdução para o caso 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 a executa para você com seu livro-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 ir ao terminal apenas quando quiser. Se preferir um terminal, o comando bea cria, verifica e gera relatórios sobre o mesmo arquivo — veja o início rápido da CLI.

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

A maioria das pessoas importa 80–95% das transações e registra o restante manualmente. Em ordem aproximada de confiabilidade: um download OFX/QFX direto do seu banco, uma exportação CSV com 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 cuida da conexão e categorização para você.

Espere escrever ou ajustar uma regra por instituição: exportações CSV de 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 único, dois conversores gratuitos no navegador fazem a parte mecânica sem enviar nada: CSV para Beancount para exportações de planilhas, e OFX e QIF para Beancount para os downloads .ofx, .qfx, .qbo e .qif que os bancos oferecem quando não oferecem CSV.

Os importadores deduplicam contra entradas já no seu livro-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 você revisá-las antes que se tornem parte do registro permanente.

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

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

Não — e para muitas pessoas essa é a razão para usar contabilidade em texto puro. Você pode exportar OFX ou CSV do seu banco você mesmo 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 afirmação de balance para o valor final do extrato, datada no dia após a data de fechamento. As afirmações de saldo são avaliadas no início da data, então a afirmação da manhã seguinte é o que inclui todas as transações até o último dia do extrato. Se seu livro-razão discorda do banco, bea check relata um erro Balance failed e sai com código não zero, o que transforma a reconciliação de uma comparação manual em algo que o software verifica toda vez que é executado.

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

Nativamente, e essa é uma das suas maiores vantagens sobre aplicativos de finanças de consumo. Todo valor carrega sua moeda, as contas podem ter várias ao mesmo tempo, e conversões são registradas explicitamente com @ para um preço ou {} para um custo, então 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 Multi-Moeda para o lado contábil.

Registre compras com um custo em 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 sai da aritmética automaticamente em vez de ser algo que você calcula à mão.

O Beancount suporta métodos de reserva STRICT, FIFO, LIFO e NONE. Reserva por custo médio é analisada, mas não totalmente implementada — 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 outro ativo: uma criptomoeda é uma unidade com um custo, então o mesmo maquinário de lotes e reserva 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 quer declarado.

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

Empresas 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 multi-usuário, nenhuma interface de faturamento integrada e nenhum fluxo de aprovação de contas a pagar — é um livro-razão, não um ERP.

Veja Configurações Específicas por Indústria e o Livro Aberto com exemplos 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 o tempo de impostos, e separá-los não custa nada no início.

Dois arquivos é geralmente a escolha mais limpa uma vez 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, depois registre a fatura quando você a emite e o pagamento quando ele chega — isso é contabilidade de competência, e o Beancount suporta isso diretamente. O que ele não tem é uma interface de faturamento: ele rastreia o que você tem a receber, não gera ou envia a fatura.

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

Exporte os relatórios em vez do livro-razão. Seu contador quase certamente não quer um arquivo de texto — ele quer 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 puro com formatos de arquivo similares. Ledger é o original e o parser mais permissivo; hledger é uma reimplementação em Haskell conhecida por regras amigáveis de importação CSV e documentação; Beancount tem o parser mais estrito e o suporte mais forte para investimentos, lotes e múltiplas moedas, além de uma API de plugins em Python.

A estritura é o verdadeiro trade-off: o Beancount se recusa a carregar um arquivo que considera ambíguo, o que detecta erros cedo ao custo de ser mais exigente. Veja Beancount vs Ledger CLI e Beancount vs hledger.

Não nativamente — essa é uma lacuna real, não um recurso oculto. O orçamento embutido do Beancount é limitado, e pessoas que querem comportamento estrito de envelopes tipicamente 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 enviar e navegar por esses documentos junto com as transações a que pertencem. Os recibos permanecem como arquivos comuns no disco, então são tão portáveis quanto o próprio livro-razão.

Veja Recursos da Interface.

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

Para captura rápida sem um aplicativo, muitas pessoas registram uma nota aproximada e a reconciliam no livro-razão depois.

Uma década de finanças pessoais tem alguns megabytes e carrega em menos de um segundo. O Beancount recalcula saldos a partir do histórico completo de transações a cada carga, e isso permanece rápido até centenas de milhares de entradas. Além disso, o limite é o conforto de edição e comparação, não o tempo de carregamento: dividir por ano com include mantém arquivos individuais pequenos, mas os arquivos incluídos ainda formam um livro combinado que o Beancount carrega e recalcula por completo, então é uma conveniência de organização de arquivos em vez de uma aceleração ou uma maneira de manter livros separados.

Veja Suporte a Múltiplos Arquivos para saber como dividir um livro-razão crescente.