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

LEEEP2024-10-30

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

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

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

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

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

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

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

CSVのヘッダー名(列名)は、指定の名前を使用してください。列の順序は変更できます。

基本25列は、値を入力しない場合もヘッダーを残してください。次の5列は任意で追加・省略できます。

  • maker_product_code(メーカー品番)

  • maker_jan_code(メーカーJANコード)

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

  • sales_start_at(販売開始日時)

  • sales_end_at(販売終了日時)

販売開始日時・販売終了日時のヘッダーは、2列をセットで追加してください。

ヘッダー名の変更、基本列の削除、同じ列名の重複、未定義の列の追加は、取込エラーになります。

基本25列は以下のとおりです。

  • product_id,sku_code,jan_code,product_name,product_description,sku_description,brand_code,category_code,category_name,sub_category_code,sub_category_name,gender_code,gender_name,color_code,color_name,size_code,size_name,price,selling_price,product_url,image_url,stock,stock_sku,is_public,is_primary_sku

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

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

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

    • 商品項目のみを登録・更新する場合は、sku_codeを空欄にしてください。この場合、SKUの登録・更新は行いません。

  • ヘッダーとして必要な列と、各行で値の入力が必要な項目は異なります。各行の入力必須項目は、次のとおりです。

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

    • SKU単位の新規登録および更新時:product_idとsku_code

  • 値を空欄にした場合、新規登録では各項目のデフォルト値が適用されます。更新では、商品名・説明・各種コードなどは原則として既存値を保持します。

    ただし、次の項目は扱いが異なります。

項目

更新時に空欄にした場合

stock_sku

SKU在庫を0に更新します

SKU行のis_public

対象SKUを非公開に更新します

is_primary_sku

対象SKUの優先SKU設定を解除します

sales_start_at , sales_end_at

ヘッダーがある場合、空欄にした側の販売期間の制限を解除します

  • SKU行の在庫・公開フラグ・優先SKUフラグは、更新する値を明示してください。

  • メーカー品番・メーカーJANコードは、値を空欄にした場合も、ヘッダーを省略した場合も既存値を保持します。空欄による値の削除はできません。

  • 販売期間は、2列のヘッダーを省略した場合、既存値を保持します。

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

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

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

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

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

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

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

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

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

    • 優先SKUに関する補足:

      • 優先SKU以外の行でも、stockを入力した場合は商品単位の在庫を更新します。

      • 非公開の優先SKU行では、商品画像・商品価格など一部の商品代表情報は更新されません。

      • 優先SKUは、同じproduct_idに属するSKUの中で設定します。別のSKUを優先SKUにすると、それまでの優先SKU設定は解除されます。

      • 既存商品のメーカー品番をSKU行から更新する場合は、優先SKU行に値を入力してください。

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

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

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

  • 在庫情報について

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

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

      • SKU単位で対応:Shopifyのみ

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

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

項目名

サンプル値

フォーマット

デフォルト値

product_id(商品番号)

商品項目

L873291

半角英数

※必須

-

maker_product_code(メーカー品番)商品項目

MK-AB1234

任意文字列・最大255文字。入力は任意

空文字

sku_code(SKUコード)SKU項目

L873291_009_W

半角英数。SKU単位の新規登録・更新時は必須

空文字

jan_code(JANコード)

SKU項目

978494999956

半角英数

空文字

maker_jan_code(メーカーJANコード)SKU項目

0123456789012

任意文字列・最大255文字。入力は任意

空文字

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:公開。商品とSKUの公開状態を設定します。詳細は下記「公開状態について」をご確認ください。

0

is_primary_sku(優先SKUフラグ)

SKU項目

1

0:優先SKUではない、1:優先SKU。同じproduct_idに属するSKUのうち、商品を代表するSKUに1を設定してください。

0

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

商品項目

1

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

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

0

sales_start_at(販売開始日時)商品項目 SKU項目

2026-11-01 00:00:00

日時。タイムゾーン指定がない場合は日本時間

制限なし

sales_end_at(販売終了日時)商品項目 SKU項目

2026-12-01 00:00:00

日時。タイムゾーン指定がない場合は日本時間

制限なし

メーカー品番・メーカーJANコードについて

メーカー品番は商品単位、メーカーJANコードはSKU単位で保存します。product_id・sku_code・jan_codeとは別項目で、商品・SKUの識別には引き続きproduct_id・sku_codeを使用します。

前後の空白は除去されます。メーカーJANコードは文字列として扱うため、Excel等で編集する際は先頭の0が失われないようご注意ください。

販売期間について

開始・終了の両方を指定する場合は、開始日時を終了日時より前に設定してください。SKU行では対象SKUにも販売期間を設定します。

公開状態について

商品を非公開にする場合は、商品側に加えて、登録済みのすべてのSKUを非公開にしてください。公開SKUが残っている場合、商品は公開状態に補正されます。

SKU単位の非公開設定だけで、すべての表示・APIから対象SKUが除外されるわけではありません。

<関連記事>