CSVチェックツールを作るときに、最初から自動修正しない理由

CSVチェックツールを作るとき、「空欄を埋める」「URLを直す」「JANの形式をそろえる」まで自動でやりたくなります。ただ、最初から自動修正を入れると、便利になる前に別の事故を作ることがあります。特にShopify商品CSVや在庫CSVは、1列の変更が商品ページ、在庫、画像、検索表示に広く効きます。

まず何が起きているか

CSVの不備には、機械的に直せるものと、業務判断が必要なものがあります。前後スペースの削除は比較的単純ですが、空欄を既定値で埋める、価格を丸める、画像URLを置き換える、説明文を翻訳する、といった処理は意図を確認しないと危険です。チェックツールの初期版は、直すより先に見つけて説明する方が役に立つことが多いです。

よくある危ない自動修正

• 空欄を「変更なし」と思い込んで埋める、または削除する
• JANコードやSKUを数値扱いし、先頭0を落とす
• 画像URLを推測で差し替え、違う商品画像にする
• Handleを自動生成して、既存商品の更新ではなく新規作成に寄せてしまう
• 英語説明文を一括生成し、ブランド用語や禁止表現を見落とす

最初に作るべき確認項目

• 列名が想定テンプレートと一致しているか
• 必須列、更新対象列、触らない列が分かれているか
• 空欄、重複、形式違い、異常に長い値があるか
• 投入前後で変わる行数、商品数、SKU数
• 修正候補ごとに、誰が判断するべきか

手作業で運用する場合の手順

まずはCSVを直接書き換えず、チェック結果だけを別ファイルに出します。次に、問題を「その場で直せる」「担当者確認が必要」「今回は触らない」に分けます。修正する場合も、元CSV、修正後CSV、差分レポートを残します。これだけで、どの判断で何が変わったかを後から説明しやすくなります。

小さく自動化できる部分

• 読み込み時の文字コード、列数、ヘッダー差分チェック
• JAN、URL、価格、数量などの形式チェック
• 更新対象列だけを抜き出した差分レポート
• 危険度別の警告表示
• 確認済みのルールだけを選択式で適用する処理

注意点

自動修正を否定しているわけではありません。問題は、ルールが固まる前に「たぶんこうだろう」で書き換えることです。CSV投入後の結果、売上、検索表示、在庫反映を保証することはできません。最初は検出と差分確認を中心にして、繰り返し安全に使えるルールだけを少しずつ自動化するのが現実的です。

相談前に整理しておくとよいこと

• チェックしたいCSVの種類: 商品、在庫、注文、帳票用など
• 過去に壊れた列、怖くて触れない列
• 自動化したい作業と、人が判断したい作業
• 投入前に見たいレポートの形
• 初回相談では、実CSVではなく列名と作業手順だけでもかまいません

参考にした公式情報

• Shopifyヘルプセンター: CSVファイルを使用した商品のインポートとエクスポート
• Shopify Help Center: Using CSV files to import and export products