Skip to content

antonioibars/irpf-declaration-helper

Repository files navigation

Declaración IRPF con Rentas Extranjeras

License: AGPL v3 Python 3.10+

Claude Skill + scripts para preparar tu declaración de IRPF (Modelo 100) cuando tienes ingresos de España y de uno o más países extranjeros.

Resuelve los problemas típicos: dos pagadores, doble imposición internacional, cotizaciones sociales extranjeras, Ley Beckham, Art. 7.p, tramos autonómicos.

Instalación

git clone https://github.com/TUSUARIO/declaracion-irpf-rentas-extranjeras.git
cd declaracion-irpf-rentas-extranjeras
pip install -r requirements.txt
bash .claude/skills/declaracion-irpf-rentas-extranjeras/scripts/setup_hacienda_cli.sh

Uso

Con Claude Code, abre una conversación en la carpeta del proyecto y di algo como:

"Soy español, volví de Alemania en mayo. Quiero hacer mi declaración"

El skill se activa y te guía paso a paso. Ver docs/GUIA-RAPIDA.md para más detalle.

Sin Claude, puedes usar los scripts directamente: ver docs/FLUJO-COMPLETO.md.

Estructura

.
├── .claude/skills/     # Claude Skill con workflow de 7 fases
├── data/               # XSDs oficiales AEAT + carpetas input/output (gitignored)
├── examples/           # JSONs de ejemplo (casos anonimizados)
├── docs/               # Documentación detallada
└── herramientas/       # hacienda-cli (gitignored, se instala via setup)

Qué NO hace

  • No presenta la declaración (la firmas tú manualmente con Cl@ve)
  • No es asesoramiento fiscal profesional
  • No soporta: País Vasco / Navarra (régimen foral) ni Modelo 151 (Ley Beckham activa)

Licencia

AGPL-3.0-or-later. Uso personal libre. Si haces fork o montas un servicio, debes compartir el código. Ver NOTICE para dependencias y CONTRIBUTING.md para contribuir.

Descargo

Asistente, no asesor fiscal. Responsabilidad del usuario sobre los datos declarados. Las sanciones por omitir rentas o aplicar mal exenciones pueden ser significativas. Ante dudas, consulta un asesor cualificado.

About

Claude Skill + scripts to help Spanish tax residents prepare their IRPF (Modelo 100) declaration. Handles foreign income, double taxation, and AEAT XML generation.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors