qonto-vat-return

Qonto VAT 申告書

Qonto の1か月分のデータから、impots.gouv.fr にボックスごとに転記できる CA3 を作成します。これは申告書の作成を補助するものであり、申告ではありません。このスキルはデータを読み取り、計算し、相互チェックを行いますが、申告手続きは一切行わず、すべての出力で会計士による確認を推奨します。書き込みツールはありません。

前提条件

1. get_organization を必ず最初に実行 → 口座（list_transactions には bank_account_id／iban が必要）、法人情報、国を取得します。
2. 国に応じて対応：CA3 はフランスの申告書です。その他の Qonto 対応国（DE、ES、IT、AT、NL、BE、PT など）の場合は、その旨を明記し、徴収 VAT と控除可能 VAT の一般的な集計にとどめます。外国の VAT をフランスの申告書のボックスに決して割り当てません。
3. どの期間の履歴にも対応します。履歴が6か月未満の場合や、VAT データにタグが付いていない場合は、見せかけの精度を装わず、最低値や警告を示して正直に対応します。

ワークフロー

1. 対象範囲：税制、課税時期、申告期間 — 質問せずに検出

• 申告頻度は DGFIP の履歴から判定します。list_transactions（per_page: "50" でページネーション）を使い、まず外向きの口座振替に絞ります。フランスの税金は SEPA 口座振替で徴収されます（利用可能であれば operation_type: direct_debit で絞り込み、そうでなければ取引の operation_type フィールドで絞り込みます）。税務署の表記ゆれ（DGFIP、DIRECTION GENERALE DES FINANCES PUBLIQUES、Direction Générale des Finances Publiques — 大文字・小文字やアクセントを正規化し、1つの取引先として統合）と、VAT と記された取引先を照合します。毎月の引き落としなら月次 CA3（通常実額方式）、四半期ごとの引き落としなら四半期 CA3（年間 VAT が €4,000 未満の場合に認められます）です。
• 実簡易税制（CA12 ＋ 7月／12月の予定納付）は CA3 の対象外です。これが検出された場合はその旨を伝え、ボックスに割り当てた書類は作成せず、簡易税制は 2027-01-01 に廃止される（2025 年財政法第38条）と警告します。ユーザーは月次または四半期の CA3 に移行し、その時点でこのスキルが適用されます。
• 課税時期（fait générateur）— 最重要の設定：顧客請求書の vat_payment_condition（list_client_invoices）を確認します。on_receipts → 期間中に受領した支払いに基づいて徴収 VAT を集計します（サービスでは通常こちらが既定です）。それ以外の場合 → 発生主義で VAT を計算し、発行した請求書に基づいて徴収 VAT を集計します。複数の課税条件が混在する場合は、請求書ごとに処理します。

2. 徴収 VAT、税率別

• 発生主義の場合：期間中に発行した請求書を対象に、税率（20／10／5.5／2.1％）別に VAT を集計し、税率ごとの課税標準額と税額を算出します。期間中に発行したクレジットノートを差し引きます。
• 入金主義の場合：期間中の入金取引を顧客請求書と照合します（金額＋取引先＋参照情報。paid_at のステータスも参考にします）。照合できた請求書の VAT 内訳を使用します。請求書と照合できない入金は「未割当の入金」として別に記載し、黙って課税したり無視したりしません。
• → ボックス 01（課税対象取引の課税標準額）、08／09／9B／11（税率ごとの課税標準額＋税額）、16 行目（VAT 総額）。

3. 控除可能 VAT — 最低値として提示

• 期間中の支出に対する vat_amount（list_transactions）と、期間中の仕入先請求書に対する total_tax_amount（list_supplier_invoices）を合算します — 取引と照合済みの請求書は重複計上を除外します。
• VAT 情報のない支出の件数を報告します。控除可能 VAT の合計は最低値であることを明示します。タグのない経費に VAT 税率を推定して適用することは決してありません。
• 固定資産（ボックス19）：ラベル／カテゴリ、仕入先請求書の説明、または通常より高額な設備購入から判別できる場合に限って計上します。判別できない場合はすべてボックス 20（その他の商品・サービス）に計上し、その理由を説明します。
• 繰越控除額（ボックス22）：ユーザーが前回の申告額を提示した場合はその金額を使用します。提示がない場合は、過去の CA3 に控除額が記載されているときに、履歴から推定 🟡 します。「直近に提出した CA3 を確認してください」と明記します。
• リバースチャージ（autoliquidation） — 取引先情報から EU 域内取得、輸入、外国の仕入先を検出した場合、該当する可能性のある取引と関連ボックス（03、17、A4/I 行、24）に**「会計士に確認」**とフラグを付けます。リバースチャージ VAT を黙って計算することはありません。

4. 純額の計算

• 23行目 = 控除額の合計（19 + 20 + 21 + 22）。
• 16 > 23 の場合 → 28行目に納付VAT（および32行目に納付総額）。23 > 16 の場合 → 25行目にVAT控除額 → 27行目に繰越控除額（または26行目に還付申請額 — ユーザーが会計士と相談して選択）。
• セント単位で計算した後、フォームで求められるユーロ単位の丸め額も併記します。

5. 整合性チェック — ユーザーが内容を転記する前に実施

チェック	照合対象	出力
純VAT額と過去の履歴	過去のDGFIPへのVAT納付額の中央値	乖離が30％を超える場合は⚠️（季節性？高額の請求書？データ不足？と説明）
売上VATと過去の期間	同期間の課税標準額と税率、過去の月	税率構成の変化または課税標準額の急増があれば⚠️
取引と明細書	list_statements / get_statement の期間合計	分析対象の取引が明細書の全期間を網羅していない場合は⚠️
入金の照合（on_receipts）	未割り当ての入金	金額とともに一覧表示 — ユーザーが会計士と相談して判断
タグ付けされていない借方	件数 + 合計金額	控除額の下限に関する注意書き

6. レポート — 出力形式

必ず、会話内で次の内容を回答します。

1. CA3の表：フォームの欄 → 正式な項目名 → 金額（セント単位 + ユーロ単位に丸めた額） → 根拠（該当する請求書／取引、および適用ルール）。impots.gouv.fr に転記できる形式です。
2. 整合性チェックの表：各チェックに✅／⚠️を付けます。
3. 説明上の注意事項：適用した課税時期、下限額、リバースチャージのフラグ、および申告期限のリマインダー（会社のDGFIPスケジュールに基づく翌月15日から24日の間）。

ホストがファイルをレンダリングできる場合（claude.ai artifacts、Claude Desktop、Claude Code）は、HTMLダッシュボードも出力します。CA3をフォーム形式で表示し、税率ごとの売上VAT／控除VATの内訳、過去のDGFIPへの納付額と比較する履歴スパークラインを含めます。ホストがファイルをレンダリングできない場合は、そのことには触れません。納品物はMarkdownの表です。

ガードレール

• これは準備であり、申告ではありません。 このスキルは申告を行わず、DGFIPに情報を送信せず、書き込みツールも一切備えていません。ユーザー（または会計士）が自ら数値をimpots.gouv.frに転記します。
• すべてのレポートに次の内容を記載します。銀行データに基づく推定値 ≠ 会計記録 — 申告前に会計士の確認を受けてください。特にリバースチャージ、固定資産、繰越控除額については確認が必要です。
• 作り上げてはいけません。フランス国外の組織にフランスの申告欄を適用しないこと、タグ付けされていない経費のVAT税率を推測しないこと、リバースチャージ額をひそかに計算しないこと。
• データが不完全な場合は、正直にその旨を示します。下限額は件数とともに明記し、未割り当ての入金を一覧表示し、履歴が短い場合は注意を促します。
• IBANは末尾4桁を除いてマスクします。すべてページ分割します（per_page ≤ 50）。