# Rastrea inversiones inmobiliarias en Beancount.io

Gestionar la contabilidad de una propiedad en alquiler entre hipotecas, cuentas de depósito en garantía (escrow), calendarios de depreciación y la eventual venta de la propiedad puede resultar complicado. Esta guía completa te muestra cómo configurar y mantener un seguimiento preciso de inversiones inmobiliarias usando el potente sistema de contabilidad de texto plano de Beancount.io.

Explora un libro contable de ejemplo de bienes raíces en vivo:

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

## Por Qué las Herramientas Tradicionales se Quedan Cortas

### Problemas Comunes con el Software de Contabilidad de Bienes Raíces

- **Sin seguimiento de depreciación**: La mayoría de las herramientas no admiten depreciación lineal a 27,5 años con convención de mitad de mes
- **Manejo deficiente de la hipoteca**: Las vistas simplificadas no desglosan los pagos en intereses, principal y escrow
- **Ajustes de base de coste ausentes**: Las mejoras de capital que se suman a la base se tratan como gastos ordinarios
- **Sin descomposición de la ganancia por venta**: No pueden dividir las ganancias de la venta entre recuperación de depreciación y ganancias de capital a largo plazo
- **Estructuras de cuentas inflexibles**: Las categorías fijas no acomodan divisiones terreno/edificio ni cuentas contra-activo
- **Dependencia del proveedor**: Los formatos propietarios hacen imposible mantener 27,5 años de registros continuos

### Ventajas de Beancount.io

- **Control total**: Tus datos son tuyos en formato de texto plano que dura décadas
- **Personalización ilimitada**: Modela cualquier estructura de propiedad con cuentas personalizadas
- **Base de coste precisa**: Registra por separado el coste original, las mejoras y la depreciación
- **Cálculos transparentes**: Ve exactamente cómo se acumula la depreciación y cómo se calculan las ganancias
- **Propiedad como commodity**: Usa directivas de precio para la vista de Holdings de Fava con seguimiento de plusvalía
- **A prueba de futuro**: El formato de texto plano garantiza accesibilidad a largo plazo durante todo tu período de tenencia

## Configurando la Estructura de Cuentas de tu Propiedad

### Jerarquía de Cuentas

Comienza con una [estructura de cuentas completa](https://beancount.io/es/docs/Tips/real-estate-templates-examples) que refleje tu inversión inmobiliaria:

```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
```

### Definición de Materia Prima con Metadatos

Define tu propiedad como un commodity para un seguimiento estilo cartera:

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

1970-01-01 commodity USD
```

Esto permite que la [vista de Holdings de Fava](https://beancount.io/es/docs/Basics/fava-options) muestre el valor de mercado actual de tu propiedad junto con acciones, bonos y otras inversiones.

## Seguimiento de la Adquisición de la Propiedad

### Registrando la Compra

Registra una compra de \$400,000 con un pago inicial del 20% y una hipoteca fija a 30 años:

```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
```

### Costos de Cierre

Registra cada coste de cierre como una transacción separada para pistas de auditoría 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
```

### Asignación de Terreno/Edificio

El IRS exige separar el terreno no depreciable del edificio depreciable. Documenta la asignación usando comentarios:

```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
```

### Depósito Inicial en Garantía (Escrow)

Los prestamistas normalmente exigen un depósito inicial en escrow al cierre:

```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
```

## Gestión de Hipotecas

### Desglose del Pago Mensual

Cada pago de hipoteca se divide en gasto por intereses, reducción del principal y escrow:

```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 de la Cuenta de Garantía

Registra cuándo la cuenta de escrow paga impuestos y 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
```

## Ingresos por Alquiler y Gestión de la Propiedad

### Renta Bruta con Honorarios del Administrador

Registra por separado los ingresos brutos por alquiler y las comisiones de gestión de la propiedad:

```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 Garantía

Los depósitos de seguridad son pasivos, no ingresos:

```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 Renta

Documenta los aumentos de alquiler con claridad:

```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
```

## Seguimiento de la Depreciación

### Línea Recta de 27.5 Años con Convención de Mitad de Mes

Reglas federales de depreciación de EE. UU. para propiedades residenciales de alquiler (MACRS — Publicación 946 del IRS):

- **Período de recuperación**: 27,5 años
- **Método**: Lineal
- **Convención**: Mitad de mes (medio mes en el primer y último mes)

```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
```

Continúa los asientos mensuales por cada mes que poseas la propiedad, y en el mes de la venta registra un último medio mes bajo la misma convención de mitad de mes — consulta la [plantilla del mes de disposición](https://beancount.io/es/docs/Tips/real-estate-templates-examples). Mantenida desde mediados de marzo de 2024 hasta mediados de noviembre de 2025, este calendario acumula 9,5 meses de depreciación en 2024 y 10,5 meses en 2025: 20 meses × \$969,70 = \$19.394,00, la depreciación acumulada que la venta a continuación cancela.

### Patrón de Contra-Activo

El enfoque de contra-activo mantiene visible el coste original de la propiedad mientras registra la reducción por depreciación acumulada:

- `Assets:RealEstate:Property` — siempre muestra el coste original (\$400.000)
- `Assets:RealEstate:AccumDepreciation` — acumula un saldo negativo con el tiempo
- **Valor neto en libros** = Propiedad - |Depreciación acumulada| = base ajustada para depreciación

Esta separación es esencial para el cálculo de la venta, donde necesitas el coste original, las mejoras totales y la depreciación total como valores distintos.

## Mejoras de Capital vs. Reparaciones

### La Distinción Crítica

**Reparaciones** (deducción corriente — totalmente deducibles en el año en que se incurren):

```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
```

**Mejoras de capital** (se suman a la base — no deducibles ahora, reducen la ganancia en la venta):

```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
```

### Cómo Decidir

| Categoría                | Ejemplos                                             | Tratamiento fiscal                  |
| ----------------------- | ---------------------------------------------------- | ------------------------------ |
| **Reparación**              | Arreglar un grifo con fugas, reemplazar un condensador, parchear el techo      | Deducción corriente (Anexo E) |
| **Mejora de capital** | Calentador de agua nuevo, electrodomésticos nuevos, techo nuevo, ampliación | Se suma a la base de coste              |
| **Mantenimiento**         | Paisajismo, control de plagas, limpieza                   | Deducción corriente (Anexo E) |

## Disposición de la Propiedad

### Cálculo de la Ganancia por Venta

Cuando vendes, la ganancia se divide entre la [recuperación de depreciación](/blog/2026/07/18/depreciation-recapture-explained-guide) y la ganancia de capital a largo plazo. Los costes de venta — la comisión de venta y los costes de cierre pagados por el vendedor — reducen el importe realizado en la venta (Publicación 544 del IRS); no son gastos operativos separados:

```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 la Venta

Concilia el estado de cierre antes de registrar cualquier cosa. El agente de escrow deduce la comisión, los costes de cierre del vendedor y la cancelación de la hipoteca de los \$435.000,00 del comprador y te transfiere el resto — cada deducción ocurre exactamente una 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
```

Registra el cierre como dos asientos. La cancelación liquida el principal restante del préstamo — la cotización de cancelación del prestamista tras el pago de octubre de 2025. La disposición recibe los ingresos netos de \$408.900,00: los \$26.100,00 de costes de venta ya están restados dentro de esa cifra, por lo que no hay un pago separado de comisión o costes de cierre desde la cuenta corriente:

```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, los dos asientos mueven la cuenta corriente exactamente por el importe transferido: \$408.900,00 entran, \$314.744,09 salen, neto \$94.155,91. No registres también la comisión o los costes de cierre como pagos de gastos — eso deduciría los mismos \$26.100,00 del efectivo una segunda vez y distorsionaría los ingresos en la misma cantidad. Ten en cuenta que la ganancia realizada (\$22.294,00) y el efectivo con el que te quedas (\$94.155,91) son cifras diferentes: la ganancia compara los ingresos netos con la base ajustada, mientras que el efectivo es lo que queda después de la cancelación del préstamo.

## Rendimiento de la Cartera

### Directivas de Precio para el Seguimiento de la Apreciación

Configura valoraciones trimestrales de la propiedad:

```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
```

Fuentes para valoraciones de propiedades: Zillow Zestimate, estimación de Redfin, ventas comparables o tasaciones profesionales.

[Live Prices](https://beancount.io/es/docs/live-prices) puede suministrar cotizaciones de mercado compatibles y pares de divisas para otras posiciones en tu libro contable alojado. No tasa una propiedad ni pone precio a un commodity de propiedad personalizado. Continúa registrando las valoraciones de la propiedad con tus propias directivas con fecha.

### Vista de Tenencias de Fava

Con la propiedad modelada como un commodity, la vista de Holdings de Fava muestra:

- **Base de coste**: Precio de compra original
- **Valor de mercado**: Basado en la última directiva de precio
- **Ganancia no realizada**: Plusvalía desde la compra

Esto te permite ver bienes raíces junto con acciones, criptomonedas y otras inversiones en una vista de cartera unificada.

## Estrategias de Optimización Fiscal

### Categorización del Anexo E

La estructura de cuentas de Beancount se asigna directamente a las líneas del Anexo E:

| Línea del Anexo E             | Cuenta de Beancount                        |
| --------------------------- | ---------------------------------------- |
| Línea 3 (Alquileres recibidos)     | `Income:RealEstate:Rent`                 |
| Línea 5 (Publicidad)        | `Expenses:RealEstate:Advertising`        |
| Línea 8 (Seguros)            | `Expenses:RealEstate:Insurance`          |
| Línea 9 (Legal/profesional) | `Expenses:RealEstate:Legal`              |
| Línea 10 (Comisiones de gestión)   | `Expenses:RealEstate:PropertyManagement` |
| Línea 12 (Intereses hipotecarios) | `Expenses:RealEstate:MortgageInterest`   |
| Línea 14 (Reparaciones)           | `Expenses:RealEstate:Repairs`            |
| Línea 16 (Impuestos)             | `Expenses:RealEstate:PropertyTax`        |
| Línea 18 (Depreciación)      | `Expenses:RealEstate:Depreciation`       |

### Conceptos de Intercambio 1031

Un [intercambio 1031](/blog/2026/07/27/1031-like-kind-exchange-small-business-guide) difiere las ganancias de capital y la recuperación de depreciación al reinvertir en una propiedad de tipo similar. Aunque la implementación completa requiere la orientación de un CPA, Beancount puede registrar la ganancia diferida mediante metadatos y asientos memo.

## Informes y Análisis

### Consulta de Ingresos Netos por Alquiler

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

### Análisis de Flujo de Caja

```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);
```

### Verificación de Fin de Año

Usa aserciones de saldo para detectar errores antes de presentar impuestos:

```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
```

## Mejores Prácticas y Consejos

### 1. Documenta la División Terreno/Edificio

Registra la asignación del tasador del condado en comentarios con la fuente y la fecha. El IRS puede impugnar asignaciones agresivas al edificio.

### 2. Realiza el Seguimiento de la Depreciación Mensualmente

Aunque se declara anualmente, los asientos mensuales mantienen tu balance preciso y hacen que el cierre de año sea sencillo.

### 3. Clasifica las Mejoras vs. las Reparaciones con Cuidado

En caso de duda, consulta la Publicación 527 del IRS. La distinción entre una mejora de capital (se suma a la base) y una reparación (deducción corriente) puede ahorrarte o costarte miles.

### 4. Usa Aserciones de Saldo

Verifica los saldos trimestralmente. Si `bea --file <file> check` informa de un fallo de aserción, detectarás errores de entrada de datos a tiempo.

### 5. Mantén los Depósitos de Garantía como Pasivos

Nunca registres los depósitos de seguridad como ingresos hasta que se pierdan legalmente.

### 6. Mantén las Directivas de Precio

Actualiza las valoraciones de la propiedad trimestralmente usando ventas comparables, estimaciones de Zillow o tasaciones profesionales.

### 7. Planifica para la Venta

Mantén tus cuentas limpias para que ambos lados del cálculo de la venta ya estén computados cuando llegue el momento: la base ajustada (coste original + mejoras - depreciación acumulada) y el importe realizado (precio de venta - costes de venta).

## Conclusión

Un seguimiento eficaz de inversiones inmobiliarias requiere precisión, consistencia y las herramientas adecuadas. Beancount.io ofrece la flexibilidad y la potencia necesarias para gestionar una contabilidad compleja de propiedades en alquiler durante todo el ciclo de vida de la inversión.

Beneficios clave de usar Beancount.io para el seguimiento inmobiliario:

- **Propiedad completa de los datos**: Tus datos en formato de texto plano que dura décadas
- **Base de coste precisa**: Registra por separado la compra, las mejoras y la depreciación
- **Informes listos para impuestos**: La estructura de cuentas se asigna directamente al Anexo E
- **Vista de cartera**: La propiedad como commodity permite la integración con Holdings de Fava
- **A prueba de futuro**: El formato abierto garantiza accesibilidad durante el período de depreciación de 27,5 años y más allá

Comienza con una sola propiedad y amplía tu seguimiento a medida que crece tu cartera. La inversión en una configuración adecuada rinde dividendos en informes precisos, optimización fiscal y tranquilidad.

¿Listo para tomar el control de tu contabilidad inmobiliaria? [Comienza con Beancount.io](https://beancount.io/sign-up) hoy.
