突合ロジック

• 単品突合： カード金額 = 古物台帳 transaction.price（1件）
• まとめ仕入れ： カード金額 = 同じ bulk_group_id の SUM(price)
• 古物台帳条件: book_date IS NULL かつ book_date_cancelled=False かつ mf_sent=False
• カード利用日以前の仕入れ日のみ対象
• 複数候補: 日付差が小さい順（最近傍）、SKU昇順

仕訳内容

要確認になる条件（全て該当）

• 古物台帳との突合なし
• マッピングで debit_account='仕入高' と判定
• detection_method が manual / kobutsu_match / manual_expense 以外
• is_kobutsu_cancelled=False
• ※ 0件でもタブは常に表示（件数確認のため）

手動振り分け

キャンセルタブに入るもの

キャンセル処理パターン

仕入れタブ（編集不可）

• 古物台帳 transactions.mf_tax_category カラムを参照
• 「適格」→ 課税仕入10% + 適格チェック ✓（青）
• 「非適格」または NULL → 課税仕入10% + 適格チェックなし（グレー）
• 表示のみ・編集不可（古物台帳が正）

経費タブ（手動設定）

• 3択プルダウン: 課仕10%（適格）/ 課仕10%（非適格）/ 対象外
• is_qualified と mf_tax_category をDBに保存

主な対象外パターン

• 荷造運賃 / 輸出配送費（カメラ・時計・その他）
• 外注工賃 / 梱包外注
• 支払手数料 / catawiki・shopee各国

マッピングルール

• マッピングルール画面（/rules/）で店名→勘定科目のルールを管理
• キーワードが摘要に含まれる場合に勘定科目・補助科目を自動設定
• 手動振り分けは detection_method で記録（manual / manual_expense）
• マッピング学習機能は未実装（次フェーズ）

MFへの仕訳登録（POST）

• 仕入れ・経費タブでチェックした明細をプレビュー確認後「この内容でMFクラウドに登録する」でPOST
• 登録後 status='registered' に更新、mf_journal_id を保存
• プレビューでは日付・借方科目・借方補助・借方部門・貸方科目・貸方補助・税区分・金額・摘要・メモ(SKU)を確認できる

重要：禁止事項

表示切り替え

• 明細一覧画面の「ステータス：」で 📋 未登録 / ✅ 登録済み を切り替え
• 登録済みタブはカード未選択（source=all）でも全件表示される
• 登録済みタブでは全項目テキスト表示のみ（編集不可）
• MF仕訳IDのリンクから直接MFクラウドの仕訳を開ける

MFメモ欄について

部門ID（DEPT_IDS）

補助科目ID（SUB_ACCOUNT_IDS）

• 同名補助科目が複数勘定科目にある場合は 「勘定科目/補助科目名」複合キー でIDを引く
• 例: 「支払手数料/月額利用料」と「通信費/月額利用料」は別ID
• DBの sub_account_id は使わず、sub_account_name → SUB_ACCOUNT_IDS で変換するのが正

部門設定ルール

• 借方（PL科目）のみに部門IDを設定する
• 貸方（BS科目: 未払金など）には部門を設定しない