# FAQ do Beancount: Perguntas de Contabilidade em Texto Puro

As perguntas abaixo vêm da comunidade de contabilidade em texto simples — Reddit, Hacker News,
a lista de discussão do Beancount — e abordam como a *prática* funciona. Para perguntas sobre o
próprio serviço Beancount.io (preços, planos, suporte, gerenciamento de conta), consulte a
[FAQ do produto](/faq).

## Começando

### Quanto de contabilidade preciso saber antes de começar?

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](https://beancount.io/pt/docs/introduction-to-beancount), mantenha o
[Glossário](https://beancount.io/pt/docs/glossary) aberto em uma aba, e adicione suas primeiras transações no
[Guia de Início Rápido](https://beancount.io/pt/docs/Basics/getting-started).

### Onde estão os débitos e créditos no Beancount?

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](https://beancount.io/pt/docs/Basics/syntax)
para saber como os lançamentos são escritos, ou
[Débitos e Créditos Explicados](/blog/2026/04/08/debits-and-credits-explained-a-plain-english-guide-for-small-business-owners)
para o contexto contábil em linguagem simples.

### Por que as transações precisam equilibrar para zero?

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.

### Como configuro meus saldos iniciais?

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](https://beancount.io/pt/docs/Basics/getting-started) percorre um exemplo completo de saldo
inicial.

### Quão detalhado deve ser meu plano de contas?

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](/blog/2026/03/16/how-to-design-chart-of-accounts-small-business-guide)
se quiser uma estrutura para copiar.

## Por que texto puro?

### Por que usar contabilidade em texto puro em vez de uma planilha?

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](https://beancount.io/pt/docs/Solutions/transparent-and-auditable).

### A contabilidade de partidas dobradas não é exagero para finanças pessoais?

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](https://beancount.io/pt/docs/introduction-to-beancount) para o argumento mais longo.

### Preciso usar a linha de comando?

Não. O [Fava](/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](https://beancount.io/pt/docs/Basics/bea-cli).

Veja [Recursos da Interface](https://beancount.io/pt/docs/Tips/ui-features) para saber o que a interface pode fazer, ou
[experimente a demonstração ao vivo](/demo).

## Obtendo seus dados

### Como importo minhas transações bancárias para o Beancount?

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](/bank-sync) 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 [Smart Import](/smart-import) para o caminho automatizado.

Para um arquivo avulso, dois conversores gratuitos de navegador fazem a parte mecânica sem
enviar nada: [CSV para Beancount](/tools/csv-to-beancount) para exportações de planilhas, e
[OFX e QIF para Beancount](/tools/ofx-to-beancount) para os downloads `.ofx`, `.qfx`, `.qbo` e
`.qif` que os bancos oferecem quando não oferecem CSV algum.

### Como evito importar a mesma transação duas vezes?

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](/tools/ofx-to-beancount) 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.

### Preciso dar meu login bancário a terceiros?

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](/security).

### Como reconcilio meu livro-razão contra o extrato bancário?

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](https://beancount.io/pt/docs/Tips/filtering-and-searching) para rastrear uma discrepância.

## Moedas e investimentos

### Como o Beancount lida com múltiplas moedas?

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](https://beancount.io/pt/docs/Basics/syntax),
[Precisão e Tolerâncias](https://beancount.io/pt/docs/Basics/precision), e
[Contabilidade Multi-Moeda](/blog/2026/03/19/multi-currency-accounting-guide-small-business-international)
para o lado contábil.

### Como mantenho os preços de avaliação atualizados?

Use [Preços ao Vivo](https://beancount.io/pt/docs/live-prices) 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.

### Como rastreio base de custo e ganhos de capital?

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](https://beancount.io/pt/docs/Basics/inventories).

### Como registro negociações de criptomoedas e sua base de custo?

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](https://beancount.io/pt/docs/Solutions/cryptocurrency-portfolio-tracking) e
os [modelos de cripto](https://beancount.io/pt/docs/Tips/cryptocurrency-templates-examples) prontos.

## Livros empresariais e freelance

### Posso usar o Beancount para uma pequena empresa, ou é apenas para finanças pessoais?

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](https://beancount.io/pt/docs/industry-specific-setups) e a
vitrine do [Razão Aberto](/open-ledger) com livros reais de empresas.

### Devo manter livros separados para pessoal e empresarial?

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](https://beancount.io/pt/docs/Tips/multi-file-support).

### Como lido com faturas e contas a receber?

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](https://beancount.io/pt/docs/financial-reporting-templates) para o lado dos
relatórios, [Configurações Específicas por Setor](https://beancount.io/pt/docs/industry-specific-setups) para exemplos
práticos, e
[Entendendo Contas a Receber](/blog/2025/08/12/understanding-accounts-receivable)
para os conceitos.

### Como entrego meus livros ao meu contador na época de impostos?

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](https://beancount.io/pt/docs/tax-prep-guides),
[Modelos de Relatórios Financeiros](https://beancount.io/pt/docs/financial-reporting-templates) e
[Consulta com SQL](https://beancount.io/pt/docs/Basics/beancount-query-language) para extrair exatamente os números que
eles pedirem.

## Ferramentas e ecossistema

### Como Beancount, Ledger e hledger diferem?

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](/compare/beancount-vs-ledger-cli) e
[Beancount vs hledger](/compare/beancount-vs-hledger).

### O Beancount faz orçamento por envelopes como o YNAB?

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](/compare/beancount-vs-ynab) antes de trocar. Para
o que funciona hoje, veja [Orçamento no Beancount](https://beancount.io/pt/docs/Tips/budgets).

### Posso anexar recibos a transações?

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](https://beancount.io/pt/docs/Tips/ui-features).

### Existe um aplicativo móvel?

Sim — o Beancount.io publica aplicativos para [iOS](/beancount-ios) e
[Android](/beancount-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.

### Quão grande pode ficar um livro-razão antes de ficar lento?

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](https://beancount.io/pt/docs/Tips/multi-file-support) para saber como dividir um razão
em crescimento.

## Ainda preso?

A [Central de Ajuda](https://beancount.io/pt/docs/help-center) indexa a documentação completa, e o
[Glossário](https://beancount.io/pt/docs/glossary) define qualquer termo acima que tenha sido desconhecido.
