Glossário

A contabilidade em texto simples empresta vocabulário da contabilidade de partidas dobradas e adiciona um punhado de palavras próprias específicas do Beancount. Este glossário define os termos que você encontrará ao ler esta documentação ou o seu próprio arquivo de razão, cada um com um pequeno exemplo onde for útil. Cada verbete tem seu próprio link, para que você possa apontar um colega diretamente para uma definição.

Conta​

Uma conta é um balde nomeado que rastreia um fluxo de valor, escrita como uma hierarquia separada por dois-pontos sob um de cinco tipos raiz: Assets (Ativos), Liabilities (Passivos), Equity (Patrimônio Líquido), Income (Receitas) ou Expenses (Despesas). A hierarquia é toda a estrutura organizadora dos seus livros — Assets:US:BofA:Checking e Expenses:Food:Restaurant são classificadas e agrupadas automaticamente. Toda conta deve ser declarada antes de ser usada. Consulte Sintaxe da Linguagem Beancount para as regras de nomenclatura.

Regime de competência​

A contabilidade pelo regime de competência registra as receitas quando são ganhas e as despesas quando são incorridas, independentemente de quando o dinheiro efetivamente se move. A contabilidade pelo regime de caixa faz o oposto: reconhece ambas apenas quando o dinheiro muda de mãos. O regime de competência fornece uma imagem mais verdadeira do desempenho de um período, e é por isso que uma fatura que você enviou em março pertence a março, mesmo que o cliente pague em maio.

Amortização​

A amortização distribui um único pagamento grande pelos períodos que ele realmente cobre, de modo que cada mês carregue sua parte justa do custo. Um prêmio de seguro anual pago em janeiro é uma despesa de todos os doze meses, não apenas de janeiro. No Beancount, você escreve os lançamentos divididos manualmente ou os gera com um plugin — consulte Amortizar.

Verificação de saldo​

Uma verificação de saldo é uma diretiva balance que informa qual deve ser o saldo de uma conta no início de uma determinada data, de modo que seu extrato bancário se torne uma verificação automática dos seus livros. Se o saldo calculado for diferente, o Beancount falha ruidosamente com os valores esperado e real. Colocar uma verificação por conta por extrato é a forma mais barata de manter um razão confiável.

2026-01-01 balance Assets:US:BofA:Checking   4,321.00 USD

Beancount​

Beancount é um sistema de contabilidade de partidas dobradas de código aberto cujo razão é um arquivo de texto simples que você edita em qualquer editor de texto e valida com uma ferramenta de linha de comando. Ele oferece uma sintaxe estrita e analisável, uma linguagem de consulta e uma interface web, sem um banco de dados ou formato de arquivo proprietário. Como o razão é texto, ele vive feliz no Git junto com seu código. Comece com Introdução ao Beancount.

Linguagem de Consulta Beancount​

A Linguagem de Consulta Beancount, geralmente abreviada como BQL, é a linguagem semelhante a SQL que você usa para fazer perguntas ao seu razão. Ela opera sobre as diretivas analisadas, em vez de um banco de dados, então SELECT account, sum(position) WHERE year = 2026 responde imediatamente a partir do mesmo arquivo que você edita. Leia o guia da linguagem de consulta para a gramática completa.

Método de alocação​

Um método de alocação é a regra que o Beancount aplica quando uma redução precisa escolher quais lotes existentes serão usados. As opções são STRICT (você deve identificar o lote você mesmo), FIFO, LIFO, AVERAGE e NONE, definidas por conta em sua diretiva open. O método que você escolher altera seus ganhos de capital realizados, portanto, escolha aquele que sua jurisdição fiscal espera e mantenha-o estável.

Plano de contas​

Um plano de contas é a lista completa de contas que seu razão usa, juntamente com a estrutura que as organiza. No Beancount, não existe um arquivo de plano separado — o conjunto de diretivas open é o seu plano de contas. Projetá-lo bem desde o início evita muitas renomeações posteriores; consulte Configurações Específicas por Setor para pontos de partida.

Diretiva de fechamento​

Uma diretiva close marca a data após a qual uma conta não pode mais ser usada, que é como você aposenta uma conta bancária ou um empréstimo quitado sem excluir seu histórico. As transações passadas permanecem válidas e reportáveis; apenas novos lançamentos são rejeitados. Fechar contas não utilizadas mantém os relatórios legíveis à medida que um razão envelhece.

2026-03-31 close Assets:US:OldBank:Checking

Commodity​

Uma commodity é qualquer unidade de valor que seu razão rastreia — uma moeda como USD, um código de ação como AAPL, um ativo cripto como BTC, ou algo que você inventa, como VACATION-DAYS (DIAS-DE-FÉRIAS). O Beancount nunca converte entre commodities nos bastidores, então um valor é sempre um número emparelhado com a commodity na qual é denominado. Uma diretiva commodity opcional permite que você anexe metadados, como um nome ou uma classe de ativo.

Base de custo​

A base de custo é o que você realmente pagou por uma participação, registrada na moeda com a qual pagou e carregada junto com a participação enquanto você a possui. O Beancount a escreve entre chaves — 10 AAPL {150.00 USD} significa dez ações adquiridas a 150 dólares cada. Como a base viaja com a posição, os ganhos de capital resultam da aritmética quando você vende. Consulte Gerenciamento de Inventário.

Diretiva​

Uma diretiva é uma instrução datada em um arquivo Beancount, e as diretivas são tudo o que um razão contém. Toda linha que começa com uma data é uma: open, close, balance, price, note, document, pad, event, commodity, e a própria transação. O Beancount classifica as diretivas por data antes de processá-las, para que você possa mantê-las na ordem que for melhor para leitura.

Contabilidade de partidas dobradas​

A contabilidade de partidas dobradas é a prática de registrar cada evento econômico como pelo menos duas entradas correspondentes, de modo que os valores sempre somem zero. O dinheiro nunca é criado ou destruído — ele apenas se move entre contas, e é por isso que a técnica detecta erros que uma lista de coluna única jamais detectaria. O Beancount aplica a regra estritamente: uma transação cujos lançamentos não se equilibram é um erro, não um aviso.

Orçamento por envelopes​

O orçamento por envelopes reserva dinheiro para um propósito antes de você gastá-lo, de modo que cada categoria tenha seu próprio limite em vez de competir por um saldo único. O nome vem dos envelopes de papel que as pessoas costumavam encher com dinheiro no dia do pagamento. Em um razão de texto simples, você modela os envelopes com contas dedicadas ou diretivas de orçamento — consulte Orçamentos.

Fava​

Fava é a interface web para o Beancount: gráficos, balanços patrimoniais, demonstrações de resultados, um editor de consultas e um formulário de entrada, servidos a partir do seu arquivo de razão. É principalmente para leitura e é executado localmente, então muda a forma como você vê seus livros sem mudar como os registra. O beancount.io hospeda uma versão gerenciada junto com suas próprias ferramentas; o guia Recursos da Interface cobre o que você pode fazer lá.

Inventário​

Um inventário é a coleção de posições que uma conta detém atualmente, cada uma com sua própria commodity e, quando relevante, sua própria base de custo e data de aquisição. Uma conta de corretagem que comprou a mesma ação três vezes mantém três lotes separados em um inventário, não um número único combinado. Manter os lotes distintos é o que torna possíveis os cálculos precisos de ganhos.

Diário​

O diário é a lista cronológica de tudo o que aconteceu em seus livros — o fluxo bruto de transações, em ordem de data, antes de qualquer agrupamento ou sumarização. É a visão que você examina quando quer responder "o que eu realmente fiz em março?". A página do diário do Fava é geralmente o lugar mais rápido para detectar uma entrada mal categorizada.

Razão​

Um razão é o conjunto completo de registros contábeis para uma entidade, que no Beancount significa seu arquivo de texto simples (mais qualquer coisa que ele inclua). A palavra serve tanto para o nome do livro de contas inteiro quanto para o nome do próprio arquivo. Por ser texto, um razão pode ser submetido a diff, revisado, ramificado e mesclado como código-fonte.

Lote​

Um lote é uma aquisição específica de uma commodity, identificada por sua base de custo e data de aquisição. Comprar o mesmo ETF em janeiro e novamente em junho cria dois lotes, e vender posteriormente significa escolher qual lote você está vendendo. Os lotes são a razão pela qual o Beancount pode calcular os ganhos realizados exatamente, em vez de aproximá-los.

2026-06-15 * "Broker" "Buy VTI"
  Assets:US:Broker:VTI     5 VTI {260.00 USD, 2026-06-15}
  Assets:US:Broker:Cash            -1,300.00 USD

Narração​

A narração é a descrição em texto livre do que foi uma transação, escrita como a segunda string entre aspas na linha da transação. É para humanos: "Aluguel mensal", "Mercado e itens domésticos". O Beancount não a analisa, mas é o que você lerá quando a entrada não fizer mais sentido daqui a seis meses.

Diretiva de abertura​

Uma diretiva open declara uma conta, a data a partir da qual ela começa a ser utilizável e, opcionalmente, as commodities que pode conter e o método de alocação que usa. O Beancount exige que toda conta seja aberta antes de seu primeiro lançamento, o que impede que um erro de digitação crie silenciosamente uma conta nova. Restringir as commodities permitidas transforma toda outra classe de erros em erros.

2026-01-01 open Assets:US:Broker:VTI   VTI   "FIFO"

Pad​

Uma diretiva pad diz ao Beancount para inserir o valor que for necessário para que a próxima verificação de saldo em uma conta seja bem-sucedida, debitando a diferença em uma segunda conta. Ela existe para exatamente um trabalho: abrir um razão no meio da vida sem reconstruir anos de histórico. Usar pad além dessa configuração inicial geralmente significa que um erro real está sendo encoberto.

Beneficiário​

O beneficiário é com quem você transacionou, escrito como a primeira string entre aspas em uma linha de transação. Manter os beneficiários consistentes — sempre "Whole Foods", nunca às vezes "WholeFoods" — é o que faz os relatórios baseados em beneficiários e os importadores automatizados funcionarem. O Beancount trata o beneficiário como opcional; uma transação pode conter apenas uma narração.

Contabilidade em texto simples​

Contabilidade em texto simples é a prática de manter seus livros em um arquivo de texto legível por humanos sob controle de versão, processado por ferramentas de linha de comando de código aberto. Ela troca uma interface apontar-e-clicar por durabilidade, auditabilidade e automação: seus dados sobrevivem a qualquer fornecedor, cada mudança é um diff revisável, e qualquer script pode lê-los. Beancount, Ledger e hledger são as três implementações mais conhecidas.

Plugin​

Um plugin é um módulo Python que o Beancount carrega ao processar seu arquivo, permitindo que ele adicione, transforme ou valide diretivas antes de os relatórios serem construídos. Os plugins são como a previsão, os cronogramas de amortização e as verificações personalizadas são implementados sem alterar a linguagem principal. Você ativa um com uma linha plugin no topo do seu razão — o guia Plugin de Previsão percorre um exemplo real.

Lançamento​

Um lançamento é uma perna de uma transação: uma conta, um valor e, opcionalmente, um custo ou preço. Uma transação precisa de pelo menos dois lançamentos, e seus valores devem somar zero. No máximo um lançamento pode deixar seu valor em branco; nesse caso, o Beancount calcula o valor de equilíbrio para você.

Diretiva de preço​

Uma diretiva price registra a taxa de câmbio entre duas commodities em uma data, que é como o Beancount converte uma participação para seu valor de mercado em relatórios. Os preços são puros dados de referência — eles nunca movem dinheiro e nunca aparecem em uma transação. Sem eles, um portfólio ainda se equilibra pelo custo, mas não pode ser avaliado a mercado.

2026-06-30 price VTI   271.40 USD

Conciliação​

Conciliação é o ato de provar que seus livros concordam com um registro externo, como um extrato bancário ou de corretagem. Na contabilidade em texto simples, é em grande parte mecânico: adicione uma verificação de saldo para cada data de extrato e deixe a ferramenta lhe dizer se os números coincidem. Um razão que concilia limpo todo mês é um do qual você pode declarar impostos sem medo.

Tags e links​

Tags e links são os dois rótulos que você anexa a transações para agrupá-las fora da hierarquia de contas: uma tag com # marca um tema como #viagem-japao, e um link com ^ une entradas relacionadas, como ^fatura-2026-014. Tags respondem "mostre-me tudo nesta categoria"; links respondem "mostre-me as entradas que pertencem a este único evento". Ambos são filtráveis no Fava e consultáveis em BQL — consulte Filtragem e Pesquisa.

Transação​

Uma transação é um evento econômico datado juntamente com os lançamentos que o registram, e é a diretiva que você escreverá com mais frequência. Ela carrega uma bandeira (* para confirmado, ! para precisa de revisão), um beneficiário opcional, uma narração e dois ou mais lançamentos cujos valores somam zero. Tudo o mais em um arquivo Beancount existe para declarar, verificar ou anotar transações.

2026-02-14 * "Blue Bottle" "Coffee with Dana"
  Expenses:Food:Coffee      9.50 USD
  Assets:US:BofA:Checking  -9.50 USD

Ainda preso em uma palavra? A Central de Ajuda indexa todos os guias deste site, e a Folha de Dicas coloca a sintaxe de cada diretiva lado a lado.