クレジットカード明細インポート — 34_wrk_card

1. 概要

焦点質問: CC明細から33タブへの自動消込はどう動作するか？

背景・課題

JCBゴールド法人カードの利用明細を 34_wrk_card タブに貼り付け、GAS メニューから実行することで、 33_wrk_bank (STL) のレコードと自動マッチングし、確認後に消込済にする。

2段階処理フロー（マトリクス）

2. 設計判断

§1 詳細: カード明細の利用先名は STL 取引先名と表記揺れが大きい（例: "CLAUDE.AI" vs "Anthropic, PBC"）。辞書で正規取引先名に変換し、特定できた場合はその取引先の STL のみにマッチ対象を限定（誤マッチ "CLAUDE.AI → Google STL" 等を防止）。

3. 変更内容

3.1 スキーマ

34_wrk_card タブレイアウト

元データ (JCB明細 A〜M列)

A: 支払年月日 | B: ご利用者 | C: カテゴリ | D: ご利用日 | E: ご利用先など |
F: ご利用金額(￥) | G: 決済区分 | H: 今回回数 | I: 訂正サイン |
J: お支払い金額(￥) | K: 国内／海外 | L: 摘要 | M: 備考

GAS管理列 (N〜T列)

GAS管理列が存在しない場合、ensureMatchCols_() がヘッダー行末尾に自動作成する（card / receipt 共通の MATCH_EXTRA_HEADERS 定義）。

33_wrk_bank「消込手段」列

3.2 ロジック

3.2.1 マッチング対象STL

33_wrk_bank の以下 3条件すべてを満たす STL 行:

1. 有効フラグ = TRUE
2. 決済口座が "クレカ" を含む (例: "クレカ_福井銀行")
3. 決済ステータス = "未処理" または (消込済 かつ 消込手段が空)

3.2.2 マッチ成立条件 (全て AND)

1. 日付一致: card.支払年月日 = STL.決済日_計画 (完全一致)
2. 金額一致: card.お支払い金額 or card.ご利用金額 が STL.税込金額_決済 の ±20%以内
3. 名前やや一致: 以下のいずれかを満たす
   • 名寄せ辞書 (Constants.CC_MERCHANT_MAP) で推定した取引先名が STL 取引先名と一致
   • STL 取引先名が card.ご利用先 に直接含まれる (正規化後、3文字以上)
   • STL 摘要が card.ご利用先 に直接含まれる (正規化後、4文字以上)
   • トークン分割での部分一致 (2文字以上)

3.2.3 辞書マッチの厳格化

名寄せ辞書で取引先が特定できた場合、その取引先のSTLのみ マッチ対象とする。 これにより CLAUDE.AI が Google の STL にマッチする等の誤マッチを防止。

3.2.4 複数候補時の優先度

金額差が最小の STL を優先。

3.2.5 金額補正

単一行マッチ

card の お支払い金額 で STL の 税込金額_決済 を上書き。差額を 差額(手数料等) に記録。

複数行合算マッチ

同じ STL_ID を複数の card 行に手動入力した場合、お支払い金額 を合算して消込。

3.2.6 アンマッチ時の候補提案

マッチ不成立の card 行には、全未処理STL (決済口座問わず) から最も近い候補を提案。 候補スコア: 日付一致(50) + 名前一致(30) + 金額近接(20) の合計で最高スコアの STL を表示。 候補提案時はSTL_IDに 候補: プレフィックスを付与し、取引先名に決済口座名を付記する。

3.2.7 スキップ条件

マッチング確認 (importCcStatement)

消込実行 (applyCcSettlement)

3.2.8 消込実行の処理詳細

applyCcSettlement() は以下の2パスで処理する:

3.2.9 正規化ロジック

normalizeMerchant_() は以下の変換を行う:

• 全角英数 → 半角英数
• 全角スペース → 半角スペース
• 全角記号 (－, ＊, ＿) → 半角
• 小文字化 + トリム

トークン分割時は会社種別名 (株式会社, 有限会社, 合同会社, pte, ltd, inc, llc, co, jp) を除外し、2文字以上のトークンのみ使用する。

3.3 UI

ハイライト仕様

メニュー

🔍 消込・マッチング
  ├─ 💳 クレカ明細マッチング確認
  ├─ 💳 クレカ消込実行 (確認FLG=TRUE)
  ├─ ───
  ├─ 📄 領収書PDFの読み込み (Drive)
  ├─ 🧾 領収書マッチング確認
  └─ 🧾 領収書消込実行 (確認FLG=TRUE)

結果ダイアログ

マッチング確認・消込実行の完了時にダイアログで結果サマリーを表示:

4. 影響範囲

5. テスト仕様

付録

付録A: 改修ファイル

付録B: 名寄せ辞書 (Constants.CC_MERCHANT_MAP)

Constants.CC_MERCHANT_MAP = [
  { keywords: ['microsoft', 'マイクロソフト', 'ﾏｲｸﾛｿﾌﾄ', 'ｍｉｃｒｏｓｏｆｔ'], vendor: '日本マイクロソフト株式会社' },
  { keywords: ['google', 'workspace'], vendor: 'Google Asia Pacific Pte. Ltd.' },
  { keywords: ['ヌーラボ', 'nulab', 'nlab'], vendor: 'NLAB_株式会社ヌーラボ' },
  { keywords: ['pollo', 'cocosoft'], vendor: 'COCOSOFT TECHNOLOGY PTE. LTD.' },
  { keywords: ['claude', 'anthropic'], vendor: 'Anthropic, PBC' },
  { keywords: ['adobe', 'acrobat'], vendor: 'Adobe KK' },
  { keywords: ['zoom'], vendor: 'Zoom Communications, Inc.' },
  { keywords: ['amazon', 'アマゾン'], vendor: 'Amazon_Services_International_LLC' },
  { keywords: ['弁護士ドットコム', 'クラウドサイン', 'cloudsign'], vendor: '弁護士ドットコム株式会社' },
  { keywords: ['big5', 'ビッグファイブ'], vendor: '【BIG5-BASIC】運営事務局' },
  { keywords: ['freenance', 'フリーナンス'], vendor: 'フリー株式会社' },
  { keywords: ['福井カード'], vendor: '株式会社福井カード' },
];