アップロードフォーマット
変更履歴
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まで | |
| original-price | メーカー希望小売価格 | メーカー希望小売価格を入力 | 半角数字のみ。8文字以内 | オープン価格：0と入力 | |
| price | 通常販売価格 | 通常販売価格を入力 | 半角数字のみ。8文字以内 | 入力必須（※1） | |
| sale-price | 特価 | セール価格を入力 | 半角数字のみ。8文字以内 | sale-period-start、sale-period-endに入力がある場合のみ有効。 | |
| member-price | 会員向け価格 | Yahoo!プレミアム会員向け価格を入力 | 半角数字のみ。ストア設定で「税込」を選択している場合8文字以内、「税抜」を選択している場合は92,592,592以下。 ※通常価格、セール価格より安い価格のみ入力可能です。 |
「会員向け価格」機能は一部出店者様にはご利用いただけません。 | |
| options | オプション | オプションを入力 | オプション項目、オプション値は各全角28文字（半角56文字）以内 | スペックのひも付けも可能 | |
| オプション項目は最大20 | |||||
| オプション値は最大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日） |
|
| temporary-point-term | 仮ポイント期間 | 商品の仮ポイント期間を設定 | 半角数字のみ。14?60を入力 | 空欄の場合はストアマネージャーで設定した期間が適用される | |
| point-code | ポイント倍率 | 商品のポイント倍率を指定する場合にpoint-codeの値を入力 | 半角英数字のみ。 | Yahoo!ショッピングがコードを提供。入力するとストアポイントより優先して倍率適用。point-code一覧はこちらのページ下部を参照。 | |
| meta-key | META keywords | 商品に関するキーワード | 全角80文字（半角160文字）以内 | ||
| キーワード間は半角パイプ（|）区切り | |||||
| 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～999を入力 | ||
| sp-code | 販促コード | キャンペーンコード | 半角英数字のみ。10文字 | Yahoo!ショッピングがコードを提供 | |
| brand-code | ブランドコード | ブランドコードを入力 | 半角数字のみ。10文字以内 | Yahoo!ショッピングがコードを提供 | |
| yahoo-product-code | Yahoo!ショッピング製品コード | Yahoo!ショッピング製品コードを入力 | 半角英数字のみ。32文字以内 | Yahoo!ショッピングがコードを提供 | |
| product-code | 製品コード | 製品のメーカー品番/型番を入力 | 半角英数字と記号（ +-*/()&:~～.@!#?_ ）のみ。50文字以内 | ● | |
| jan | JANコード/ISBNコード | JANコード/ISBNコードを入力 | 半角数字のみ。13文字以内 | ● | |
| delivery | 送料無料 | 送料無料の設定 | 半角数字のみ。0、1、3のいずれかを入力。 | なし（送料がかかる場合）：0、無料：1、条件付送料無料：3を入力 空欄の場合は「なし」 ※「送料込み：2」は2013年9月18日（水）に廃止しました。 |
|
| astk-code | きょうつく、あすつく | 当日配達 「きょうつく」 翌日配達 「あすつく」の設定 |
半角数字のみ。 0、1、2のいずれかを入力。 |
非対応：0 あすつく対応：1 きょうつく対応：2を入力 空欄の場合は「非対応」 |
|
| condition | 商品の状態 | 商品の状態の設定 | 半角数字のみ。 0、1のいずれかを入力。 |
0 : 新品 1 : 中古 （※古物免許を登録していないと中古に設定することはできません） 2 : 新品：Yahoo!オークション併売 ※Yahoo!オークション併売プラン限定 3 : 中古：未使用 4 : 中古：未使用に近い 5 : 中古：目立った傷や汚れなし 6 : 中古：やや傷や汚れあり 7 : 中古：傷や汚れあり 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を入力 空欄の場合は「変更なし」 | |
| supplier-type ※PayPayモール出店者様限定 |
販売ルート | 国内正規販売店、または日本の正規輸入代理店が定める流通を通じて仕入れられている商品か否かを入力 | 半角数字のみ 1、2、3を入力 |
選択なし:1 正規販売・輸入代理店品:2 並行輸入品、他:3 初期設定は「選択なし」です。『選択なし』『並行輸入品、他』はPayPayモール内では非表示になります。非表示対象商材の場合はPayPayモールストア内検索、Yahoo!ショッピングでは表示されます。 |
|
| y-shopping-display-flag※PayPayモール出店者様限定 | Yahoo!ショッピング検索に表示する商品 | Yahoo!ショッピング検索やレコメンドに商品を表示するか否かを入力 ※ストア内検索には表示されます。 |
半角数字のみ 1、0を入力。 |
表示:1 非表示: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以下 | 「価格の自動切替設定」利用の場合は必須 | |
| reserve-sale-price | 自動切替設定：セール価格 | 切替期間のセール価格を入力 | 半角数字のみ。ストア設定で「税込」を選択している場合8文字以内、「税抜」を選択している場合は92,592,592以下 | 自動切替設定：通常販売価格より安い価格のみ入力可 | |
| reserve-member-price | 自動切替設定：Y!プレミアム会員向け価格 | 切替期間のYahoo!プレミアム会員価格を入力 | 半角数字のみ。ストア設定で「税込」を選択している場合8文字以内、「税抜」を選択している場合は92,592,592以下 | 自動切替設定：通常販売価格、予約セール価格より安い価格のみ入力可 | |
| reserve-selling-period-start | 自動切替設定：切替期間（開始日） | 価格変更の開始日時 | 半角数字のみ。YYYYMMDDHHMM形式 | 「価格の自動切替設定」利用の場合は必須 | |
| reserve-selling-period-end | 自動切替設定：切替期間（終了日） | 価格変更の終了日時 | 半角数字のみ。YYYYMMDDHHMM形式 | 「価格の自動切替設定」利用の場合は必須 |
※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フィールドの指定方法の種別は次のように記述します。
＋：足す
－：引く
空欄：値にする
フィールド自体がない場合は、「値にする」として処理されます。