GASで経費明細から
AIで勘定科目を自動仕分けする方法

// スクリプトプロパティにAPIキーを保存しておく（初回1回だけ実行）
function saveApiKey() {
  PropertiesService.getScriptProperties()
    .setProperty("CLAUDE_API_KEY", "sk-ant-xxxxxxxx");
}

function getApiKey() {
  const key = PropertiesService.getScriptProperties()
    .getProperty("CLAUDE_API_KEY");
  if (!key) throw new Error("APIキーが未設定です。saveApiKey を実行してください。");
  return key;
}

// 自社で使っている勘定科目に差し替える（ここを固定するのが最大のポイント）
const ACCOUNTS = [
  "旅費交通費",
  "消耗品費",
  "会議費",
  "接待交際費",
  "通信費",
  "新聞図書費",
  "水道光熱費",
  "支払手数料",
  "広告宣伝費",
  "外注費",
];

// 経費明細の配列を渡し、勘定科目と確信度を受け取る
function classifyExpenses(items) {
  const prompt =
    "あなたは日本の中小企業の経理担当です。\n" +
    "次の経費明細を、下の勘定科目の候補から1つだけ選んで仕分けしてください。\n" +
    "候補にどうしても当てはまらない場合だけ \"要確認\" としてください。\n" +
    "各明細に、選んだ理由の自信度を confidence として 0〜1 で付けてください。\n" +
    "余計な説明は出力せず、JSON配列だけを返してください。\n" +
    "形式: [{\"index\":0,\"account\":\"消耗品費\",\"confidence\":0.9}]\n\n" +
    "勘定科目の候補:\n" + ACCOUNTS.join(" / ") + "\n\n" +
    "経費明細（番号: 摘要 / 金額 / 支払先）:\n" +
    items.map((it, i) =>
      i + ": " + it.memo + " / " + it.amount + "円 / " + it.payee
    ).join("\n");

  const payload = {
    model: "claude-sonnet-4-20250514",
    max_tokens: 1024,
    messages: [{ role: "user", content: prompt }],
  };

  const res = UrlFetchApp.fetch("https://api.anthropic.com/v1/messages", {
    method: "post",
    contentType: "application/json",
    headers: {
      "x-api-key": getApiKey(),
      "anthropic-version": "2023-06-01",
    },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true,
  });

  if (res.getResponseCode() !== 200) {
    throw new Error("API error: " + res.getContentText());
  }

  const text = JSON.parse(res.getContentText()).content[0].text;
  return JSON.parse(extractJson(text));
}

// レスポンスからJSON配列部分だけを取り出す（前後の余計な文字対策）
function extractJson(text) {
  const start = text.indexOf("[");
  const end = text.lastIndexOf("]");
  return text.slice(start, end + 1);
}

// A列=日付 B列=摘要 C列=金額 D列=支払先 E列=勘定科目 F列=確信度 を想定
function classifyExpensesAll() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("経費");
  const last = sheet.getLastRow();
  if (last < 2) return;

  const values = sheet.getRange(2, 1, last - 1, 6).getValues();
  const BATCH = 15;

  // 勘定科目（E列）が未入力の行だけを対象にする
  const targets = [];
  values.forEach((row, i) => {
    const memo = String(row[1]).trim();
    const done = String(row[4]).trim() !== "";
    if (memo && !done) {
      targets.push({
        rowIndex: i,
        memo: memo,
        amount: row[2],
        payee: String(row[3]).trim(),
      });
    }
  });

  for (let s = 0; s < targets.length; s += BATCH) {
    const chunk = targets.slice(s, s + BATCH);
    const result = classifyWithRetry(chunk);

    result.forEach((r) => {
      const target = chunk[r.index];
      if (!target) return;
      values[target.rowIndex][4] = r.account || "要確認";
      values[target.rowIndex][5] = r.confidence;
    });

    Utilities.sleep(500); // 連続呼び出しの間隔をあける
  }

  sheet.getRange(2, 1, values.length, 6).setValues(values);
}

// 一時的なエラー時に最大3回まで再試行する
function classifyWithRetry(items, maxRetry) {
  const limit = maxRetry || 3;
  for (let attempt = 1; attempt <= limit; attempt++) {
    try {
      return classifyExpenses(items);
    } catch (e) {
      Logger.log("試行" + attempt + "回目で失敗: " + e.message);
      if (attempt === limit) throw e;
      Utilities.sleep(1000 * attempt); // 待ち時間を伸ばして再試行
    }
  }
}

// 確信度が低い行・要確認の行に色を付けて担当者に知らせる
function highlightLowConfidence() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("経費");
  const last = sheet.getLastRow();
  if (last < 2) return;

  const range = sheet.getRange(2, 5, last - 1, 2); // E列（科目）とF列（確信度）
  const values = range.getValues();
  const THRESHOLD = 0.8; // この値未満は人の確認対象にする

  const colors = values.map((row) => {
    const account = String(row[0]).trim();
    const confidence = Number(row[1]);
    const needCheck = account === "要確認" || confidence < THRESHOLD;
    return [needCheck ? "#FCE8E6" : null, needCheck ? "#FCE8E6" : null];
  });

  range.setBackgrounds(colors);
}

// 毎月1日の朝に自動で仕分けと確認マークを実行する
function createMonthlyTrigger() {
  ScriptApp.newTrigger("runMonthlyClassify")
    .timeBased()
    .onMonthDay(1)
    .atHour(7)
    .create();
}

function runMonthlyClassify() {
  classifyExpensesAll();
  highlightLowConfidence();
}