qonto-tax-pilot

Qonto Tax Pilot

税務当局の動きを予測し、資金を安全な場所に移します。読み取り中心で、書き込みは安全な操作を1つだけ行います。このスキルが計算と準備を行い、資金を動かすのはQontoアプリでユーザーがSCA承認した場合のみです。

前提条件

1. get_organization → 口座、残高、税務上の情報（法的形態、国）を取得します。税金用サブ口座を特定します（名前に「taxe」「tax」「impôt」「TVA」が含まれる口座）。見つからない場合は、計算結果のみを表示し、アプリでの作成方法（手動、初回のみ）を説明します。
2. 国に応じて対応します。フランスの税務カレンダー全体に対応します。その他のQonto対応国（DE、ES、IT、AT、NL、BE、PTなど）については、その旨を明記し、どの国でも有効な内容に絞ります。つまり、現金予測、定期的な資金フローの検出、履歴に基づく一般的なVAT積立のみとし、他国の納税期限を決して作り上げません。
3. 税務カレンダーはIS（フランスの法人税）が課される会社を前提とします。それ以外の場合は文言を調整してください。

ワークフロー

1. 過去の状況を把握する（24～36か月）

口座ごとにlist_transactionsを使用し、3か月単位でper_page: "50"を指定してページネーションします。履歴がある場合は少なくとも過去2会計年度分を対象にします。税金の支払い周期（ISの四半期予定納税、12月のCFE、VATの周期）は年間を通したデータがないと確認できず、前年比較も予測に役立ちます。

• 定期的な資金フロー：正規化した取引相手、金額が安定（±10％）、月次／四半期／年次の周期、3回以上の記録（年次は2回）。
• 税務履歴 — まず口座振替による出金を検索：フランスの税金（VAT、ISの予定納税、CFE）はSEPA口座振替で徴収されるため、名称で照合する前に出金された口座振替に絞ります（コネクターが対応している場合はoperation_type: direct_debitフィルターを使用し、対応していない場合は各取引のoperation_typeフィールドで絞り込みます）。すべての出金を調べるよりノイズが大幅に減ります。その後、すべての表記で取引相手を照合します。同じ税務署がDGFIP、DIRECTION GENERALE DES FINANCES PUBLIQUES（大文字）、Direction Générale des Finances Publiques（大文字と小文字の混在）と表示されることがあります。大文字と小文字、アクセントを正規化し、1つの取引相手として統合します。税金と分かる取引も追加し、税目ごと、年ごとの金額と周期を記録します。
• VAT制度と申告頻度 — 質問せずに検出：DGFIPへの支払いが月次なら月次CA3（réel normal）、四半期ごとなら四半期CA3（年間VATが4,000ユーロ未満の場合に可能）、7月と12月の予定納税ならréel simplifié（CA12）です。⚠️ 簡易課税制度（CA12と予定納税）は2027-01-01に廃止されます（2025年財政法第38条）。2027年以降は、四半期CA3（売上高が100万ユーロ以下）または月次CA3となるため、現在CA12を利用しているユーザーには切り替えについて警告してください。また、顧客の請求書のvat_payment_conditionも確認します。on_receiptsは、VATが発行済み請求書ではなく、顧客からの入金に基づくことを意味します。徴収済みVATの計算には現金収入を使用します。

2. 税務基準カレンダー（IS適用企業。会計年度末に応じて調整）

期限	税金	金額の見積もり
毎月または四半期ごとの15～24日頃（réel normal。年間VATが4,000ユーロ未満の場合は四半期ごと）	VAT CA3	直近のVAT支払いの中央値。徴収済みVATと控除可能VATの差額で精度を高めます
7月に55％＋12月に40％、CA12は5月初旬（réel simplifié — 2027-01-01に廃止。CA3への切り替えを計画）	VATの予定納税	前回のCA12、または過去の7月・12月の支払い
15/03 · 15/06 · 15/09 · 15/12	ISの予定納税（2571）	過去の予定納税額。それ以外の場合はIS N-1 ÷ 4。IS N-1が3,000ユーロ未満の場合、予定納税はありません
12/31決算の場合は15/05	ISの確定納税（2572）	推定IS N-1 − 予定納税額
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純額 = 預かったVAT − 控除可能な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アプリの「リクエスト」セクションに保留中のリクエストが届いており、本人が自分の2FAで承認するまで資金は移動しないことを伝えます。これはセキュリティモデルであり、制限ではありません。税金用サブ口座への内部振替は「Impôts et taxes」に自動分類され、領収書は不要です。

6. レポート — 出力形式

必ず、会話内でMarkdownの表を使って回答します。

1. 税金予定表（日付・税目・金額・根拠・信頼度）。各期限について、積立口座の残高を踏まえて✅ 対応済み／⚠️ X € 不足と表示します。
2. 90日間の資金繰り予測（週 × 口座）。最低残高を強調表示します。
3. 積立口座の状況と当月の納税準備額の内訳。
4. 重大度別の説明付きアラート。

さらに、ホストがファイルを表示できる場合（claude.ai のアーティファクト、Claude Desktop、Claude Code）は、インタラクティブな HTML ダッシュボードを生成してユーザーに渡します。口座ごとの残高を1本の線で示し、不確実性の帯、税金の期限を示すマーカー、積立口座のゲージを含めます。ホストがファイルを表示できない場合は、そのことには触れません。Markdownの表を成果物とします。3つ目の出力はリクエストメモ（計算の全内容）で、承認者はSCA時にQontoアプリで確認できます。

ガードレール

• 現在の会話でユーザーの明示的な確認を得る前に、送金リクエストを作成してはなりません。実行済みとして伝えてはなりません。ユーザーのSCA承認待ちです。
• 資金繰り予測と税額は推定であり、申告額ではありません。会計士による確認を推奨します。履歴が6か月未満の場合は、その制約を正直に伝えてください。
• リハーサルでは、その後に decline_request を実行します（request_type: "multi_transfers"、複数形）。
• IBANは末尾4桁以外をマスキングします。すべてページネーションします（per_page ≤ 50）。