mcpField
G
gestor-autonomos

gestor-autonomos

github.com/alexdcdその他6436 回インストール15 週間前に更新
リポジトリ

gestor-autonomos について

スペインの自営業者向けに、会計・税務処理を支援するスキルです。Pythonスクリプトで四半期のIVAやIRPFを計算し、請求書やStripe・SubstackのCSVを扱いますが、結果は有資格の専門家による確認が必要です。

主な機能

  1. 01スクリプトによるIVA・IRPF計算
  2. 02請求書と経費の処理
  3. 03会計帳簿の生成
  4. 04Stripe・SubstackのCSV処理
  5. 05AEATに基づく税務ガイダンス

活用シーン

  1. 01四半期のIVA・IRPFの試算
  2. 02請求書と経費記録の処理
  3. 03Stripe・Substack収入の集計
  4. 04スペインの税務申告用データの準備

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/alexdcd/mafia-claude-skills --skill gestor-autonomos

インストール後、Claude Code で/gestor-autonomosを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
normativa_fiscal.md
scripts/
calcular_irpf.py
calcular_iva.py
generar_libro.py
procesar_facturas.py
procesar_stripe.py

詳細

スペインの自営業者管理

数学的に正確な計算に基づいて、スペインの自営業者の会計および税務を管理するスキルです。

注意

警告：このスキルは補助ツールであり、専門家による助言に代わるものではありません。生成された計算結果や提案は、税務管理者または資格を持つ専門家が確認する必要があります。このツールの使用は、ユーザー自身の責任で行ってください。Mafia Claude Skills およびその貢献者は、税務申告の誤りや使用に起因する罰則について責任を負いません。

基本原則

  1. 数学的な正確性が必須です：計算には必ず Python スクリプトを使用してください。暗算は絶対にしないでください。
  2. 法的根拠：すべての処理は AEAT（税務庁）の規定に従います。
  3. 二重確認：各計算は検証でき、追跡可能でなければなりません。

主なワークフロー

ステップ 1：処理の種類を特定する

ユーザーが必要としていることは何ですか？

  • 四半期ごとの IVA の計算 → scripts/calcular_iva.py を実行
  • 四半期ごとの IRPF の計算 → scripts/calcular_irpf.py を実行
  • 請求書／経費の処理 → scripts/procesar_facturas.py を実行
  • 会計帳簿の作成 → scripts/generar_libro.py を実行
  • Stripe／Substack の収入処理 → scripts/procesar_stripe.py を実行
  • 法規制についての問い合わせ → references/normativa_fiscal.md を参照
ステップ 2：データを収集する

処理の種類に応じて、必要な情報をユーザーに尋ねます。

四半期ごとの IVA の場合：

  • 発行した請求書（課税標準額＋請求 IVA）
  • 控除対象となる受領請求書（課税標準額＋支払 IVA）
  • 四半期（1T、2T、3T、4T）と年

IRPF（Modelo 130）の場合：

  • 四半期の収入（IVA を除く）
  • 四半期の控除対象経費（IVA を除く）
  • 顧客によって源泉徴収された金額
  • その年にすでに行った分割納付額

請求書の場合：

  • 請求書番号
  • 日付
  • 顧客／仕入先の NIF／CIF
  • 内容
  • 課税標準額
  • 適用される IVA 税率
  • IRPF の源泉徴収（該当する場合）
ステップ 3：スクリプトで計算を実行する

すべての数値計算でスクリプトを使用することが必須です。

# 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>
ステップ 4：結果を提示する

ユーザーに以下を提示します。

  1. 計算の詳細な内訳
  2. 通貨形式（€）での最終結果
  3. 該当する場合は申告期限
  4. 関連する警告や注意事項

スペインの IVA 税率（2024～2025 年）

種類税率適用対象
標準21%大半の商品およびサービス
軽減10%食品、輸送、宿泊・飲食
超軽減4%パン、牛乳、果物、野菜、書籍、新聞・雑誌
非課税0%医療、教育、保険、金融サービス

請求書における IRPF の源泉徴収

状況源泉徴収率
専門職（通常）15%
自営業を始めて間もない人（最初の 3 年間）7%
講座、講演15%
賃貸19%

四半期ごとの申告期限

四半期期間申告期限
1T1 月～3 月4 月 1 日～20 日
2T4 月～6 月7 月 1 日～20 日
3T7 月～9 月10 月 1 日～20 日
4T10 月～12 月1 月 1 日～30 日（翌年）

主な控除対象経費

詳細は references/normativa_fiscal.md を参照してください。

全額控除対象：

  • 自営業者の社会保険料
  • 税務管理および税務相談費用
  • 賠償責任保険
  • 事務用品
  • ホスティング、ドメイン、ソフトウェア
  • 事業に関連する研修
  • 広告およびマーケティング

上限付きの控除対象：

  • 光熱費など（自宅で仕事をする場合は 30%）
  • 車両（事業での使用状況に応じて最大 50%）
  • 食事代および交通費（1 日あたりの上限あり）

重要な警告

  1. 決して概算しないでください：税額計算は1セント単位まで正確に行う必要があります。
  2. 証憑を保管してください：請求書は最低4年間保管する必要があります。
  3. NIFを確認してください：NIF/CIFが正しいことを必ず確認してください。
  4. IVAの整合性：仕入IVAは、事業活動に関連している場合に限り控除できます。

Stripe/Substackとの連携

⚠️ 重要 - Modelo 303とModelo 130の違い

Modelo 303（四半期ごとのIVA申告）：

  • 申告時に課税標準額は記載しません
  • 以下のみを報告します：
    • Casilla 03：納付IVA額（EUの顧客に対する21%）
    • Casilla 60：免税輸出（EU域外の課税標準額）

Modelo 130（四半期ごとのIRPF申告）：

  • 課税標準額を記載します（EU＋EU域外の合計）
  • その後、控除対象経費（手数料）を差し引きます
  • 結果：当四半期の純利益
重要 - 適用される税務ルール

1. 請求価格にはIVAが含まれます（Tax Inclusive）

  • 顧客に請求する金額には、すでにIVAが含まれています
  • 課税標準額の算出：Base = Total / 1.21
  • 0.21を掛けないでください（それではIVAを上乗せすることになります）
  • 例：60€を請求する場合 → 課税標準額 = 49,59€、IVA = 10,41€

2. 課税地は通貨ではなく国によって決まります

  • EURで支払うチリの顧客 → 輸出（IVAなし）
  • USDで支払うスペインの顧客 → IVAの課税対象
  • 優先順位：country (billing) > country (ip)

3. 国を特定できない支払い → 保守的な基準（EU）

  • 国が不明な場合は、EUの顧客として扱います（IVAを支払います）
  • 多少多く支払うことになっても、税務上はより安全です

4. 手数料（Substack + Stripe）は控除対象経費です

  • IRPF（Modelo 130）で差し引きます
  • IVAには影響しません
対応形式

SubstackのCSV（ネイティブ形式）：

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

Stripe DashboardのCSV：

id,Amount,Currency,Created (UTC),country (billing),Status,...
pi_xxx,60.00,eur,2025-10-02,ES,succeeded,...
スクリプトの使用方法
# 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
生成される結果

Modelo 303（IVA）：

  • Casilla 03：徴収するIVA額（EUの課税標準額の21%）
  • Casilla 60：免税輸出（EU域外の顧客） - 重要：税額ではなく課税標準額として報告します

Modelo 130（IRPF）：

  • 課税標準額：EUおよびEU域外の顧客の課税標準額の合計
  • 経費：Substack + Stripeの手数料（控除対象）
  • 純利益：課税標準額 - 経費
EU-27加盟国（参考）

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

⚠️ 英国（GB/UK）は2021年以降EUに加盟していません → 免税

実践例
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€

法令に関する問い合わせ

法律について質問する場合は、以下を含むreferences/normativa_fiscal.mdを参照してください：

  • IVA法（Ley 37/1992）
  • IRPF法（Ley 35/2006）
  • 請求書発行規則
  • AEATの基準

コメント

Markdown 対応