qonto-tax-pilot

Qonto 税务助手

预判税务支出，让资金远离风险。本技能以读取为主，只执行一项安全写入：技能负责计算和准备；只有用户在 Qonto 应用中通过 SCA 审批后，资金才会转移。

前提条件

1. get_organization → 账户、余额、税务身份信息（legal_form、country）。识别税务子账户（名称包含 "taxe"/"tax"/"impôt"/"TVA"）。如果没有：仅展示计算结果，并说明如何在应用中创建税务子账户（手动操作，一次性设置）。
2. 按国家适配：法国提供完整税务日历。对于其他 Qonto 国家（DE、ES、IT、AT、NL、BE、PT……），请明确说明，并将功能限制为在所有国家都适用的内容：现金流预测、周期性收支检测、根据历史记录进行通用增值税预留——绝不编造外国税务截止日期。
3. 日历假设公司适用 IS（法国企业所得税）；如不适用，请调整表述。

工作流

1. 了解历史情况（24–36 个月）

按账户调用 list_transactions，使用 per_page: "50"，按 3 个月为窗口分页查询。只要历史记录足够，至少覆盖前两个财年：只有跨越完整年度，才能看出税务缴纳周期（季度 IS 预缴款、12 月 CFE、增值税缴纳节奏），而且同比比较有助于预测。

• 周期性收支：对手方名称标准化、金额稳定（±10 %）、按月／季度／年度发生，至少出现 3 次（年度收支至少出现 2 次）。
• 税务历史记录——先查找出账直接扣款：法国税费（增值税、IS 预缴款、CFE）通过 SEPA 直接扣款征收，因此应先缩小范围，只扫描出账直接扣款，再按名称匹配（如果连接器提供 operation_type: direct_debit 筛选器，就使用该筛选器；否则按每笔交易的 operation_type 字段筛选）——与扫描所有借记交易相比，干扰信息会少得多。然后匹配对手方的所有写法：同一税务机关可能显示为 DGFIP、DIRECTION GENERALE DES FINANCES PUBLIQUES（全大写）和 Direction Générale des Finances Publiques（大小写混合）——统一大小写并去除重音符号，将它们合并为同一个对手方。添加带有税务标记的交易 → 按税种、按年度记录金额和周期。
• 增值税制度和申报频率——通过检测判断，不要询问：每月向 DGFIP 扣款 → 每月申报 CA3（réel normal）；每季度扣款 → 每季度申报 CA3（年增值税低于 €4,000 时允许）；7 月 + 12 月预缴款 → réel simplifié（CA12）。⚠️ 简化制度（CA12 + 预缴款）将于 2027-01-01 废止（《2025 年财政法》第 38 条）：自 2027 年起，改为按季度申报 CA3（营业额 ≤ €1M）或按月申报 CA3——提醒仍适用 CA12 的用户注意制度变更。此外，还要读取客户发票上的 vat_payment_condition：on_receipts 表示增值税按客户付款计算，而非按已开具发票计算——使用现金收款额计算已收取的增值税。

2. 税务参考日历（公司适用 IS；根据财年结账日调整）

截止日期	税种	金额估算
每月或每季度约 15 日–24 日（réel normal；年增值税低于 €4,000 时可按季度申报）	增值税 CA3	近期增值税付款的中位数；结合已收增值税减去可抵扣增值税进行调整
7 月缴纳 55 % + 12 月缴纳 40 %；CA12 于 5 月初申报（réel simplifié——将于 2027-01-01 废止，请规划切换至 CA3）	增值税预缴款	上一份 CA12／历史上 7 月 + 12 月的付款记录
15/03 · 15/06 · 15/09 · 15/12	IS 预缴款（2571）	过去的预缴款；否则按上一年度 IS ÷ 4 估算；上一年度 IS < 3 000 € 时，无需缴纳预缴款
结账日为 31/12 时，于 15/05 截止	IS 应缴尾款（2572）	估算的上一年度 IS − 已缴预缴款
15/06（若 ≥ 3 000 €）+ 15/12	CFE	上一年度的付款金额
分红后次月 15 日	股息——先询问股东是谁	个人股东 → PFU 30 %（表格 2777），预留相应金额。适用母子公司制度的控股公司（CGI 第 145/216 条，持股比例 ≥ 5 %）→ 完全不缴 PFU，95 % 免税——只有 5 % 需要加回并在控股公司层面纳税，此处几乎无需预留。绝不能自行假设：先询问（提示：向企业对手方转出的过往股息可能表明对方是控股公司）。仅在计划分红时适用

每一项都应带有置信度标签：🟢 历史记录中已发现／🟡 估算／🔵 有条件适用。

3. 项目未来 90 天

按账户逐日展示：余额 + 典型日期的周期性资金流 + 有明确日期的项目（list_client_invoices 中的未付款项按到期日并根据客户历史延迟调整；list_supplier_invoices 中的计划付款）+ 税款时间表 + 非经常性基线。输出余额低点（日期 + 金额）、跌破阈值的情况（默认 0 / 2 000 €）、期末余额。按需进行假设分析（客户延迟 +N 天、一次性采购、新增周期性成本）。

4. 计算本月预留金额

• 已收 VAT：若为 on_receipts，则按本月的现金收款计算（将收款与发票匹配；使用发票的 vat_amount）；否则按已开具的发票计算。
• 可抵扣 VAT：将本月借记交易的 vat_amount 相加（说明其中有多少项为 null → 估算值是下限），或使用供应商发票的 total_tax_amount。
• 净 VAT = 已收 − 可抵扣，最低为 0。另加历史数据中的 IS/12 和 CFE/12。
• 显示带置信度标签的明细表。

5. 执行 — 仅在获得明确同意后

比较税款储备账户余额与累计目标金额。若金额不足，且用户明确确认，调用 create_multi_transfer_request：debit_iban = 主账户；转账需提供 credit_iban、credit_account_name、credit_account_currency（省略时会返回 422）、amount、currency、reference（"PROVISION IMPOTS YYYY-MM"）。将完整计算过程写入请求的 note — 审批人会在审批时看到（无法通过 MCP 设置交易备注）。 然后告知用户：待处理请求现已显示在推送通知和 Qonto 应用的 Requests 部分；在用户使用自己的 2FA 批准之前，不会有任何资金转移。 这是安全机制，并非限制。转入税款子账户的内部转账会自动归类为“Impôts et taxes”，无需收据。

6. 报告 — 输出格式

始终在对话中以 Markdown 表格回复：

1. 税款时间表（日期 · 税种 · 金额 · 依据 · 置信度），根据储备账户余额，将每个截止日期标记为 ✅ 已覆盖 / ⚠️ 尚缺 X €。
2. 90 天预测（周 × 账户），突出显示余额低点。
3. 储备账户状态 + 本月预留金额明细。
4. 按严重程度排列的文字提醒。

此外，在宿主环境支持渲染文件时（claude.ai artifacts、Claude Desktop、Claude Code）：生成交互式 HTML 仪表板 — 每个账户一条曲线、不确定性区间、以标记显示的税款截止日期、储备账户仪表，并交给用户。若宿主环境无法渲染文件，则无需说明：Markdown 表格即为交付内容。第三项输出是请求备注（完整计算过程），审批人会在 Qonto 应用的 SCA 审批时看到。

安全规则

• 绝不在当前对话中未经用户明确确认就创建转账请求；绝不将其描述为已执行 — 请求仍待用户完成 SCA 审批。
• 预测和税款金额均为估算值，并非申报数据；建议由会计师核验。若历史数据不足 6 个月，应如实降低预测可靠性。
• 演练后调用 decline_request（request_type: "multi_transfers"，注意使用复数）。
• 对 IBAN 脱敏（仅显示末尾 4 位）。所有内容均需分页（per_page ≤ 50）。