gestor-autonomos

西班牙个体经营者管理

用于西班牙个体经营者会计和税务管理的技能，计算结果具有数学精度。

注意

警告：此技能仅为辅助工具，不能替代专业建议。生成的计算结果和建议必须由管理人员或具备资质的专业人士审核。使用此工具的全部责任由用户自行承担。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%

季度申报期限

季度	期间	申报期限
1T	1 月至 3 月	4 月 1 日至 20 日
2T	4 月至 6 月	7 月 1 日至 20 日
3T	7 月至 9 月	10 月 1 日至 20 日
4T	10 月至 12 月	1 月 1 日至 30 日（次年）

主要可抵扣支出

完整详情请参见 references/normativa_fiscal.md

可全额抵扣：

• 个体经营者社保缴费
• 会计和税务咨询服务
• 民事责任保险
• 办公用品
• 主机托管、域名、软件
• 与经营活动相关的培训
• 广告和营销

限额抵扣：

• 水电等公共事业费用（在家办公时可抵扣 30%）
• 车辆（最高 50%，视业务用途而定）
• 餐费和差旅费（有每日限额）

重要警告

1. 切勿估算：税务计算必须精确到分。
2. 保留凭证：必须至少保存发票 4 年。
3. 核实 NIF：务必验证 NIF/CIF 是否正确。
4. 增值税一致性：只有与经营活动相关的进项增值税才可抵扣。

与 Stripe/Substack 集成

⚠️ 重要 — Modelo 303 与 Modelo 130 的区别

Modelo 303（季度增值税）：

• 申报时不填写应税基数
• 仅申报：
  • 第 03 栏：应计增值税额（来自欧盟客户的 21%）
  • 第 60 栏：免税出口（非欧盟客户的应税基数）

Modelo 130（季度个人所得税）：

• 需要填写应税基数（欧盟 + 非欧盟客户的总和）
• 随后扣除可抵扣费用（手续费）
• 结果：本季度净收益

重要 — 适用的税务规则

1. 收取的价格已包含增值税（Tax Inclusive）

• 向客户收取的金额已包含增值税
• 提取应税基数：Base = Total / 1.21
• 不要乘以 0.21（那样会在原金额上额外加收增值税）
• 示例：如果收取 60€ → 应税基数 = 49,59€，增值税 = 10,41€

2. 属地性根据国家而非货币确定

• 来自智利的客户以 EUR 付款 → 出口（不含增值税）
• 来自西班牙的客户以 USD 付款 → 需缴纳增值税
• 优先级：country (billing) > country (ip)

3. 未识别国家的付款 → 保守处理（欧盟）

• 如果没有国家信息，则按欧盟客户处理（需缴纳增值税）
• 从税务角度看更安全，即使需要多缴一些税

4. 手续费（Substack + Stripe）属于可抵扣费用

• 在个人所得税（Modelo 130）中扣除
• 不影响增值税

支持的格式

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（增值税）：

• 第 03 栏：应计增值税额（欧盟应税基数的 21%）
• 第 60 栏：免税出口（非欧盟客户）——重要：此处申报的是应税基数，而非税额

Modelo 130（个人所得税）：

• 应税基数：欧盟 + 非欧盟客户应税基数之和
• 费用：Substack + Stripe 手续费（可抵扣）
• 净收益：应税基数 - 费用

欧盟 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 年起不属于欧盟 → 免税

实例

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，其中包含：

• 增值税法（第 37/1992 号法律）
• 个人所得税法（第 35/2006 号法律）
• 开票条例
• AEAT 标准