商品発注点設定

POST

/stores/{store_id}/product_order_points/bulk

• サンドボックス
• 本番

指定の店舗における、商品ごとの発注点を設定します。

リテールビジネスプランでご利用できる在庫アラート機能では、商品の在庫が発注点の値以下になると発注を促すための各種通知を行うことができます。

※ 在庫アラート機能については詳しくはヘルプサイトをご覧ください。

こちらで設定した場合、指定の店舗において、商品に設定されている発注点よりもこちらで設定した発注点が優先して在庫アラートに適用されます。

※ 指定された店舗ID、商品IDの店舗における発注点のみ更新されます。指定されていない店舗や商品の発注点は更新されません。

※ 商品は1リクエストにつき500件まで設定できます。

対象プラン

• スタンダード
• プレミアム
• プレミアムプラス
• フードビジネス
• リテールビジネス

Authorizations

• AppAccessToken
  pos.stores:write
• UserAccessToken
  pos.stores:write

Parameters

Path Parameters

store_id

required

string

店舗ID
※ ユーザーアクセストークンを利用する場合、ユーザーの所属する店舗IDを指定してください。

Request Body

object

productOrderPoints

required

商品店舗別発注点

商品店舗別発注点

Array<object>

>= 1 items <= 500 items unique items

object

productId

required

商品ID

※ ユーザーアクセストークンを利用する場合でも、ユーザーの所属する店舗で販売しているかに関わらず商品IDを指定できます。

string format: int

>= 1 <= 999999999999999

orderPoint

required

発注点

発注をかけるべき在庫数。
本項目にnullを指定した商品は、指定店舗における発注点は未設定となります。（在庫アラートでは商品に設定された発注点が適用されるようになります。）

integer

<= 999999999

Example

{
  "productOrderPoints": [
    {
      "productId": "123456789012345",
      "orderPoint": 123456789
    }
  ]
}

Responses

200

更新成功

object

productOrderPoints

商品店舗別発注点

Array<object>

商品店舗別発注点

object

productId

商品ID：数字15桁以内。
指定店舗に対して発注点が設定されている商品の場合、そのIDが返ります。
指定店舗に対して発注点が未設定の商品の場合、そのIDの要素はレスポンスの配列には含まれません。

string

storeId

店舗ID：数字9桁以内。

string

orderPoint

発注点：指定店舗に対して発注点が設定されている商品の場合、その発注点の値が返ります。

integer

<= 999999999

updDateTime

設定日時：更新時の日時。[YYYY-MM-DDThh:mm:ssTZD]

string

Example

{
  "productOrderPoints": [
    {
      "productId": "string",
      "storeId": "string",
      "orderPoint": 123456789,
      "updDateTime": "string"
    }
  ]
}

400

• 商品が１件も指定されなかった場合
• リクエスト上限数を超えている場合
• 指定された商品が存在しない場合
• 指定された商品が重複する場合

object

type

required

string

title

required

string

detail

string

status

integer

Examples

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "商品は１件以上指定してください。",
  "status": 400
}

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "リクエストの上限数を超えています。上限数-{上限数}",
  "status": 400
}

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "指定された商品が存在しません。(商品ID-{商品ID})",
  "status": 400
}

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "商品IDが重複しています。(商品ID-{商品ID})",
  "status": 400
}

404

指定された店舗が見つからない場合

object

type

required

string

title

required

string

detail

string

status

integer

Examples

{
  "type": "about:blank",
  "title": "NotFound",
  "detail": "指定されたIDのリソースが見つかりません",
  "status": 404
}