公開日：2026/08/15 19:08 最終更新日：2026/08/17 11:22

同じ注文を2回処理する前に止める｜GASで注文行の重複をdry-run検査

Xでシェア facebookでシェア LINEでシェア

Gasおじ｜GoogleアカウントをAIエージェント化

先に知っておきたいこと
準備するシート
コピーして使える最小コード
実行手順
コードが行っている安全策
失敗しやすい点
公開前チェックリスト
まとめ

注文一覧へCSVを追記したあと、「この行は前にも取り込んだかもしれない」と不安になったことはありませんか。重複に気づかず処理を進めると、入金確認や発送準備を二重に数える原因になります。

この記事では、Googleスプレッドシートの注文表を変更せずに読み取り、注文ID・商品コード・数量・注文日の組み合わせが同じ行を重複候補として別シートへ記録する無料のGAS例を紹介します。行の削除、ステータス変更、メール送信は行いません。最初は必ずコピーしたシートと少量のサンプルで確認してください。

先に知っておきたいこと

対象は自分で管理している注文一覧です。
同じ注文IDでも商品コードが違う行は別の明細として扱います。
一致した行は削除せず、DUPLICATE_CANDIDATEとして確認対象にします。
ログには購入者名、住所、メール、電話番号、注文内容を残しません。
注文IDなどから作った短い照合キーだけをAuditLogへ記録します。
支払い、在庫、発送、返金の判断は自動化しません。

準備するシート

スプレッドシートにOrdersという名前のシートを作り、1行目へ次の列を用意します。

注文ID
商品コード
数量
注文日
ステータス
メモ

確認用コピーには、同じ注文ID・商品コード・数量・注文日を持つ行を2行入れておくと、重複候補の動きを確かめられます。実際の購入者情報は使わず、TEST-001などの架空データで試してください。

コピーして使える最小コード

function auditDuplicateOrderRowsFree() {
  const DRY_RUN = true;
  const SOURCE_SHEET = 'Orders';
  const LOG_SHEET = 'AuditLog';
  const MAX_ROWS = 500;

  if (!DRY_RUN) {
    throw new Error('この無料例はDRY_RUN: trueのまま実行してください。');
  }

  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const source = spreadsheet.getSheetByName(SOURCE_SHEET);
  if (!source) {
    throw new Error('Ordersシートが見つかりません。');
  }

  const values = source.getDataRange().getDisplayValues();
  if (values.length < 2) {
    throw new Error('見出し行の下に確認用データを1行以上入れてください。');
  }
  if (values.length - 1 > MAX_ROWS) {
    throw new Error('最初は500行以内に絞って確認してください。');
  }

  const headers = values[0].map(value => value.trim());
  const required = ['注文ID', '商品コード', '数量', '注文日'];
  const indexes = {};
  required.forEach(name => {
    const index = headers.indexOf(name);
    if (index < 0) throw new Error('1行目に「' + name + '」が必要です。');
    indexes[name] = index;
  });

  const runId = Utilities.getUuid().slice(0, 8);
  const seen = new Map();
  const logs = [];

  values.slice(1).forEach((row, offset) => {
    const sourceRow = offset + 2;
    const orderId = normalizeOrderValueFree_(row[indexes['注文ID']]);
    const itemCode = normalizeOrderValueFree_(row[indexes['商品コード']]);
    const quantityText = normalizeOrderValueFree_(row[indexes['数量']]);
    const orderDate = normalizeOrderValueFree_(row[indexes['注文日']]);

    if (![orderId, itemCode, quantityText, orderDate].some(Boolean)) return;

    const quantity = Number(quantityText);
    if (!orderId || !itemCode || !quantityText || !orderDate) {
      logs.push([new Date(), runId, sourceRow, 'INPUT_HOLD', '', '必須項目に空欄があります']);
      return;
    }
    if (!Number.isFinite(quantity) || quantity <= 0 || !Number.isInteger(quantity)) {
      logs.push([new Date(), runId, sourceRow, 'INPUT_HOLD', '', '数量は1以上の整数で入力してください']);
      return;
    }

    const comparisonKey = [orderId, itemCode, String(quantity), orderDate].join('|');
    const shortKey = shortOrderHashFree_(comparisonKey);
    if (seen.has(comparisonKey)) {
      logs.push([
        new Date(), runId, sourceRow, 'DUPLICATE_CANDIDATE', shortKey,
        '同じ組み合わせの先行行: ' + seen.get(comparisonKey)
      ]);
    } else {
      seen.set(comparisonKey, sourceRow);
      logs.push([new Date(), runId, sourceRow, 'OK', shortKey, '一致する先行行なし']);
    }
  });

  const logSheet = spreadsheet.getSheetByName(LOG_SHEET) || spreadsheet.insertSheet(LOG_SHEET);
  if (logSheet.getLastRow() === 0) {
    logSheet.appendRow(['実行日時', 'run_id', '元の行', '判定', '照合キー', '確認メモ']);
  }
  if (logs.length > 0) {
    logSheet.getRange(logSheet.getLastRow() + 1, 1, logs.length, logs[0].length).setValues(logs);
  }

  console.log(JSON.stringify({
    dryRun: DRY_RUN,
    checkedRows: values.length - 1,
    logRows: logs.length,
    sourceUpdated: false,
    autoDeleted: false
  }));
}

function normalizeOrderValueFree_(value) {
  return String(value || '').normalize('NFKC').trim().toLowerCase();
}

function shortOrderHashFree_(value) {
  const digest = Utilities.computeDigest(Utilities.DigestAlgorithm.SHA_256, value);
  return Utilities.base64EncodeWebSafe(digest).slice(0, 12);
}