バリエーション一括登録・修正

設定画面：商品管理 / 商品一覧 / CSV一括処理 / バリエーション一括登録・修正

商品のバリエーションをCSVファイルで一括登録・更新する「アップロード」、登録済みのバリエーションデータをCSVで書き出す「ダウンロード」、ダウンロード時の出力項目を決める「フォーマット管理」、およびアップロードするCSVファイルの作り方をご案内します。

1. アップロード

CSVファイルをアップロードして、バリエーションを一括で新規登録・更新する機能です。
旧管理画面で「オプション一括登録」「オプション一括修正」に分かれていた2つの機能が、この1つの画面に統合されています。
CSVファイルの作り方（項目名・行の特定方法・空欄とNULLの扱いなど）は「4. CSVファイルの作成」をご覧ください。

1-1. アップロードの手順

• 「新規追加」の「未登録のバリエーションを新規追加する」を確認します（初期状態はオン）。
  オンの場合はCSVにあるバリエーションを更新し、登録されていないものは新しく追加します（旧「オプション一括登録」に相当）。
  オフの場合はすでに登録されているバリエーションの更新だけを行います（旧「オプション一括修正」に相当）。
• 「完了お知らせメール」に、取り込み完了を知らせるメールアドレスを入力します。
  ログイン中のユーザーが前回CSVを取り込んだときのアドレスが初期表示されます（商品関連のCSVアップロードで共通）。不要な場合は空にできます。
• CSVファイルを選択します（ドラッグ＆ドロップ、またはファイル選択）。
  CSVは、CSV一括処理の画面でダウンロードしたものを編集してご利用ください。
• 選択と同時に自動で書式チェックが実行され、結果が表示されます。
  エラーがある行は「行」「項目名」「エラー内容」の一覧で表示されます。
  取り込まれない列があれば「スキップされた項目」に表示されます。
  「CSVの読み取り方」に、CSVがどう読み取られるかが表示されます。
• 内容を確認して「アップロード」ボタンをクリックします。
• 「アップロードが完了しました」の画面に切り替わります。

ファイルサイズは最大14MBです。超える場合はファイルを分割してください。10バイト未満のファイルは選択できません。  文字コードは自動で判別します（UTF-8 / BOM付きUTF-8 / Shift-JIS）。指定は不要です。  エラー行があってもアップロードできます。エラーの行だけスキップして、残りの行が取り込まれます。  この画面に表示されるエラーは先頭1,000件までです。すべてのエラーは「CSV処理ジョブ管理」の詳細画面で確認できます。  「未登録のバリエーションを新規追加する」は、ファイルを確認したあとに切り替えても構いません（ファイルを選び直す必要はありません）。

1-2. 取り込み結果の確認

アップロードは順番待ちのうえ、順次処理されます。
処理の状況と結果は「CSV処理ジョブ管理」（アップロード一覧）で確認します。

• アップロード完了画面の「CSV処理ジョブを確認」ボタンをクリックします。
  あとから確認する場合は、CSV一括処理の画面の「CSV処理ジョブ管理」から開きます。
• 「アップロード一覧」で、対象のジョブのステータス（処理待ち / 処理中 / 完了 / 失敗 / キャンセル）、進捗（処理済み / 総数）、エラー件数を確認します。
  ファイル名をクリックすると、アップロードしたCSVをダウンロードできます。
• ジョブIDをクリックすると「CSV処理詳細」画面が開き、成功件数・失敗件数と、エラーの「行数」「項目名」「エラー内容」を確認できます。

1-3. 主なエラーメッセージ

書式のエラーはアップロード前の確認で表示されます。次のエラーは確認では表示されず、取り込みを実行したあとに表示されます。

• 「一致する商品データが存在しません。」「対象のバリエーションが存在しません。」「1商品に登録できるバリエーションは30,000件までです。」は、その行の特定に使った項目と値がかっこ内に表示されます。
  例：対象のバリエーションが存在しません。（商品ID：「15581」／バリエーション１ID：「1」／バリエーション２ID：「0」）
• 商品属性のエラーは、空欄のセルでは判定しません。ほかの商品向けの属性の列があっても、空欄のままなら取り込めます。
• 在庫数や商品属性のエラーで取り込めなかった行は、同じ行の「販売価格」「バリエーション独自コード」「JANコード」などもまとめて取り込まれません。
  在庫が変わらないため、その行の再入荷お知らせメールも送信されません。

1-4. 注意事項

• 旧管理画面の「オプションデータダウンロード」で出力したCSVは、項目名が旧名称のままでも新しい画面にそのままアップロードいただけます。
  列の順番もダウンロード時のままである必要はありません。
• 「販売価格」は9桁までです。旧「オプション一括修正」で10〜11桁の販売価格を入力していた行はエラーになります。
• printio商品では「数量」とAmazon連携の項目（ASIN / Amazon出品者SKU / Amazon出品価格）を更新できません。値を変更するとその行がエラーになります。
  printio商品を更新する場合は、フォーマット管理の「printioで更新できない項目を非表示」ボタンで作成したフォーマットをご利用ください。
• サンプルCSVをご用意しておりません。
  サンプルが必要な場合は、ダウンロード機能で既定のフォーマットを出力してご利用ください。
• CSVファイルはExcelで作成いただくことをおすすめします。
  「ファイル」→「名前を付けて保存」→「ファイルの種類」で「CSV（カンマ区切り）（*.csv）」を選択して保存してください。

2. ダウンロード

現在登録されているバリエーションデータを、CSVファイルでダウンロードする機能です。
ダウンロードしたCSVを編集して「アップロード」すれば、バリエーションを一括で更新できます。

2-1. ダウンロードの手順

• CSV一括処理の画面で、「バリエーション一括登録・修正」カードの「ダウンロード」をクリックします。
• 「フォーマット」（必須）を選びます。
  出力する項目を決めるもので、既定のフォーマット3種（登録・修正用 / 旧オプション一括修正（全項目） / 旧オプション一括修正（数量のみ））と、ショップで登録したフォーマットから選べます。
• 「カテゴリ」を選択すると、そのカテゴリに属する商品のバリエーションだけを出力します。
  未選択の場合は全商品が対象です。
• 「文字コード」をShift-JIS / UTF-8 から選びます（前回選んだ値が初期表示されます）。
• 「ダウンロード」ボタンをクリックします。
  データ件数が多い場合や、ほかのダウンロード処理が混み合っている場合は、その場でダウンロードされず「ダウンロードを受け付けました。」のダイアログが表示されます。
  ダイアログの「ダウンロードページへ」ボタンから「ダウンロード一覧」に移動し、処理の完了後にファイルを取得してください。

選んだフォーマットの出力項目の組み合わせによっては、フォーマットのプルダウンのすぐ下に次の警告が表示されます。

2-2. ダウンロード一覧での確認

順番待ちになったダウンロードは、「ダウンロード一覧」で状況を確認します。
一覧では、ジョブID・処理区分（「バリエーション」と表示）・テンプレート名（選んだフォーマット名）・総件数・実行日時・実行者・ステータス（処理待ち / 処理中 / 完了 / 失敗）を確認できます。
完了したジョブからファイルをダウンロードします。

2-3. 注意事項

• 「完了」「失敗」になったジョブは、最終更新から5日を過ぎると一覧から削除されます。
  必要なファイルは早めにダウンロードしてください。削除後に必要になった場合は、同じフォーマットでダウンロードし直してください。
• 対象データが0件の場合でも、1行目（項目名）だけのCSVが出力されます。
  バリエーションが未登録のショップが、記入用のひな形として利用できます。
• UTF-8を選んだ場合も、Excelで開いたときに文字化けしない形式で出力されます。
• 「商品特定コード指定」「バリエーション特定コード指定」を出力するフォーマットでは、フォーマットの項目構成から決まった値（0または1）が全行に同じ値で入ります。
• カテゴリを選択したままダウンロードすると、対象が一部の商品だけになります。
  全件をダウンロードする場合は、カテゴリが未選択になっているかご確認ください。
• 旧管理画面の3つのダウンロードボタンは、既定のフォーマットに次のとおり対応しています。
  オプションデータ → 登録・修正用 / 現在のオプションデータ → 旧オプション一括修正（全項目） / 現在の数量データ → 旧オプション一括修正（数量のみ）
• 出力する項目そのものの設定は「フォーマット管理」で行います。

3. フォーマット管理

バリエーションデータをCSVでダウンロードするときの出力項目を、フォーマットとして登録・管理する機能です。
どの項目を、どの順番で、どの項目名で出力するかを、ショップごとに自由に決められます。
CSV一括処理の画面で、「バリエーション一括登録・修正」カードの「フォーマット管理」をクリックすると、フォーマット一覧が開きます。
登録したフォーマットは、ダウンロードのモーダルで選択します。

フォーマット一覧では、フォーマット名・作成日時・最終更新日時・説明を確認できます。
一覧の右上に「登録数 ◯/20」が表示されます。アップロードに使えない組み合わせのフォーマットには、行の下に警告が表示されます（3-3参照）。
右上「フォーマットを登録」から新規登録が可能です。

3-1. フォーマットの新規登録

• 一覧画面の右上「フォーマットを登録」ボタンをクリックします。
• 「基本情報」にフォーマット名（必須・255文字まで）と説明（255文字まで）を入力します。
• 既定のフォーマットをベースにしたい場合は、「プリセットの反映」のプルダウンから3種類のいずれかを選び、「反映」ボタンをクリックします。
  選んだプリセットの項目構成が「出力項目」に反映され、プリセットに含まれない項目（商品属性を含む）は非表示になります。
• 「出力項目」で、出力する項目の表示 / 非表示、並び順、項目名を調整します（3-2参照）。
  「すべて表示」「すべて非表示」「printioで更新できない項目を非表示」ボタンで、まとめて切り替えることもできます。
• 画面下部の「登録」ボタンをクリックします。

「プリセットの反映」で選べる既定のフォーマットは次の3種類です。各項目の役割は「4-2. 使用できる項目の一覧」をご覧ください。

3-2. 出力項目の設定

出力項目で選べる項目と、それぞれの役割（行の特定に使う項目・更新する値・出力専用の項目など）は「4-2. 使用できる項目の一覧」をご覧ください。

• 表示 / 非表示：
  各項目の右端のスイッチで切り替えます。表示にした項目だけがCSVに出力されます。
• 並び順：
  各項目の左端のドラッグアイコンで変更します。ここで並べた順番が、そのままCSVの列の順番になります。
• 旧名称を使用する：
  チェックを入れると、CSVの1行目に旧「オプション◯◯」の項目名で出力します。旧管理画面から出力したCSVと同じ項目名で運用したい場合に使います。
  チェックボックスが表示されるのは、名称が変わった6項目（バリエーション特定コード指定 / バリエーション独自コード / バリエーション１項目 / バリエーション２項目 / バリエーション１ID / バリエーション２ID）だけです。
• 商品属性：
  ショップで定義した商品属性も出力項目として選べます。「商品属性」のラベルが付き、CSVには「属性:（属性名）」の項目名で出力されます。
• 「※アップロード時いずれか必須」のラベル：
  行の特定に使う項目に付きます（商品の特定：システム商品コード / 独自商品コード / 商品ID、バリエーションの特定：バリエーション１項目 / バリエーション独自コード / バリエーション１ID）。
  アップロードにも使うフォーマットでは、それぞれいずれか1つ以上を表示にしてください。
• 「更新専用」のラベル：
  「商品ID」「バリエーション１ID」「バリエーション２ID」に付きます。これらの項目で行を特定するCSVでは、既存のバリエーションの更新だけが行われ、新規追加はできません（4-3参照）。
• 「ダウンロード専用」のラベル：
  「ネームラベル」など、CSVに出力するだけの項目に付きます。アップロードしても値は更新されません。
• 「商品特定コード指定」「バリエーション特定コード指定」：
  そのフォーマットでダウンロードしたときに入る値（例：「ダウンロード時の値：1（バリエーション項目名で特定）」）が表示されます。値の意味は4-3をご覧ください。
• printioで更新できない項目を非表示：
  printio商品では「数量」とAmazon連携の項目（ASIN / Amazon出品者SKU / Amazon出品価格）を更新できません。値を変更すると、アップロード時にその行がエラーになります。
  このボタンをクリックすると、これらの項目をまとめて非表示にでき、printio商品の更新に使うフォーマットを作れます。

3-3. アップロードに使えない組み合わせの警告

このフォーマットで出力したCSVをそのままアップロードできない組み合わせの場合、登録・編集画面、登録・保存時の確認ダイアログ、フォーマット一覧、ダウンロードのモーダルに警告が表示されます。
「出力する項目がありません。1つ以上を表示にしてください。」以外は、登録もダウンロードも妨げません。

3-4. 編集・コピー・削除

• 編集：
  一覧画面でフォーマット名をクリックし、内容を変更して「保存」します。
• コピーして新規登録：
  編集画面の「その他」ボタン→「コピーして新規登録」を選ぶと、そのフォーマットの内容をもとに新しいフォーマットを登録できます。
• 削除：
  編集画面の「その他」ボタン→「削除」を選び、確認ダイアログで実行します。
  削除したフォーマットは元に戻せません。

3-5. 注意事項

• 新しい項目（商品属性の追加など）がシステムに増えた場合、既存のフォーマットにも非表示の状態で末尾に追加されます。使いたい場合は編集画面で表示に切り替えてください。
• すでに保存したフォーマットの並び順は、システム側の初期の並び順が変わっても影響を受けません。
• Amazon連携の契約が終了した場合、Amazon関連の3項目はフォーマットから自動的に除外されます。
• フォーマットの読み込みに失敗した場合は、エラーメッセージと「フォーマット管理へ戻る」ボタンが表示されます。時間をおいて開き直してください。

4. CSVファイルの作成

アップロードするCSVファイルの作り方です。
「ダウンロード」で出力したCSVを編集して使うのが基本です。出力する項目は「フォーマット管理」で決められます。

4-1. CSVの構成

この機能は1行目に書かれた項目名で列を読み取ります。

• 列の順番は自由です。「販売価格」を「数量」より右に置いても、いちばん左に置いても同じように読み取ります。
• 必要な列だけ書けば取り込めます。
  たとえば数量だけを更新したいなら、行を特定する項目と「数量」だけのCSVで構いません。
• 知らない項目名が混ざっていても取り込めます。
  取り込まれない列は、確認時に「スキップされた項目」として画面に表示されます。
• 旧「オプション◯◯」という項目名もそのまま使えます。
  旧管理画面から出力したCSVを、そのままアップロードできます。
• 項目名の前後の空白は無視します。「バリエーション１項目」などの「１」「２」は全角で書きます。
  「バリエーション1項目」のように半角で書くと、知らない項目名としてスキップされます。

各行の列数は、1行目の列数と比べてチェックします。

4-2. 使用できる項目の一覧

CSVの1行目に書くと読み取られる項目名は次の通りです。
「旧名称」は旧管理画面（オプション一括登録・修正）の項目名で、どちらの書き方でも取り込めます。

4-3. 行の特定方法

CSVの各行がどのバリエーションを指しているかは、1行目の項目名で決まります。
1行目に「商品ID」または「バリエーション１ID」があるかどうかで、ID指定 / コード・項目名指定のどちらかになります。画面の「未登録のバリエーションを新規追加する」の設定とは関係ありません。

ID指定のCSVに「システム商品コード」「独自商品コード」の列がある場合、コード・項目名指定のCSVに「バリエーション２ID」の列がある場合は、その列は読み取られず「スキップされた項目」として表示されます。
コード・項目名指定では、1行目にある項目によって、商品とバリエーションそれぞれの特定方法が次のように決まります（上から順に判定します）。

4-4. 入力できる値

文字数はすべて、全角・半角の区別なく1文字として数えます。

4-5. 空欄と「NULL」の扱い

4-6. ファイル全体が取り込めないケース

次の場合は、行単位のエラーではなくファイル全体が取り込めません。確認の段階でメッセージが表示され、「アップロード」ボタンは押せません。