コンテンツにスキップ
スマレジ・プラットフォームAPI リファレンス

商品価格変更履歴一覧取得

GET
/products/{product_id}/prices/changes
curl --request GET \
  --url https://api.smaregi.dev/TARGET-CONTRACT-ID/pos/products/example/prices/changes \
  --header 'Authorization: Bearer <token>'

商品価格変更履歴の一覧を取得します。

対象プラン

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

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
product_id
required
string

商品ID

Query Parameters

Section titled “Query Parameters”
fields
array

検索パラメータ（カンマ区切りで指定可）
Response項目を指定可能
※一部項目(withで指定する項目、2階層目以降の項目)については指定不可

sort
string

並び順（カンマ区切りで指定可）

指定可能なパラメータ

  • updDateTime：更新日時
limit
integer

上限数

page
integer

ページ

price_division
string

価格区分：(1：商品単価、2：会員価格、3：原価、4：商品単価詳細、5：会員価格詳細)

Responses

Section titled “Responses”

200

Section titled “200”

取得成功

Media typeapplication/json
Array<object>
object
id

ID

string
productId

商品ID

string
beforeTaxDivision

変更前税区分：(0：税込、1：税抜、2：非課税)

string
beforePrice

変更前価格

string
afterTaxDivision

変更後税区分：(0：税込、1：税抜、2：非課税)

string
afterPrice

変更後価格

string
priceDivision

価格区分：(1：商品単価、2：会員価格、3：原価、4：商品単価詳細、5：会員価格詳細)

string
procDivision

価格登録・更新時の処理区分：
01：管理画面での商品登録・更新・削除
02：仕入時の商品価格変更
03：EC連携での商品登録・更新・削除
04：スマレジAPI連携で商品登録・更新・削除
05：waiter連携時の商品登録・更新・削除

string
procDetailDivision

処理詳細区分：(1：登録、2：更新、3：削除)

string
updDateTime

更新日時

string
Example
[
  {
    "id": "string",
    "productId": "string",
    "beforeTaxDivision": "string",
    "beforePrice": "string",
    "afterTaxDivision": "string",
    "afterPrice": "string",
    "priceDivision": "string",
    "procDivision": "string",
    "procDetailDivision": "string",
    "updDateTime": "string"
  }
]

400

Section titled “400”

価格区分が[1, 2, 3, 4, 5]の何れかの値ではない場合

Media typeapplication/json
object
type
required
string
title
required
string
detail
string
status
integer
Examples
Example価格区分が[1, 2, 3, 4, 5]の何れかの値ではない場合
{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "[price_division] は[1,2,3,4,5]の中から指定して下さい",
  "status": 400
}

404

Section titled “404”

指定した商品IDが存在しない場合

Media typeapplication/json
object
type
required
string
title
required
string
detail
string
status
integer
Examples
Example指定した商品IDが存在しない場合
{
  "type": "about:blank",
  "title": "NotFound",
  "detail": "指定された商品IDのリソースが見つかりません",
  "status": 404
}