# Acompanhe investimentos imobiliários no Beancount.io

Gerenciar a contabilidade de imóveis de aluguel — envolvendo hipotecas, contas de caução (escrow), cronogramas de depreciação e a eventual venda do imóvel — pode ser desafiador. Este guia abrangente mostra como configurar e manter um rastreamento preciso de investimentos imobiliários usando o poderoso sistema de contabilidade em texto simples do Beancount.io.

Explore um exemplo real de livro-razão imobiliário:

<LedgerEmbed
  username="open_ledger"
  ledger="real-estate-example"
  page=""
  title="Real Estate Example Ledger"
/>

## Por que as Ferramentas Tradicionais São Insuficientes

### Problemas Comuns com Software de Contabilidade Imobiliária

- **Sem Rastreamento de Depreciação**: A maioria das ferramentas não suporta depreciação linear de 27,5 anos com convenção de meio de mês
- **Manuseio Deficiente de Hipotecas**: Visualizações simplificadas não dividem os pagamentos em juros, principal e caução
- **Ajustes de Base de Custo Ausentes**: Melhorias de capital que aumentam a base são tratadas como despesas comuns
- **Sem Decomposição do Ganho na Venda**: Não é possível separar o produto da venda em recuperação de depreciação versus ganhos de capital de longo prazo
- **Estruturas de Contas Inflexíveis**: Categorias fixas não acomodam a separação entre terreno/edificação ou contas contrárias ao ativo
- **Aprisionamento a Fornecedor**: Formatos proprietários tornam impossível manter 27,5 anos de registros contínuos

### Vantagens do Beancount.io

- **Controle Total**: Seus dados em formato de texto simples que dura décadas
- **Personalização Ilimitada**: Modele qualquer estrutura de imóvel com contas personalizadas
- **Base de Custo Precisa**: Rastreie custo original, melhorias e depreciação separadamente
- **Cálculos Transparentes**: Veja exatamente como a depreciação se acumula e os ganhos são computados
- **Imóvel como Commodity**: Use diretivas de preço para a visualização de Holdings do Fava com rastreamento de valorização
- **À Prova de Futuro**: O formato de texto simples garante acessibilidade de longo prazo durante todo o seu período de detenção

## Configurando a Estrutura de Contas da Sua Propriedade

### Hierarquia de Contas

Comece com uma [estrutura de contas abrangente](https://beancount.io/pt/docs/Tips/real-estate-templates-examples) que reflita seu investimento imobiliário:

```bean
; ============================================================
; Property Asset Accounts
; ============================================================

; The property commodity — 1 unit purchased at cost basis
1970-01-01 open Assets:RealEstate:Property
; Contra-asset: accumulated depreciation reduces building value on balance sheet
; Note: Land ($80K, 20%) is non-depreciable; Building ($320K, 80%) is depreciated
1970-01-01 open Assets:RealEstate:AccumDepreciation
; Capital improvements added to basis
1970-01-01 open Assets:RealEstate:CapitalImprovements

; ============================================================
; Bank Accounts
; ============================================================

1970-01-01 open Assets:Bank:Checking
1970-01-01 open Assets:Bank:Savings
; Escrow impound: monthly contributions for property tax & insurance
1970-01-01 open Assets:Bank:EscrowImpound

; ============================================================
; Liability Accounts
; ============================================================

; 30-year fixed mortgage at 7.0% APR
1970-01-01 open Liabilities:Mortgage
; Tenant security deposit — not income until forfeited
1970-01-01 open Liabilities:SecurityDeposit

; ============================================================
; Income Accounts
; ============================================================

1970-01-01 open Income:RealEstate:Rent
1970-01-01 open Income:RealEstate:CapitalGains:LongTerm
1970-01-01 open Income:RealEstate:DepreciationRecapture

; ============================================================
; Expense Accounts
; ============================================================

1970-01-01 open Expenses:RealEstate:MortgageInterest
1970-01-01 open Expenses:RealEstate:LoanOrigination
1970-01-01 open Expenses:RealEstate:PropertyTax
1970-01-01 open Expenses:RealEstate:Insurance
1970-01-01 open Expenses:RealEstate:PropertyManagement
1970-01-01 open Expenses:RealEstate:Repairs
1970-01-01 open Expenses:RealEstate:Maintenance
1970-01-01 open Expenses:RealEstate:Depreciation
; Buyer-side closing costs (purchase only). There is deliberately no
; SellingCosts expense account: costs of sale reduce the amount realized
; at closing instead — see Property Disposition below.
1970-01-01 open Expenses:RealEstate:ClosingCosts
```

### Definição da Commodity com Metadados

Defina seu imóvel como uma commodity para rastreamento no estilo de portfólio:

```bean
1970-01-01 commodity PROP123MAIN
  name: "123 Main St, Anytown, CA 90210"
  asset-class: "real-estate"

1970-01-01 commodity USD
```

Isso permite que a [visualização de Holdings do Fava](https://beancount.io/pt/docs/Basics/fava-options) exiba o valor de mercado atual do seu imóvel ao lado de ações, títulos e outros investimentos.

## Acompanhamento da Aquisição da Propriedade

### Registrando a Compra

Rastreie uma compra de \$400.000 com 20% de entrada e hipoteca fixa de 30 anos:

```bean
; Down payment — 20% of $400,000
2024-03-15 * "Escrow" "Down payment — 20% of $400,000"
  Assets:RealEstate:Property           1 PROP123MAIN {400,000.00 USD, 2024-03-15}
  Assets:Bank:Checking              -80,000.00 USD
  Liabilities:Mortgage             -320,000.00 USD
```

### Custos de Fechamento

Registre cada custo de fechamento como uma transação separada para trilhas de auditoria claras:

```bean
2024-03-15 * "Lender" "Loan origination fee — 1% of $320,000"
  Expenses:RealEstate:LoanOrigination   3,200.00 USD
  Assets:Bank:Checking                 -3,200.00 USD

2024-03-15 * "Title company" "Title insurance, escrow fees, recording"
  Expenses:RealEstate:ClosingCosts      2,800.00 USD
  Assets:Bank:Checking                 -2,800.00 USD

2024-03-15 * "Appraiser" "Property appraisal"
  Expenses:RealEstate:ClosingCosts        450.00 USD
  Assets:Bank:Checking                   -450.00 USD
```

### Alocação Terreno/Construção

A Receita Federal dos EUA (IRS) exige a separação do terreno não depreciável da edificação depreciável. Documente a alocação usando comentários:

```bean
; Land / building cost allocation (from county assessor):
; County assessor shows 20% land ($80K) / 80% building ($320K).
; Only the building portion ($320K) is depreciated — see depreciation section.
; Source: County Assessor parcel record, assessed 2024-01-01
```

### Caução Inicial

Os credores normalmente exigem um depósito inicial de caução no fechamento:

```bean
; Initial escrow: 3 months property tax + 1 year insurance prepaid
; Property tax: ~$5,000/yr → $416.67/mo × 3 = $1,250.00
; Insurance: ~$1,800/yr prepaid
2024-03-15 * "Escrow" "Initial escrow impound — property tax (3 mo) + insurance (1 yr)"
  Assets:Bank:EscrowImpound              1,250.00 USD
  Expenses:RealEstate:Insurance          1,800.00 USD
  Assets:Bank:Checking                  -3,050.00 USD
```

## Gerenciamento de Hipoteca

### Detalhamento do Pagamento Mensal

Cada pagamento de hipoteca se divide em despesa de juros, redução do principal e caução:

```bean
; 30-year fixed: $320,000 at 7.0% APR
; Monthly P&I: $2,129.06
; Monthly escrow: $566.67 ($416.67 tax + $150.00 insurance)
; Total payment: $2,695.73

; Month 1: Interest = $320,000.00 × 0.07 / 12 = $1,866.67
2024-04-01 * "Bank" "Mortgage payment — April 2024"
  Expenses:RealEstate:MortgageInterest    1,866.67 USD
  Liabilities:Mortgage                      262.39 USD
  Assets:Bank:EscrowImpound                 566.67 USD
  Assets:Bank:Checking                   -2,695.73 USD

; Month 2: Interest = ($320,000.00 - $262.39) × 0.07 / 12 = $1,865.14
2024-05-01 * "Bank" "Mortgage payment — May 2024"
  Expenses:RealEstate:MortgageInterest    1,865.14 USD
  Liabilities:Mortgage                      263.92 USD
  Assets:Bank:EscrowImpound                 566.67 USD
  Assets:Bank:Checking                   -2,695.73 USD
```

### Desembolsos da Caução

Rastreie quando a conta de caução paga impostos e seguros:

```bean
; Semi-annual property tax disbursement
2024-09-15 * "County tax collector" "Property tax — first installment"
  Expenses:RealEstate:PropertyTax    2,500.00 USD
  Assets:Bank:EscrowImpound        -2,500.00 USD

; Annual insurance renewal
2025-03-15 * "Insurance company" "Homeowner insurance renewal — year 2"
  Expenses:RealEstate:Insurance      1,850.00 USD
  Assets:Bank:EscrowImpound        -1,850.00 USD
```

## Renda de Aluguel e Gerenciamento de Propriedade

### Aluguel Bruto com Taxas de Administração

Rastreie a receita bruta de aluguel e as taxas de administração imobiliária separadamente:

```bean
; Rent: $2,400/mo, PM fee: 8% = $192
; Net to owner: $2,208

2024-04-01 * "Tenant" "April 2024 rent"
  Assets:Bank:Checking                    2,208.00 USD
  Expenses:RealEstate:PropertyManagement    192.00 USD
  Income:RealEstate:Rent                 -2,400.00 USD
```

### Depósitos de Segurança

Depósitos de segurança são passivos, não receita:

```bean
; Receive deposit — creates liability
2024-03-20 * "Tenant" "Security deposit — 1 month rent"
  Assets:Bank:Checking                    2,400.00 USD
  Liabilities:SecurityDeposit           -2,400.00 USD

; Return deposit — eliminates liability
2025-11-01 * "Tenant" "Return security deposit — lease ended"
  Liabilities:SecurityDeposit            2,400.00 USD
  Assets:Bank:Checking                  -2,400.00 USD
```

### Aumentos de Aluguel

Documente aumentos de aluguel claramente:

```bean
; 2025 rent increase: $2,400 → $2,500/mo
; New PM fee: 8% × $2,500 = $200
2025-01-01 * "Tenant" "January 2025 rent (increased to $2,500)"
  Assets:Bank:Checking                    2,300.00 USD
  Expenses:RealEstate:PropertyManagement    200.00 USD
  Income:RealEstate:Rent                 -2,500.00 USD
```

## Acompanhamento de Depreciação

### Depreciação Linear de 27,5 Anos com Convenção de Meio-Mês

Regras federais dos EUA de depreciação para imóveis residenciais de aluguel (MACRS — IRS Publication 946):

- **Período de recuperação**: 27,5 anos
- **Método**: Linear
- **Convenção**: Meio de mês (meio mês no primeiro e no último meses)

```bean
; Building cost: $320,000 (80% of purchase price)
; Monthly depreciation: $320,000 / 27.5 / 12 = $969.70
; Half-month: $484.85

; First month — half-month (placed in service 3/15)
2024-03-31 * "Depreciation" "March 2024 — half-month (placed in service)"
  Expenses:RealEstate:Depreciation          484.85 USD
  Assets:RealEstate:AccumDepreciation      -484.85 USD

; Full months
2024-04-30 * "Depreciation" "April 2024"
  Expenses:RealEstate:Depreciation          969.70 USD
  Assets:RealEstate:AccumDepreciation      -969.70 USD

2024-05-31 * "Depreciation" "May 2024"
  Expenses:RealEstate:Depreciation          969.70 USD
  Assets:RealEstate:AccumDepreciation      -969.70 USD
```

Continue os lançamentos mensais para cada mês em que você detém o imóvel e, no mês da venda, registre um meio mês final sob a mesma convenção de meio de mês — veja o [modelo do mês de alienação](https://beancount.io/pt/docs/Tips/real-estate-templates-examples). Mantido de meados de março de 2024 a meados de novembro de 2025, este cronograma acumula 9,5 meses de depreciação em 2024 e 10,5 meses em 2025: 20 meses × \$969,70 = \$19.394,00, a depreciação acumulada que a venda abaixo zera.

### Padrão de Ativo Redutor

A abordagem de conta contrária ao ativo mantém o custo original do imóvel visível enquanto rastreia a redução da depreciação acumulada:

- `Assets:RealEstate:Property` — sempre mostra o custo original (\$400.000)
- `Assets:RealEstate:AccumDepreciation` — acumula saldo negativo ao longo do tempo
- **Valor líquido contábil** = Imóvel - |Depreciação Acumulada| = base ajustada para depreciação

Essa separação é essencial para o cálculo da venda, onde você precisa do custo original, total de melhorias e total de depreciação como valores distintos.

## Melhorias de Capital vs. Reparos

### A Distinção Crítica

**Reparos** (dedução corrente — totalmente dedutível no ano em que incorridos):

```bean
2024-05-18 * "HVAC Pro" "A/C repair — replaced capacitor"
  Expenses:RealEstate:Repairs             285.00 USD
  Assets:Bank:Checking                   -285.00 USD

2024-06-10 * "Joe's Plumbing" "Fix leaking kitchen faucet"
  Expenses:RealEstate:Repairs             180.00 USD
  Assets:Bank:Checking                   -180.00 USD
```

**Melhorias de capital** (adicionam à base — não dedutíveis agora, reduzem o ganho na venda):

```bean
2024-08-12 * "Home Depot" "Replace water heater — 50 gal gas"
  Assets:RealEstate:CapitalImprovements  1,800.00 USD
  Assets:Bank:Checking                  -1,800.00 USD

2024-10-05 * "Lowe's" "New kitchen appliances — stove + dishwasher"
  Assets:RealEstate:CapitalImprovements  4,200.00 USD
  Assets:Bank:Checking                  -4,200.00 USD
```

### Como Decidir

| Categoria                  | Exemplos                                                      | Tratamento Fiscal                    |
| -------------------------- | ------------------------------------------------------------- | ------------------------------------ |
| **Reparo**                 | Consertar torneira com vazamento, trocar capacitor, remendar telhado | Dedução corrente (Schedule E)  |
| **Melhoria de Capital**    | Novo aquecedor de água, novos eletrodomésticos, novo telhado, ampliação | Adiciona à base de custo     |
| **Manutenção**             | Paisagismo, controle de pragas, limpeza                        | Dedução corrente (Schedule E)        |

## Disposição da Propriedade

### Cálculo do Ganho na Venda

Quando você vende, o ganho se divide entre [recuperação de depreciação](/blog/2026/07/18/depreciation-recapture-explained-guide) e ganho de capital de longo prazo. Os custos de venda — a comissão de venda e os custos de fechamento pagos pelo vendedor — reduzem o valor realizado na venda (IRS Publication 544); eles não são despesas operacionais separadas:

```bean
; === Gain Calculation ===
;
; Purchase price:              $400,000.00
; + Capital improvements:      +  6,000.00
; - Accumulated depreciation:  - 19,394.00
; = Adjusted basis:            $386,606.00
;
; Sale price:                  $435,000.00
; - Selling costs (6%):        - 26,100.00 (itemized in the closing statement below)
; = Net proceeds:              $408,900.00
;
; Total gain:                  $ 22,294.00 (net proceeds - adjusted basis)
;   Depreciation recapture:    $ 19,394.00 (unrecaptured §1250 gain — taxed at max 25%)
;   Long-term capital gain:    $  2,900.00 (taxed at LTCG rates)
```

### Registrando a Venda

Reconcilie o extrato de fechamento antes de registrar qualquer coisa. O agente de caução deduz a comissão, os custos de fechamento do vendedor e a quitação da hipoteca dos \$435.000,00 do comprador e transfere o restante para você — cada dedução ocorre exatamente uma vez:

```bean
; === Closing Statement ===
;
; Contract price:              $435,000.00
; - Sales commission (5%):     - 21,750.00
; - Seller closing costs (1%): -  4,350.00
; = Net proceeds:              $408,900.00
; - Mortgage payoff:           -314,744.09
; = Cash wired to seller:      $ 94,155.91
```

Registre o fechamento como dois lançamentos. A quitação zera o principal remanescente do empréstimo — a cotação de quitação do credor após o pagamento de outubro de 2025. A alienação recebe o produto líquido de \$408.900,00: os \$26.100,00 de custos de venda já estão subtraídos dentro desse valor, então não há pagamento separado de comissão ou custos de fechamento pela conta corrente:

```bean
; Mortgage payoff — remaining principal per the lender's payoff quote
2025-11-15 * "Bank" "Mortgage payoff at closing"
  Liabilities:Mortgage                  314,744.09 USD
  Assets:Bank:Checking                 -314,744.09 USD

; Dispose property and recognize gain — the cash posting is net of the
; $26,100.00 selling costs, which reduce the amount realized at closing
2025-11-15 * "Sale" "Dispose property — recognize gain"
  Assets:RealEstate:Property              -1 PROP123MAIN {400,000.00 USD, 2024-03-15}
  Assets:RealEstate:CapitalImprovements   -6,000.00 USD
  Assets:RealEstate:AccumDepreciation     19,394.00 USD
  Assets:Bank:Checking                   408,900.00 USD
  Income:RealEstate:DepreciationRecapture -19,394.00 USD
  Income:RealEstate:CapitalGains:LongTerm  -2,900.00 USD
```

Juntos, os dois lançamentos movimentam a conta corrente exatamente pelo valor transferido: \$408.900,00 entrando, \$314.744,09 saindo, líquido de \$94.155,91. Não registre também a comissão ou os custos de fechamento como pagamentos de despesas — isso deduziria os mesmos \$26.100,00 do caixa uma segunda vez e distorceria a receita no mesmo valor. Observe que o ganho realizado (\$22.294,00) e o caixa com que você fica (\$94.155,91) são números diferentes: o ganho compara o produto líquido com a base ajustada, enquanto o caixa é o que resta após a quitação do empréstimo.

## Desempenho do Portfólio

### Diretivas de Preço para Acompanhamento de Valorização

Configure avaliações trimestrais do imóvel:

```bean
2024-03-15 price PROP123MAIN  400,000.00 USD
2024-06-30 price PROP123MAIN  405,000.00 USD
2024-09-30 price PROP123MAIN  412,000.00 USD
2024-12-31 price PROP123MAIN  418,000.00 USD
2025-03-31 price PROP123MAIN  425,000.00 USD
2025-06-30 price PROP123MAIN  430,000.00 USD
```

Fontes para avaliações de imóveis: Zillow Zestimate, estimativa do Redfin, vendas comparáveis ou avaliações profissionais.

[Live Prices](https://beancount.io/pt/docs/live-prices) pode fornecer cotações de mercado suportadas e pares de moedas para outros ativos no seu livro-razão hospedado. Ele não avalia um imóvel nem precifica uma commodity de imóvel personalizada. Continue registrando avaliações de imóveis com suas próprias diretivas datadas.

### Visualização Holdings do Fava

Com o imóvel modelado como uma commodity, a visualização de Holdings do Fava mostra:

- **Base de custo**: Preço de compra original
- **Valor de mercado**: Com base na diretiva de preço mais recente
- **Ganho não realizado**: Valorização desde a compra

Isso permite ver imóveis ao lado de ações, criptomoedas e outros investimentos em uma visualização unificada de portfólio.

## Estratégias de Otimização Fiscal

### Categorização do Anexo E

A estrutura de contas do Beancount mapeia diretamente para os itens do Schedule E:

| Linha do Schedule E              | Conta Beancount                          |
| -------------------------------- | ---------------------------------------- |
| Linha 3 (Aluguéis recebidos)     | `Income:RealEstate:Rent`                 |
| Linha 5 (Publicidade)            | `Expenses:RealEstate:Advertising`        |
| Linha 8 (Seguro)                 | `Expenses:RealEstate:Insurance`          |
| Linha 9 (Jurídico/profissional)  | `Expenses:RealEstate:Legal`              |
| Linha 10 (Taxas de administração)| `Expenses:RealEstate:PropertyManagement` |
| Linha 12 (Juros de hipoteca)     | `Expenses:RealEstate:MortgageInterest`   |
| Linha 14 (Reparos)               | `Expenses:RealEstate:Repairs`            |
| Linha 16 (Impostos)              | `Expenses:RealEstate:PropertyTax`        |
| Linha 18 (Depreciação)           | `Expenses:RealEstate:Depreciation`       |

### Conceitos de Troca 1031

Uma [troca 1031](/blog/2026/07/27/1031-like-kind-exchange-small-business-guide) adia ganhos de capital e recuperação de depreciação ao reinvestir em imóveis semelhantes. Embora a implementação completa exija orientação de um contador, o Beancount pode rastrear o ganho diferido por meio de metadados e lançamentos de memorando.

## Relatórios e Análises

### Consulta de Renda Líquida de Aluguel

```sql
SELECT account, sum(position) as total
WHERE account ~ "Income:RealEstate" OR account ~ "Expenses:RealEstate"
GROUP BY account
ORDER BY total;
```

### Análise de Fluxo de Caixa

```sql
-- Monthly net cash flow from property
SELECT year(date), month(date), sum(position) as net_flow
WHERE account ~ "Assets:Bank:Checking"
  AND (narration ~ "rent" OR narration ~ "Mortgage" OR narration ~ "repair")
GROUP BY year(date), month(date)
ORDER BY year(date), month(date);
```

### Verificação de Fim de Ano

Use asserções de saldo para detectar erros antes da declaração de impostos:

```bean
2025-01-01 balance Assets:RealEstate:Property    1 PROP123MAIN
2025-01-01 balance Assets:RealEstate:CapitalImprovements  6,000.00 USD
2025-01-01 balance Assets:RealEstate:AccumDepreciation   -9,212.15 USD
2025-01-01 balance Liabilities:SecurityDeposit           -2,400.00 USD
```

## Melhores Práticas e Dicas

### 1. Documente a Divisão Terreno/Construção

Registre a alocação do avaliador do condado em comentários com a fonte e a data. O IRS pode contestar alocações agressivas de edificação.

### 2. Acompanhe a Depreciação Mensalmente

Embora seja reportada anualmente, lançamentos mensais mantêm seu balanço patrimonial preciso e tornam o fim de ano simples.

### 3. Classifique Melhorias vs. Reparos com Cuidado

Em caso de dúvida, consulte a IRS Publication 527. A distinção entre uma melhoria de capital (adiciona à base) e um reparo (dedução corrente) pode economizar ou custar milhares.

### 4. Use Asserções de Saldo

Faça asserções de saldos trimestralmente. Se `bea --file <file> check` reportar uma falha de asserção, você detectará erros de entrada de dados cedo.

### 5. Mantenha Depósitos de Segurança como Passivos

Nunca registre depósitos de segurança como receita até que sejam legalmente perdidos.

### 6. Mantenha Diretivas de Preço

Atualize as avaliações do imóvel trimestralmente usando vendas comparáveis, estimativas do Zillow ou avaliações profissionais.

### 7. Planeje a Venda

Mantenha suas contas organizadas para que ambos os lados do cálculo da venda já estejam computados quando chegar a hora: a base ajustada (custo original + melhorias - depreciação acumulada) e o valor realizado (preço de venda - custos de venda).

## Conclusão

O rastreamento eficaz de investimentos imobiliários exige precisão, consistência e as ferramentas certas. O Beancount.io oferece a flexibilidade e o poder necessários para gerenciar a contabilidade complexa de imóveis de aluguel ao longo de todo o ciclo de vida do investimento.

Principais benefícios de usar o Beancount.io para rastreamento imobiliário:

- **Propriedade Completa dos Dados**: Seus dados em formato de texto simples que dura décadas
- **Base de Custo Precisa**: Rastreie compra, melhorias e depreciação separadamente
- **Relatórios Prontos para Impostos**: A estrutura de contas mapeia diretamente para o Schedule E
- **Visão de Portfólio**: O imóvel como commodity permite a integração com Holdings do Fava
- **À Prova de Futuro**: O formato aberto garante acessibilidade durante o período de depreciação de 27,5 anos e além

Comece com um único imóvel e expanda seu rastreamento conforme seu portfólio cresce. O investimento na configuração adequada rende dividendos em relatórios precisos, otimização fiscal e tranquilidade.

Pronto para assumir o controle da sua contabilidade imobiliária? [Comece com o Beancount.io](https://beancount.io/sign-up) hoje.
