Communitygithub.com

ASoudy/AGS

Gestion comptable et fiscale pour les travailleurs indépendants en Espagne : calcul de la TVA trimestrielle (modèle 303), des acomptes d'IRPF (modèle 130), gestion du livre de recettes et dépenses, traitement des revenus Stripe/Substack et conformité fiscale.

Qu'est-ce que AGS ?

Cette skill est conçue pour assister les développeurs et les agents IA dans la gestion comptable et fiscale des travailleurs indépendants (autónomos) en Espagne. Elle automatise les calculs précis de la TVA trimestrielle (modèle 303), de l'IRPF (modèle 130), la gestion des factures, et le traitement des revenus provenant de plateformes comme Stripe et Substack. La skill applique les réglementations fiscales espagnoles en vigueur et garantit l'exactitude mathématique en exécutant des scripts Python dédiés pour tous les calculs numériques. Elle prend en charge la classification des paiements par pays (UE avec TVA vs. exportations hors UE exonérées), la conversion en euros, et la génération de rapports pour les déclarations trimestrielles. Idéale pour les freelances, les indépendants et les petites entreprises opérant en Espagne, elle simplifie les tâches de gestion fiscale courantes tout en rappelant qu'elle reste un outil d'aide et non un substitut à un conseil professionnel.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/claude_skills_libraries/landing-page-mastery/skills/gestor-autonomos

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

  1. Précision mathématique obligatoire : Utiliser TOUJOURS les scripts Python pour tout calcul. Ne JAMAIS calculer mentalement.
  2. Base légale : Toutes les opérations suivent la réglementation de l'AEAT (Agence Tributaire Espagnole).
  3. 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 :

  1. Détail complet du calcul
  2. Résultat final au format monétaire (€)
  3. Date limite de dépôt si applicable
  4. Avertissements ou considérations pertinentes

Types de TVA en Espagne (2024-2025)

TypePourcentageApplication
Général21%Majorité des biens et services
Réduit10%Aliments, transport, hôtellerie
Super-réduit4%Pain, lait, fruits, légumes, livres, presse
Exonéré0%Santé, éducation, assurances, services financiers

Retenues IRPF sur les factures

SituationRetenue
Professionnels (général)15%
Nouveaux indépendants (3 premières années)7%
Cours, conférences15%
Locations19%

Délais de dépôt trimestriels

TrimestrePériodeDélai de dépôt
1TJanvier-Mars1-20 Avril
2TAvril-Juin1-20 Juillet
3TJuillet-Septembre1-20 Octobre
4TOctobre-Décembre1-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

  1. Ne jamais approximer : Les calculs fiscaux doivent être exacts au centime près.
  2. Conserver les justificatifs : Obligation de garder les factures 4 ans minimum.
  3. Vérifier les NIF : Toujours valider que les NIFs/CIFs sont corrects.
  4. 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

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Skills associés