Início Rápido

Pronto para assumir o controle de suas finanças? Este guia irá prepará-lo para usar o Beancount em minutos. Você aprenderá como criar seu primeiro livro-razão, configurar contas essenciais e registrar suas primeiras transações.

Explore the live ledger →

Configuração Inicial​

Criando Seu Primeiro Livro-Razão​

; Estrutura básica para um novo livro-razão
2024-01-01 open Assets:Checking
2024-01-01 open Equity:Opening-Balances
 
2024-01-02 * "Depósito Inicial"
  Assets:Checking           100.00 USD
  Equity:Opening-Balances

Configuração Essencial​

option "title" "Livro-Razão de Finanças Pessoais"
option "operating_currency" "USD"

Organização de Arquivos​

Estrutura Recomendada​

; 1. Opções de Configuração
option "title" "Livro-Razão Pessoal"
option "operating_currency" "USD"
 
; 2. Declarações de Conta
2024-01-01 open Assets:Checking    USD
2024-01-01 open Assets:Savings     USD
2024-01-01 open Expenses:Food      USD
 
; 3. Saldos Iniciais
2024-01-01 pad Assets:Checking Equity:Opening-Balances
2024-01-01 balance Assets:Checking 1000.00 USD
 
; 4. Transações
2024-01-15 * "Mercado" "Compras da semana"
  Expenses:Food            50.00 USD
  Assets:Checking

Organização de Seções​

1. Contas Permanentes

   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​

# Verificar erros
bean-check ledger.beancount
 
# Visualizar interface web
bean-web ledger.beancount

Relatórios Comuns​

# Balanço patrimonial
bean-report ledger.beancount balsheet
 
# Demonstração do resultado
bean-report ledger.beancount income
 
# Diário da conta
bean-report ledger.beancount journal -a Assets:Checking

Gerenciando Saldos Iniciais​

Exemplo de Preenchimento (Padding)​

2024-01-01 open Assets:Checking    USD
 
; Preencher a conta para corresponder ao saldo conhecido
2024-01-01 pad Assets:Checking Equity:Opening-Balances
 
; Afirmar o saldo conhecido
2024-01-01 balance Assets:Checking 1525.00 USD

Fechamento de Conta​

2024-01-01 open Assets:OldBank:Checking   USD
2024-06-30 close Assets:OldBank:Checking  ; Conta fechada

Deduplicação de Transações​

Lidando com Transferências​

; Pagamento de cartão de crédito - visão combinada
2024-01-15 * "Pagamento de Cartão de Crédito"
  Assets:Checking            -500.00 USD
  Liabilities:CreditCard     500.00 USD
 
; Sinalizador para correspondência pendente
2024-01-15 * "Pagamento Pendente CC"
  ! Assets:Checking         -500.00 USD
  Liabilities:CreditCard    500.00 USD

Declarações de Saldo​

; Verificações regulares de saldo evitam duplicatas
2024-01-31 balance Assets:Checking    2150.25 USD
2024-01-31 balance Liabilities:CreditCard  -350.00 USD

Melhores 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 Conta

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

3. Verificação de Saldo

   • Declarações de saldo regulares
   • Preencha as contas apropriadamente (Padding)
   • Rastreie os fechamentos de conta

4. Manuseio de Moeda

   • Declare as moedas operacionais
   • Use códigos de mercadoria 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 e receitas diárias
2. Configure Importações de Contas Bancárias: Use importações de CSV ou conexões bancárias para automatizar a entrada de dados
3. Exemplos de Contas em Funcionamento (Ledger): Copie cinco padrões de ledger Beancount vivos e validados para finanças domésticas, orçamento por envelopes, faturamento de freelancers, propriedades para aluguel e base de custo de investimentos.
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 do usuário para criar relatórios financeiros e analisar seus gastos

Referência Rápida​

Tipos de Conta Comuns:

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

Comandos Essenciais:

• bean-check ledger.beancount - Valide seu livro-razão
• bean-report ledger.beancount balsheet - Gere o balanço patrimonial
• bean-web ledger.beancount - Inicie a interface web

Estas diretrizes estabelecem uma base sólida para gerenciar finanças pessoais com Beancount. Pronto para adicionar sua primeira transação? Confira nosso guia de transação da interface do usuário.