Gestionnaire d'Autónomos Espagne
Skill pour la gestion comptable et fiscale des travailleurs indépendants en Espagne avec des calculs mathématiquement précis.
[!CAUTION] AVERTISSEMENT : Cette skill est un outil d'aide et ne remplace pas un conseil professionnel. Les calculs et suggestions générés doivent être vérifiés par un gestionnaire ou un professionnel qualifié. L'utilisation de cet outil se fait sous la seule responsabilité de l'utilisateur. Mafia Claude Skills et ses contributeurs déclinent toute responsabilité en cas d'erreurs dans les déclarations fiscales ou de sanctions en découlant.
Principes fondamentaux
- Précision mathématique obligatoire : Utiliser TOUJOURS les scripts Python pour tout calcul. Ne JAMAIS calculer mentalement.
- Base légale : Toutes les opérations suivent la réglementation de l'AEAT (Agence Tributaire Espagnole).
- Double vérification : Chaque calcul doit être vérifiable et traçable.
Workflow principal
Étape 1 : Identifier le type d'opération
De quoi l'utilisateur a-t-il besoin ?
- Calculer la TVA trimestrielle → Exécuter
scripts/calcular_iva.py - Calculer l'IRPF trimestriel → Exécuter
scripts/calcular_irpf.py - Traiter les factures/dépenses → Exécuter
scripts/procesar_facturas.py - Générer le livre comptable → Exécuter
scripts/generar_libro.py - Traiter les revenus Stripe/Substack → Exécuter
scripts/procesar_stripe.py - Consultation réglementaire → Voir
references/normativa_fiscal.md
Étape 2 : Collecter les données
Demander à l'utilisateur les informations nécessaires selon l'opération :
Pour la TVA trimestrielle :
- Factures émises (base imposable + TVA collectée)
- Factures reçues déductibles (base imposable + TVA déductible)
- Trimestre (1T, 2T, 3T, 4T) et année
Pour l'IRPF (Modèle 130) :
- Revenus du trimestre (hors TVA)
- Dépenses déductibles du trimestre (hors TVA)
- Retenues effectuées par les clients
- Acomptes précédents de l'année
Pour les factures :
- Numéro de facture
- Date
- NIF/CIF du client/fournisseur
- Concept
- Base imposable
- Type de TVA applicable
- Retenue IRPF (si applicable)
Étape 3 : Exécuter les calculs avec les scripts
OBLIGATOIRE d'utiliser les scripts pour tous les calculs numériques :
# Calculer la TVA trimestrielle
python3 scripts/calcular_iva.py --iva-repercutido <montant> --iva-soportado <montant>
# Calculer l'IRPF modèle 130
python3 scripts/calcular_irpf.py --ingresos <montant> --gastos <montant> --retenciones <montant> --pagos-anteriores <montant>
# Traiter une liste de factures depuis un CSV
python3 scripts/procesar_facturas.py --archivo <chemin.csv> --tipo <emitidas|recibidas>
# Générer le livre des recettes et dépenses
python3 scripts/generar_libro.py --trimestre <1-4> --año <YYYY> --facturas-emitidas <chemin> --facturas-recibidas <chemin>
Étape 4 : Présenter les résultats
Afficher à l'utilisateur :
- Détail complet du calcul
- Résultat final au format monétaire (€)
- Date limite de dépôt si applicable
- Avertissements ou considérations pertinentes
Types de TVA en Espagne (2024-2025)
| Type | Pourcentage | Application |
|---|---|---|
| Général | 21% | Majorité des biens et services |
| Réduit | 10% | Aliments, transport, hôtellerie |
| Super-réduit | 4% | Pain, lait, fruits, légumes, livres, presse |
| Exonéré | 0% | Santé, éducation, assurances, services financiers |
Retenues IRPF sur les factures
| Situation | Retenue |
|---|---|
| Professionnels (général) | 15% |
| Nouveaux indépendants (3 premières années) | 7% |
| Cours, conférences | 15% |
| Locations | 19% |
Délais de dépôt trimestriels
| Trimestre | Période | Délai de dépôt |
|---|---|---|
| 1T | Janvier-Mars | 1-20 Avril |
| 2T | Avril-Juin | 1-20 Juillet |
| 3T | Juillet-Septembre | 1-20 Octobre |
| 4T | Octobre-Décembre | 1-30 Janvier (année suivante) |
Principales dépenses déductibles
Voir le détail complet dans references/normativa_fiscal.md
Déductibles à 100% :
- Cotisation des indépendants (cuota de autónomos)
- Frais de gestion et de conseil
- Assurances responsabilité civile
- Fournitures de bureau
- Hébergement, domaines, logiciels
- Formation liée à l'activité
- Publicité et marketing
Déductibles avec limites :
- Fournitures (30% si vous travaillez depuis chez vous)
- Véhicule (50% maximum, selon usage professionnel)
- Frais de déplacement (avec limites journalières)
Avertissements importants
- Ne jamais approximer : Les calculs fiscaux doivent être exacts au centime près.
- Conserver les justificatifs : Obligation de garder les factures 4 ans minimum.
- Vérifier les NIF : Toujours valider que les NIFs/CIFs sont corrects.
- Cohérence de la TVA : La TVA déductible ne l'est que si elle est liée à l'activité.
Intégration avec Stripe/Substack
⚠️ IMPORTANT - Différence entre Modèle 303 et Modèle 130
Modèle 303 (TVA trimestrielle) :
- NE comporte PAS de base imposable dans la déclaration
- Ne reporte que :
- Case 03 : Quota de TVA collectée (21% des clients UE)
- Case 60 : Exportations exonérées (base imposable des non-UE)
Modèle 130 (IRPF trimestriel) :
- COMPORTE une base imposable (somme UE + non-UE)
- Puis soustrait les dépenses déductibles (frais)
- Résultat : rendement net du trimestre
IMPORTANT - Règles fiscales appliquées
1. Le prix facturé INCLUT la TVA (Tax Inclusive)
- Le montant facturé au client contient déjà la TVA
- Pour extraire la base imposable :
Base = Total / 1.21 - NE PAS multiplier par 0.21 (cela ajouterait la TVA par-dessus)
- Exemple : Si vous facturez 60€ → Base = 49,59€, TVA = 10,41€
2. La territorialité est déterminée par le PAYS, pas par la devise
- Un client du Chili qui paie en EUR → Exportation (sans TVA)
- Un client d'Espagne qui paie en USD → Avec TVA
- Priorité :
country (billing)>country (ip)
3. Paiements sans pays identifié → Critère conservateur (UE)
- Si aucun pays, traiter comme client UE (paiement avec TVA)
- C'est plus sûr fiscalement même si vous payez un peu plus
4. Les frais (commissions Substack + Stripe) sont des dépenses déductibles
- Ils se déduisent dans l'IRPF (Modèle 130)
- N'affectent pas la TVA
Formats supportés
CSV de Substack (format natif) :
email,date,currency,amount,Substack fee,Stripe fee,...,country (ip),country (billing)
[email protected],02-Oct-25,eur,€60.00,€6.00,€1.15,...,ES,ES
CSV du Dashboard Stripe :
id,Amount,Currency,Created (UTC),country (billing),Status,...
pi_xxx,60.00,eur,2025-10-02,ES,succeeded,...
Utilisation du script
# Traiter un CSV de Substack ou Stripe :
python3 scripts/procesar_stripe.py --archivo pagos.csv --trimestre 4 --año 2025
# Le script automatiquement :
# - Détecte le format (Substack ou Stripe)
# - Parse les montants avec symbole (€60.00, CA$140.00)
# - Extrait la base imposable en divisant par 1.21 (ne multiplie pas)
# - Classe par PAYS du client (pas par devise)
# - Calcule les frais comme dépenses déductibles
Résultats générés
Pour le Modèle 303 (TVA) :
- Case 03 : Quota de TVA à collecter (21% de la base UE)
- Case 60 : Exportations exonérées (clients non-UE) - IMPORTANT : déclaré comme base, pas comme quota
Pour le Modèle 130 (IRPF) :
- Base imposable : Somme des bases clients UE + non-UE
- Dépenses : Frais Substack + Stripe (déductibles)
- Rendement net : Base imposable - Dépenses
Pays UE-27 (référence)
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
⚠️ Royaume-Uni (GB/UK) n'est PAS dans l'UE depuis 2021 → Exonéré
Exemple pratique
Paiement de 60€ depuis l'Espagne (ES) :
Base imposable : 60 / 1.21 = 49,59€
TVA incluse : 60 - 49,59 = 10,41€
Paiement de 60€ depuis le Chili (CL) :
Base imposable : 60€ (total, sans division)
TVA : 0€ (exportation exonérée)
Paiement de 85€ sans pays identifié :
→ Traité comme UE (conservateur)
Base imposable : 85 / 1.21 = 70,25€
TVA incluse : 85 - 70,25 = 14,75€
Consultations réglementaires
Pour les questions sur la législation, consulter references/normativa_fiscal.md qui contient :
- Loi sur la TVA (Loi 37/1992)
- Loi sur l'IRPF (Loi 35/2006)
- Règlement sur la facturation
- Critères de l'AEAT