Pular para o conteúdo principal
Beancount.io Logo
Início Rápido

Início Rápido

Guia de configuração rápida para criar seu primeiro livro-razão Beancount com configuração essencial, organização de arquivos e etapas de validação.

Pronto para assumir o controle das suas finanças? Este guia fará você começar com o Beancount em minutos. Você aprenderá a criar seu primeiro livro-razão, configurar contas essenciais e registrar suas primeiras transações.

Visão do diário beancount.io listando transações de partidas dobradas em texto puro com filtros de tipo de diretiva

Explore o livro-razão ao vivo →

Configuração Inicial​

Criando Seu Primeiro Livro-Razão​

; Basic structure for a new ledger
2024-01-01 open Assets:Checking
2024-01-01 open Equity:Opening-Balances
 
2024-01-02 * "Initial Deposit"
  Assets:Checking           100.00 USD
  Equity:Opening-Balances

Configuração Essencial​

option "title" "Personal Finance Ledger"
option "operating_currency" "USD"

Organização de Arquivos​

Estrutura Recomendada​

; 1. Configuration Options
option "title" "Personal Ledger"
option "operating_currency" "USD"
 
; 2. Account Declarations
2024-01-01 open Assets:Checking    USD
2024-01-01 open Assets:Savings     USD
2024-01-01 open Expenses:Food      USD
2024-01-01 open Equity:Opening-Balances
 
; 3. Initial Balances
; Pad fills the gap up to Equity:Opening-Balances, so it must be dated
; before the assertion. Balance assertions are checked at the start of
; their day, so assert the next morning.
2024-01-01 pad Assets:Checking Equity:Opening-Balances
2024-01-02 balance Assets:Checking 1000.00 USD
 
; 4. Transactions
2024-01-15 * "Grocery Store" "Weekly groceries"
  Expenses:Food            50.00 USD
  Assets:Checking

Organização de Seções​

  1. Contas Eternas

    2024-01-01 open Liabilities:Payables    USD
2024-01-01 open Assets:Receivables      USD

  2. Contas Bancárias

    2024-01-01 open Assets:Bank:Checking     USD
2024-01-01 open Assets:Bank:Savings      USD
2024-01-01 open Income:Bank:Interest     USD

  3. Contas de Investimento

    2024-01-01 open Assets:Investment:Cash    USD
2024-01-01 open Assets:Investment:Stocks  VTSAX
2024-01-01 open Income:Investment:Dividend USD

Validação e Relatórios​

Validação Básica​

# Check for errors (prints nothing and exits 0 when clean)
bean-check ledger.beancount
 
# Browse balances, reports, and charts in the web interface
fava ledger.beancount

bean-check é o validador: ele não imprime nada e sai com 0 quando o livro-razão está limpo, e lista todos os erros e sai com código diferente de zero caso contrário. Fava é a interface web — execute-a e abra o endereço http://localhost:5000 impresso para o balanço patrimonial, a demonstração de resultados e os diários de contas.

Relatórios Comuns​

O Beancount 3 produz relatórios através da interface web do Fava ou consultas ad-hoc com bean-query, que executa a Linguagem de Consulta do Beancount. Os comandos mais antigos bean-report e bean-web foram removidos no Beancount 3, então os comandos abaixo os substituem.

# Balance-sheet numbers: balances by asset, liability, and equity account
bean-query ledger.beancount "SELECT account, sum(position) AS balance WHERE account ~ '^(Assets|Liabilities|Equity)' GROUP BY account ORDER BY account"
 
# Income-statement numbers: totals by income and expense account
bean-query ledger.beancount "SELECT account, sum(position) AS total WHERE account ~ '^(Income|Expenses)' GROUP BY account ORDER BY account"
 
# One account's journal, with a running balance
bean-query ledger.beancount "SELECT date, narration, position, balance WHERE account = 'Assets:Checking'"

Gerenciando Saldos Iniciais​

Exemplo de Preenchimento​

2024-01-01 open Assets:Checking    USD
2024-01-01 open Equity:Opening-Balances
 
; Pad account to match a known balance
2024-01-01 pad Assets:Checking Equity:Opening-Balances
 
; Assert the known balance the next day: assertions are evaluated at the
; start of their date, and the pad transaction must fall before it
2024-01-02 balance Assets:Checking 1525.00 USD

Uma asserção de saldo verifica a conta no início de sua data, portanto ela deve ser datada após o preenchimento (ou qualquer transação) que deve incluir. Datar o preenchimento e o saldo no mesmo dia deixa o preenchimento não utilizado e a asserção incompleta — o Beancount relata Entrada de preenchimento não utilizada e Falha no saldo. A conta Equity:Opening-Balances deve ser aberta antes de ser preenchida.

Encerramento de Conta​

2024-01-01 open Assets:OldBank:Checking   USD
2024-06-30 close Assets:OldBank:Checking  ; Account closed

Deduplicação de Transações​

Gerenciando Transferências​

; Credit card payment - combined view
2024-01-15 * "Credit Card Payment"
  Assets:Checking            -500.00 USD
  Liabilities:CreditCard     500.00 USD
 
; Flag for pending match
2024-01-15 * "Pending CC Payment"
  ! Assets:Checking         -500.00 USD
  Liabilities:CreditCard    500.00 USD

Asserções de Saldo​

; Regular balance checks prevent duplicates
2024-01-31 balance Assets:Checking    2150.25 USD
2024-01-31 balance Liabilities:CreditCard  -350.00 USD

Boas Práticas​

  1. Organização de Arquivos

    • Mantenha um arquivo principal inicialmente
    • Use cabeçalhos de seção claros
    • Agrupe contas relacionadas

  2. Nomes de Contas

    • Use convenções de nomenclatura consistentes
    • Inclua prefixos de país/instituição
    • Mantenha hierarquia lógica

  3. Verificação de Saldos

    • Asserções de saldo regulares
    • Preencha contas adequadamente
    • Acompanhe encerramentos de contas

  4. Manuseio de Moedas

    • Declare moedas operacionais
    • Use códigos de commodities consistentes
    • Especifique restrições de moeda

Próximos Passos​

Agora que você tem um livro-razão básico configurado:

  1. Registre Transações Regulares: Comece com suas despesas diárias e receitas
  2. Configure Importações de Contas Bancárias: Use importações CSV ou conexões bancárias para automatizar a entrada de dados. Cole um extrato exportado no conversor de CSV para Beancount para obter entradas balanceadas no seu navegador, ou use OFX e QIF para Beancount para downloads .ofx, .qfx e .qif.
  3. Copie um Layout Comprovado: Baixe um arquivo inicial executável das seções doméstica, orçamento em envelopes ou freelancer dos exemplos de livros-razão funcionais, depois adapte os padrões de propriedade e investimento da mesma galeria
  4. Aprenda Sintaxe Avançada: Explore a referência de sintaxe para cenários mais complexos
  5. Gere Seus Primeiros Relatórios: Use os recursos da interface para criar relatórios financeiros e analisar seus gastos

Referência Rápida​

Tipos Comuns de Contas:

  • Assets:Bank:Checking - Sua conta corrente
  • Expenses:Food:Groceries - Gastos com supermercado
  • Income:Salary:Company - Renda de emprego
  • Liabilities:CreditCard:Visa - Dívida de cartão de crédito

Comandos Essenciais:

  • bean-check ledger.beancount - Valide seu livro-razão (sai com código diferente de zero em erros)
  • fava ledger.beancount - Inicie a interface web para relatórios e gráficos
  • bean-query ledger.beancount "SELECT ..." - Consulte saldos e transações

Estas diretrizes estabelecem uma base sólida para gerenciar finanças pessoais com o Beancount. Pronto para adicionar sua primeira transação? Confira nosso guia de transações na interface.

Início Rápido

Fonte: https://beancount.io/pt/docs/Basics/getting-started