開発者向けサポート

/stocks

必要権限

  • item

提供メソッド

GET

サンプル
リクエスト
GET /stocks.json?item_id=2
レスポンス
200 OK

[
	{"ITEM_ID": 2,"ITEMPROPERTY_LIST": "1-2","ZAIKO": 8},
	{"ITEM_ID": 2,"ITEMPROPERTY_LIST": "1-4","ZAIKO": 8},
	{"ITEM_ID": 2,"ITEMPROPERTY_LIST": "3-2","ZAIKO": 8},
	{"ITEM_ID": 2,"ITEMPROPERTY_LIST": "3-4","ZAIKO": 8}
]
リクエスト文説明
クエリーパラメータ

item_id
商品IDを指定します。「,」区切りで複数の商品IDを指定することが可能です。
item_cd
商品コードを指定します。「,」区切りで複数の商品コードを指定することが可能です。item_idと同時に指定した場合、item_idが優先になります。
select
取得する列名を指定します。指定しない場合は ITEM_ID,ITEMPROPERTY_LIST,ZAIKO を指定した場合と同じ動作をします。
query
検索条件をJSON形式で指定します。詳細はデータアクセスAPIのページの共通パラメータを参照してください。item_id、item_cdが指定された場合はqueryは無視されます。
search_order
queryを指定する場合に使用できます。検索結果の順序を指定します。
指定しない場合は商品ID(ITEM_ID), 商品属性コード属性No部分(ITEMPROPERTY_LIST)を基準に昇順で並べ変えられます。
また、ITEM_ID, ITEMPROPERTY_LISTは一意の項目です。
result_count
queryを指定する場合に使用できます。検索結果の取得数を指定します。1～100で指定してください。未指定の場合、結果は20件分返します。
page
queryを指定する場合に使用できます。>取得するページ番号 ((page-1)*resultCount)+1件目からpage*resultCount件目までのデータが取得対象となります。未指定の場合は1が指定されたものとして動作します。

応答値説明
ボディー文字列

在庫情報を格納したJSON値を返します。

POST

サンプル
リクエスト
POST stocks.json?data_type=multi_update

[
	{
		"ITEM_ID": 1,
		"ITEMPROPERTY_LIST": "0",
		"ZAIKO": 100
	},
	{
		"ITEM_ID": 2,
		"ITEMPROPERTY_LIST": "1-3",
		"ZAIKO": 100
	}
]
レスポンス
200 OK

{
	"errorStocks": [
		{
			"ITEM_ID": 1,
			"ITEMPROPERTY_LIST": "0",
			"index": 1,
			"messages": [
				"stock not found"
			]
		}
	],
	"succeededStocks": [
		{
			"ITEM_ID": 2,
			"ITEMPROPERTY_LIST": "1-3",
		}
	]
}
リクエスト文説明
クエリーパラメータ

data_type
リクエストデータの種別です。指定できる値：multi_update
ignore_transaction_check
非推奨です。使用を控えてください。multi_updateの場合に使用できる値です。トランザクション使用下でmulti_updateを使用したい場合はtrueを指定してください。（デフォルトはトランザクション使用下だとエラーになります）

ボディー文字列

リクエストパラメータ "data_type" = "multi_update"の場合:
複数行の在庫データ更新します。データ形式として、商品ID、バリエーション文字列と更新対象プロパティをセットます。
一度に更新できる最大の件数は1000件までです。
現在サポートしている対象プロパティは以下の通りです。サポート外のプロパティを設定することはできません。
  • ZAIKO
  • YOYAKU_FLG
  • YOYAKU_FLG_AUTO_ON_FLG

応答値説明
ボディー文字列

リクエストパラメータ "data_type" = "multi_update"の場合:
次の項目を含むJSONオブジェクトを返します。
  • succeededStocks: 成功した在庫情報のリスト、それぞれの要素には次のプロパティを含みます。
  • index: リクエストボディに渡したリストのindex値
  • ITEM_ID: 商品ID（商品IDが取得できない場合はnull）
  • ITEMPROPERTY_LIST: バリエーション文字列（バリエーション文字列が取得できない場合はnull）
  • errorStocks: 失敗した在庫情報のリスト、それぞれの要素には次のプロパティを含みます。
    • index: リクエストボディに渡したリストのindex値
    • ITEM_ID: 商品ID（商品IDが取得できない場合はnull）
    • ITEMPROPERTY_LIST: バリエーション文字列（バリエーション文字列が取得できない場合はnull）
    • messages: エラーメッセージを含んだリスト

ここを見た方は他にもこんなページを見ています。