Gestor de Autónomos España

Skill para gestión contable y fiscal de trabajadores autónomos en España con cálculos matemáticamente precisos.

[!CAUTION] ADVERTENCIA: Esta skill es una herramienta de apoyo y no sustituye el asesoramiento profesional. Los cálculos y sugerencias generados deben ser revisados por un gestor o profesional cualificado. El uso de esta herramienta se realiza bajo la responsabilidad exclusiva del usuario. Mafia Claude Skills y sus contribuidores no se hacen responsables de errores en las declaraciones fiscales o sanciones derivadas de su uso.

Principios fundamentales

Precisión matemática obligatoria: SIEMPRE usar los scripts de Python para cualquier cálculo. NUNCA calcular mentalmente.
Base legal: Todas las operaciones siguen la normativa de la AEAT (Agencia Tributaria).
Verificación doble: Cada cálculo debe ser verificable y trazable.

Workflow principal

Paso 1: Identificar el tipo de operación

¿Qué necesita el usuario?

Calcular IVA trimestral → Ejecutar scripts/calcular_iva.py
Calcular IRPF trimestral → Ejecutar scripts/calcular_irpf.py
Procesar facturas/gastos → Ejecutar scripts/procesar_facturas.py
Generar libro contable → Ejecutar scripts/generar_libro.py
Procesar ingresos Stripe/Substack → Ejecutar scripts/procesar_stripe.py
Consulta normativa → Ver references/normativa_fiscal.md

Paso 2: Recopilar datos

Solicitar al usuario la información necesaria según la operación:

Para IVA trimestral:

Facturas emitidas (base imponible + IVA repercutido)
Facturas recibidas deducibles (base imponible + IVA soportado)
Trimestre (1T, 2T, 3T, 4T) y año

Para IRPF (Modelo 130):

Ingresos del trimestre (sin IVA)
Gastos deducibles del trimestre (sin IVA)
Retenciones practicadas por clientes
Pagos fraccionados anteriores del año

Para facturas:

Número de factura
Fecha
NIF/CIF del cliente/proveedor
Concepto
Base imponible
Tipo de IVA aplicable
Retención IRPF (si aplica)

Paso 3: Ejecutar cálculos con scripts

OBLIGATORIO usar scripts para todos los cálculos numéricos:

# Calcular IVA trimestral
python3 scripts/calcular_iva.py --iva-repercutido <cantidad> --iva-soportado <cantidad>

# Calcular IRPF modelo 130
python3 scripts/calcular_irpf.py --ingresos <cantidad> --gastos <cantidad> --retenciones <cantidad> --pagos-anteriores <cantidad>

# Procesar lista de facturas desde CSV
python3 scripts/procesar_facturas.py --archivo <ruta.csv> --tipo <emitidas|recibidas>

# Generar libro de ingresos y gastos
python3 scripts/generar_libro.py --trimestre <1-4> --año <YYYY> --facturas-emitidas <ruta> --facturas-recibidas <ruta>

Paso 4: Presentar resultados

Mostrar al usuario:

Desglose completo del cálculo
Resultado final con formato monetario (€)
Fecha límite de presentación si aplica
Advertencias o consideraciones relevantes

Tipos de IVA en España (2024-2025)

Tipo	Porcentaje	Aplicación
General	21%	Mayoría de bienes y servicios
Reducido	10%	Alimentos, transporte, hostelería
Superreducido	4%	Pan, leche, frutas, verduras, libros, prensa
Exento	0%	Sanidad, educación, seguros, servicios financieros

Retenciones IRPF en facturas

Situación	Retención
Profesionales (general)	15%
Nuevos autónomos (primeros 3 años)	7%
Cursos, conferencias	15%
Arrendamientos	19%

Plazos de presentación trimestral

Trimestre	Período	Plazo presentación
1T	Enero-Marzo	1-20 Abril
2T	Abril-Junio	1-20 Julio
3T	Julio-Septiembre	1-20 Octubre
4T	Octubre-Diciembre	1-30 Enero (año siguiente)

Gastos deducibles principales

Ver detalle completo en references/normativa_fiscal.md

Deducibles al 100%:

Cuota de autónomos
Gestoría y asesoría
Seguros de responsabilidad civil
Material de oficina
Hosting, dominios, software
Formación relacionada con actividad
Publicidad y marketing

Deducibles con límites:

Suministros (30% si trabajas desde casa)
Vehículo (50% máximo, según uso profesional)
Dietas y desplazamientos (con límites diarios)

Advertencias importantes

Nunca aproximar: Los cálculos fiscales deben ser exactos al céntimo.
Conservar justificantes: Obligatorio guardar facturas 4 años mínimo.
Verificar NIFs: Siempre validar que los NIFs/CIFs sean correctos.
Coherencia IVA: El IVA soportado solo es deducible si está vinculado a la actividad.

Integración con Stripe/Substack

⚠️ IMPORTANTE - Diferencia entre Modelo 303 y Modelo 130

Modelo 303 (IVA trimestral):

NO lleva base imponible en la presentación
Solo reporta:
- Casilla 03: Cuota IVA devengada (21% de clientes UE)
- Casilla 60: Exportaciones exentas (base imponible de no-UE)

Modelo 130 (IRPF trimestral):

SÍ lleva base imponible (suma de UE + no-UE)
Luego resta gastos deducibles (fees)
Resultado: rendimiento neto del trimestre

IMPORTANTE - Reglas fiscales aplicadas

1. El precio cobrado INCLUYE el IVA (Tax Inclusive)

El importe que cobras al cliente ya tiene el IVA dentro
Para extraer la base imponible: Base = Total / 1.21
NO multiplicar por 0.21 (eso sería añadir IVA encima)
Ejemplo: Si cobras 60€ → Base = 49,59€, IVA = 10,41€

2. La territorialidad se determina por PAÍS, no por moneda

Un cliente de Chile que paga en EUR → Exportación (sin IVA)
Un cliente de España que paga en USD → Lleva IVA
Prioridad: country (billing) > country (ip)

3. Pagos sin país identificado → Criterio conservador (UE)

Si no hay país, se trata como cliente UE (paga IVA)
Es más seguro fiscalmente aunque pagues algo más

4. Los fees (Substack + Stripe) son gastos deducibles

Se restan en el IRPF (Modelo 130)
NO afectan al IVA

Formatos soportados

CSV de Substack (formato nativo):

email,date,currency,amount,Substack fee,Stripe fee,...,country (ip),country (billing)
user@mail.com,02-Oct-25,eur,€60.00,€6.00,€1.15,...,ES,ES

CSV de Stripe Dashboard:

id,Amount,Currency,Created (UTC),country (billing),Status,...
pi_xxx,60.00,eur,2025-10-02,ES,succeeded,...

Uso del script

# Procesar CSV de Substack o Stripe:
python3 scripts/procesar_stripe.py --archivo pagos.csv --trimestre 4 --año 2025

# El script automáticamente:
# - Detecta formato (Substack o Stripe)
# - Parsea importes con símbolo (€60.00, CA$140.00)
# - Extrae base imponible dividiendo por 1.21 (no multiplicando)
# - Clasifica por PAÍS del cliente (no por moneda)
# - Calcula fees como gastos deducibles

Resultados generados

Para Modelo 303 (IVA):

Casilla 03: Cuota IVA a repercutir (21% de la base UE)
Casilla 60: Exportaciones exentas (clientes no-UE) - IMPORTANTE: se reporta como base, no como cuota

Para Modelo 130 (IRPF):

Base imponible: Suma de bases de clientes UE + no-UE
Gastos: Fees de Substack + Stripe (deducibles)
Rendimiento neto: Base imponible - Gastos

Países UE-27 (referencia)

AT, BE, BG, CY, CZ, DE, DK, EE, ES, FI, FR, GR, HR, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI, SK

⚠️ Reino Unido (GB/UK) NO está en la UE desde 2021 → Exento

Ejemplo práctico

Pago de 60€ desde España (ES):
  Base imponible: 60 / 1.21 = 49,59€
  IVA incluido:   60 - 49,59 = 10,41€

Pago de 60€ desde Chile (CL):
  Base imponible: 60€ (total, sin división)
  IVA: 0€ (exportación exenta)

Pago de 85€ sin país identificado:
  → Tratado como UE (conservador)
  Base imponible: 85 / 1.21 = 70,25€
  IVA incluido:   85 - 70,25 = 14,75€

Consultas normativas

Para preguntas sobre legislación, consultar references/normativa_fiscal.md que contiene:

Ley del IVA (Ley 37/1992)
Ley del IRPF (Ley 35/2006)
Reglamento de facturación
Criterios de la AEAT

gestor-autonomos