# Desintoxique as finanças da sua pequena empresa — o caminho do Beancount

_Transforme um livro-razão bagunçado em um negócio calmo e confiante no caixa em 30 dias—usando contabilidade de texto simples._

---

## TL;DR

- **Separe, simplifique e trave** seus livros com um plano de contas enxuto, importações consistentes e verificações de saldo automatizadas.
- **Mostre o que importa**—COGS, custos gerais, reserva de caixa—via relatórios rápidos do `bean-query`.
- **Corte o ruído** (assinaturas não utilizadas, ferramentas duplicadas) e **codifique bons hábitos** (conciliação semanal, fechamento mensal, recibos anexados).
- **Torne a temporada fiscal chata** mantendo extratos, recibos e saldos verificáveis em um local.

---

## Por que uma "Desintoxicação"?

A bagunça financeira em uma pequena empresa não é apenas desordenada—é cara. Ela esconde gastos desperdiçados, obscurece sua verdadeira lucratividade e transforma a temporada fiscal em uma caça ao tesouro frenética. Uma desintoxicação financeira é um reinício focado de 30 dias: você identifica o que move (e vaza) dinheiro, remove a complexidade e então institucionaliza rotinas simples e repetíveis para mantê-lo limpo.

O Beancount é a ferramenta perfeita para isso porque é **transparente, programável e verificável**. Diferentemente de software caixa-preta, um livro-razão de texto simples significa que todo número é explicável. Toda verificação e saldo pode ser automatizado com diretivas e consultas, criando um sistema de auto-auditoria que força a clareza. Este guia irá conduzi-lo através de um plano de quatro semanas para conseguir exatamente isso.

---

## Semana 0 — Defina sua linha de base

Antes de poder limpar, você precisa de uma base sólida. Esta semana é sobre definir a estrutura do seu mundo financeiro.

### Crie um plano de contas enxuto

Seu plano de contas é o esqueleto do seu sistema financeiro. O objetivo aqui é o minimalismo. Não crie uma conta para cada possível despesa que você _poderia_ ter. Comece com o essencial que você usa hoje; você sempre pode adicionar mais depois. Um plano de contas bagunçado encoraja a categorização incorreta e torna a análise de alto nível difícil.

Aqui está um ponto de partida simples e eficaz:

```beancount
; Entidades principais
2025-01-01 open Assets:Bank:Checking           USD
2025-01-01 open Assets:Bank:Savings            USD
2025-01-01 open Liabilities:CreditCard:Business USD
2025-01-01 open Income:Sales
2025-01-01 open Expenses:COGS
2025-01-01 open Expenses:Overhead:Rent
2025-01-01 open Expenses:Overhead:Utilities
2025-01-01 open Expenses:SaaS
2025-01-01 open Equity:Opening-Balances
```

### Trave saldos que você pode verificar

A funcionalidade mais poderosa na contabilidade de texto simples é a capacidade de afirmar a realidade. Uma diretiva `balance` diz ao Beancount: "Nesta data, esta conta tinha exatamente esta quantia de dinheiro." Se não for o caso, o Beancount gerará um erro. Esta é sua rede de segurança principal.

Ao começar, use `pad` em combinação com `balance` para inicializar suas contas a partir de um extrato bancário. A diretiva `pad` cria uma transação que força a conta ao saldo inicial correto, registrando a diferença em uma conta de patrimônio.

```beancount
; Inicializar a partir de extratos
2024-12-31 pad     Assets:Bank:Checking      Equity:Opening-Balances
2025-01-01 balance Assets:Bank:Checking      12345.67 USD
```

**Uma palavra de cautela:** Use `pad` com moderação. É para começar limpamente, não para mascarar erros recorrentes de conciliação.

---

## Semana 1 — Separe e simplifique os fluxos

Com uma estrutura no lugar, é hora de esclarecer como o dinheiro se move através do seu negócio.

### Mantenha Negócio ≠ Pessoal

Esta é a regra de ouro das finanças de pequena empresa. Misturar fundos é uma receita para confusão e dores de cabeça fiscais.

- Mantenha uma conta bancária dedicada ao negócio e um cartão de crédito comercial.
- Espelhe esta separação em seu livro-razão: `Assets:Bank:Business:Checking`, `Liabilities:CreditCard:Business`.
- Se você se paga, registre como uma distribuição para `Equity:Owner-Draws`. Nunca categorize despesas pessoais diretamente de contas comerciais.

### Padronize categorias de fornecedores

Você paga por AWS, Google Cloud e Vercel? Não crie três contas separadas. Mapeie todos eles para uma única categoria lógica como `Expenses:Cloud`. Evite criar micro-contas que você não analisará realmente. O objetivo é ver padrões, não rastrear cada fornecedor individual com sua própria conta.

---

## Semana 2 — Automatize entradas e recibos

A entrada manual de dados é lenta, propensa a erros e insustentável. Esta semana é sobre construir uma máquina para alimentar seu livro-razão confiavelmente.

### Construa um caminho de importação sem drama

O framework de importação do Beancount permite ensiná-lo como ler arquivos CSV ou OFX do seu banco e gerar transações automaticamente. Invista o tempo para configurar isso uma vez, e você economizará centenas de horas a longo prazo. Mantenha suas regras de importação sob controle de versão (como Git) para que seu sistema seja repetível e com backup.

- Comece com o guia oficial **Importing External Data** do Beancount.
- Para um fluxo de trabalho mais interativo, considere uma ferramenta como **beancount-import**, que fornece uma interface web para correspondência semi-automática.
- Muitos usuários dependem dos frameworks integrados `ingest` ou mais recentes `beangulp` para construir seus importadores personalizados. Escolha um e mantenha-se nele para consistência.

### Anexe documentos onde eles pertencem

Uma transação sem recibo é uma afirmação não substanciada. O Beancount e sua interface web, Fava, tornam trivial vincular documentos fonte às entradas, criando uma trilha de auditoria inabalável.

Você tem duas ótimas opções:

1.  **Pasta de Documentos + Diretiva:** Armazene todos os seus recibos e extratos em uma pasta dedicada. Então, vincule um arquivo a uma transação usando a diretiva `document`.
2.  **Arrastar e Soltar no Fava:** Simplesmente arraste um arquivo PDF ou de imagem sobre uma transação na interface do Fava. O Fava automaticamente armazena o arquivo e insere a diretiva `document` correta no seu arquivo de livro-razão.



```beancount
; No seu arquivo principal do livro-razão, diga ao Fava onde seus documentos vivem
option "documents" "/home/acme/docs"

; Vincule um recibo a um lançamento de transação específico
2025-08-07 * "Figma" "Monthly Subscription"
  Assets:CreditCard:Business    -12.00 USD
  Expenses:SaaS                 12.00 USD
    document: "receipts/figma-2025-08-07.pdf"
```

---

## Semana 3 — Veja a verdade (Consultas rápidas que você reutilizará)

Seu livro-razão agora está limpo e alimentado com dados. É hora de fazer perguntas importantes. Inicie a ferramenta de linha de comando `bean-query` para obter respostas instantâneas.

### 1\) Onde está meu dinheiro?

Obtenha um instantâneo rápido dos seus ativos líquidos.

```bash
bean-query business.beancount 'BALANCES FROM year = 2025 AND (account ~ "Assets:Bank" OR account ~ "Liabilities:CreditCard")'
```

Isso lhe dá uma visão imediata e em tempo real da sua posição de caixa sem fazer login em múltiplos portais bancários.

### 2\) No que estou gastando em custos gerais vs. COGS?

Entenda para onde seu dinheiro está _realmente_ indo. Você está gastando mais em custos gerais não essenciais ou nos custos diretamente ligados à entrega do seu produto (Custo dos Produtos Vendidos)?

```sql
SELECT
  account,
  units(sum(position))
WHERE
  account ~ "^Expenses:(Overhead|COGS)" AND year = 2025
GROUP BY
  account
ORDER BY
  account
```

Esta consulta separa seus custos operacionais principais da sua carga administrativa, uma percepção crítica para a lucratividade.

### 3\) Quais assinaturas parecem "zumbis"?

Encontre despesas recorrentes e pequenas que frequentemente voam sob o radar. Essas assinaturas "zumbi" podem sangrar seu fluxo de caixa.

```sql
SELECT
  payee,
  COUNT(*) AS num_transactions,
  SUM(number) AS total_spent
WHERE
  account ~ "^Expenses:SaaS" AND date >= '2025-01-01'
GROUP BY
  payee
ORDER BY
  num_transactions DESC,
  total_spent DESC
```

Esta consulta instantaneamente revela fornecedores que você paga frequentemente. Se você ver um que não reconhece ou não precisa mais, é hora de cancelar.

---

## Semana 4 — Arrume e trave o sistema

A semana final é sobre construir os hábitos e barreiras que mantêm suas finanças limpas para sempre.

### Coloque orçamentos simples no lugar

O Fava pode ler diretivas `budget` do seu livro-razão e exibir barras de progresso úteis em seus relatórios, mostrando se você está no caminho certo. Isso fornece um lembrete suave e constante dos seus objetivos de gastos.

```beancount
; Limite gastos SaaS a $100 por mês
2025-01-01 custom "budget" Expenses:SaaS "monthly" 100.00 USD
```

Defina estes para categorias de despesas variáveis chave como software, publicidade ou contratados para notar desvios antes que se tornem um problema.

### Feche o mês, toda vez

Estabeleça um processo de fechamento mensal simples e inegociável:

1.  **Concilie:** Para cada conta bancária e de cartão de crédito, adicione uma afirmação `balance` correspondente ao número final no seu extrato mensal.
2.  **Anexe:** Anexe o próprio extrato PDF à entrada `balance` usando a diretiva `document`.
3.  **Relate:** Execute suas três consultas salvas (caixa, custos gerais/COGS, assinaturas) e cole as saídas em uma breve nota de revisão mensal.

A **afirmação de saldo** é um gatilho automático. Se seu livro-razão não corresponder ao extrato bancário, o Beancount gerará um erro, dizendo exatamente onde procurar pela discrepância.

---

## Torne a temporada fiscal chata (de um jeito bom)

Seguindo este sistema, você transforma a preparação fiscal de uma crise em um simples exercício de relatório.

- **Recibos estão anexados às transações**, então não há busca frenética. No Fava, você está a um clique do documento fonte para qualquer despesa.
- **Itens relevantes para impostos podem ser marcados** (ex., `#tax-deductible`), permitindo extrair um relatório limpo com `bean-query` para seu contador.
- **Saldos de fim de ano estão travados e verificados** com afirmações `balance`, dando a você e seu preparador confiança nos números.

---

## Uma lista de verificação de 30 dias (Imprima isto)

- **Dia 1–3**
  - [ ] Crie um plano de contas mínimo.
  - [ ] Adicione `pad` + `balance` para cada banco/cartão usando os extratos mais recentes.
- **Dia 4–10**
  - [ ] Configure um pipeline de importação e confirme suas regras no controle de versão.
  - [ ] Preencha 90 dias de transações; execute um primeiro instantâneo `BALANCES`.
- **Dia 11–15**
  - [ ] Padronize fornecedores para suas respectivas contas (SaaS, Cloud, Envio, etc.).
  - [ ] Anexe PDFs de extratos para os períodos conciliados; confirme que aparecem no Fava.
- **Dia 16–20**
  - [ ] Execute a consulta de custos gerais vs. COGS; corrija qualquer item categorizado incorretamente.
  - [ ] Execute a consulta de frequência de assinatura; cancele ou consolide serviços não utilizados.
- **Dia 21–25**
  - [ ] Adicione um ou dois limites orçamentários para despesas variáveis chave via `custom "budget"`.
  - [ ] Salve seus três comandos `bean-query` mais importantes em um script para fácil reutilização.
- **Dia 26–30**
  - [ ] Concilie todas as contas com afirmações `balance` de fim de mês.
  - [ ] Escreva uma breve nota de "fechamento mensal" resumindo números chave e vinculando a documentos.

---

## Trechos comuns que você reutilizará

**Um lançamento de despesa limpo**

```beancount
2025-08-05 * "Figma" "Pro plan"
  Expenses:SaaS               12.00 USD
  Assets:Bank:Checking       -12.00 USD
```

**Afirmação de saldo de um extrato**

```beancount
2025-09-01 balance Assets:Bank:Checking  8423.17 USD
```

**Barreira orçamentária para aluguel**

```beancount
2025-01-01 custom "budget" Expenses:Overhead:Rent "monthly" 2500.00 USD
```

---

## Mantenha simples, mantenha programado

A filosofia de uma desintoxicação financeira alimentada pelo Beancount é simples:

- **Programe o que você repete:** Automatize importações e relatórios.
- **Deixe as afirmações falharem alto:** Elas são seus trilhos de segurança, não uma inconveniência.
- **Prefira contas menos numerosas e mais claras** sobre categorização perfeita e granular.

Adote esses hábitos, e seu negócio funcionará com loops de feedback apertados: visibilidade de caixa diariamente, desvio de gastos visível semanalmente, e um fim de ano verdadeiramente chato. Essa é a clareza e controle que esta desintoxicação foi projetada para entregar.

---

### Referências e leitura adicional

- Beancount Query Language ([beancount][1])
- Importing External Data with Beancount ([beancount][4])
- Fava Budgets (`custom "budget" …`) ([Fava][11])
- Documents & `document` Directive ([beancount][2], [Fava][7])
- Balance and Pad Directives ([beancount][13])

_Este post é apenas para propósitos educacionais e não é aconselhamento fiscal ou legal._

[1]: https://www.google.com/search?q=%5Bhttps://beancount.github.io/docs/beancount_query_language.html%5D(https://beancount.github.io/docs/beancount_query_language.html) "Beancount Query Language - Beancount Documentation"
[4]: https://www.google.com/search?q=%5Bhttps://beancount.github.io/docs/importing_external_data.html%5D(https://beancount.github.io/docs/importing_external_data.html) "Importing External Data - Beancount Documentation"
[11]: https://www.google.com/search?q=%5Bhttps://fava.pythonanywhere.com/example-beancount-file/help/budgets%5D(https://fava.pythonanywhere.com/example-beancount-file/help/budgets) "Budgets"
[2]: https://www.google.com/search?q=%5Bhttps://beancount.github.io/docs/beancount_language_syntax.html%5D(https://beancount.github.io/docs/beancount_language_syntax.html) "Beancount Language Syntax"
[7]: https://www.google.com/search?q=%5Bhttps://fava.pythonanywhere.com/example-beancount-file/help/features%5D(https://fava.pythonanywhere.com/example-beancount-file/help/features) "Fava's features"
[13]: https://www.google.com/search?q=%5Bhttps://beancount.github.io/docs/balance_assertions_in_beancount.html%5D(https://beancount.github.io/docs/balance_assertions_in_beancount.html) "Balance Assertions in Beancount"
