🏷 HowMa除外申請レポート

月初の承認対応 — HowMa（how-ma.com）流入を査定ID単位で課金/非課金判定し、除外申請リストを自動生成

script化済み（毎月1コマンド）代理店対応 DB SELECT only

※ 本資料は HowMa様専用。他媒体は別フォーマット・別ルールの可能性あり

📋 この業務でやること

前月のHowMa流入査定を、提供会社「全社」のステータスで課金/非課金を判定
除外申請が必要な「要確認」案件だけを抽出
要確認を A/B/C/D に振り分け（即除外 / 目視 / 残す）
除外理由を6選択肢に自動マッピング（本人確認ルール準拠）
スプレッドシート転記用のタブ区切り6列で出力

使い方

scriptを月指定で実行→ 6列タブ区切りが出力→ スプシに貼り付け→ A案件を中心に除外申請

⚖️ 判定ルール

一次フィルタ（査定ID単位 / 提供会社全社のstatusで決まる）

✅ OK（除外申請不要）：全提供会社が status=1（仮課金） または 3（確定課金）
⚠️ 要確認：1社でも他status（2/4/5/6/9）が混在 → A/B/C/D振り分けへ

A/B/C/D 振り分け

ランク	意味	条件（script実装）	アクション
A	明らかに除外	無効・課金対象外のみ（課金見込みなし）	即除外申請
B	除外寄り・目視	全社が申請中（status=2）のみ	目視 → 申請判断
C	課金寄り・残す	1社でも課金あり、または重複元あり	残す方向で目視
D	明らかに課金	（全課金はOK判定に入るため実質未使用）	残す

statusの定義

status	ラベル	課金
1	仮課金	✅ 課金
2	申請中	❌ 非課金 → 要確認
3	確定課金	✅ 課金
4	課金対象外	❌ 非課金 → 要確認
5	無効（イタズラ）	❌ 非課金 → 要確認
6	無効（キャンセル）	❌ 非課金 → 要確認
9	無効（運営判断）	❌ 非課金 → 要確認

理由の6選択肢と本人確認ルール

理由は 売却意思なし / 売却意思なし（本人確認）/ 賃貸意思なし / 賃貸意思なし（本人確認）/ 重複 / キャンセル（依頼者都合） のいずれかに当てはめる。

「（本人確認）」表記ルール：本人確認が取れた確証がある時のみ付ける。
・✅ 付ける：result_reason に「依頼者様にお電話したところ確認が取れました」等の明記あり
・❌ 付けない（＝「売却意思なし」等のみ）：「確認が取れませんでした」（連絡つかず）／申請中で結果未確定／文面が空

📤 出力フォーマット（HowMa専用）

タブ区切り6列・日付昇順。そのままスプレッドシートに貼り付け可。

列	中身
ID	査定ID（sale_assess_info_id）
日付	査定日時（created）`YYYY/MM/DD H:MM:SS`
理由	6選択肢のいずれか（本人確認ルール適用）
ランク	A / B / C / D
中身	判定根拠（例: 1社・課金対象外 / 2社中1社課金 / 重複元126275）
アクション	申請 / 目視→申請判断 / 残す

出力サンプル（2026-05実績）

ID	日付	理由	ランク	中身	アクション
125806	2026/05/01 15:54:57	売却意思なし	A	1社・課金対象外	申請
126234	2026/05/19 21:33:54	重複	A	1社・無効（運営判断）	申請
126478	2026/05/29 8:19:04	重複	C	重複元126275	残す

⚙️ 実行方法（script化済み）

cd /Users/horie/Data/mrs-claude-ad
python3 "projects/広告媒体管理/howma_exclusion_report.py"                 # 先月分
python3 "projects/広告媒体管理/howma_exclusion_report.py" --month 2026-05  # 月指定

stdout：6列タブ区切り（コピペ用）
stderr：OK件数・要確認件数・A/B/C内訳のサマリ
Claudecode_DB の db.py を借用（SELECT only）、.env は相対パスで自動ロード
2026-05実績で手動結果（OK42 / 要確認9・A3/B2/C4）と完全一致を検証済み

既知の簡略化：C・重複案件の「中身」は重複元IDのみ表示。重複元の出処名（smoola/t23m-navi 等）は追加クエリが必要なため省略。理由・ランクの判定には影響なし。