EC CSV / Upload Safety
CSVアップロード差分ガード
前回CSVと今回CSVを比較し、価格0円化、在庫ゼロ化、必須列の空欄化など、アップロード前に見たい危険な変更だけを先に出します。
危険な変更
| 危険度 | SKU | 列 | Before | After | 理由 |
|---|---|---|---|---|---|
| CSVを入力して差分チェックを実行してください。 | |||||
利用前に確認したいこと
CSVアップロード差分ガード \について、公開ページと一次資料で確認できる範囲を整理しました。ページの役割と確認範囲を分けて読めるようにしています。
入力
前回と今回のファイルを逆にすると、追加・削除の意味が逆転する。キー列はSKU等の一意識別子を指定し、価格列・在庫列は実際のアップロード対象列と一致させる。
Before CSV、After CSVの2ファイルと、キー列、必須列、価格列、在庫列の指定。
確認範囲: 比較対象は、同じ業務・同じ列体系の前回CSVと今回CSVを想定する。キー列が一意でない場合、列名が一致しない場合、文字コードや区切りが非対応の場合の詳細挙動は未確認。
出力
結果はアップロード前レビューの優先順位付けに使う。件数が0でも、すべてのモール固有エラーや商品情報の妥当性を検査したことにはならない。
Critical、Warning、追加、削除、更新の件数と、危険度、SKU、列、Before値、After値、理由の一覧。価格0円化、在庫ゼロ化、必須列空欄化等を危険変更として抽出する。共有用メモをコピーできる。
確認範囲: 検出ルールの閾値、CriticalとWarningの全条件、数値変換、空白の扱い、追加・削除判定式は実装ソース未確認。
制限事項
差分ガードで安全と表示されても、必須列、許容値、文字数、列順、更新権限はアップロード先で再確認する。更新前バックアップと少数SKUテストを併用する。
CSVの構文・文字コード・列重複・複合キー・巨大ファイル・引用符内改行への対応上限は公開本文から未確認。差分検出はアップロード先の公式バリデーションを代替しない。
確認範囲: RFC 4180は一般的CSV形式の参考であり、文字コードやモール独自CSV仕様をすべて定めない。
プライバシー
顧客情報、仕入価格、非公開SKU等を含むCSVでは、ページ表示だけでなく通信ログも確認してから利用する。本文では公開仕様と実装監査済みの事実を区別する。
ページは『ブラウザ内処理』『CSVはサーバへ送信されません』と明記している。公開本文上の仕様として確認できるが、解析イベント、エラー収集、共通JavaScriptを含む実装監査は未実施。
確認範囲: FileReader等でローカル処理することは可能だが、読み取り後にfetch、XHR、sendBeacon等で送信しないことの最終確認にはソースとNetworkログが必要。
未確認事項と次に必要な資料
現在確認できるのは画面上の入出力と『サーバーへ送信されない』という公開説明まで。実装根拠を追加すると安全性説明が強くなる。
対応文字コード、区切り文字、最大ファイルサイズ、キー重複時の挙動、危険度ルール一覧、CSVパーサー、外部通信処理。
確認範囲: ツールJavaScript、テストケース、Networkログ、共通解析タグ設定が必要。
前回CSVと今回CSVを比較し、価格0円化、在庫ゼロ化、必須列の空欄化など、アップロード前に優先して確認したい危険な変更を抽出するツールです。対象はモール、基幹、在庫、商品マスタへCSVを一括アップロードするEC・業務担当者です。最初にアップロード用CSVのコピーと、直前に正常利用した比較元CSVを用意してください。画面が返す数値や一覧は事前確認に使い、公開・アップロード・登録の成否を保証する結果として扱いません。公開画面と一次資料の確認日は2026年8月6日です。
30秒要約
- 前回CSVと今回CSVの差分を確認します。
- 価格0、在庫0、必須列空欄などの危険候補を先に表示します。
- キー列、文字コード、列名、重複キーの整合が前提です。
- 差分なしはアップロード成功を保証しません。
- 顧客・注文・個人情報を含むCSVは入力しません。
対象作業
一括更新の前に、大量の行差分から業務事故につながりやすい変更を先に見つける作業です。CSVの仕様検証、モールへの送信、更新結果のロールバックは行いません。
入力と出力
| 区分 | 内容 | 確認ポイント |
|---|---|---|
| 入力 | 前回CSV、今回CSV、画面で指定するキー・比較条件 | 同一形式・同一文字コードを推奨 |
| 出力 | 危険な変更候補、行・キー・列・前後値 | 抽出ルールに該当した差分のみ |
| 判定外 | アップロード先の全バリデーション、文字制限、関連テーブル整合 | 公式仕様・テスト環境が必要 |
基本の使い方
- 元CSVと今回CSVを別名でコピーし、原本を上書きしません。
- 画面で2ファイルを読み込み、ヘッダー、行数、キー列を確認します。
- 危険差分を価格、在庫、必須列などの種類別に確認します。
- 該当行を元CSV・編集元データへ戻って修正します。
- 再出力したCSVで再比較し、アップロード先のテスト・プレビューへ進みます。
このページ固有の3つの論点
1. 差分の基準となるキーが重要
商品コードやSKUが欠損・重複・Excel変換されると、同じ商品を対応付けられません。行番号だけの比較は並べ替えで崩れます。
2. ゼロは正しい変更の場合もある
在庫完売や価格解除など意図した0もあります。ツールは危険候補を出すもので、業務判断を自動化しません。
3. CSV形式の違いは差分より先に確認
文字コード、区切り、引用符、改行、列順、ヘッダー名が変わると、大量差分や読込エラーになります。
具体例1：在庫ゼロ化を検出する
前回CSVのSKU A001が在庫10、今回CSVが0のテストデータを用意します。
期待結果と確認方法
在庫ゼロ化としてSKU、列、10→0が表示されることを確認し、意図した完売か変換ミスかを在庫元データで判断します。
具体例2：必須列の空欄を検出する
前回は商品名があり、今回CSVで1件だけ空欄にしたテストデータを比較します。
期待結果と確認方法
必須列空欄候補に該当行が表示され、空文字、空白文字、引用符だけの値をどのように扱うか確認します。
想定外の入力・処理できない範囲
ヘッダー重複、キー重複、BOM、Shift_JIS、セル内改行、カンマを含む未引用値、巨大CSV、Excelで変換された指数・日付・先頭ゼロは、誤差分や読込失敗の原因です。削除行・追加行・複合キーの扱いは画面仕様で確認します。
制約・プライバシー
商品マスタでも仕入価格、未公開商品、内部SKUが機密になる場合があります。顧客名、住所、電話、注文ID、メールアドレスを含むCSVは入力対象にしません。公開説明でブラウザー処理とされる場合でも、全通信の監査が完了していない限り匿名テストデータを優先します。
失敗したときの確認順
- 全行が差分になる場合はヘッダー、文字コード、区切り、キー列を確認します。
- 同じキーが複数ある場合は比較を止め、重複を解消します。
- 先頭ゼロ・日付が変わった場合はExcelで開く前の元CSVを再取得します。
- アップロード後の事故に備え、前回CSVとアップロード先のエクスポートを保管します。
このページを使うか別手段を選ぶか
| 状況 | 判断 | 次の行動 |
|---|---|---|
| 前回と今回が同形式 | このツール | 危険差分を確認 |
| 初回アップロード | 別チェック | 比較元がないため仕様検証 |
| 顧客・注文CSV | 入力しない | ローカル専用手段を使う |
| API・複数テーブル更新 | 別手段 | 関連整合とtransactionが必要 |
本番データの前に小さな検証を行う
最初から大量ファイルや本番原稿を読み込まず、具体例と同じような小さいテストデータで処理を確認します。入力件数、設定値、期待結果をメモし、結果が一致した場合だけ対象を広げます。ブラウザー、OS、ページ更新によって挙動が変わる可能性があるため、重要作業では実行日時も残します。
tool: CSVアップロード差分ガード
browser:
input_copy:
settings:
expected:
actual:
checked_at: 2026-08-06出力ファイルを作るツールでは、ダウンロード直後に開いて件数、ファイル名、文字コード、画像形式、数値、先頭ゼロを確認します。出力されたという事実だけで正常処理と判断しません。元データは別名で保持し、上書き・アップロード・公開は検証後に行います。
結果を再現できる形で残す
作業を他の担当者が再現できるよう、入力のコピー、設定、出力、確認結果を一組で保存します。機密情報を含む入力は保存範囲とアクセス権を限定し、共有用記録ではダミー値へ置き換えます。
- 入力ファイルの名前、取得元、作成日時
- 選択した項目、列、単位、並び順、変換形式
- 出力ファイルと対応表
- エラーや警告の全文
- 最終確認を行った管理画面・プレビュー
- 元へ戻すためのバックアップ
よくある確認
結果が表示されたら、そのまま使ってよいですか？
いいえ。一括更新の前に、大量の行差分から業務事故につながりやすい変更を先に見つける作業です。CSVの仕様検証、モールへの送信、更新結果のロールバックは行いません。 ツールが確認する範囲と、実際の登録先・公開先が検証する範囲は異なります。小さい既知データで計算や変換を検算し、最終システムのプレビューやテスト登録を行います。
ページを閉じた後も入力や結果は残りますか？
保存の有無はページごとの実装、ブラウザーストレージ、ダウンロード操作に依存します。公開説明に明記がない場合は残らない前提で作業記録を別に保存し、保存されないとも断定しません。
大量データでも同じように処理できますか？
ファイルサイズ、件数、画像寸法、ブラウザーのメモリ上限により失敗する可能性があります。少量から増やし、処理時間と出力欠落を確認してください。
関連ページ
日付列の変換事故はCSV 日付 変換でExcelに壊されない方法で確認します。楽天登録作業全体は楽天登録前チェックパックからたどれます。
確認範囲
現行検索説明で前回/今回CSV、価格0円化、在庫ゼロ化、必須列空欄の抽出を確認しました。対応文字コード、最大容量、キー指定、保存方式の全実装は未監査です。
更新履歴
- 2026-08-06: 公開ページ、検索結果に表示される現行説明、関連する公式仕様を再確認し、入力・出力・制約・プライバシー・失敗時の案内を更新しました。
参考リンク
- CSVアップロード差分ガード - 現行ツール
- RFC 4180 - CSVの一般形式
- CSV日付変換ガイド - Excel変換事故の関連ページ