FAQ do Beancount: Perguntas de Contabilidade em Texto Puro

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 fechar. O Beancount cuida do resto para você — ele sinaliza qualquer transação cujos números não fecham como um erro em vez de aceitá-la silenciosamente, então o software captura os erros que um iniciante deixaria passar.

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" de forma alguma — 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 por partidas dobradas que os contadores fazem, com o vocabulário que confunde os iniciantes removido.

Se você já 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 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 metades 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 razão em texto simples é mais confiável do que uma planilha de despesas: a própria estrutura se auto-verifica. 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 move o saldo atual de cada conta a partir de Equity:Opening-Balances, 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 estão naquele dia, e siga em frente a partir daí.

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

Comece grosso e divida apenas quando uma divisão mais fina mudaria uma decisão. Umas vinte contas são suficientes para começar; se você se pegar pensando se "Expenses:Food" deveria separar mantimentos 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 de 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 consegue te dizer quando está errada. A contabilidade em texto simples impõe partidas dobradas, então toda transação se auto-verifica, e o arquivo permanece pesquisável com grep, comparável com diff e programável enquanto existirem arquivos de texto. Você também obtém histórico de versões real: git log no seu 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 partida simples silenciosamente se desvia da verdade. Veja Contabilidade Transparente e Auditável.

Se você só quer saber quanto gastou em café, sim — uma planilha basta. As partidas dobradas se pagam 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 partida simples perde dinheiro sem te avisar.

Uma forma útil de pensar nisso: partidas dobradas são uma soma de verificação para suas finanças. Veja a Introdução para o argumento mais longo.

Não. 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 continua sendo a fonte da verdade, então você pode usar a interface web no dia a dia e recorrer ao terminal apenas quando quiser. Se você preferir um terminal, o comando de linha bea cria, verifica e gera relatórios sobre esse 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 digita o resto manualmente. Em ordem aproximada de confiabilidade: um download direto OFX/QFX do seu banco, uma exportação CSV mais regras de importação, uma conexão com agregador e — apenas como último recurso — um extrato em PDF convertido para CSV. A sincronização bancária do Beancount.io cuida da conexão e da 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 não escapada é um problema real e comum. Veja Importação Inteligente para o caminho automatizado.

Para um arquivo avulso, dois conversores gratuitos de 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 algum.

Os importadores deduplicam contra lançamentos já presentes no seu razão, combinando data, valor e favorecido, 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.

O OFX torna isso mais fácil do 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 as transferências: dinheiro se movendo 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.

Não — e para muitas pessoas este é o motivo de usar contabilidade em texto simples. Você mesmo 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 para o valor de fechamento do extrato, datada do dia seguinte à data de fechamento. As asserções de saldo são avaliadas no início de sua data, então a asserção da manhã seguinte é o que inclui toda transação até o último dia do extrato. Se seu razão discordar do banco, bea check reporta um erro Balance failed e sai com código diferente de zero, o que transforma a conciliação de uma comparação manual em algo que o software verifica toda vez que roda.

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

Nativamente, e esta é uma de suas maiores vantagens sobre aplicativos de finanças de consumo. Todo 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, então uma mudança na taxa de câmbio nunca reescreve seu histórico silenciosamente.

Nada é convertido pelas 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.

Use Preços ao Vivo para ativos suportados em um razão Beancount.io hospedado, ou busque cotações em arquivos de preços locais para o Beancount e o Fava originais. O seletor permite escolher uma moeda de cotação e copiar includes gerenciados. Versões compatíveis do bea também suportam includes gerenciados; o guia de configuração tem links para suas instruções.

Os preços gerenciados afetam a avaliação de mercado, não os valores das transações ou a base de custo. Seu próprio preço tem prioridade para a mesma data e par. As atualizações podem usar preços em cache desatualizados durante uma indisponibilidade, e uma cotação posterior não pode preencher uma data de avaliação histórica ausente.

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

O Beancount suporta os métodos de apuração STRICT, FIFO, LIFO e NONE. A apuração por custo médio é interpretada mas não totalmente implementada — se sua jurisdição fiscal exige custo médio, planeje rastreá-lo com um plugin ou lotes explícitos. Veja Gerenciamento de Estoque.

Exatamente como qualquer outra mercadoria: uma criptomoeda é uma unidade com um custo, então a mesma maquinaria de lotes e apuração 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 reportado.

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

Empresas o usam, incluindo companhias com centenas de milhares de transações. Ele lida com contabilidade por 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, nem interface de faturamento embutida, nem fluxo de aprovação de contas a pagar — é um razão, não um ERP.

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

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

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

Modele recebíveis como uma conta de ativo e pagáveis como um passivo, depois registre a fatura quando você a emite e o pagamento quando ele chega — isso é contabilidade por 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 — 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 Consulta com SQL para extrair exatamente os números que eles pedirem.

Os três são sistemas de partidas dobradas em texto simples com formatos de arquivo semelhantes. O Ledger é o original e o analisador mais permissivo; o hledger é uma reimplementação em Haskell conhecida por regras de importação de CSV amigáveis e boa documentação; 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 é o verdadeiro trade-off: o Beancount se recusa a carregar um arquivo que considera ambíguo, o que captura 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 escondido. O orçamento embutido do Beancount é limitado, e as pessoas que querem comportamento estrito de envelopes normalmente usam um plugin da comunidade ou modelam envelopes como contas.

Se o orçamento por envelopes é o principal que você quer, leia Beancount vs YNAB antes de trocar. 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 às transações a que pertencem. Os recibos ficam como arquivos comuns no disco, então são tão portáveis quanto o próprio razão.

Veja Recursos da Interface.

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

Para captura rápida sem um aplicativo, muitas pessoas anotam um lembrete aproximado e o conciliam no razão depois.

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

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