商品削除API

商品データを削除します。

※ フロント反映はしません。別途反映処理が必要です。
※ 商品を削除すると「画像管理」の商品画像フォルダ内にある商品画像、商品詳細画像及び在庫データも削除されます。

変更履歴

2024年03月21日

以下エラーコードを追加しました。

  • it-06005

リクエストURL

本番環境
https://circus.shopping.yahooapis.jp/ShoppingWebService/V1/deleteItem
テスト環境
https://test.circus.shopping.yahooapis.jp/ShoppingWebService/V1/deleteItem

テスト用APIを利用したい場合は、こちらから利用申請をお願いします。

リクエストパラメータ

Web APIの使い方#POSTとは」をご参照ください。

パラメータ 説明
seller_id
(必須)
string ストアアカウントを指定します。
item_code
(必須)
string 商品コードを指定します。「,」区切りで複数指定可能。(最大100個)

サンプルリクエストURL

https://circus.shopping.yahooapis.jp/ShoppingWebService/V1/deleteItem

サンプルリクエスト

POST /ShoppingWebService/V1/deleteItem HTTP/1.1
Host: circus.shopping.yahooapis.jp
Authorization: Bearer <アクセストークン>

seller_id=teststore&item_code=item1%2Citem2

レスポンスフィールド

フィールド 説明
/ResultSet クエリーレスポンスのすべてを含みます。
/ResultSet/Result 各個別レスポンスを含みます。
/ResultSet/Result/Status 更新結果(このフォーマットではOKのみ)

サンプルレスポンス

<?xml version="1.0" encoding="UTF-8" ?>
<ResultSet>
    <Result>
        <Status>OK</Status>
    </Result>
</ResultSet>

エラー

Yahoo!ショッピングで提供している全てのAPIには、共通で利用するエラーコードがあります。エラーの際には、まず始めに以下をご確認ください。

商品系API、および商品削除APIで固有に返すエラーコードは以下をご覧ください。

商品系API共通エラーコード

コード HTTPステータスコード 説明
ed-00000 404 ページが見つかりません。
ed-00001 500 システムエラーが発生しました。
ed-00002 503 サーバがメンテナンス中です。
ed-00003 400 ストアアカウントが指定されていません。
ed-00004 400 ストアアカウントが存在しません。
ed-00005 400 ストアアカウントの指定が不正です。
ed-00006 400 反映またはアップロード中のため更新ができません。

エラーコード

コード HTTPステータスコード 説明
it-06001 400 item_codeが指定されていません。
it-06002 400 item_codeが指定できる上限を超えています。
it-06003  400 指定された商品コードは存在しません。
it-06004  400 item_codeの値が不正です。
it-06005  400 セール期間中の商品が含まれているため、すべて削除できません。

利用制限

※短い時間の間に同一URLに大量にアクセスを行った場合、一定時間利用できなくなることもございます。(1クエリー/秒)

利用約款

このAPIに関する利用約款はこちら

アプリケーションの管理

目次

利用のルール

開発のヒント