アップロードフォーマット
変更履歴
2026年8月26日
商品アップロードフォーマット（CSV） 以下フィールド名の入力方法の記述を変更いたしました。
options オプション
各全角28文字（半角56文字）以内 → 全角200文字（半角400文字）以内
2026年5月21日
商品アップロードフォーマット（CSV）以下フィールド名を追加
person-sale-limit 注文回数制限
フィールド名「sale-limit」の項目名・説明の変更
購入数制限 → 1注文あたりの購入数制限
購入数の制限を入力 → 1注文あたりの購入数の制限を入力
2026年2月19日
フィールド名 海外向け購入代行の除外設定 の記載が誤っておりましたので訂正いたしました。
（誤）isCrossBorderAgency
（正）cross-border-agency-flag
リリース後の訂正となり申し訳ございません。お詫び申し上げます。
2026年2月6日
商品アップロードフォーマット（CSV）以下フィールド名の内容を訂正しました。
isCrossBorderAgency
「購入代行サービスへの掲載可否」→「海外向け購入代行の除外設定」
true：許可 → 1：除外しない
false：不許可 → 0：除外する
2026年2月4日
商品アップロードフォーマット（CSV）以下パラメータが削除されたことを追記しました。
・sub-code で指定する pick_and_delivery_code
2026年2月2日
商品アップロードフォーマット（CSV）以下フィールド名を追加しました。
isCrossBorderAgency（購入代行サービス設定）
2026年1月22日
商品アップロードフォーマット（CSV）以下フィールド名を追加しました。
・variation1～5-free-title（バリエーション1～5 - 項目名）
2025年12月17日
Y!プレミアム会員に関連する記載を変更しました。
「Y!プレミアム会員」→「LYPプレミアム会員」
2025年12月8日
商品アップロードフォーマット（CSV）に以下フィールド名を追加しました。
item-social-gift-type 商品ごとのソーシャルギフト機能の提供可否設定
2025年11月12日
「ECOチャレンジ」終了に伴い、下記フィールド名を削除いたします。
eco-setting-id（環境ラベル / エコキーワード）
eco-setting-evidence-url（環境ラベル / エコキーワードのエビデンスURL）
フィールド名 商品の状態（Condition）の説明を追記しました。
※2026年6月に「1：中古」は廃止になります。
2025年5月16日
以下のフィールドを追加いたしました。
grouping-id グルーピングID
variation1-spec-id variation2-spec-id variation3-spec-id variation4-spec-id variation5-spec-id バリエーション設定1～5-スペック
variation1-name variation2-name variation3-name variation4-name variation5-name バリエーション設定1～5-表示名
API更新後のよりご利用いただけておりましたが、更新後のご案内となり申し訳ございません。お詫び申し上げます。
2024年10月30日
LINEギフトに関連する記載を変更しました。
「LINEギフト」→「LINE」
2024年5月24日
ドキュメントを最新化しました。
・下記項目の「備考」に説明文言を追記しました。
sub-code、original-price、price、sale-price、member-price、options、point-code、jan、delivery、condition、lead-time-instock、lead-time-outstock、reserve-price、reserve-sale-price、reserve-member-price
・下記項目を追加しました。
item-image-urls、subscription-type、subscription-price、subscription-group-index、subscription-recommended-cycle、subscription-point-code、point-immediate、eco-setting-id、eco-setting-evidence-url
・下記項目は廃止済みとなっております。
temporary-point-term、meta-key、yahoo-product-code、astk-code、supplier-type、y-shopping-display-flag
2024年5月13日
フィールド名： "options"に下記説明文言を追加しました。
※オプション項目合計では全角10000文字（半角20000文字）
2024年3月6日
アップロード上限件数を修正しました。
10万件 → 2万件
2024年3月6日に訂正をした商品アップロードAPIのアップロード上限数についてですが、従来より2万件となっておりました。
ドキュメント上の誤記を訂正したものであり、仕様変更ではございません。
ご迷惑をおかけしますこと、謹んでお詫び申し上げます。
（2024年4月19日追記）
2023年10月30日
サービス名称変更に伴い下記文言を修正しました。
ヤフオク!、ヤフオク → Yahoo!オークション
2022年12月07日
プロダクトカテゴリ登録必須化に伴い、下記項目を入力必須で「備考」へ記載しました。
・product-category
2022年07月04日
release-date（発売日）の「備考」を修正しました。
修正前）現在の日付から240日以内で設定可
修正後）現在の日付から365日以内で設定可
2021年09月15日
下記項目を追加しました。・reserve-price
・reserve-sale-price
・reserve-member-price
・reserve-selling-period-start
・reserve-selling-period-end
2021年09月01日
下記項目を追加しました。・linegift_cooperation_flag（LINEギフト出品設定）
・linegift_item_commission（LINEギフト手数料）
・linegift_item_shortname（LINEギフト用商品名）
・linegift_item_image_url（LINEギフト用商品画像）
ご注意
- 商品CSV、在庫CSVアップロードのみ可能です。オプションCSV等はアップロードできません。
- アップロード上限は2万件です。
商品アップロードフォーマット（CSV）
- ファイル形式は、必ずCSV形式にしてください。
- データの1行目には必ず正確なフィールド名（半角英数字）を入力してください。フィールド名を省略したり、独自の項目を入力するとエラーになります。
- 半角カナ、特殊記号、機種依存文字は入力できません。また、各項目ごとに入力可能文字種が異なりますのでご注意ください。
- 各項目は、制限文字数内で入力してください。
- 改行コードはCR/LFまたはLFに変換してください。
- 文字コードは必ずEUCコードかshift-JISコードに変換してください。
- アップロードする前に、データに不要な改行やスペースが含まれていないかを確認してください。MKエディタなど、文字制御コードが表示されるテキストエディターを使用すると確認が容易です。
| フィールド名 | 商品編集ページの項目名 | 説明 | 入力方法 | 備考 | 検索対象 |
|---|---|---|---|---|---|
| path | パス | 商品ページのストア内カテゴリパス | カテゴリ名：全角20文字（半角40文字）以内 | 入力必須（※1） 【例】 レディースファッション：レディース：婦人服：Tシャツ |
|
| カテゴリ階層：8階層以内 | |||||
| カテゴリ間は半角コロン（：）区切り | |||||
| name | 商品名 | 商品名を入力 | 全角75文字（半角150文字）以内 | 入力必須（※1） | ● |
| code | 商品コード | 商品コードを入力 | 半角英数字、ハイフンのみ。99文字以内 | 入力必須（※1） | ● |
| sub-code | 個別商品コード | 個別商品コードを入力 | 1つのコードが半角99文字以内 | 存在するオプションのみ、最大100まで 個別商品コード、オプション、プロダクトカテゴリ、スペック1～5のフィールドはセットで指定してください。 存在するオプションのみ、最大400まで ［例］ option1:value1#option2:value2 ※ヤマト運輸ピック＆デリバリーサービス専用項目「pick_and_delivery_code」は2026年2月に廃止されました。 ※項目を指定してもエラーになりません |
|
| original-price | メーカー希望小売価格 | メーカー希望小売価格を入力 | 半角数字のみ。8文字以内 | オープン価格：0と入力 半角数字のみ。ストア設定で「税込」を選択している場合8文字以内、「税抜」選択で通常税率（10％）の場合：90,909,090以下 軽減税率（8%）の場合：92,592,592以下 メーカー希望小売価格の表示は （1）エビデンスURLの入力 （2）下記対象カテゴリのプロダクトカテゴリコードの入力とJANコードの入力 （1）（2）いずれかの入力が必要です。 【対象カテゴリ】 ・CD、音楽ソフト（2516）配下全て ・DVD、映像ソフト（2517）配下全て ・本、雑誌、コミック（10002）配下全て |
|
| price | 通常販売価格 | 通常販売価格を入力 | 半角数字のみ。8文字以内 | 入力必須（※1） ストア設定で「税込」を選択している場合8文字以内、「税抜」選択で通常税率（10％）の場合：90,909,090以下 軽減税率（8%）の場合：92,592,592以下 |
|
| sale-price | 特価 | セール価格を入力 | 半角数字のみ。8文字以内 | sale-period-start、sale-period-endに入力がある場合のみ有効 「税抜」選択で通常税率（10％）の場合：90,909,090以下 軽減税率（8%）の場合：92,592,592以下 ※通常販売価格と特価の両方を表示させる場合、景品表示法の規制に基づき、通常販売価格は、『特価開始時点からさかのぼる8週間のうち、4週間以上販売していた実績にある価格』で、かつ『セール開始の時点において、最後に販売された日から2週間が経過していない価格』を入力ください。 景品表示法の規制の詳細については、監督官庁に確認いただき、出店者様の責任で適法な価格表示を行うようにしてください。 |
|
| member-price | 会員向け価格 | LYPプレミアム会員向け価格を入力 | 半角数字のみ。ストア設定で「税込」を選択している場合8文字以内、「税抜」を選択している場合は92,592,592以下。 ※通常価格、セール価格より安い価格のみ入力可能です。 |
「会員向け価格」機能は一部出店者様にはご利用いただけません。 | |
| options | オプション | オプションを入力 | オプション項目、オプション値は |
スペックのひも付けも可能 | |
| 「options」に含められる文字数は最大全角10,000文字(半角20,000文字) | |||||
| オプション値は最大100 | |||||
| オプション項目、オプション値に半角記号の|;:&=#"\は不可 | |||||
| 入力欄（inscription）の場合、項目名は全角30文字（半角60文字）、入力文字数は60まで | |||||
| HTML不可 | |||||
| headline | キャッチコピー | 商品のキャッチコピーを入力 | 全角30文字（半角60文字）以内、HTML不可 | ● | |
| caption | 商品説明 | 商品の説明文 | 全角5,000文字（半角10,000文字）以内、HTML可 | ||
| abstract | ひと言コメント | カテゴリページに記載される商品説明 | 全角500文字（半角1,000文字）以内、HTML可 | ||
| explanation | 商品情報 | 商品に関する情報 | 全角500文字（半角1,000文字）以内、HTML不可 | ● | |
| additional1 | フリースペース | 商品の補足説明を入力 | 全角5,000文字（半角10,000文字）以内、HTML可 | ||
| additional2 | フリースペース | 商品の補足説明を入力 | 全角5,000文字（半角10,000文字）以内、HTML可 | ||
| additional3 | フリースペース | 商品の補足説明を入力 | 全角5,000文字（半角10,000文字）以内、HTML可 | ||
| relevant-links | おすすめ商品 | 商品ページに表示させるおすすめ商品の商品コードを入力 | 商品コード間は半角スペース区切り | ||
| 20商品まで指定可半角数字のみ。半角99文字以内 | |||||
| ship-weight | 重量 | 送料/手数料計算で使用する重量単位 | 半角数字のみ。7文字以内半角数字 | ||
| taxable | 課税対象 | 商品の税込み/非課税を指定 | 半角数字のみ。1または0を入力 | 課税：1、非課税：0を入力。空欄の場合は「課税」 | |
| taxrate-type | 軽減税率コード | 商品が軽減税率商品かどうかを指定 | 半角英数字のみ。0.1または0.08を入力 | 通常税率10％：0.1 軽減税率8％：0.08 ※空欄の場合は通常税率10％ |
|
| release-date | 発売日 | 商品の発売日（ポイント、注文管理のみに使用） | 半角数字のみ。YYYYMMDD形式 | 現在の日付から365日以内で設定可 【例】20071001（2007年10月1日） |
|
廃止済み |
|||||
| point-code | ポイント倍率 | 商品のポイント倍率を指定する場合にpoint-codeの値を入力 | 空欄もしくは「1～15」の半角英数字 | Yahoo!ショッピングがコードを提供。入力するとストアポイントより優先して倍率適用。point-code一覧はこちらのページ下部を参照。 | |
| 廃止済み | |||||
| キーワード間は半角パイプ（|）区切り | |||||
| meta-desc | META description | 商品の説明文 | 全角80文字（半角160文字）以内 | ||
| フィールド名 | 商品編集ページの 項目名 |
説明 | 入力方法 | 備考 | 検索対象 |
| display | ページ公開 | ページの公開/非公開を入力 | 半角数字のみ。1または0を入力 | 公開：1、非公開：0と入力。空欄の場合は「公開」 | |
| template | 使用中のテンプレート | テンプレートを指定 | 半角英数字のみ。4文字以内 | 「商品ページテンプレート設定」ページでテンプレート名の後に表示されている文字列を入力 【例】テンプレート名（IT01）と表示されている場合は「IT01」と入力 |
|
| sale-period-start | 販売期間（開始日） | セール開始日時 | 半角数字のみ。YYYYMMDDHHMM形式 | 【例1】2007100115（2007年10月1日午後3時00分） 【例2】200710011520（2007年10月1日午後3時20分） |
|
| sale-period-end | 販売期間（終了日） | セール終了日時 | 半角数字のみ。YYYYMMDDHHMM形式 | 【例1】2007100810（2007年10月8日午前10時00分） 【例2】200710081020（2007年10月8日午前10時20分） |
|
| sale-limit | 1注文あたりの購入数制限 |
1注文あたりの購入数の制限を入力 |
半角数字のみ。1～999を入力 | ||
| sp-code | 販促コード | キャンペーンコード | 半角英数字のみ。10文字 | Yahoo!ショッピングがコードを提供 | |
| brand-code | ブランドコード | ブランドコードを入力 | 半角数字のみ。10文字以内 | Yahoo!ショッピングがコードを提供 | |
廃止済み |
|||||
| product-code | 製品コード | 製品のメーカー品番/型番を入力 | 半角英数字と記号（ +-*/()&:~～.@!#?_ ）のみ。50文字以内 | ● | |
| jan | JANコード/ISBNコード | JANコード/ISBNコードを入力 | 半角数字のみ。13文字以内 | ※「isbn」は「jan」に統合したため、こちらに入力してください | ● |
| delivery | 送料無料 | 送料無料の設定 | 半角数字のみ。0、1、3のいずれかを入力。 | なし（送料がかかる場合）：0、無料：1、条件付送料無料：3を入力 空欄の場合は「なし」 ※「送料込み：2」は2013年9月18日（水）に廃止しましたが、「無料：1」に変換されます。 |
|
「きょうつく」 翌日配達 「あすつく」の設定 |
0、1、2のいずれかを入力 |
あすつく対応：1 きょうつく対応：2を入力 空欄の場合は「非対応」 廃止済み |
|||
| condition | 商品の状態 | 商品の状態の設定 | 半角数字のみ。 0、1のいずれかを入力。 |
0 : 新品 1 : 中古 （※ 2 : 新品：Yahoo!オークション併売 ※Yahoo!オークション併売プラン限定 3 : 中古：未使用 4 : 中古：未使用に近い 5 : 中古：目立った傷や汚れなし 6 : 中古：やや傷や汚れあり 7 : 中古：傷や汚れあり 8 : 中古：全体的に状態が悪い 空欄の場合は「新品」 ※2026年6月に「1：中古」は廃止になります。 中古設定は3〜8を指定してください。 |
|
| product-category | プロダクトカテゴリ | 商品カテゴリを入力 | 半角数字のみ。10文字以内 | 入力必須（※1） Yahoo!ショッピングがコードを提供 |
|
| spec1 | スペック | スペック項目とスペック値を入力 |
半角数字のみ、項目と値をパイプ（|）で区切って入力。各10文字以内 ※2015年10月1日以降の仕様 半角数字、ピリオド（数値を入力する場合）のみ。項目と値をパイプ（|）、値はコロン（:）で区切って入力。各10文字以内。 |
Yahoo!ショッピングがコードを提供 【例】84|461（スペック項目のコードが84、スペック値のコードが461） ※2015年10月1日以降の仕様 【例】84|461:511:193 （スペック項目のコードが84、スペック値のコードが461、511、193） |
|
| spec2 | スペック | スペック項目とスペック値を入力 |
半角数字のみ、項目と値をパイプ（|）で区切って入力。各10文字以内 ※2015年10月1日以降の仕様 半角数字、ピリオド（数値を入力する場合）のみ。項目と値をパイプ（|）、値はコロン（:）で区切って入力。各10文字以内。 |
Yahoo!ショッピングがコードを提供 【例】84|461（スペック項目のコードが84、スペック値のコードが461） ※2015年10月1日以降の仕様 【例】84|461:511:193 （スペック項目のコードが84、スペック値のコードが461、511、193） |
|
| spec3 | スペック | スペック項目とスペック値を入力 |
半角数字のみ、項目と値をパイプ（|）で区切って入力。各10文字以内 ※2015年10月1日以降の仕様 半角数字、ピリオド（数値を入力する場合）のみ。項目と値をパイプ（|）、値はコロン（:）で区切って入力。各10文字以内。 |
Yahoo!ショッピングがコードを提供 【例】84|461（スペック項目のコードが84、スペック値のコードが461） ※2015年10月1日以降の仕様 【例】84|461:511:193 （スペック項目のコードが84、スペック値のコードが461、511、193） |
|
| spec4 | スペック | スペック項目とスペック値を入力 |
半角数字のみ、項目と値をパイプ（|）で区切って入力。各10文字以内 ※2015年10月1日以降の仕様 半角数字、ピリオド（数値を入力する場合）のみ。項目と値をパイプ（|）、値はコロン（:）で区切って入力。各10文字以内。 |
Yahoo!ショッピングがコードを提供 【例】84|461（スペック項目のコードが84、スペック値のコードが461） ※2015年10月1日以降の仕様 【例】84|461:511:193 （スペック項目のコードが84、スペック値のコードが461、511、193） |
|
| spec5 | スペック | スペック項目とスペック値を入力 |
半角数字のみ、項目と値をパイプ（|）で区切って入力。各10文字以内 ※2015年10月1日以降の仕様 半角数字、ピリオド（数値を入力する場合）のみ。項目と値をパイプ（|）、値はコロン（:）で区切って入力。各10文字以内。 |
Yahoo!ショッピングがコードを提供 【例】84|461（スペック項目のコードが84、スペック値のコードが461） ※2015年10月1日以降の仕様 【例】84|461:511:193 （スペック項目のコードが84、スペック値のコードが461、511、193） |
|
| spec6 この項目は2015年10月1日以降指定可能になります。 |
スペック | スペック項目とスペック値を入力 | 半角数字、ピリオド（数値を入力する場合）のみ。項目と値をパイプ（|）、値はコロン（:）で区切って入力。各10文字以内。 | Yahoo!ショッピングがコードを提供 【例】84|461:511:193 （スペック項目のコードが84、スペック値のコードが461、511、193） |
|
| spec7 この項目は2015年10月1日以降指定可能になります。 |
スペック | スペック項目とスペック値を入力 | 半角数字、ピリオド（数値を入力する場合）のみ。項目と値をパイプ（|）、値はコロン（:）で区切って入力。各10文字以内。 | Yahoo!ショッピングがコードを提供 【例】84|461:511:193 （スペック項目のコードが84、スペック値のコードが461、511、193） |
|
| spec8 この項目は2015年10月1日以降指定可能になります。 |
スペック | スペック項目とスペック値を入力 | 半角数字、ピリオド（数値を入力する場合）のみ。項目と値をパイプ（|）、値はコロン（:）で区切って入力。各10文字以内。 | Yahoo!ショッピングがコードを提供 【例】84|461:511:193 （スペック項目のコードが84、スペック値のコードが461、511、193） |
|
| spec9 この項目は2015年10月1日以降指定可能になります。 |
スペック | スペック項目とスペック値を入力 | 半角数字、ピリオド（数値を入力する場合）のみ。項目と値をパイプ（|）、値はコロン（:）で区切って入力。各10文字以内。 | Yahoo!ショッピングがコードを提供 【例】84|461:511:193 （スペック項目のコードが84、スペック値のコードが461、511、193） |
|
| spec10 この項目は2015年10月1日以降指定可能になります。 |
スペック | スペック項目とスペック値を入力 | 半角数字、ピリオド（数値を入力する場合）のみ。項目と値をパイプ（|）、値はコロン（:）で区切って入力。各10文字以内。 | Yahoo!ショッピングがコードを提供 【例】84|461:511:193 （スペック項目のコードが84、スペック値のコードが461、511、193） |
|
| ※商品表示順序を指定する場合は「sort_priority」を設定してください。 | |||||
| sort_priority | 商品表示優先度 | カテゴリ内での表示序を入力 | 半角数字1～9999999、空白 | 入力数字の重複や空欄の場合は、ストアカテゴリの商品並び順設定の順（おすすめ順/新着順のいずれか）で表示されます。 ※商品表示優先度を指定したカテゴリに『リンク先』商品ページが含まれている場合、【リンク元】商品ページのみ順序が変動し、 『リンク先』商品ページの順序の変更を行うことは出来ません。『リンク先』商品ページの順序変更は、商品管理画面から、直接変更作業を行うことで可能です。 |
|
| sp-additional | スマートフォン用フリースペース | スマートフォン用商品の補足説明を入力。 | 全角5,000文字以内（半角10,000文字以内）、画像込みの総容量2000キロバイト以内（600キロバイトまでを推奨） 、HTML可 | 総容量オーバーのエラーが出た場合は、ストアエディターのページ編集＞商品ページ編集＞スマートフォン用情報に入力、保存ボタンを押下して現在の容量をご確認ください。 | |
| original-price-evidence | エビデンスURL | メーカー希望小売価格のエビデンスURLを入力 | URL形式のみ | ||
| lead-time-instock | 発送日情報 | 在庫設定があり在庫数が1以上 | 発送日情報管理番号（在庫があり時に表示したい発送日表示文言の設定） | ストア構築＞カート設定＞お届け情報設定で設定した「発送日情報管理番号」を入力 | |
| lead-time-outstock | 発送日情報 | 在庫数設定なし、または在庫数の設定があり在庫数が0以下 | 発送日情報管理番号（在庫が切れ時に表示したい発送日表示文言の設定） | ストア構築＞カート設定＞お届け情報設定で設定した「発送日情報管理番号」を入力 | |
| keep-stock | 注文者からのキャンセル時、在庫を元に戻す設定 | 0:キャンセル時在庫を元にさない 1:キャンセル時在庫を元に戻す(初期値) |
|||
| postage-set | 配送グループ | ストアクリエイタProで設定した配送グループの「管理番号」を入力 | 半角数字のみ （1～20） |
以下はエラー ・存在しない配送グループ管理番号 ・数値以外の入力 ・1～20以外の数値 ・複数入力 空でアップロードされた場合、更新を行いません。 |
|
| is-drug | 第1類医薬品 | 第1類医薬品の場合入力 | 半角数字のみ。0または1を入力 | 通常商品：0、第1類医薬品：1を入力 空欄の場合は「変更なし」 | |
※PayPayモール出店者様限定 |
1、2、3を入力 |
正規販売・輸入代理店品:2 並行輸入品、他:3 初期設定は「選択なし」です。『選択なし』『並行輸入品、他』はPayPayモール内では非表示になります。非表示対象商材の場合はPayPayモールストア内検索、Yahoo!ショッピングでは表示されます。 廃止済み |
|||
※ストア内検索には表示されます。 |
1、0を入力 |
非表示:0 廃止済み |
|||
| linegift_cooperation_flag ※LINE出店者様限定 |
LINE出品設定 | LINEへ商品を表示するか否かの設定 | 半角数字のみ1、0を入力 |
出品しない：0 （初期値） 出品する：1 ※注意点 ・「ページ公開設定」が「非公開」の商品は出品設定がされていてもLINEに掲載されません。 ・「隠しページ設定」が「隠しページ」の商品はLINE上でも検索やトップページには掲載されませんが商品ページへのアクセスは可能（注文可能）となります。 |
|
| linegift_item_commission ※LINE出店者様限定 |
LINE手数料 | 全国一律の送料、ギフト梱包料など諸経費を含めた金額 | 半角数字のみ、8文字以内 | 商品価格にLINE手数料を加算した金額がLINEでの販売価格となります | |
| linegift_item_shortname ※LINE出店者様限定 |
LINE用商品名 | LINEで使用する商品名 | 全角、半角20文字以内 | LINE出品設定が1: 出品するの場合は必須 半角カナを利用された場合、LINEページ上では全角に変換されて表示されます。 |
|
| linegift_item_image_url ※LINE出店者様限定 |
LINE用商品画像 | LINEで使用する商品画像のURL | URL形式のみ |
LINE出品設定が1: 出品するの場合は必須 Yahoo!ショッピング 追加画像の仕様と同様となります。詳細は下記マニュアルをご参照ください。 ストアクリエイタProマニュアル - 画像管理の概要 ファイル形式：拡張子は.gif/.jpg/.jpe/.jpeg /.pngのみ ファイルサイズ：500キロバイト以下 ファイル名：半角英数字、ハイフン（ - ）、アンダーバー（ _ ）、ピリオド（ . ）のみ使用可 画像サイズ：縦1250ピクセル、横1250ピクセル以内 URL形式：https://shopping.c.yimg.jp/lib/ストアアカウント/ファイル名.拡張子 |
|
| reserve-price | 自動切替設定：通常販売価格 | 切替期間の通常販売価格を入力 | 半角数字のみ。ストア設定で「税込」を選択している場合8文字以内、「税抜」を選択している場合は92,592,592以下 | 「価格の自動切替設定」利用の場合は必須 ストア設定で「税込」を選択している場合8文字以内、「税抜」選択で通常税率（10％）の場合：90,909,090以下 軽減税率（8%）の場合：92,592,592以下 |
|
| reserve-sale-price | 自動切替設定：セール価格 | 切替期間のセール価格を入力 | 半角数字のみ。ストア設定で「税込」を選択している場合8文字以内、「税抜」を選択している場合は92,592,592以下 | 自動切替設定：通常販売価格より安い価格のみ入力可 ストア設定で「税込」を選択している場合8文字以内、「税抜」選択で通常税率（10％）の場合：90,909,090以下 軽減税率（8%）の場合：92,592,592以下 |
|
| reserve-member-price | 自動切替設定：LYPプレミアム会員向け価格 | 切替期間のLYPプレミアム会員価格を入力 | 半角数字のみ。ストア設定で「税込」を選択している場合8文字以内、「税抜」を選択している場合は92,592,592以下 | 自動切替設定：通常販売価格、予約セール価格より安い価格のみ入力可 ストア設定で「税込」を選択している場合8文字以内、「税抜」選択で通常税率（10％）の場合：90,909,090以下 軽減税率（8%）の場合：92,592,592以下 |
|
| reserve-selling-period-start | 自動切替設定：切替期間（開始日） | 価格変更の開始日時 | 半角数字のみ。YYYYMMDDHHMM形式 | 「価格の自動切替設定」利用の場合は必須 | |
| reserve-selling-period-end | 自動切替設定：切替期間（終了日） | 価格変更の終了日時 | 半角数字のみ。YYYYMMDDHHMM形式 | 「価格の自動切替設定」利用の場合は必須 | |
| item-image-urls | 商品画像 商品詳細画像 |
商品画像1枚目以降画像をURLで最大21枚入力 【例】URL1;URL2 |
画像URLを入力 商品画像、商品詳細画像、追加画像いずれも設定可能 |
区切り文字「;」 空欄可 ※空欄の場合は更新なし。 「0」をいれた場合、画像の種類によって動きが異なります。 ［商品画像の場合］ 設定されている商品画像のひも付けがなくなります。 画像ファイル自体も削除されます。 ［商品詳細画像の場合］ 設定されている商品詳細画像のひも付けがなくなります。 画像ファイル自体は削除されません。 |
|
| subscription-type | 定期購入設定 | 定期購入の設定 | 半角数字のみ 0、1、2を入力 |
0：設定なし 1：通常購入／定期購入 2：定期購入のみ ※初期設定は「設定なし」 ※空欄の場合は「設定なし」 |
|
| subscription-price | 定期購入価格 | 定期購入価格を入力 |
半角数字のみ ストア設定で「税込」を選択している場合8文字以内、「税抜」選択で通常税率（10％）の場合：90,909,090以下 軽減税率（8%）の場合：92,592,592以下 |
subscription-typeが1または2の場合は必須 | |
| subscription-group-index | 定期購入グループ管理番号 | 定期購入＞定期購入サービス設定＞定期購入グループ設定で設定した「定期購入グループ管理番号」を入力 | 半角数字のみ 1～20 |
subscription-typeが1または2の場合は必須 | |
| subscription-recommended-cycle | おすすめサイクル | 商品ページに表示するおすすめのお届け頻度を入力 |
指定方法 半角数字のみ。 0、1、2を入力 日数または月数 半角数字のみ。 日数：10～90 月数：1～6 半角コロン（:）区切り |
【例】
設定なし 0おすすめサイクルが10日・・・1:10 おすすめサイクルが1か月・・・2:1 ※空欄の場合は「設定なし」 |
|
| subscription-point-code | 定期購入ポイント倍率 | 定期購入商品ごとにポイント倍率を設定 | 半角数字のみ 0～15 |
【例】 指定なし・・・0 +1倍・・・1 ※初期設定は「指定なし」 ※空欄の場合は「指定なし」 |
|
| point-immediate | 獲得ポイント今すぐ利用 | 獲得ポイント今すぐ利用の対象設定 | 半角数字のみ 0、1を入力 |
1:対象 0:対象外 空欄の場合は「1: 対象」 |
|
| eco-setting-id | 環境ラベル/エコキーワード設定 | ECOチャレンジの環境ラベル／エコキーワード設定 | 半角数字のみ |
環境ラベル／エコキーワードのコードの設定でECOチャレンジ商品掲載対象となります。 環境ラベル対象商品の場合、環境ラベルを優先設定してください。 値は、環境ラベル／エコキーワードのコード値一覧（別ページ）参照 2026年1月1日以降「ECOチャレンジ」終了に伴い、当パラメータは廃止されます。 パラメーターを指定した場合でもエラーにはならず更新処理が行われますが、当該項目は更新されません。 |
|
| eco-setting-evidence-url | 環境ラベル/エコキーワード設定（エビデンスURL） | 環境ラベルもしくはエコキーワードのエビデンスURL | URL形式のみ |
エビデンスURLには商品本体やカタログなど、一般消費者に広く呈示されていることが分かるキャプチャ画像を設定ください。 基準を満たす画像URL、もしくはウェブサイトURLを設定ください。 詳細は環境ラベル／エコキーワードのエビデンスURL参照。 2026年1月1日以降「ECOチャレンジ」終了に伴い、当パラメータは廃止されます。 パラメーターを指定した場合でもエラーにはならず更新処理が行われますが、当該項目は更新されません。 |
|
| grouping-id | グルーピングID | 半角英数字、ハイフンのみ。99文字以内 | 他の商品とのひも付け機能を利用する場合に設定してください。 基本情報（6）他の商品とのひも付けを参照 |
||
| variation1-spec-id | バリエーション設定1-スペック | バリエーションとして使用するスペック項目を入力。 | 半角数字、ピリオド（数値を入力する場合）のみ。 | ||
| variation1-free-title | バリエーション1 - 項目名 | 2026年1月22日追加 バリエーションとして使用する項目名を入力。 |
全角28文字（半角56文字）以内、半角記号の|;:&=#"＼は不可。HTML不可 | ||
| variation1-name | バリエーション設定1-表示名 | バリエーション表示名をスペック値から変更したい場合に入力。 | 全角28文字（半角56文字）以内、半角記号の|;:&=#"＼は不可。HTML不可 | ||
| variation2-spec-id | バリエーション設定2-スペック | バリエーションとして使用するスペック項目を入力。 | 半角数字、ピリオド（数値を入力する場合）のみ。 | ||
| variation2-free-title | バリエーション2 - 項目名 | 2026年1月22日追加 バリエーションとして使用する項目名を入力。 |
全角28文字（半角56文字）以内、半角記号の|;:&=#"＼は不可。HTML不可 | ||
| variation2-name | バリエーション設定2-表示名 | バリエーション表示名をスペック値から変更したい場合に入力。 | 全角28文字（半角56文字）以内、半角記号の|;:&=#"＼は不可。HTML不可 | ||
| variation3-spec-id | バリエーション設定3-スペック | バリエーションとして使用するスペック項目を入力。 | 半角数字、ピリオド（数値を入力する場合）のみ。 | ||
| variation3-free-title | バリエーション3 - 項目名 | 2026年1月22日追加 バリエーションとして使用する項目名を入力。 |
全角28文字（半角56文字）以内、半角記号の|;:&=#"＼は不可。HTML不可 | ||
| variation3-name | バリエーション設定3-表示名 | バリエーション表示名をスペック値から変更したい場合に入力。 | 全角28文字（半角56文字）以内、半角記号の|;:&=#"＼は不可。HTML不可 | ||
| variation4-spec-id | バリエーション設定4-スペック | バリエーションとして使用するスペック項目を入力。 | 半角数字、ピリオド（数値を入力する場合）のみ。 | ||
| variation4-free-title | バリエーション4 - 項目名 | 2026年1月22日追加 バリエーションとして使用する項目名を入力。 |
全角28文字（半角56文字）以内、半角記号の|;:&=#"＼は不可。HTML不可 | ||
| variation4-name | バリエーション設定4-表示名 | バリエーション表示名をスペック値から変更したい場合に入力。 | 全角28文字（半角56文字）以内、半角記号の|;:&=#"＼は不可。HTML不可 | ||
| variation5-spec-id | バリエーション設定5-スペック | バリエーションとして使用するスペック項目を入力。 | 半角数字、ピリオド（数値を入力する場合）のみ。 | ||
| variation5-free-title | バリエーション5 - 項目名 | 2026年1月22日追加 バリエーションとして使用する項目名を入力。 |
全角28文字（半角56文字）以内、半角記号の|;:&=#"＼は不可。HTML不可 | ||
| variation5-name | バリエーション設定5-表示名 | バリエーション表示名をスペック値から変更したい場合に入力。 | 全角28文字（半角56文字）以内、半角記号の|;:&=#"＼は不可。HTML不可 | ||
| item-social-gift-type | ソーシャルギフト設定 | 商品ごとにソーシャルギフト機能の提供可否を設定することが可能 | 半角数字のみ。 0：ストアクリエイターProの設定を適用 1：対象 2：対象外 |
2025年12月8日追加 ストアクリエイターProの設定は「ストア構築」＞「カート設定」＞「オプション設」から「ソーシャルギフト」をご確認ください。 |
● |
cross-border-agency-flag |
海外向け購入代行の除外設定 | 商品ごとに、海外向け購入代行を行っているサービス（Buyeeなど）への掲載除外を設定することが可能 | 1：除外しない 0：除外する 空欄の場合は「1」 |
※2026年 デフォルト値は「1」 |
|
| person-sale-limit | 注文回数制限 | 購入者1人につき注文回数制限を入力 | 0：設定なし 1：設定あり（1人1回のみ注文可能） 空欄の場合は「0」 |
2026年 |
※1 path、name、code、price、product-categoryの5つのフィールドは、
入力必須項目です。
ただし、すでに登録済みの商品情報へアップロードタイプを「項目指定」で
アップロード更新する場合は、入力必須項目がcodeのみとなり、
"code"と"更新が必要な項目"で更新が可能です。
在庫アップロードフォーマット（CSV）
| フィールド名 | 意味 | 入力方法 |
|---|---|---|
| code | 商品コード | 半角の英数字またはハイフンのみ、99文字以内 |
| sub-code | 個別商品 コード |
半角の英数字またはハイフンのみ、99文字以内 ※個別商品コードがない商品の場合は空欄 |
| quantity | 在庫数 | 半角数字のみ、9けたまで |
| mode | 種別 | 半角のプラス（+）、マイナス（-）または空欄 |
| allow-overdraft | 在庫数を超えた注文 | 0：庫数を越えても注文できない 1：在庫数を越えても注文できる |
| stock-close | 在庫クローズフラグ | 在庫クローズフラグが立っている場合は、在庫切れ状態として扱っています。 0:在庫クローズ状態の解除 未指定もしくは空の場合は、在庫クローズフラグの更新を行いません。 |
modeフィールドの指定方法の種別は次のように記述します。
＋：足す
－：引く
空欄：値にする
フィールド自体がない場合は、「値にする」として処理されます。