esmDevelopers
JSプラグイン
esm API
JSプラグイン
esm API
  • 商品(product)

商品(product)

商品に関する情報の登録・更新・取得・削除ができます。

レコードのidの取得にはSearch APIが使用できます。

商品取得

必要な権限

商品参照

Request

URL

https://gateway-esm.softbrain.com/sheet-fs/{tenant}/pub/esms/v1/sheet/product/{id}

HTTP Method

GET

Parameter

Path Parameter
No.パラメータ必須タイプデフォルト値説明
1tenant○string-テナントID
2id○string-対象レコードID

商品登録

必要な権限

商品登録

Request

URL

https://gateway-esm.softbrain.com/sheet-fs/{tenant}/pub/esms/v1/sheet/product

HTTP Method

POST

Parameter

Path Parameter
No.パラメータ必須タイプデフォルト値説明
1tenant○string-テナントID
Request Body
No.プロパティ名必須項目名タイプ備考
1products.product.product_category所属カテゴリstring所属カテゴリマスタの選択肢名。マスタの選択肢取得方法
2products.product.product_name商品名string
3products.product.product_name_designation商品名(呼称)string
4products.product.unit_price参考標準価格number
5products.product.product_picture商品画像object
- fileidファイルIDstring事前にcmsにアップロードしたfileIdを指定
6products.product.is_available使用可否booleantrue もしくは false
7products.product.memoメモstring
8拡張項目の項目名は、システムで設定するitem_idを設定する。item_idの確認方法拡張項目any()拡張項目を追加する際、アイテムタイプ別定義のページを参照する

Example

{
  "products.product.product_category": "ライセンス",
  "products.product.product_name": "AIコンシェルジュ",
  "products.product.product_name_designation": null,
  "products.product.unit_price": 2500000.0,
  "products.product.product_picture": {
    "fileid": "e9d21953b1e744668eaded9c7e368180"
  },
  "products.product.is_available": true,
  "products.product.memo": "メモ"
}

商品更新

必要な権限

商品変更

Request

URL

https://gateway-esm.softbrain.com/sheet-fs/{tenant}/pub/esms/v1/sheet/product/{id}

HTTP Method

PUT

Parameter

Path Parameter
No.パラメータ必須タイプデフォルト値説明
1tenant○string-テナントID
2id○string-対象レコードID
Request Body
No.プロパティ名必須項目名タイプ備考
1products.product.product_category所属カテゴリstring所属カテゴリマスタの選択肢名。マスタの選択肢取得方法
2products.product.product_name商品名string
3products.product.product_name_designation商品名(呼称)string
4products.product.unit_price参考標準価格number
5products.product.product_picture商品画像object
- fileidファイルIDstring事前にcmsにアップロードしたfileIdを指定
6products.product.is_available使用可否booleantrue もしくは false
7products.product.memoメモstring
8拡張項目の項目名は、システムで設定するitem_idを設定する。item_idの確認方法拡張項目any()拡張項目を追加する際、アイテムタイプ別定義のページを参照する

Example

{
  "products.product.product_category": "ライセンス",
  "products.product.product_name": "AIコンシェルジュ",
  "products.product.product_name_designation": null,
  "products.product.unit_price": 2500000.0,
  "products.product.product_picture": {
    "fileid": "e9d21953b1e744668eaded9c7e368180"
  },
  "products.product.is_available": true,
  "products.product.memo": "メモ"
}

商品削除

必要な権限

商品削除・商品一括削除

Request

URL

https://gateway-esm.softbrain.com/sheet-fs/{tenant}/pub/esms/v1/sheet/product/{id}

HTTP Method

DELETE

Parameter

Path Parameter
No.パラメータ必須タイプデフォルト値説明
1tenant○string-テナントID
2id○string-対象レコードID

Response

Response Body

Response Bodyはこちらの共通仕様に則っています。

No.プロパティ名項目名タイプ備考
1products.product.id商品IDnumber
2products.product.product_category所属カテゴリstringカテゴリマスタの値
3products.product.product_name商品名string
4products.product.product_name_designation商品名(呼称)string
5products.product.unit_price参考標準価格number
6products.product.product_picture商品画像object
- fileidファイルIDstring取得したfileIdを使って、cmsからファイルをダウンロード可能
- filenameファイル名string
7products.product.is_available使用可否booleantrue もしくは false
8products.product.memoメモstring
9system_reg_date登録日string"yyyy/mm/dd hh:MM"形式 ※取得のみ
10system_reg_user登録ユーザnumber登録者ユーザID ※取得のみ
11system_reg_employee登録社員number登録社員ID ※取得のみ
12system_upd_date更新日string"yyyy/mm/dd hh:MM"形式 ※取得のみ
13system_upd_user最終更新ユーザnumber最終更新者ユーザID ※取得のみ
14system_upd_employee最終更新社員number最終更新者社員ID ※取得のみ
15拡張項目の項目名は、システムで設定するitem_idを設定する。item_idの確認方法拡張項目any()拡張項目を追加する際、アイテムタイプ別定義のページを参照する

Example

{
  "products.product.id": 123,
  "products.product.product_category": "ライセンス",
  "products.product.product_name": "AIコンシェルジュ",
  "products.product.product_name_designation": null,
  "products.product.unit_price": 2500000.0,
  "products.product.product_picture": {
    "fileid": "e9d21953b1e744668eaded9c7e368180",
    "filename": "file.jpg"
  },
  "products.product.is_available": true,
  "products.product.memo": "メモ",
  "system_reg_date": "2024/01/01 00:00",
  "system_reg_user": 123,
  "system_reg_employee": 456,
  "system_upd_date": "2024/01/02 00:00",
  "system_upd_user": 123,
  "system_upd_employee": 456
}