# DeclaRenta

![DeclaRenta](<https://declarenta.com/docs/images/banner.svg>)

[![Descargas en Docker Hub](<https://img.shields.io/docker/pulls/drumsergio/declarenta?style=flat-square&amp;logo=docker>)](<https://hub.docker.com/r/drumsergio/declarenta>) [![Estrellas en GitHub](<https://img.shields.io/github/stars/GeiserX/DeclaRenta?style=flat-square&amp;logo=github>)](<https://github.com/GeiserX/DeclaRenta/stargazers>) [![Última versión](<https://img.shields.io/github/v/release/GeiserX/DeclaRenta?style=flat-square>)](<https://github.com/GeiserX/DeclaRenta/releases>) [![Licencia AGPL-3.0](<https://img.shields.io/github/license/GeiserX/DeclaRenta?style=flat-square>)](<https://github.com/GeiserX/DeclaRenta/blob/main/LICENSE>)

---

**DeclaRenta** es una aplicación web gratuita que lee los informes de tu broker extranjero y calcula las casillas de la renta con FIFO y los tipos de cambio oficiales del BCE. Renta Web no importa esos datos, así que sin esto hay que hacerlo a mano. Funciona en [declarenta.com](<https://declarenta.com>) sin registro, o en tu propio equipo con [Docker](<https://declarenta.com/docs/getting-started/#docker>). Empieza por [Primeros pasos](<https://declarenta.com/docs/getting-started/index.md>) y ten a mano las [casillas del Modelo 100](<https://declarenta.com/docs/casillas/index.md>).

- **[Primeros pasos](<https://declarenta.com/docs/getting-started/index.md>)**

  ---

  Entra en declarenta.com o levanta la imagen Docker. Sin cuenta y sin instalar nada.
- **[Tu primera declaración](<https://declarenta.com/docs/getting-started/#tu-primera-declaracion>)**

  ---

  Sube un informe, revisa lo que ha detectado y copia las casillas en Renta Web. Hay ficheros de ejemplo para probar.
- **[Uso](<https://declarenta.com/docs/usage/index.md>)**

  ---

  Las secciones de la web (perfil, Renta, guía, 720, 721 y D-6) y todos los comandos de la CLI.
- **[Casillas del Modelo 100](<https://declarenta.com/docs/casillas/index.md>)**

  ---

  Cada casilla con su fórmula, su base legal y las notas que evitan los errores habituales.

## La aplicación

Un asistente de tres pasos: subes los ficheros, revisas lo que ha detectado y obtienes las casillas. La barra lateral añade el perfil fiscal, la [guía de Renta Web](<https://declarenta.com/docs/usage/#guia-renta-web>) y las secciones del [Modelo 720, 721 y D-6](<https://declarenta.com/docs/modelos-informativos/index.md>). Los datos de las capturas son ficheros de ejemplo con cuentas e ISIN ficticios.

![Resultados del Modelo 100 para el ejercicio 2024 a partir de seis ficheros de cinco brokers: la barra del ejercicio y las casillas 0328, 0331, 0029, 0027 y 0588 con su importe, la ganancia neta y el aviso de pérdidas bloqueadas por anti-churning](<https://declarenta.com/docs/images/screenshots/resultados.png>)

![El paso de subida en un móvil, con los seis ficheros de ejemplo añadidos](<https://declarenta.com/docs/images/screenshots/subir-mobile.png>)

Subida de ficheros

![El paso Revisar datos en un móvil: IBKR, Degiro, Trading 212, Scalable Capital y Freedom24, 27 operaciones y 10 dividendos](<https://declarenta.com/docs/images/screenshots/revisar-mobile.png>)

Revisión de los datos

![La sección del Modelo 720 en un móvil, con los datos del perfil fiscal y la barra del umbral de 50.000 euros](<https://declarenta.com/docs/images/screenshots/modelo-720-mobile.png>)

Modelo 720

Antes de los resultados, el paso [Revisar datos](<https://declarenta.com/docs/getting-started/#tu-primera-declaracion>) muestra por broker cuántas operaciones, dividendos y divisas ha leído, para que compruebes que cuadra con tu informe antes de calcular nada.

![El paso Revisar datos: tarjetas con los brokers detectados, las operaciones, los dividendos, el rango de fechas y las divisas, y la tabla de ficheros](<https://declarenta.com/docs/images/screenshots/revisar.png>)

## Qué calcula

- Las casillas 0328, 0331, 1633, 1637, 0029, 0027 y 0588 del [Modelo 100](<https://declarenta.com/docs/casillas/index.md>), con FIFO estricto y el tipo del BCE de la fecha de cada operación.
- El fichero del [Modelo 720](<https://declarenta.com/docs/modelos-informativos/#modelo-720>) en el formato de la AEAT, validado contra la especificación del BOE. Con el fichero de tu último 720 (subido en la sección Modelo 720, o con `--previous-720` en la CLI) distingue además los tipos A, M y C.
- La revisión del [Modelo 721](<https://declarenta.com/docs/modelos-informativos/#modelo-721>) para criptomonedas y la guía del [Modelo D-6](<https://declarenta.com/docs/modelos-informativos/#modelo-d-6>).
- La [regla anti-churning](<https://declarenta.com/docs/casillas/#regla-anti-churning-art-335fg-lirpf>) de forma proporcional, la [doble imposición](<https://declarenta.com/docs/modelos-fiscales/#doble-imposicion-internacional>) por país y la [compensación de pérdidas](<https://declarenta.com/docs/modelos-fiscales/#compensacion-de-perdidas>) de cuatro años (solo en la CLI, con `--prior-losses`).
- Splits, fusiones, spin-offs y scrip dividends; acciones, ETFs, opciones, futuros, forex, bonos, CFDs y cripto. Ver [Modelos fiscales y motor fiscal](<https://declarenta.com/docs/modelos-fiscales/index.md>).
- Los 13 brokers de [Brokers soportados](<https://declarenta.com/docs/brokers/index.md>), en un solo FIFO cuando subes varios ficheros.

## Cómo funciona

```
flowchart LR
    F[Informes del broker<br/>.xml .csv .json .xlsx] --> P[Parsers]
    subgraph B [Tu navegador]
        P --> M[Motor FIFO<br/>anti-churning, divisas]
        M --> C[Casillas, 720, 721, D-6]
        C --> L[(localStorage<br/>perfil y resúmenes)]
    end
    E[API pública del BCE<br/>tipos de cambio] --> M
    C --> X[JSON, CSV, PDF, fichero 720]
```

- Es una web estática. Los ficheros se leen en el navegador y la única conexión de red es la [API del BCE](<https://declarenta.com/docs/privacidad/index.md>) para los tipos de cambio.
- La imagen `drumsergio/declarenta` sirve la misma web con nginx en el puerto 80 (`linux/amd64`). Ver [Docker](<https://declarenta.com/docs/getting-started/#docker>).
- La [CLI](<https://declarenta.com/docs/usage/#cli>) hace lo mismo desde el código fuente: `convert`, `modelo720` y `d6`, con salida JSON, CSV o PDF.
- La web es una PWA: funciona sin conexión tras la primera visita, salvo los tipos de cambio que aún no haya descargado.
- Interfaz en español, inglés, catalán, euskera y gallego, con tema claro y oscuro.

## Qué no hace

- No rellena Renta Web. La AEAT no importa estos datos por fichero: copias cada importe a mano, con la [guía de Renta Web](<https://declarenta.com/docs/usage/#guia-renta-web>).
- No sustituye a un asesor. Los importes son una ayuda de cálculo y los tienes que comprobar antes de presentarlos.
- No genera el XML oficial del Modelo 721; muestra una revisión orientativa. El D-6 es una guía, no un fichero.
- No lee todavía XTB ni MyInvestor, ni CFDs de criptomonedas. Ver [Desarrollo](<https://declarenta.com/docs/development/index.md>) si quieres ayudar.
- Con ficheros de un solo ejercicio, la pérdida diferida por anti-churning de años anteriores se sigue a mano. Ver [Regla anti-churning](<https://declarenta.com/docs/casillas/#regla-anti-churning-art-335fg-lirpf>).

## Privacidad

- Sin servidor: no hay nada que reciba tus ficheros. Todo el cálculo ocurre en tu navegador.
- Sin analítica, sin cookies de terceros y sin telemetría.
- La única petición a Internet va a `data-api.ecb.europa.eu` y pide tipos de cambio por año y divisa; no lleva ningún dato tuyo.
- El perfil fiscal y los resúmenes por año se guardan en el `localStorage` del navegador. El botón **Borrar mis datos de este navegador**, en el perfil fiscal, los borra. Ver [Privacidad](<https://declarenta.com/docs/privacidad/index.md>).
- El pie de la web muestra la versión y el commit desplegados, para cotejarlos con el [código fuente](<https://github.com/GeiserX/DeclaRenta>).

Detalle en [Privacidad](<https://declarenta.com/docs/privacidad/index.md>).

## Ayuda

- Si algo no cuadra, empieza por [Solución de problemas](<https://declarenta.com/docs/troubleshooting/index.md>) y las [Preguntas frecuentes](<https://declarenta.com/docs/faq/index.md>).
- Para auditar una cifra de divisa, activa la [traza del motor FX](<https://declarenta.com/docs/traza-fx/index.md>).
- Errores y propuestas: [GitHub Issues](<https://github.com/GeiserX/DeclaRenta/issues>). Novedades: el canal de Telegram [@declarenta](<https://t.me/declarenta>).
- Problemas de seguridad: la [política de seguridad](<https://github.com/GeiserX/DeclaRenta/blob/main/SECURITY.md>), sin abrir una incidencia pública.
- Para contribuir un parser o una regla fiscal: [Desarrollo](<https://declarenta.com/docs/development/index.md>).

## Licencia

DeclaRenta se publica bajo [AGPL-3.0-or-later](<https://github.com/GeiserX/DeclaRenta/blob/main/LICENSE>). Si ofreces una versión modificada como servicio en red, debes ofrecer su código fuente a sus usuarios.
