Pular para o conteúdo principal
Guia Rápido

Guia Rápido

Guia rápido completo do Beancount com estruturas de contas, sintaxe de transação, comandos e exemplos práticos para contabilidade em texto simples e manutenção de registros financeiros.

Estrutura da Conta

Tipos de Conta e Sinais

Tipo          Sinal   Exemplo
------------------------------------------------
Ativos        (+)     Ativos:BR:Banco:Corrente
Passivos      (-)     Passivos:Credito:Amex
Receitas      (-)     Receitas:Salario:Bruto
Despesas      (+)     Despesas:Alimentacao:Restaurante
Patrimônio Líquido (-)     Patrimônio Líquido:Saldo-Inicial

Formato da Moeda/Ativo

# Financeiro
USD, EUR, CAD, AUD     # Moedas padrão
GOOG, AAPL, VTI       # Veículos de investimento
BTC, ETH              # Criptomoedas
 
# Rastreamento personalizado
HORAS                 # Rastreamento de tempo
MILHAS_AEREAS           # Pontos de recompensa
CASA_MAIOG             # Propriedade

Sintaxe de Diretivas

Gerenciamento de Contas

# Abertura de contas
2024-01-01 open Ativos:Corrente            # Simples
2024-01-01 open Ativos:Investimento USD,GOOG  # Com restrições
 
# Fechamento de contas
2024-12-31 close Ativos:Antiga:Conta

Declaração de Moeda/Ativo

2024-01-01 commodity VTSAX
    name: "Vanguard Total Stock Market Index"
    asset-class: "equity"

Registro de Transações

# Transação básica
2024-01-15 * "Mercado" "Compras semanais"
    Ativos:Corrente     -100.00 USD
    Despesas:Alimentacao:Mercado
 
# Com metadados e tags
2024-01-15 * "Restaurante" "Jantar de negócios" #trabalho ^fatura-123
    id: "T-1234"
    receipt: "caminho/para/recibo.pdf"
    Despesas:Refeicoes      80.00 USD
    Passivos:Credito

Especificações de Lançamento

# Valor básico
Ativos:Dinheiro              100.00 USD
 
# Rastreamento do custo base
Ativos:Investimento:VTSAX      10 VTSAX {100.00 USD}        # Por unidade
Ativos:Investimento:VTSAX      10 VTSAX {{1000.00 USD}}     # Custo total
Ativos:Investimento:VTSAX      10 VTSAX {100.00 # 9.95 USD} # Com taxas
 
# Especificações de preço
Ativos:Forex            1000.00 USD @ 0.85 EUR        # Por unidade
Ativos:Forex            1000.00 USD @@ 850.00 EUR     # Preço total
 
# Lotes datados
Ativos:Investimento:VTSAX      10 VTSAX {100.00 USD, 2024-01-15}

Verificação de Saldo

# Declaração de saldo
2024-01-31 balance Ativos:Corrente  1000.00 USD
 
# Preenchimento de saldo
2024-01-01 pad Ativos:Corrente Patrimônio Líquido:Saldo-Inicial

Rastreamento de Metadados

# Anexo de nota
2024-01-15 note Ativos:Corrente "Liguei para o banco sobre a taxa"
 
# Link de documento
2024-01-15 document Ativos:Corrente "caminho/para/extrato.pdf"
 
# Registro de preço
2024-01-15 price VTSAX  100.00 USD

Registro de Eventos

# Rastreamento de localização
2024-01-15 event "localização" "Nova York, EUA"
 
# Alterações de propriedade
2024-01-15 event "endereço" "Rua Principal, 123"

Gerenciamento de Tags

# Controle de escopo de tag
pushtag #ferias
2024-01-15 * "Hotel"
    Despesas:Viagem:Hospedagem   200.00 USD
    Ativos:Credito
poptag #ferias

Opções de Configuração

# Configurações básicas
option "title" "Livro Razão de Finanças Pessoais"
option "operating_currency" "USD"
 
# Nomenclatura de contas
option "name_assets" "Ativos"
option "name_liabilities" "Passivos"
option "name_income" "Receitas"
option "name_expenses" "Despesas"
option "name_equity" "Patrimônio Líquido"
 
# Tratamento de documentos
option "documents" "/caminho/para/docs"

Comentários e Organização

; Comentário de linha única
 
* Cabeçalho da Seção
** Subseção
; Bloco de transações a seguir...
 
; Agrupamento de contas
; Ativos
2024-01-15 ...
 
; Despesas
2024-01-16 ...

Esta referência fornece uma visão geral completa dos elementos de sintaxe do Beancount com exemplos práticos.