# Introdução ao Beancount.io

## Por Que a Contabilidade Moderna Importa

Ainda gerencia seus investimentos com planilhas? Embora as planilhas sejam versáteis, elas podem se tornar complicadas e propensas a erros à medida que sua carteira de investimentos cresce. Apresentamos o Beancount.io – uma plataforma de rastreamento de investimentos sofisticada e fácil de usar, projetada especificamente para gerenciar carteiras de ações e criptomoedas. Construído com engenheiros e minimalistas financeiros em mente, o Beancount.io combina recursos poderosos com uma interface intuitiva para otimizar sua experiência de rastreamento de investimentos.

![Expenses](https://res.cloudinary.com/dohtidfqh/image/upload/v1567841828/web-guiguio/expenses.png)

![Income Statement](https://res.cloudinary.com/dohtidfqh/image/upload/v1567841514/web-guiguio/income-statement.png)

![Balance Sheet](https://res.cloudinary.com/dohtidfqh/image/upload/v1567841513/web-guiguio/balance-sheet.png)

## Contabilidade de Partidas Dobradas: A Base da Precisão

Beancount.io é construído sobre os princípios da contabilidade de partidas dobradas – uma metodologia comprovada pelo tempo, usada por instituições financeiras em todo o mundo. Este sistema garante precisão matemática através de um conceito simples, mas poderoso: cada transação financeira deve equilibrar-se perfeitamente.

Na contabilidade de partidas dobradas, cada transação requer pelo menos duas entradas – um débito (+) e um crédito (-) – em diferentes contas. Este sistema de verificação integrado torna virtualmente impossível registrar transações desequilibradas, garantindo que seus registros financeiros permaneçam precisos e confiáveis.

```bean
1970-01-01 open Income:BeancountCorp
1970-01-01 open Assets:Cash
1970-01-01 open Expenses:Food
1970-01-01 open Assets:Receivables:Alice
1970-01-01 open Assets:Receivables:Bob
1970-01-01 open Assets:Receivables:Charlie
1970-01-01 open Liabilities:CreditCard

2019-05-31 * "BeancountCorp" "Salary of May 15th to May 31st"
  Income:BeancountCorp               -888 USD
  Assets:Cash                         888 USD

2019-07-12 * "Popeyes chicken sandwiches" "dinner with Alice, Bob, and Charlie"
  Expenses:Food 20 USD
  Assets:Receivables:Alice 20 USD
  Assets:Receivables:Bob 20 USD
  Assets:Receivables:Charlie 20 USD
  Liabilities:CreditCard -80 USD
```

Como você pode ver nos dois exemplos acima, toda transação deve satisfazer a equação contábil.

```txt
Assets = Liabilities + Equity(aka Net Assets)
```

Usamos a sintaxe Beancount de Martin Blais e o projeto web Fava de Jakob Schnitzer para construir este site. E ele irá alertá-lo se alguma transação tiver pernas que não somam zero.

![Error Alert](https://res.cloudinary.com/dohtidfqh/image/upload/v1567898686/web-guiguio/bct-error-alert.png)

Agora você entende como impomos a correção do livro-razão. Mas você pode perguntar o que são essas "contas"?

## Compreendendo as Contas: A Analogia do Balde de Água

Pense em suas contas financeiras como um sistema de baldes de água interconectados, onde o dinheiro flui como água entre eles. Essa analogia torna a contabilidade de partidas dobradas intuitiva: quando você transfere dinheiro de uma conta para outra, é como derramar água de um balde para outro – a quantidade total de água (dinheiro) no sistema permanece constante.

Beancount.io introduz cinco tipos de contas.

1. **Receita** — Seu valor é sempre negativo ou a débito. Isso ocorre porque você está ganhando dinheiro, e então o dinheiro está debitando da conta de "Receita" e creditando em seus "Ativos".
2. **Despesas** — Seu valor é sempre positivo ou a crédito. Isso ocorre porque você está gastando dinheiro, e o dinheiro está fluindo dos "Ativos" ou "Passivos" para as "Despesas".
3. **Passivos** — Seu valor é positivo ou zero. Suas dívidas de cartão de crédito são um bom exemplo, que aumentam e diminuem em ciclos.
4. **Ativos** — Seu valor é positivo ou zero. Seu dinheiro ou casas sempre valem alguns preços.
5. **Patrimônio Líquido** — Seus ativos líquidos. O sistema calculará automaticamente para você. `Patrimônio Líquido = Ativos - Passivos` e reflete o quão rico você é.

Agora você pode abrir suas contas personalizadas com as palavras-chave acima:

```bean
1970-01-01 open Assets:Cash
1970-01-01 open Assets:Stock:Robinhood
1970-01-01 open Assets:Crypto:Coinbase
1970-01-01 open Expenses:Transportation:Taxi
1970-01-01 open Equity:OpeningBalance
```

## Rastreamento Avançado de Investimentos com Commodities

Beancount.io se destaca no rastreamento de investimentos diversos, de ações a criptomoedas. Vamos explorar como ele lida com cenários de investimento complexos. Por exemplo, veja como você registraria a compra de 10 Bitcoins a US$ 100 cada em 2014:

```bean
2014-08-08 * "Buy 10 Bitcoin"
  Assets:Trade:Cash -1000.00 USD
  Assets:Trade:Positions  10 BTC {100.00 USD}
```

E então, três anos depois, você os vende (originalmente com custos de US$ 100 por unidade anotados com `{100.00 USD}`) ao preço de **US$ 10.000 por unidade** anotado com `@ 10,000.00 USD`.

```bean
2017-12-12 * "Sell 2 Bitcoin"
  Assets:Trade:Positions                   -2 BTC {100.00 USD} @ 10,000.00 USD
  Assets:Trade:Cash                          20,000.00 USD
  Income:Trade:PnL                          -19,800.00 USD
```

Ou a mesma transação com `@@ 20,000.00 USD` significa que ao preço de **US$ 20.000 no total**.

```bean
2017-12-12 * "Sell 2 Bitcoin"
  Assets:Trade:Positions                   -2 BTC {100.00 USD} @@ 20,000.00 USD
  Assets:Trade:Cash                          20,000.00 USD
  Income:Trade:PnL                          -19,800.00 USD
```

A soma de todas as pernas da transação, incluindo `-2 BTC {100.00 USD}`, ainda é, como sempre, zero.

A etiqueta de custos `{100.00 USD}` é importante porque você pode ter comprado a mesma commodity a custos diferentes.

```bean
100 BTC {10.00 USD, 2012-08-08}
10 BTC {100.00 USD, 2014-08-08}
```

Se você quiser simplificar o processo, pode configurar a conta no início com FIFO ou LIFO. FIFO significa 'primeiro a entrar, primeiro a sair', enquanto LIFO significa 'último a entrar, primeiro a sair'. Nos EUA, o IRS usa FIFO para calcular seu PnL e impostos de acordo.

```bean
1970-01-01 open Assets:Trade:Positions "FIFO"
```

E então, quando você o vende de forma abreviada como `-2 BTC {}`, o beancount aplicará a estratégia FIFO automaticamente e venderá a commodity mais antiga.
