商品CSVのフォーマットについて

東海林 愛2024-10-30

これまでの旧CSVテンプレートでは、LEEEPに商品を一括で登録および更新することのみが可能でしたが、最新版CSVテンプレートをご利用いただくことで、商品のSKU情報や在庫情報なども登録・更新できるようになりました。

なお、旧CSVテンプレートは2024年12月31日をもって廃止されておりますので、あらかじめご了承ください。

最新版CSVテンプレートはこのような場合におすすめです

  • 投稿にSKU単位で商品を紐づけ、お客様にお見せしたい場合

  • 投稿に紐づけている商品のうち、在庫切れの商品を表示したくない場合

  • SKUを考慮したサムネイル画像を設定したい場合

最新版CSVフォーマットの仕様は以下の通りです。

CSVファイルのヘッダー行(列名)は変更しないでください。

  • ヘッダーの編集や削除を行うと、アップロード時にエラーが発生します。

  • 項目には商品項目SKU項目の属性があります。

    • 商品項目:商品としての属性を表します。

    • SKU項目:SKUとしての属性を表します。

    • 商品単位の項目のみを更新したい場合、SKU項目のデータは空欄のままで構いません。

  • CSVとして必須な項目は次の通りです。

    • 商品単位の新規登録および更新時:product_id のみ

    • SKU単位の新規登録および更新時:product_idsku_code

  • 必須でない項目について空欄でアップロードした場合、新規登録か更新かで挙動が変わります。

    • 新規登録:デフォルト値が反映されます。

      • 各項目のデフォルト値については表をご確認ください。

    • 更新:以前のデータが保持されます。

  • 優先SKUフラグ(is_primary_sku) について

    • sku_codeが指定されている場合、その行は「SKU特化のデータ」であることを表します。

    • 優先SKUフラグは、その行が「対象商品を代表するデータ」でもあることを表します。

    • 優先SKUフラグにより、対象行の取り込み挙動は以下のように変化します。

      • 商品が取り込み済みの場合

        • 優先SKUの場合:商品項目・SKU項目を更新します

        • 優先SKUではない場合:SKU項目のみ更新します

      • 商品が未取り込みの場合

        • 優先SKUフラグによらず、商品項目・SKU項目を利用して新規作成

  • レビュー依頼スキップ商品について

    • レビュー依頼のスキップは、商品単位でのみ登録可能です。

      SKU単位での設定には対応しておりませんので、あらかじめご了承ください。

  • 在庫情報について

    • API連携により、以下のカートシステムをご利用の場合、在庫情報が自動で連携されます。

      • 商品単位で対応:Shopify、ColorMe、makeshop

      • SKU単位で対応:Shopifyのみ

以下に、最新版CSVテンプレートの各項目の説明を記載しておりますので、ご活用ください。

※商品登録の手順については、こちらのページをご確認ください。

項目名

サンプル値

フォーマット

デフォルト値

product_id(商品番号)

商品項目

L873291

半角英数

※必須

-

sku_code(SKUコード)

SKU項目

L873291_009_W

半角英数

※必須

空文字

jan_code(JANコード)

SKU項目

978494999956

数字のみ

空文字

product_name(商品名)

商品項目

SSシャツ

任意文字列

空文字

product_description(商品説明)

商品項目

ボリュームスリーブがフェミニンな印象のシャツです。

任意文字列

空文字

sku_description(SKU説明)

SKU項目

鮮やかなグリーンがおすすめポイントです。

任意文字列

空文字

brand_code(ブランドコード)

商品項目

brandXXX

半角英数

※LEEEPに複数のブランドを連携している場合にご入力ください。

※ブランドコードはこちらからご確認ください。

自身のウェブサイトに紐づけられた最初のブランド

category_code(親カテゴリコード)

商品項目

tops

半角英数

空文字

category_name(親カテゴリ名)

商品項目

トップス

任意文字列

空文字

sub_category_code(子カテゴリコード)

商品項目

shirts

半角英数

空文字

sub_category_name(子カテゴリ名)

商品項目

シャツ

任意文字列

空文字

gender_code(性別コード)

商品項目

mens

半角英数

空文字

gender_name(性別名)

商品項目

メンズ

任意文字列

空文字

color_code(カラーコード)

SKU項目

green

半角英数

空文字

color_name(カラー名)

SKU項目

グリーン

任意文字列

空文字

size_code(サイズコード)

SKU項目

s

半角英数

空文字

size_name(サイズ名)

SKU項目

S

任意文字列

空文字

price(定価 (税込))

商品項目

SKU項目

2200

数値のみ

0

selling_price(販売価格 (税込))

商品項目

SKU項目

1650

数値のみ

0

product_url(商品詳細URL)

商品項目

SKU項目

https://www.sample.jp/item/detail/001

最大2000文字

※プロトコルも省略せずご入力ください。

URLなし

image_url(商品画像URL)

商品項目

SKU項目

https://www.sample.jp/image.jpg

最大2000文字

※SKU情報を登録・更新する場合はSKU毎に設定してください。

画像なし

stock(EC在庫数(メーカー品番単位))

商品項目

10

数値のみ

0

stock_sku(EC在庫数 (メーカーSKUコード単位))

SKU項目

5

数値のみ

0

is_public(商品公開フラグ)

商品項目

SKU項目

1

0 : 非公開商品、1 : 公開中商品

※0の商品はAPIで返却されません。

0

is_primary_sku(優先SKUフラグ)

SKU項目

1

0 : 優先SKUではない、1 : 優先SKU

※同じメーカー品番のうち主となるメーカーSKUコード

0

is_skip_review_request(レビュー依頼スキップフラグ)

商品項目

1

0 : レビュー依頼対象、1 : レビュー依頼スキップ対象

※SKU単位では設定できません。商品単位でご登録ください。

0

<関連記事>