# Lançamentos Contábeis Beancount: Como Fazer, Definições e Exemplos

Toda transação financeira que sua empresa realiza precisa ser registrada — e no mundo da contabilidade em texto simples, isso começa com os **lançamentos contábeis**. Se você está usando o [Beancount](https://beancount.io), entender os lançamentos contábeis é fundamental para construir registros financeiros precisos, auditáveis e claros.

Este guia irá te guiar por:

- O que é um lançamento contábil
- Por que os lançamentos contábeis são importantes
- Como escrevê-los na sintaxe Beancount
- Como usá-los de forma eficaz
- Exemplos de transações do mundo real (pagamentos de clientes, compras, empréstimos, etc.)

## 🧾 O que é um Lançamento Contábil no Beancount?

No Beancount, um **lançamento contábil** é uma transação datada escrita em um formato de texto simples e legível por humanos. Cada lançamento segue os princípios da **contabilidade de partidas dobradas** — você registra de onde o dinheiro vem (crédito) e para onde ele vai (débito), garantindo que seus livros sempre se equilibrem.

**Exemplo:**

```bean
2024-06-01 * "Client payment for invoice #123"
  Assets:Bank:Checking     600.00 USD
  Income:Sales
```

- O `*` indica uma transação compensada.
- A descrição mostra o contexto para o lançamento.
- `Assets:Bank:Checking` é debitado.
- `Income:Sales` é creditado (valor implícito).

Cada lançamento reside dentro de um arquivo `.beancount` — apenas um arquivo de texto que você pode controlar a versão, fazer backup e até mesmo editar no Vim ou VSCode.

## 📒 Por que os Lançamentos Contábeis são Importantes

Os lançamentos contábeis são a unidade atômica do seu livro-razão.

Eles:

- Alimentam seu **Razão Geral** e **Saldos de Contas**
- Geram todos os relatórios: _Demonstrações de Resultados, Balanços Patrimoniais, Fluxos de Caixa_
- Permitem que você rastreie cada dólar, linha por linha, até sua origem

Com as ferramentas certas, você verá essas transações renderizadas em uma interface de usuário — categorizadas, pesquisáveis e filtráveis. Mas tudo começa com aquele simples lançamento em texto simples.

## 📚 Como a Contabilidade de Partidas Dobradas Funciona no Beancount

Beancount impõe a **contabilidade de partidas dobradas**. Toda transação deve ser equilibrada: total de débitos = total de créditos.

Regra rápida:

- **Debite** ativos e despesas (você _ganha_ dinheiro ou incorre em um custo)
- **Credite** receitas e passivos (você _ganha_ dinheiro ou assume uma dívida)

**Exemplo – Compra de Material de Escritório:**

```bean
2024-06-02 * "Bought printer ink"
  Expenses:OfficeSupplies   100.00 USD
  Assets:Bank:Checking
```

## 🧠 Visualizando Lançamentos

Depois de salvar, na navegação lateral esquerda de https://beancount.io/ledger/0/income_statement/ você verá ...

- **Visualização de Diário**: Veja transações com pesquisa, tags e filtragem
- **Menu Suspenso de Filtro de Conta**: Veja saldos contínuos e lançamentos por conta
- **Demonstração de Resultados**: Soma das suas contas `Income:*` e `Expenses:*`
- **Balanço Patrimonial**: Seus ativos menos passivos

Fava ajuda a transformar seus lançamentos brutos do Beancount em relatórios acionáveis — com configuração de banco de dados zero.

## 💡 Exemplos Comuns de Lançamentos Contábeis

### ✅ Você recebe de um cliente

```bean
2024-06-05 * "Payment for invoice #456"
  Assets:Bank:Checking     1,200.00 USD
  Income:Consulting
```

Opcional: Se você usa Contas a Receber:

```bean
2024-05-20 * "Invoice #456 sent"
  Assets:AccountsReceivable   1,200.00 USD
  Income:Consulting

2024-06-05 * "Payment for invoice #456"
  Assets:Bank:Checking        1,200.00 USD
  Assets:AccountsReceivable  -1,200.00 USD
```

### 🖨️ Você compra material de escritório

```bean
2024-06-07 * "Staples run"
  Expenses:OfficeSupplies     85.00 USD
  Assets:Bank:Checking
```

### 🏦 Você faz um pagamento de empréstimo

Digamos que você pague \$1.000, com \$200 de juros e \$800 para o principal:

```bean
2024-06-10 * "Loan repayment"
  Liabilities:Loan            800.00 USD
  Expenses:LoanInterest       200.00 USD
  Assets:Bank:Checking      -1,000.00 USD
```

## 🔒 Lançamentos de Encerramento no Fim do Ano

Para "encerrar os livros", você geralmente transfere todas as contas de `Receita` e `Despesas` para o `Patrimônio Líquido`.

```bean
2024-01-01 open Income:Consulting
2024-01-01 open Expenses:OfficeSupplies
2024-12-31 close Income:Consulting
2024-12-31 close Expenses:OfficeSupplies
```

Ou, manualmente:

```bean
2024-12-31 * "Close books"
  Equity:RetainedEarnings     45,000.00 USD
  Income:Consulting          -45,000.00 USD
```

## 🛠️ Lançamentos de Ajuste

Se você está usando a **contabilidade de regime de competência**, você vai querer adicionar **lançamentos de ajuste** — para despesas pré-pagas, receitas acumuladas, etc.

Exemplo: Assinatura de software mensal de \$100 paga anualmente

```bean
2024-01-01 * "Annual software payment"
  Assets:Prepaid             1,200.00 USD
  Assets:Bank:Checking      -1,200.00 USD

2024-01-31 * "Monthly amortization"
  Expenses:Software           100.00 USD
  Assets:Prepaid             -100.00 USD
```

Automatize com scripts ou ferramentas Beancount disponíveis.

## 🧰 Beancount: Leve, Auditável, Poderoso

Beancount não é apenas uma ferramenta contábil — é uma ideia: **verdade financeira transparente e em texto simples.** É um sistema de escrituração moderna que é:

- Fácil de controlar a versão (Git!)
- Totalmente portátil (sem banco de dados proprietário)
- Ótimo para desenvolvedores, freelancers e pequenas empresas

## Pronto para Começar?

Comece seu arquivo Beancount com:

```bean
option "title" "My Business Ledger"
option "operating_currency" "USD"

2024-01-01 open Assets:Bank:Checking USD
2024-01-01 open Income:Sales USD
2024-01-01 open Expenses:OfficeSupplies USD
2024-01-01 open Equity:OpeningBalances USD

2024-01-01 * "Initial balance"
  Assets:Bank:Checking     10,000.00 USD
  Equity:OpeningBalances
```

Em seguida, carregue seu arquivo com sua ferramenta de visualização preferida para ver a mágica.

Quer um começo mais fácil? Experimente modelos, importadores ou ferramentas da comunidade como `bean-extract`.

Com o Beancount, seus livros são finalmente _seus_ — simples, programáveis e à prova de auditoria.

Me avise se você gostaria de uma versão em PDF para download ou variações dos exemplos específicas para pequenas empresas.
