ReCORE.co-api

在庫

在庫検索

概要

• 在庫情報の検索を行う

基本情報

• リクエストパス: GET /items
• JWTスコープ: item:index
• 必須個別JWTパラメータ: なし
• レートリミット: 5 rps

query

key	説明	制約など
ids	在庫ID	整数のみ、カンマ区切りで複数指定可能
codes	在庫コード	カンマ区切りで複数指定可能
alias_codes	代替在庫コード	カンマ区切りで複数指定可能
is_tracked	在庫数管理	-
product_ids	商品ID	整数のみ、カンマ区切りで複数指定可能
ia_*	在庫属性	(*1)
pa_*	商品属性	(*1)
created_at_from	作成日から	2024-04-12 12:08:38 形式
created_at_to	作成日まで	同上
updated_at_from	更新日から	同上
updated_at_to	更新日まで	同上
page	ページ	整数のみ、デフォルト:1
limit	1ページあたりの件数	整数のみ、デフォルト:50、最大: 250
cursor	ページカーソル	-

• *1) 「*」部分に在庫/商品属性キーを指定することで、その属性値に一致する在庫を検索できる。
  • 例: ia_custom_aaa=あいう pa_asin=404733202X pa_brand=KADOKAWA

例

• Request

GET /items?codes=ITBC0PV0VJPA

• Response

[
  {
    "id": 23,
    "code": "ITBC0PV0VJPA",
    "is_tracked": true,
    "alias_code": null,
    "store": {
      "id": 1,
      "name": "main"
    },
    "price": 33,
    "grade": {
      "id": 2,
      "name": "中古A"
    },
    "condition_note": null,
    "condition_tags": [
      {
        "id": 1,
        "name": "喫煙あり"
      }
    ],
    "note": null,
    "stocks": [
      {
        "location": {
          "id": 1,
          "type": "DEFAULT",
          "name": "デフォルト"
        },
        "status": "PENDING",
        "quantity": 1,
        "cost_price": 20
      }
    ],
    "attribute": {
      "size": "S"
    },
    "image_urls": [
      "https://..."
    ],
    "racks":[
      {
        "numbers":[
          "棚1",
          "棚2"
        ],
        "location": {
          "id": 1,
          "type": "DEFAULT",
          "name": "デフォルト"
        }
      }
    ],
    "product_id": 7,
    "created_at": 1673411650,
    "updated_at": 1673411650
  }
]

key	type	説明
*	array<object>	在庫
*.id	int	在庫ID
*.code	string	在庫コード
*.is_tracked	boolean	在庫数管理
*.alias_code	string | null	代替在庫コード
*.store	object	所属店舗
*.store.id	int	所属店舗ID
*.store.name	string	所属店舗名
*.price	int	価格
*.grade	object	グレード
*.grade.id	int	グレードID
*.grade.name	string	グレード名
*.condition_note	string | null	コンディション詳細
*.condition_tags	array<object>	コンディションタグ
*.condition_tags.*.id	int	コンディションタグID
*.condition_tags.*.name	string	コンディションタグ名
*.note	string | null	在庫メモ
*.stocks	array<object>	在庫、location-statusでユニーク
*.stocks.*.location	object	在庫ロケーション
*.stocks.*.location.id	int	在庫ロケーションID
*.stocks.*.location.type	string	在庫ロケーションタイプ
*.stocks.*.location.name	string	在庫ロケーション名
*.stocks.*.status	string	在庫ステータス
*.stocks.*.quantity	int	在庫数
*.stocks.*.cost_price	int	在庫原価
*.attribute	object | null	在庫属性
*.image_urls	array<string>	在庫画像URL
*.racks	array<object>	棚情報
*.racks.*.location	object	ロケーション
*.racks.*.numbers	array<string>	番号
*.product_id	int	商品ID
*.created_at	int | null	作成日時
*.updated_at	int | null	更新日時

在庫取得

概要

• 在庫情報を1件取得する

基本情報

• リクエストパス: GET /items/{item_id}
• JWTスコープ: item:show
• 必須個別JWTパラメータ: なし
• レートリミット: 5 rps

例

• Request

GET /items/23

• Response

在庫検索のresponse[0]と同様

在庫作成

概要

• 在庫情報を作成する

基本情報

• リクエストパス: POST /items
• JWTスコープ: item:store
• 必須個別JWTパラメータ: store_id (またはX-Store-Idヘッダ)
• レートリミット: 2 rps

body

key	type	説明	制約など
product_id	int	商品ID	-
price	int	価格	-
is_tracked	?boolean	在庫数管理	デフォルト: true
alias_code	?string | null	代替在庫コード	50文字まで
grade_id	?int	グレードID	-
condition_note	?string | null	コンディション詳細	-
condition_tag_ids	?array<int>	コンディションタグID	-
note	?string | null	在庫メモ	-
attribute	?object	在庫属性	-
image_urls	?array<string>	商品画像URL	(*1)
racks	?array<object>	棚情報	-
racks.*.location_id	int	ロケーションID	-
racks.*.numbers	array<string> | null	番号	-

• *1) ファイルアップロード(公開ファイル)で取得したファイルURLを使用

例

• Request

POST /items

{
  "product_id": 2,
  "price": 100,
  "is_tracked": true,
  "alias_code": null,
  "condition_tag_ids": [1, 2, 3],
  "image_urls": ["https://***", "https://***"],
  "racks": [
    {
      "location_id": 1,
      "numbers": ["棚1", "棚2"]
    }
  ]
}

• Response

在庫取得と同様

在庫更新

概要

• 在庫情報を更新する

基本情報

• リクエストパス: PUT /items/{item_id}
• JWTスコープ: item:update
• 必須個別JWTパラメータ: なし
• レートリミット: 2 rps

body

key	type	説明	制約など
is_tracked	?boolean	在庫数管理	-
alias_code	?string | null	代替在庫コード	50文字まで
grade_id	?int	グレードID	-
condition_note	?string | null	コンディション詳細	-
condition_tag_ids	?array<int>	コンディションタグID	-
note	?string | null	在庫メモ	-
attribute	?object	在庫属性	(*1)
image_urls	?array<string>	商品画像URL	(*2) (*3)
racks	?array<object>	棚情報	-
racks.*.location_id	int	ロケーションID	-
racks.*.numbers	array<string> | null	番号	-

• *1) 既存の項目とマージされる、キーを削除したい場合はnullを指定
• *2) ファイルアップロード(公開ファイル)で取得したファイルURLを使用
• *3) 既存の項目とマージされず完全上書きとなる、追記したい場合は予め取得API等で既存の値を取得しておく

例

• Request

PUT /items/23

{
  "alias_code": null,
  "condition_tag_ids": [1, 2, 3],
  "image_urls": ["https://***", "https://***"]
}

• Response

在庫取得と同様

在庫一括作成

概要

• 在庫情報を一括作成する

基本情報

• リクエストパス: POST /items/bulk
• JWTスコープ: item:bulk:store
• 必須個別JWTパラメータ: store_id (またはX-Store-Idヘッダ)
• レートリミット: 2 rps

body

key	type	説明	制約など
*	array<object>	-	1件以上 1000件まで
*.*	-	(以下在庫作成と同様)	-

例

• Request

POST /items/bulk

[
  {
    "product_id": 2,
    "price": 100,
    "alias_code": null,
    "condition_tag_ids": [1, 2, 3]
  }
]

• Response

在庫検索と同様

在庫一括更新

概要

• 在庫情報を一括更新する

基本情報

• リクエストパス: PUT /items/bulk
• JWTスコープ: item:bulk:update
• 必須個別JWTパラメータ: なし
• レートリミット: 2 rps

body

key	type	説明	制約など
*	array<object>	-	1件以上 1000件まで
*.id	int	在庫ID	-
*.*	-	(以下在庫更新と同様)	-

例

• Request

PUT /items/bulk

[
  {
    "id": 234,
    "alias_code": null,
    "condition_tag_ids": [1, 2, 3]
  }
]

• Response

在庫検索と同様

在庫入庫

概要

• 既存の在庫に入庫する

基本情報

• リクエストパス: PUT /items/inbounds
• JWTスコープ: item:inbound:update
• 必須個別JWTパラメータ: なし
• レートリミット: 2 rps

body

key	type	説明	制約など
staff_id	?int | null	スタッフID	-
location_id	int	ロケーションID	-
status	string	入庫ステータス	PENDING ACTIVE
items	array<object>	入庫在庫	1件以上 1000件まで
items.*.id	int	在庫ID	-
items.*.quantity	int	入庫数量	1以上
items.*.cost_price	int	税抜原価小計	-
note	?string | null	内部メモ	-

例

• Request

PUT /items/inbounds

{
  "location_id": 1,
  "status": "ACTIVE",
  "items": [
    {
      "id": 12,
      "quantity": 3,
      "cost_price": 100
    }
  ]
}

• Response

在庫検索と一部同様、差分を下記に示す

key	type	説明	制約など
*.attribute	-	(削除)	-
*.image_urls	-	(削除)	-
*.image_url	string | null	1枚目画像URL	-

在庫廃棄

概要

• 既存の在庫から廃棄する

基本情報

• リクエストパス: PUT /items/disposals
• JWTスコープ: item:disposal:update
• 必須個別JWTパラメータ: なし
• レートリミット: 2 rps

body

key	type	説明	制約など
staff_id	?int | null	スタッフID	-
location_id	int	ロケーションID	-
status	string	廃棄ステータス	PENDING ACTIVE
items	array<object>	廃棄在庫	1件以上 1000件まで
items.*.id	int	在庫ID	-
items.*.quantity	int	廃棄数量	1以上
note	?string | null	内部メモ	-

例

• Request

PUT /items/inbounds

{
  "location_id": 1,
  "status": "ACTIVE",
  "items": [
    {
      "id": 12,
      "quantity": 3
    }
  ]
}

• Response

在庫入庫と同様

在庫ロケーション変更

概要

• 在庫のロケーションを変更する

基本情報

• リクエストパス: PUT /items/change_locations
• JWTスコープ: item:change_location:update
• 必須個別JWTパラメータ: なし
• レートリミット: 2 rps

body

key	type	説明	制約など
staff_id	?int | null	スタッフID	-
location_id	int	移動元ロケーションID	-
dist_location_id	int	移動先ロケーションID	-
status	string	移動ステータス	PENDING ACTIVE
items	array<object>	移動在庫	1件以上 1000件まで
items.*.id	int	在庫ID	-
items.*.quantity	int	移動数量	1以上
note	?string | null	内部メモ	-

例

• Request

PUT /items/change_locations

{
  "location_id": 1,
  "dist_location_id": 2,
  "status": "ACTIVE",
  "items": [
    {
      "id": 12,
      "quantity": 3
    }
  ]
}

• Response

在庫入庫と同様

在庫価格変更

概要

• 在庫の価格を変更する

基本情報

• リクエストパス: PUT /items/change_prices
• JWTスコープ: item:change_price:update
• 必須個別JWTパラメータ: なし
• レートリミット: 2 rps

body

key	type	説明	制約など
staff_id	?int | null	スタッフID	-
items	array<object>	移動在庫	1件以上 1000件まで
items.*.id	int	在庫ID	-
items.*.price	int	変更後価格	0以上
note	?string | null	内部メモ	-

例

• Request

PUT /items/change_prices

{
  "items": [
    {
      "id": 12,
      "price": 200
    }
  ]
}

• Response

在庫入庫と同様

在庫品出し

概要

• 在庫の品出しを実行する

基本情報

• リクエストパス: PUT /items/activations
• JWTスコープ: item:activation:update
• 必須個別JWTパラメータ: なし
• レートリミット: 2 rps

body

key	type	説明	制約など
staff_id	?int | null	スタッフID	-
location_id	int	ロケーションID	-
items	array<object>	品出し在庫	1件以上 1000件まで
items.*.id	int	在庫ID	-
items.*.quantity	int	数量	1以上
note	?string | null	内部メモ	-

例

• Request

PUT /items/activations

{
  "location_id": 1,
  "items": [
    {
      "id": 12,
      "quantity": 3
    }
  ]
}

• Response

在庫入庫と同様

在庫振替検索

概要

• 在庫振替の検索を行う

基本情報

• リクエストパス: GET /items/transfers
• JWTスコープ: item:transfer:index
• 必須個別JWTパラメータ: なし
• レートリミット: 5 rps

query

key	説明	制約など
ids	ケースID	整数のみ、カンマ区切りで複数指定可能
created_at_from	作成日から	2024-04-12 12:08:38 形式
created_at_to	作成日まで	同上
note	備考	部分一致検索
src_item_ids	振替元在庫ID	整数のみ、カンマ区切りで複数指定可能
dist_item_ids	振替先在庫ID	整数のみ、カンマ区切りで複数指定可能
page	ページ	整数のみ、デフォルト:1
limit	1ページあたりの件数	整数のみ、デフォルト:50、最大: 250

例

• Request

GET /items/transfers

• Response

[
  {
    "id": 1,
    "store": {
      "id": 1,
      "name": "main"
    },
    "staff": {
      "id": 1,
      "name": "山田 太郎",
      "kana": "ヤマダ タロウ"
    },
    "note": "振替メモ",
    "details": [
      {
        "src_item": {
          "id": 23,
          "code": "ITBC0PV0VJPA",
          "alias_code": null,
          "store": {
            "id": 1,
            "name": "main"
          },
          "price": 33,
          "grade": {
            "id": 2,
            "name": "中古A"
          },
          "condition_note": null,
          "condition_tags": [
            {
              "id": 1,
              "name": "喫煙あり"
            }
          ],
          "note": null,
          "stocks": [
            {
              "location": {
                "id": 1,
                "type": "DEFAULT",
                "name": "デフォルト"
              },
              "status": "PENDING",
              "quantity": 1,
              "cost_price": 20
            }
          ],
          "image_url": "https://...",
          "racks": [],
          "product_id": 7,
          "created_at": 1673411650,
          "updated_at": 1673411650
        },
        "dist_item": {
          "id": 24,
          "code": "ITBC0PV0VJPB",
          "alias_code": null,
          "store": {
            "id": 1,
            "name": "main"
          },
          "price": 1500,
          "grade": {
            "id": 1,
            "name": "新品"
          },
          "condition_note": null,
          "condition_tags": [],
          "note": null,
          "stocks": [
            {
              "location": {
                "id": 1,
                "type": "DEFAULT",
                "name": "デフォルト"
              },
              "status": "ACTIVE",
              "quantity": 2,
              "cost_price": 10
            }
          ],
          "image_url": null,
          "racks": [],
          "product_id": 8,
          "created_at": 1673411700,
          "updated_at": 1673411700
        },
        "price_ratio": 0.5,
        "quantity_ratio": 0.5,
        "cost_price": 10
      }
    ],
    "created_at": 1673411700
  }
]

key	type	説明
*	array<object>	在庫振替ケース
*.id	int	ケースID
*.store	object	店舗
*.store.id	int	店舗ID
*.store.name	string	店舗名
*.staff	object | null	担当スタッフ
*.staff.id	int	スタッフID
*.staff.name	string	スタッフ名
*.note	string | null	備考
*.details	array<object>	振替詳細
*.details.*.src_item	object	振替元在庫 (在庫入庫と同様)
*.details.*.dist_item	object	振替先在庫 (在庫入庫と同様)
*.details.*.price_ratio	float	価格比率 (*1)
*.details.*.quantity_ratio	float	数量比率 (*2)
*.details.*.cost_price	int	原価
*.created_at	int | null	ケース作成日時

• *1) price_ratio: 振替元商品の総価値（価格×数量）に対する各商品の価値割合。例) 商品A(100円×2個=200円)と商品B(200円×2個=400円)の場合、Aは0.333、Bは0.667となる
• *2) quantity_ratio: 振替先商品の総数量に対する各振替元商品の数量割合。振替元の数量配分を振替先全体の規模に対して正規化した値

在庫振替実行

概要

• 在庫を別の商品に振替する

基本情報

• リクエストパス: PUT /items/transfers
• JWTスコープ: item:transfer:update
• 必須個別JWTパラメータ: なし
• レートリミット: 2 rps

body

key	type	説明	制約など
staff_id	?int | null	担当スタッフID	-
location_id	int	振替先ロケーションID	-
status	string	ステータス	PENDING ACTIVE
note	?string | null	備考	-
src_items	array<object>	振替元在庫	1件以上 1000件まで (*1)
src_items.*.id	int	振替元在庫ID	-
src_items.*.quantity	int	振替元数量	1以上
dist_items	array<object>	振替先在庫	1件以上 1000件まで (*1)
dist_items.*.product_id	int	振替先商品ID	-
dist_items.*.quantity	int	振替先数量	1以上
dist_items.*.price	int	振替先価格	0以上
dist_items.*.grade_id	int	振替先グレードID	-
dist_items.*.condition_note	?string | null	振替先コンディション詳細	-
dist_items.*.condition_tag_ids	?array<int>	コンディションタグIDリスト	-
dist_items.*.cost_price	?int | null	原価	0以上 (*2)

• *1) 振替元在庫と振替先在庫の組み合わせ上限は2500件まで
• *2) 振替先在庫の原価を指定しない場合、振替元在庫の原価残を振替先数量・価格で按分した値を原価に自動適用

例

• Request

PUT /items/transfers

{
  "location_id": 1,
  "status": "ACTIVE",
  "src_items": [
    {
      "id": 1001,
      "quantity": 2
    }
  ],
  "dist_items": [
    {
      "product_id": 2001,
      "quantity": 2,
      "price": 1500,
      "grade_id": 1
    },
    {
      "product_id": 2002,
      "quantity": 2,
      "price": 1500,
      "grade_id": 2
    }
  ]
}

• Response

在庫入庫と同様

在庫振替取得

概要

• 在庫振替を1件取得する

基本情報

• リクエストパス: GET /items/transfers/{case_id}
• JWTスコープ: item:transfer:show
• 必須個別JWTパラメータ: なし
• レートリミット: 5 rps

例

• Request

GET /items/transfers/1

• Response

在庫振替検索のresponse[0]と同様

在庫店舗変更ケース検索

概要

• 在庫店舗変更ケースの検索を行う

基本情報

• リクエストパス: GET /items/change_stores
• JWTスコープ: item:change_store:index
• 必須個別JWTパラメータ: なし
• レートリミット: 5 rps

query

key	説明	制約など
ids	ケースID	整数のみ、カンマ区切りで複数指定可能
statuses	ステータス	カンマ区切りで複数指定可能
page	ページ	整数のみ、デフォルト:1
limit	1ページあたりの件数	整数のみ、デフォルト:50、最大: 250
cursor	ページカーソル	-

例

• Request

GET /items/change_stores

• Response

[
  {
    "id": 123,
    "store": {
      "id": 1,
      "name": "main"
    },
    "status": "IN_PROGRESS",
    "location": {
      "id": 1,
      "type": "DEFAULT",
      "name": "デフォルト"
    },
    "item_status": "ACTIVE",
    "src_store": {
      "id": 1,
      "name": "main"
    },
    "dist_store": {
      "id": 2,
      "name": "branch"
    },
    "note": "サンプル",
    "created_staff": {
      "id": 1,
      "name": "山田 太郎"
    },
    "issued_staff": null,
    "done_staff": null,
    "details": [
      {
        "id": 456,
        "src_item": {
          "id": 23,
          "code": "ITBC0PV0VJPA",
          "is_tracked": true,
          "alias_code": null,
          "store": {
            "id": 1,
            "name": "main"
          },
          "price": 33,
          "grade": {
            "id": 2,
            "name": "中古A"
          },
          "condition_note": null,
          "condition_tags": [
            {
              "id": 1,
              "name": "喫煙あり"
            }
          ],
          "note": null,
          "stocks": [
            {
              "location": {
                "id": 1,
                "type": "DEFAULT",
                "name": "デフォルト"
              },
              "status": "PENDING",
              "quantity": 1,
              "cost_price": 20
            }
          ],
          "image_url": "https://...",
          "racks": [],
          "product_id": 7,
          "created_at": 1673411650,
          "updated_at": 1673411650
        },
        "dist_item": null,
        "issued_quantity": 1,
        "received_quantity": 0,
        "cost_price": 20
      }
    ],
    "created_at": 1673411650,
    "issued_at": null,
    "done_at": null
  }
]

key	type	説明
*	array<object>	在庫店舗変更ケース
*.id	int	ID
*.store	object	店舗
*.store.id	int	店舗ID
*.store.name	string	店舗名
*.status	string	ステータス
*.location	object	ロケーション
*.location.id	int	ロケーションID
*.location.type	string	ロケーションタイプ
*.location.name	string	ロケーション名
*.item_status	string	在庫ステータス (*1)
*.src_store	object	移動元店舗情報
*.src_store.id	int	移動元店舗ID
*.src_store.name	string	移動元店舗名
*.dist_store	object	移動先店舗情報
*.dist_store.id	int	移動先店舗ID
*.dist_store.name	string	移動先店舗名
*.created_staff	object | null	作成担当者
*.created_staff.id	int	作成担当者ID
*.created_staff.name	string	作成担当者名
*.issued_staff	object | null	出庫担当者
*.issued_staff.id	int	出庫担当者ID
*.issued_staff.name	string	出庫担当者名
*.done_staff	object | null	完了担当者
*.done_staff.id	int	完了担当者ID
*.done_staff.name	string	完了担当者名
*.note	string | null	備考
*.details	array<object>	詳細
*.details.*.id	int	詳細ID
*.details.*.src_item	object	移動元在庫 (在庫入庫と同様)
*.details.*.dist_item	object | null	移動先在庫 (在庫入庫と同様)
*.details.*.issued_quantity	int	出庫数量
*.details.*.received_quantity	int	入庫数量
*.details.*.cost_price	int	コスト
*.created_at	int | null	作成日時
*.issued_at	int | null	出庫日時
*.done_at	int | null	完了日時

• ステータス
  • IN_PROGRESS 処理中
  • ISSUED 出庫済み
  • RECEIVED 入庫済み
  • CANCELED キャンセル

在庫店舗変更ケース取得

概要

• 在庫店舗変更ケースを1件取得する

基本情報

• リクエストパス: GET /items/change_stores/{case_id}
• JWTスコープ: item:change_store:show
• 必須個別JWTパラメータ: なし
• レートリミット: 5 rps

例

• Request

GET /items/change_stores/123

• Response

在庫店舗変更ケース検索のresponse[0]と同様

在庫店舗変更ケース作成

概要

• 在庫店舗変更ケースを作成する

基本情報

• リクエストパス: POST /items/change_stores
• JWTスコープ: item:change_store:store
• 必須個別JWTパラメータ: store_id (またはX-Store-Idヘッダ)
• レートリミット: 2 rps

body

key	type	説明	制約など
staff_id	?int | null	スタッフID	-
location_id	int	ロケーションID	-
item_status	string	在庫ステータス	PENDING ACTIVE
src_store_id	int	移動元店舗ID	-
dist_store_id	int	移動先店舗ID	-
note	?string | null	備考	-
details	array<object>	詳細情報	1件以上 1000件まで
details.*.src_item_id	int	移動元在庫ID	-
details.*.issued_quantity	?int	出庫数量	1以上
details.*.received_quantity	?int	入庫数量	0以上

例

• Request

POST /items/change_stores

{
  "staff_id": 1,
  "location_id": 1,
  "item_status": "ACTIVE",
  "src_store_id": 1,
  "dist_store_id": 2,
  "note": null,
  "details": [
    {
      "src_item_id": 23,
      "issued_quantity": 1,
      "received_quantity": 0
    }
  ]
}

• Response

在庫店舗変更ケース取得と同様

在庫店舗変更ケース更新

概要

• 在庫店舗変更ケースを更新する

基本情報

• リクエストパス: PUT /items/change_stores/{case_id}
• JWTスコープ: item:change_store:update
• 必須個別JWTパラメータ: なし
• レートリミット: 2 rps

body

在庫店舗変更ケース作成との差分のみ記載

key	type	説明	制約など
details.*.action	string	アクション	CREATE UPDATE DELETE
details.*.id	?int (*2)	詳細ID	-
details.*.src_item_id	?int (*1)	移動元在庫ID	-
details.*.issued_quantity	?int	出庫数量	1以上
details.*.received_quantity	?int	入庫数量	0以上

• *1) action: CREATEの場合必須
• *2) action: UPDATEの場合必須

例

• Request

PUT /items/change_stores/123

{
  "note": null,
  "details": [
    {
      "action": "UPDATE",
      "id": 456,
      "issued_quantity": 2,
      "received_quantity": 1
    },
    {
      "action": "CREATE",
      "src_item_id": 24,
      "issued_quantity": 1,
      "received_quantity": 0
    }
  ]
}

• Response

在庫店舗変更ケース取得と同様

在庫店舗変更ケース削除

概要

• 在庫店舗変更ケースを削除する

基本情報

• リクエストパス: DELETE /items/change_stores/{case_id}
• JWTスコープ: item:change_store:destroy
• 必須個別JWTパラメータ: なし
• レートリミット: 2 rps

例

• Request

DELETE /items/change_stores/123

• Response

(なし)

在庫店舗変更ステータス更新

概要

• 在庫店舗変更ケースのステータスを更新する

基本情報

• リクエストパス: PUT /items/change_stores/{case_id}/status
• JWTスコープ: item:change_store:status:update
• 必須個別JWTパラメータ: なし
• レートリミット: 2 rps

body

key	type	説明	制約など
staff_id	?int | null	スタッフID	-
status	string	ステータス	(*1)

• *1) ステータス遷移の制約:
  • IN_PROGRESS → ISSUED
  • ISSUED → RECEIVED CANCELED
  • RECEIVED CANCELED: 他のステータスへ変更不可

例

• Request

PUT /items/change_stores/123/status

{
  "staff_id": 1,
  "status": "ISSUED"
}

• Response

在庫店舗変更ケース取得と同様

在庫属性検索

概要

• 在庫属性情報の検索を行う

基本情報

• リクエストパス: GET /items/attributes
• JWTスコープ: item:attribute:index
• 必須個別JWTパラメータ: なし
• レートリミット: 5 rps

query

key	説明	制約など
ids	在庫ID	整数のみ、カンマ区切りで複数指定可能
category_id	カテゴリID	-
page	ページ	整数のみ、デフォルト:1
limit	1ページあたりの件数	整数のみ、デフォルト:50、最大: 250

例

• Request

GET /items/attributes?ids=1,2

• Response

[
  {
    "id": 1,
    "key": "custom_huga",
    "label": "フガ",
    "type": "TEXT",
    "sort": 0,
    "is_required": true,
    "description": "説明文のサンプル",
    "is_multiple": false,
    "has_options": false,
    "options": []
  }
]

key	type	説明
*	array<object>	在庫属性
*.key	string	在庫属性キー
*.label	string	在庫属性名
*.type	string	属性タイプ
*.sort	int	表示順
*.is_required	boolean	必須項目かどうか
*.description	string | null	属性の説明文
*.is_multiple	boolean	複数選択可能かどうか
*.has_options	boolean	選択肢を持つかどうか
*.options	array<string>	選択肢