Yahoo!ショッピングに「注文回数制限」が追加　商品CSVの列が1つ増えます

何が変わったのか

Yahoo!ショッピングの商品データに「注文回数制限」という項目が加わりました。取りうる値は2つだけで、公式ドキュメントには「0：設定なし」「1：設定あり（1人1回のみ注文可能）」とあります。デフォルトは0です。

呼び名はAPIごとに違い、商品登録APIのリクエストパラメータでは person_sale_limit、商品CSVでは person-sale-limit、商品参照APIのレスポンスでは /ResultSet/Result/PersonSaleLimit になります。同じ設定なのに表記が3通りあるので、連携を自作している方は取り違えに注意してください。

同時に、以前からある sale_limit（CSVでは sale-limit）の説明文も書き換えられました。更新履歴には矢印つきでこう記されています。

購入数制限 → 1注文あたりの購入数制限

sale_limit は「1人が何個まで買えるか」ではなく「1回の注文で何個まで買えるか」だった、という線引きが新項目に合わせてはっきりしました。1人1回に縛りたいなら新しい person_sale_limit を使います。

エラーコードも2つ増えました。it-14194 は「注文回数制限は0か1を入力してください。」、it-14195 は定期購入設定が「通常購入／定期購入」または「定期購入のみ」の商品に1を指定できない、という内容です。

いつから

• 2026年5月21日 — 商品登録APIとアップロードフォーマット（商品CSV）に追加
• 2026年6月22日 — 商品参照APIのレスポンスに追加
• 提供時期 — 仕様表の表記は「2026年 ~~6月下旬~~ 7月下旬追加予定」

書き込み側の仕様が5月に出て、読み出し側が6月22日に揃い、提供時期は当初の6月下旬から7月下旬へ一度ずれた形です。

2026年8月1日時点でも仕様表には「7月下旬追加予定」が残ったままで、実施日入りへの書き換えは確認できていません。デベロッパーネットワークのお知らせ一覧にも、この項目を名指しした告知は出ていません。先行した「海外向け購入代行の除外設定」は提供後に「~~2月中旬追加予定~~ 2月16日追加」へ書き換えられているので、まだ書き換え待ちと読むのが自然です。自分のストアで動いているかは、商品参照APIを1件叩いて PersonSaleLimit が返るかを見るのが確実です。

誰に影響するのか

対象は、商品CSV（商品アップロードAPI）で一括更新している方、商品登録API（editItem）で商品を作成・更新している方、商品参照API（getItem）の結果を自社DBや連携ツールに取り込んでいる方です。

逆に、価格と在庫だけを回している経路は対象外です。商品一括更新API（updateItems）のパラメータに person_sale_limit は含まれず、「指定された項目だけを更新し、省略された項目は更新しません」と明記されています。在庫更新API（setStock）のパラメータも seller_id・item_code・quantity などに限られていて、こちらにも含まれません。日々の価格改定と在庫同期がこの追加で止まることはありません。

放置するとどうなるのか

商品アップロードAPIにはアップロードタイプが4つあり、「追加」（type=1）について公式ドキュメントはこう書いています。

フィールドを削除してデータをアップロードしますと、削除したフィールド部分のデータは削除されます

そして商品CSVの person-sale-limit には「空欄の場合は「0」」とあります。0は設定なしです。

この2つを突き合わせると、列を持たない古いテンプレートのまま「追加」で流し続けた場合に、入れた値が保持されない読み筋が出てきます。ただし「person-sale-limit列のないCSVをtype=1で流すと1が0に戻る」と名指しした公式記載は見つかっていません。断定はしません。安全側に倒すなら、部分更新は「項目指定」（type=4）を使ってください。こちらの説明は「アップロードするデータベースファイルに含まれる商品データの、指定したフィールドのみ、データの変更を行います」となっています。

取り込み側にも一点あります。商品参照APIのレスポンスに PersonSaleLimit が増えるため、XMLを固定の要素数や並び順で読む実装は影響を受けます。要素名でアクセスしていれば問題ありません。

今日やること

1. 商品CSVテンプレートに person-sale-limit 列があるか確認する。無いなら、type=1（追加）とtype=4（項目指定）のどちらで流しているかを特定してください。type=1なら、type=4へ切り替えるか列を足すかです。
2. 商品参照APIを1件だけ叩き、<PersonSaleLimit> が返るか見る。返れば提供開始済み、返らなければまだです。
3. 商品登録APIを使っているなら、it-14194 と it-14195 をエラーハンドリングに足す。it-14195 は定期購入商品にしか出ません。
4. 社内資料やツールの説明で sale_limit を「購入数制限」と書いている箇所を「1注文あたりの購入数制限」に直す。人が読む文書のほうが後から効いてきます。
5. 同時期のもう1件も見てください。payment_a17 の PayMethodName を「PayPay残高等」の1種類から「PayPay残高等」「PayPay残高」「PayPayポイント」の3種類へ広げる変更が、2026年7月16日実施予定として告知されています。実施完了を伝える続報は8月1日時点で出ていないので、日付上は過ぎていても実データで確かめてください。告知には「リリース前の注文に関しては変更されません」とあるため、新旧の表記は混在します。決済方法名の文字列で仕分けている受注処理や会計連携があるなら、7月16日以降の注文を見ておくと安心です。

ClariaSync をお使いの場合

ClariaSyncがYahoo!ショッピングに対して行っているのは在庫数の同期と価格の改定です。どちらのリクエストにも person_sale_limit は含まれないので、今回の追加で在庫同期や価格改定が止まることはなく、ストア側で設定した注文回数制限を勝手に書き換えることもありません。

注文回数制限そのものをClariaSyncの管理画面から編集する機能は、まだ用意していません。設定するときは商品CSVか商品登録APIを使ってください。ストアクリエイターProの画面から設定できるかどうかは、公開されているドキュメントでは確認できませんでした。

一点だけ補足します。注文回数制限は在庫数の制御ではありません。1人1回に絞っても、在庫を複数モールで共有している以上、別々の購入者が同時に買えば売り越しは起こりえます。そこはClariaSyncの在庫同期が受け持つ領域で、同期の設計と頻度で減らしていくものだと考えてください。

この変更をどこで知るか

一次情報は次の4ページです。

• 更新履歴一覧（2026年）
• 商品登録API
• 商品参照API
• アップロードフォーマット（商品CSV）

各APIのページにある「変更履歴」で、そのAPIに何がいつ足されたかを追えます。提供時期は仕様表の中に取り消し線つきで書かれているので、表も開いてください。障害やメンテナンスを含む告知はYahoo!ショッピングのお知らせにまとまっており、Atomフィードも公開されています。