# RF-PFM-006: Reportes Fiscales

**Épica:** OQI-008 - Portfolio Manager
**Versión:** 1.0
**Fecha:** 2025-12-05
**Estado:** Planificado
**Prioridad:** P1 - Alto

---

## Descripción

El sistema debe generar reportes fiscales que ayuden al usuario a cumplir con sus obligaciones tributarias, incluyendo cálculo de ganancias/pérdidas de capital, dividendos recibidos y documentación para declaración de impuestos.

---

## Requisitos Funcionales

### RF-PFM-006.1: Reporte de Ganancias/Pérdidas
- El sistema debe calcular ganancias/pérdidas realizadas
- Distinguir entre corto plazo (<1 año) y largo plazo (>1 año)
- Mostrar costo base y precio de venta
- Calcular ganancia/pérdida neta del período
- Permitir seleccionar método de cálculo (FIFO, LIFO, identificación específica)

### RF-PFM-006.2: Reporte de Dividendos
- El sistema debe listar todos los dividendos recibidos
- Clasificar dividendos: ordinarios vs calificados
- Mostrar total de dividendos por período
- Incluir dividendos de acciones y de ETFs

### RF-PFM-006.3: Reporte Anual de Impuestos
- Generar reporte consolidado del año fiscal
- Incluir sección de ganancias/pérdidas de capital
- Incluir sección de dividendos
- Incluir sección de intereses (si aplica)
- Formato compatible con formularios fiscales

### RF-PFM-006.4: Tax-Loss Harvesting (Premium)
- El sistema debe identificar posiciones con pérdida
- Sugerir ventas para compensar ganancias
- Calcular ahorro fiscal estimado
- Alertar de regla de wash sale (30 días)
- Mostrar impacto en portfolio

### RF-PFM-006.5: Exportación de Reportes
- Exportar a PDF para archivo
- Exportar a CSV para tax software
- Exportar formato compatible con SAT (México)
- Incluir toda la documentación de soporte

---

## Criterios de Aceptación

```gherkin
Feature: Reportes Fiscales

Scenario: Generar reporte de ganancias/pérdidas
  Given tengo ventas realizadas en el año
  When genero "Reporte de Ganancias/Pérdidas 2025"
  Then veo lista de todas las ventas
  And cada venta muestra:
    | Campo | Ejemplo |
    | Fecha compra | 15/03/2025 |
    | Fecha venta | 05/12/2025 |
    | Símbolo | AAPL |
    | Cantidad | 10 |
    | Costo base | $1,750 |
    | Precio venta | $1,855 |
    | Ganancia | $105 |
    | Plazo | Largo |
  And veo totales de corto y largo plazo

Scenario: Ver oportunidades de tax-loss harvesting
  Given soy usuario Premium
  And tengo posiciones con pérdida
  And tengo ganancias realizadas en el año
  When veo "Oportunidades Tax-Loss Harvesting"
  Then veo posiciones con pérdida no realizada
  And veo ahorro fiscal estimado si las vendo
  And veo alerta de wash sale si aplica

Scenario: Exportar reporte para declaración
  Given generé mi reporte fiscal anual
  When selecciono "Exportar para SAT"
  Then se descarga archivo en formato compatible
  And incluye todos los datos necesarios
  And incluye documentación de soporte
```

---

## Reglas de Negocio

| Regla | Descripción |
|-------|-------------|
| RN-001 | Reportes fiscales disponibles para Pro/Premium |
| RN-002 | Método de costo base default: FIFO |
| RN-003 | Largo plazo: >365 días de tenencia |
| RN-004 | Wash sale: No recomprar mismo activo en 30 días |
| RN-005 | Tax-loss harvesting solo Premium |
| RN-006 | Considerar zona horaria del usuario para fechas |

---

## Formato de Reporte

### Sección de Ganancias de Capital
```markdown
## Ganancias y Pérdidas de Capital 2025

### Resumen
| Categoría | Ganancias | Pérdidas | Neto |
|-----------|-----------|----------|------|
| Corto Plazo | $2,500 | -$800 | $1,700 |
| Largo Plazo | $5,200 | -$1,200 | $4,000 |
| **Total** | $7,700 | -$2,000 | **$5,700** |

### Detalle de Transacciones

| Fecha Compra | Fecha Venta | Símbolo | Cant. | Costo | Venta | G/P | Plazo |
|--------------|-------------|---------|-------|-------|-------|-----|-------|
| 15/03/2024 | 05/12/2025 | AAPL | 10 | $1,750 | $1,855 | +$105 | L |
| 20/07/2025 | 15/11/2025 | TSLA | 5 | $1,300 | $1,200 | -$100 | C |
...
```

### Sección de Dividendos
```markdown
## Dividendos Recibidos 2025

### Resumen
| Tipo | Total |
|------|-------|
| Dividendos Calificados | $450.00 |
| Dividendos Ordinarios | $125.00 |
| **Total** | **$575.00** |

### Detalle
| Fecha | Símbolo | Tipo | Monto |
|-------|---------|------|-------|
| 15/03/2025 | AAPL | Calificado | $75.00 |
| 15/06/2025 | MSFT | Calificado | $82.00 |
...
```

---

## Wireframe

```
┌─────────────────────────────────────────────────────────────────────────┐
│ Reportes Fiscales                                         [Premium]     │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│ Año Fiscal: [2025 ▾]                    [Generar Reporte] [Exportar ▾] │
│                                                                          │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Resumen Fiscal 2025                                                  │ │
│ │                                                                      │ │
│ │  ┌────────────────────┐  ┌────────────────────┐                     │ │
│ │  │ GANANCIAS CAPITAL  │  │    DIVIDENDOS      │                     │ │
│ │  │     $5,700         │  │      $575          │                     │ │
│ │  │  Neto (G-P)        │  │   Total recibido   │                     │ │
│ │  └────────────────────┘  └────────────────────┘                     │ │
│ │                                                                      │ │
│ │  Desglose Ganancias de Capital:                                     │ │
│ │  • Corto plazo: $1,700 (tasa ordinaria)                             │ │
│ │  • Largo plazo: $4,000 (tasa preferencial)                          │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│                                                                          │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ 💡 Tax-Loss Harvesting Oportunidades                    [Premium]   │ │
│ │                                                                      │ │
│ │ Posiciones con pérdida no realizada:                                │ │
│ │                                                                      │ │
│ │ Símbolo   │ Pérdida    │ Ahorro Est.  │ Wash Sale │ Acción          │ │
│ │ TSLA      │ -$500      │ ~$125        │ ✓ OK      │ [Vender]        │ │
│ │ COIN      │ -$300      │ ~$75         │ ⚠️ 15 días│ [Ver más]       │ │
│ │                                                                      │ │
│ │ Ahorro fiscal potencial total: ~$200                                │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│                                                                          │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Reportes Disponibles                                                │ │
│ │                                                                      │ │
│ │ 📄 Ganancias/Pérdidas de Capital          [Generar] [⬇️]            │ │
│ │ 📄 Reporte de Dividendos                  [Generar] [⬇️]            │ │
│ │ 📄 Reporte Consolidado Anual              [Generar] [⬇️]            │ │
│ │ 📄 Formato SAT (México)                   [Generar] [⬇️]            │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│                                                                          │
└─────────────────────────────────────────────────────────────────────────┘
```

---

## Dependencias

### Épicas Requeridas
- **OQI-004:** Historial de transacciones
- **OQI-008:** Portfolio Manager

---

## Especificaciones Técnicas Relacionadas

- [ET-PFM-006: Motor de Reportes Fiscales](../especificaciones/ET-PFM-006-reportes-fiscales.md)

---

## Historias de Usuario Relacionadas

- US-PFM-012: Generar reporte fiscal anual

---

## Notas Legales

> **Disclaimer:** Los reportes fiscales generados son informativos y de apoyo.
> El usuario es responsable de verificar la información con un profesional
> fiscal y cumplir con las regulaciones locales.

---

*Documento de requerimientos - Sistema NEXUS*
*OrbiQuant IA Trading Platform*
