Communitygithub.com

ASoudy/AGS – Autónomenverwaltung Spanien

Hilft spanischen Selbstständigen bei der Buchhaltung und Steuerverwaltung: Berechnung der vierteljährlichen Umsatzsteuer (Modell 303), der Einkommensteuervorauszahlungen (Modell 130), Verwaltung des Einnahmen- und Ausgabenbuchs, Prüfung von Rechnungen, Berechnung von Steuerabzügen, Vorbereitung von Quartalserklärungen sowie Verarbeitung von Stripe- und Substack-Zahlungen.

Was ist AGS – Autónomenverwaltung Spanien?

Diese Fähigkeit ist ein spezialisiertes Tool für spanische Selbstständige (Autónomos), das mathematisch präzise Steuer- und Buchhaltungsberechnungen auf Basis der geltenden spanischen Steuergesetzgebung (AEAT) ermöglicht. Sie unterstützt bei der Berechnung der vierteljährlichen Umsatzsteuererklärung (Modell 303), der Einkommensteuervorauszahlungen (Modell 130), der Verwaltung von Einnahmen- und Ausgabenbüchern sowie der Verarbeitung von Rechnungen. Ein besonderer Schwerpunkt liegt auf der Integration mit Stripe- und Substack-Zahlungen, bei der automatisch zwischen EU-Kunden (mit Umsatzsteuer) und Nicht-EU-Kunden (steuerfrei) unterschieden wird, Währungen in Euro umgerechnet werden und die Gebühren als abzugsfähige Ausgaben behandelt werden. Die Berechnungen werden ausschließlich über Python-Skripte durchgeführt, um mathematische Fehler auszuschließen, und die Ergebnisse enthalten eine vollständige Aufschlüsselung der Beträge sowie die jeweiligen Abgabefristen. Die Fähigkeit ist für den Einsatz in KI-Agenten wie Claude Code, Cursor oder Codex konzipiert, die auf spanische Steuer- und Buchhaltungsfragen spezialisiert sind. Es wird ausdrücklich darauf hingewiesen, dass die Ergebnisse nicht die professionelle Steuerberatung ersetzen und vor endgültigen Steuererklärungen von einem qualifizierten Steuerberater geprüft werden sollten.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Verwaltung für Selbstständige in Spanien

Skill für die Buchhaltungs- und Steuerverwaltung von Selbstständigen in Spanien mit mathematisch präzisen Berechnungen.

[!CAUTION] WARNUNG: Dieser Skill ist ein unterstützendes Werkzeug und ersetzt keine professionelle Beratung. Die generierten Berechnungen und Vorschläge müssen von einem Steuerberater oder qualifizierten Fachmann überprüft werden. Die Nutzung dieses Tools erfolgt in der alleinigen Verantwortung des Benutzers. Mafia Claude Skills und seine Mitwirkenden übernehmen keine Haftung für Fehler in Steuererklärungen oder daraus resultierende Sanktionen.

Grundlegende Prinzipien

  1. Zwingende mathematische Genauigkeit: IMMER die Python-Skripte für Berechnungen verwenden. NIE Kopfrechnen.
  2. Rechtliche Grundlage: Alle Vorgänge folgen den Vorschriften der AEAT (Steuerbehörde).
  3. Doppelte Überprüfung: Jede Berechnung muss nachvollziehbar und überprüfbar sein.

Hauptworkflow

Schritt 1: Art des Vorgangs identifizieren

Was benötigt der Benutzer?

  • Vierteljährliche Umsatzsteuer berechnen → scripts/calcular_iva.py ausführen
  • Vierteljährliche Einkommensteuer berechnen → scripts/calcular_irpf.py ausführen
  • Rechnungen/Ausgaben verarbeiten → scripts/procesar_facturas.py ausführen
  • Buchhaltungsbuch erstellen → scripts/generar_libro.py ausführen
  • Stripe/Substack-Einnahmen verarbeiten → scripts/procesar_stripe.py ausführen
  • Rechtsfragen klären → references/normativa_fiscal.md konsultieren

Schritt 2: Daten sammeln

Dem Benutzer die erforderlichen Informationen für den Vorgang anfordern:

Für die vierteljährliche Umsatzsteuer:

  • Ausgestellte Rechnungen (Steuerbemessungsgrundlage + vereinnahmte Umsatzsteuer)
  • Abzugsfähige erhaltene Rechnungen (Steuerbemessungsgrundlage + abzugsfähige Vorsteuer)
  • Quartal (1Q, 2Q, 3Q, 4Q) und Jahr

Für die Einkommensteuer (Modell 130):

  • Einnahmen des Quartals (ohne Umsatzsteuer)
  • Abzugsfähige Ausgaben des Quartals (ohne Umsatzsteuer)
  • Von Kunden einbehaltene Steuerabzüge
  • Frühere Vorauszahlungen des Jahres

Für Rechnungen:

  • Rechnungsnummer
  • Datum
  • Steuer-ID des Kunden/Lieferanten
  • Beschreibung
  • Steuerbemessungsgrundlage
  • Anwendbarer Umsatzsteuersatz
  • Einkommensteuerabzug (falls zutreffend)

Schritt 3: Berechnungen mit Skripten durchführen

VERPFLICHTEND Skripte für alle numerischen Berechnungen verwenden:

# Vierteljährliche Umsatzsteuer berechnen
python3 scripts/calcular_iva.py --iva-repercutido <Betrag> --iva-soportado <Betrag>

# Einkommensteuer Modell 130 berechnen
python3 scripts/calcular_irpf.py --ingresos <Betrag> --gastos <Betrag> --retenciones <Betrag> --pagos-anteriores <Betrag>

# Liste von Rechnungen aus CSV verarbeiten
python3 scripts/procesar_facturas.py --archivo <pfad.csv> --tipo <emitidas|recibidas>

# Einnahmen- und Ausgabenbuch erstellen
python3 scripts/generar_libro.py --trimestre <1-4> --año <YYYY> --facturas-emitidas <pfad> --facturas-recibidas <pfad>

Schritt 4: Ergebnisse präsentieren

Dem Benutzer anzeigen:

  1. Vollständige Aufschlüsselung der Berechnung
  2. Endergebnis im Geldformat (€)
  3. Abgabefrist, falls zutreffend
  4. Relevante Warnungen oder Hinweise

Umsatzsteuersätze in Spanien (2024-2025)

SatzProzentsatzAnwendung
Allgemein21%Die meisten Waren und Dienstleistungen
Ermäßigt10%Lebensmittel, Transport, Gastgewerbe
Stark ermäßigt4%Brot, Milch, Obst, Gemüse, Bücher, Presse
Steuerfrei0%Gesundheitswesen, Bildung, Versicherungen, Finanzdienstleistungen

Einkommensteuerabzüge auf Rechnungen

SituationAbzug
Freiberufler (allgemein)15%
Neue Selbstständige (erste 3 Jahre)7%
Kurse, Vorträge15%
Vermietungen19%

Fristen für vierteljährliche Einreichungen

QuartalZeitraumEinreichungsfrist
1QJanuar–März1.–20. April
2QApril–Juni1.–20. Juli
3QJuli–September1.–20. Oktober
4QOktober–Dezember1.–30. Januar (nächstes Jahr)

Wichtigste abzugsfähige Ausgaben

Vollständige Details in references/normativa_fiscal.md

100 % abzugsfähig:

  • Selbstständigenbeitrag (cuota de autónomos)
  • Buchhaltungs- und Beratungskosten
  • Berufshaftpflichtversicherung
  • Büromaterial
  • Hosting, Domains, Software
  • Fortbildung im Zusammenhang mit der Tätigkeit
  • Werbung und Marketing

Abzugsfähig mit Grenzen:

  • Betriebskosten (30 % bei Arbeit von zu Hause)
  • Fahrzeug (max. 50 %, je nach beruflicher Nutzung)
  • Verpflegung und Reisen (mit täglichen Höchstgrenzen)

Wichtige Hinweise

  1. Niemals runden: Steuerberechnungen müssen centgenau sein.
  2. Belege aufbewahren: Rechnungen mindestens 4 Jahre lang aufbewahren.
  3. Steuer-IDs prüfen: Immer die Gültigkeit der Steuer-IDs sicherstellen.
  4. Umsatzsteuer-Kohärenz: Vorsteuer ist nur abzugsfähig, wenn sie mit der Tätigkeit zusammenhängt.

Integration mit Stripe/Substack

⚠️ WICHTIG - Unterschied zwischen Modell 303 und Modell 130

Modell 303 (vierteljährliche Umsatzsteuer):

  • Enthält KEINE Steuerbemessungsgrundlage in der Meldung
  • Meldet nur:
    • Feld 03: Geschuldete Umsatzsteuer (21 % von EU-Kunden)
    • Feld 60: Steuerfreie Exporte (Steuerbemessungsgrundlage von Nicht-EU)

Modell 130 (vierteljährliche Einkommensteuer):

  • Enthält SEHR WOHL die Steuerbemessungsgrundlage (Summe EU + Nicht-EU)
  • Anschließend Abzug der abzugsfähigen Ausgaben (Gebühren)
  • Ergebnis: Nettoertrag des Quartals

WICHTIG - Angewandte Steuerregeln

1. Der vereinnahmte Preis ENTHÄLT die Umsatzsteuer (Tax Inclusive)

  • Der Betrag, den du dem Kunden berechnest, enthält bereits die Umsatzsteuer
  • Zur Ermittlung der Steuerbemessungsgrundlage: Grundlage = Gesamtbetrag / 1,21
  • NICHT mit 0,21 multiplizieren (das würde Umsatzsteuer hinzufügen)
  • Beispiel: Bei 60 € → Grundlage = 49,59 €, Umsatzsteuer = 10,41 €

2. Die Gebietszugehörigkeit wird durch das LAND bestimmt, nicht durch die Währung

  • Ein Kunde aus Chile, der in EUR zahlt → Export (ohne Umsatzsteuer)
  • Ein Kunde aus Spanien, der in USD zahlt → Enthält Umsatzsteuer
  • Priorität: country (billing) > country (ip)

3. Zahlungen ohne identifiziertes Land → Konservativer Ansatz (EU)

  • Wenn kein Land vorhanden ist, wird der Kunde als EU-Kunde behandelt (zahlt Umsatzsteuer)
  • Steuerlich sicherer, auch wenn etwas mehr gezahlt wird

4. Die Gebühren (Substack + Stripe) sind abzugsfähige Ausgaben

  • Sie werden bei der Einkommensteuer (Modell 130) abgezogen
  • Sie haben KEINE Auswirkung auf die Umsatzsteuer

Unterstützte Formate

CSV von Substack (natives Format):

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 vom Stripe Dashboard:

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

Verwendung des Skripts

# CSV von Substack oder Stripe verarbeiten:
python3 scripts/procesar_stripe.py --archivo payments.csv --trimestre 4 --año 2025

# Das Skript macht automatisch:
# - Format erkennen (Substack oder Stripe)
## - Beträge mit Symbol parsen (€60.00, CA$140.00)
# - Steuerbemessungsgrundlage durch Division durch 1,21 (nicht Multiplikation) extrahieren
# - Nach LAND des Kunden klassifizieren (nicht nach Währung)
# - Gebühren als abzugsfähige Ausgaben berechnen

Generierte Ergebnisse

Für Modell 303 (Umsatzsteuer):

  • Feld 03: Geschuldete Umsatzsteuer (21 % der EU-Grundlage)
  • Feld 60: Steuerfreie Exporte (Nicht-EU-Kunden) – WICHTIG: wird als Grundlage gemeldet, nicht als Betrag

Für Modell 130 (Einkommensteuer):

  • Steuerbemessungsgrundlage: Summe der Grundlagen von EU + Nicht-EU-Kunden
  • Ausgaben: Gebühren von Substack + Stripe (abzugsfähig)
  • Nettoertrag: Steuerbemessungsgrundlage - Ausgaben

EU-27-Länder (Referenz)

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

⚠️ Vereinigtes Königreich (GB/UK) ist seit 2021 NICHT mehr in der EU → steuerfrei

Praxisbeispiel

Zahlung von 60 € aus Spanien (ES):
  Steuerbemessungsgrundlage: 60 / 1,21 = 49,59 €
  Enthaltene Umsatzsteuer:   60 - 49,59 = 10,41 €

Zahlung von 60 € aus Chile (CL):
  Steuerbemessungsgrundlage: 60 € (Gesamtbetrag, ohne Division)
  Umsatzsteuer: 0 € (steuerfreier Export)

Zahlung von 85 € ohne identifiziertes Land:
  → Als EU behandelt (konservativ)
  Steuerbemessungsgrundlage: 85 / 1,21 = 70,25 €
  Enthaltene Umsatzsteuer:   85 - 70,25 = 14,75 €

Rechtsfragen

Bei Fragen zur Gesetzgebung references/normativa_fiscal.md konsultieren, das Folgendes enthält:

  • Umsatzsteuergesetz (Gesetz 37/1992)
  • Einkommensteuergesetz (Gesetz 35/2006)
  • Rechnungsstellungsverordnung
  • Kriterien der 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.

Verwandte Skills