自社フォーマットで商品を登録するCSV アップロードと手動登録、バリエーション商品の書き方

自社フォーマットは、CataMap が定める最小構成の商品 CSV です。モール固有の列を持たないので、同じファイルを楽天市場のカタログにも Yahoo!ショッピングのカタログにもアップロードできます。登録した商品はモール CSV から取り込んだ商品と同じように AI 判定・CSV 出力の対象になります。

• 単品商品: 1 行に 1 商品を書きます。
• バリエーション商品（カラー・サイズなど）: 1 行に 1 SKU を書き、同じ商品管理番号の行を 1 商品としてまとめます。
• 手動登録: 1 件ずつ画面から登録することもできます（バリエーションにも対応）。

サイドバーの「カタログ」横の「＋」か、カタログ一覧の「新規カタログを作成」を押します。連携先モール（出力したい CSV のモール）とカタログ名を入れ、登録経路は「手動でカタログを作成」を選んで作成します。

作成直後のカタログは商品が 0 件です。「CSVをアップロード」ボタンの下にある「テンプレートCSVをダウンロード」を押すと、列名と見本行が入った catamap-item-template.csv が保存されます （CSV アップロードのダイアログ内にも同じリンクがあります）。

見本行は「単品 1 行」と「バリエーション商品 1 件（4 SKU）」です。書き方の参考にしたうえで、 アップロード前に削除するか自社の商品で上書きしてください。

1 行目は列名です。列名は変更せず、順番の入れ替えと不要な列の削除は自由です（列は名前で読み取ります）。

商品の列

バリエーション（SKU）の列

単品商品ではこれらの列は空欄のままにします。

テンプレートを Excel で開き、1 行に 1 商品を書きます。バリエーションの列（SKU管理番号・バリエーション1〜3・SKU画像URL）は空欄のままにします。

カラーやサイズで SKU が分かれる商品は、SKU の数だけ行を作り、すべての行に同じ商品管理番号を入れます。各行の SKU管理番号 に SKU のコード、バリエーション1項目名 と バリエーション1選択肢 に軸の名前と値を入れます。

書き方のルール

1. 1 行 = 1 SKU。同じ商品管理番号の行が 1 商品にまとまります。行が離れていても構いません。
2. 商品名・商品説明・画像URL は最初の行だけに書けば足ります（2 行目以降に同じ値を繰り返しても構いません）。
3. 項目名（カラー・サイズなど）は全 SKU 行で同じ名前にします。Excel では最初の行に入力してフィルハンドルで下に複写するのが確実です。
4. 軸の値は バリエーション1選択肢・バリエーション2選択肢… に書きます。同じ組み合わせ（赤 × S など）の SKU を 2 つ作ることはできません。
5. SKU管理番号 は商品内で一意にします。半角英数字とハイフン（例: item-0002-01）を推奨します。
6. 軸は最大 3 つ、選択肢は 1 軸あたり最大 40 個、SKU は 1 商品あたり最大 400 件です。

編集が終わったら、Excel の 「ファイル」→「名前を付けて保存」を開き、ファイル形式で「CSV UTF-8（コンマ区切り）(.csv)」を選んで保存します。

商品一覧の 「CSVアップロード」を押し、保存した CSV をドラッグ＆ドロップするか「ファイルを選択」で指定して「アップロード」を押します。 フォーマットはヘッダー行から自動で判定されるので、モール CSV と自社フォーマットの切り替え操作はありません。

完了画面には登録した商品数と、バリエーション商品があればその件数・軸の数・SKU 総数が表示されます。 スキップした行や除外した画像 URL があれば、理由が行番号つきで一覧に出ます（よくあるエラーと対処）。

一覧に戻ると、バリエーション商品には 「N SKU」のバッジが付きます。バッジをクリックすると SKU の一覧が展開され、SKU管理番号とカラー・サイズの組み合わせを確認できます。

数点だけ登録したいときは、商品一覧の 「手動追加」から 1 件ずつ登録できます。商品コード・商品名・商品説明・画像URL を入れ、バリエーションがある商品は「バリエーションがある商品」をオンにします。

1. 軸ごとに項目名（例: カラー）と選択肢（例: 赤, 青 — カンマ・読点・改行区切り）を入れます。「軸を追加」で最大 3 軸まで増やせます。
2. 「SKU を生成」を押すと、選択肢の組み合わせが表になります。SKU管理番号は「商品コード-01」のような連番が入るので、必要に応じて書き換えます。
3. 存在しない組み合わせ（例: 白 × L は作らない）は、行のチェックを外します。
4. 「登録する」を押すと、CSV で取り込んだときと同じ形で商品と SKU が登録されます。

同じカタログに同じ商品管理番号でアップロードすると、その商品は上書きされます。次の点を押さえておくと安心です。

• 商品名・商品説明・画像URL は最新の CSV の値になります。AI 判定の結果（カテゴリ・属性）は保持されます。
• 判定後に商品名や説明・画像・SKU 構成が変わった商品は「判定後にデータが変わった」商品として扱われ、 モールへの反映前に再判定が必要になります。
• バリエーション商品（SKU 行あり）は CSV の SKU 一覧が正になります。CSV から消えた SKU は削除され、増えた SKU は追加されます。
• 単品行（SKU管理番号が空）で再アップロードしても、既存のバリエーション構成には触れません。バリエーション商品を単品に戻したい場合は、いったん商品を削除してから登録し直してください。
• ファイル内に同じ SKU管理番号の行が 2 つ以上あると、あとの行はスキップされます。

アップロード完了画面の一覧に出るメッセージと、その直し方です。行番号は CSV の行（1 行目が列名）を指します。