役割・役職更新

Authorizations

AppAccessToken
pos.staffs:write
UserAccessToken
pos.staffs:write

Path Parameters

role_id

required

string

役割・役職ID

Request Body

object

roleName

役割名・役職名

対象プラン プレミアム／プレミアムプラス／フードビジネス／リテールビジネス
役割名・役職名

string

<= 30 characters

note

説明

対象プラン プレミアム／プレミアムプラス／フードビジネス／リテールビジネス
説明

string

<= 255 characters

functionControls

機能制限

機能制限：POS機能における役割・役職に対する機能制限の一覧です。
※ 機能ID 2:商品管理機能が指定されている場合、商品管理機能の個別設定（ID: 2001〜2012）のうち指定されていないものに対しては、機能ID 2に対して設定された制限区分の値を超えない最大の制限区分の値が一括で付与されます。
※ 機能ID 7:スタッフ管理機能が指定されている場合、スタッフ管理機能の個別設定（ID: 7001〜7003）のうち指定されていないものに対しては、機能ID 7に対して設定された制限区分の値を超えない最大の制限区分の値が一括で付与されます。（例外として、機能ID 7:スタッフ管理機能の制限区分に「3:編集」が設定された場合、機能ID 7003:ログイン情報編集権限には「4:すべて」の制限区分が付与されます。）
※ 上記以外は、IDが指定された機能の制限区分のみ変更されます。

Array<object>

object

functionId

required

機能ID

機能ID：制限対象機能のIDです。
機能制限を設定する場合必須。
※ 役割・役職IDが 1:管理者の場合は、7:スタッフ管理機能は設定できません。
1:トップページ機能
2:商品管理機能 ※ 下記2000番台にある商品管理機能個別設定が存在する場合は、個別設定権限の方が優先して適用されます。
3:日次処理機能
4:取引履歴機能
5:売上分析機能（1:使用不可または 2:閲覧または 4:すべてのみ）
6:店舗管理機能
7:スタッフ管理機能 ※ 下記7000番台にあるスタッフ管理機能個別設定が存在する場合は、個別設定権限の方が優先して適用されます。
8:予算管理機能
9:会員管理機能
10:スマレジ・ストア機能（1:使用不可または 4:すべてのみ）
11:値札発行機能（1:使用不可または 4:すべてのみ）（非推奨）※ 商品管理機能個別設定へ移行するため将来的に入力チェックでエラーとなる予定です。商品管理機能個別設定（2012:値札発行）の設定が存在する場合、個別設定権限の方が優先して適用されます。
12:各種設定機能
13:原価表示機能
14:一括削除機能
15:アプリ通知機能
16:PL管理機能
18:ポイント管理機能
19:集計パターン保存・削除権限（1:使用不可または 4:すべてのみ）
20:レジ端末印刷機能（1:使用不可または 2:閲覧または 4:すべてのみ）
2001:商品
2002:部門
2003:仕入先
2004:在庫調整
2005:お気に入り商品（アイコン）（1:使用不可または 4:すべてのみ）
2006:価格変更履歴（1:使用不可または 2:閲覧または 4:すべてのみ）
2007:セール
2008:オプショングループ
2009:バンドル販売
2010:販売商品パターン
2011:属性
2012:値札発行（1:使用不可または 4:すべてのみ）
7001:スタッフ
7002:役割・役職
7003:ログイン情報編集権限（1:使用不可または 4:すべてのみ）

string

Allowed values: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 18 19 20 2001 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 7001 7002 7003

controlDivision

required

制限区分

制限区分：対象機能に対する制限区分です。（1:使用不可、2:閲覧、3:編集、4:すべて）
機能制限を設定する場合必須。

string

Allowed values: 1 2 3 4

inventoryFunctionControls

在庫機能制限

対象プラン リテールビジネス
在庫機能制限：在庫機能における役割・役職に対する機能制限の一覧です。
※ IDが指定された機能の制限区分のみ変更されます。

Array<object>

object

functionId

required

機能ID

機能ID：制限対象機能のIDです。
在庫機能制限を設定する場合必須。
1:発注管理機能
2:発注設定機能
3:入荷管理機能
4:出庫管理機能
5:入庫管理機能
6:棚卸機能
7:在庫分析機能
8:在庫高機能（1:使用不可または 2:閲覧のみ）
9:在庫一覧機能（1:使用不可または 2:閲覧または 4:すべてのみ）
10:ロス管理機能
11:出荷管理機能
12:棚卸完了権限（1:使用不可または 4:すべてのみ）

string

Allowed values: 1 2 3 4 5 6 7 8 9 10 11 12

controlDivision

required

制限区分

制限区分：対象機能に対する制限区分です。（1:使用不可、2:閲覧、3:編集、4:すべて）
在庫機能制限を設定する場合必須。

string

Allowed values: 1 2 3 4

alertFunctionControls

アラート機能制限

対象プラン リテールビジネス
アラート機能制限：在庫アラートにおける役割・役職に対する機能制限の一覧です。
※ IDが指定された機能の制限区分のみ変更されます。

Array<object>

object

alertType

required

アラート種別

アラート種別：制限対象アラートの種別です。（1:在庫切れ、2:発注点）
アラート機能制限を設定する場合必須。

string

Allowed values: 1 2

controlDivision

required

制限区分

制限区分：対象機能に対する制限区分です。（0:使用不可、1:使用可）
アラート機能制限を設定する場合必須。

string

Allowed values: 0 1

Example

{
  "roleName": "string",
  "note": "string",
  "functionControls": [
    {
      "functionId": "1",
      "controlDivision": "1"
    }
  ],
  "inventoryFunctionControls": [
    {
      "functionId": "1",
      "controlDivision": "1"
    }
  ],
  "alertFunctionControls": [
    {
      "alertType": "1",
      "controlDivision": "0"
    }
  ]
}

200

更新成功

object

roleId

役割・役職ID

string

roleName

役割名・役職名

string

note

説明

string

insDateTime

作成日時：登録時の日時。[YYYY-MM-DDThh:mm:ssTZD]

string

updDateTime

更新日時：登録時・更新時の日時。[YYYY-MM-DDThh:mm:ssTZD]

string

functionControls

機能制限：POS機能における役割・役職に対する機能制限の一覧です。
※ 機能ID 2:商品管理機能が指定されている場合、商品管理機能の個別設定（ID: 2001〜2012）のうち指定されていないものに対しては、機能ID 2に対して設定された制限区分の値を超えない最大の制限区分の値が一括で付与されます。
※ 機能ID 7:スタッフ管理機能が指定されている場合、スタッフ管理機能の個別設定（ID: 7001〜7003）のうち指定されていないものに対しては、機能ID 7に対して設定された制限区分の値を超えない最大の制限区分の値が一括で付与されます。（例外として、機能ID 7:スタッフ管理機能の制限区分に「3:編集」が設定された場合、機能ID 7003:ログイン情報編集権限には「4:すべて」の制限区分が付与されます。）
※ 上記以外は、IDが指定された機能の制限区分のみ変更されます。

Array<object>

object

functionId

機能ID：制限対象機能のIDです。
機能制限を設定する場合必須。
※ 役割・役職IDが 1:管理者の場合は、7:スタッフ管理機能は設定できません。
1:トップページ機能
2:商品管理機能 ※ 下記2000番台にある商品管理機能個別設定が存在する場合は、個別設定権限の方が優先して適用されます。
3:日次処理機能
4:取引履歴機能
5:売上分析機能（1:使用不可または 2:閲覧または 4:すべてのみ）
6:店舗管理機能
7:スタッフ管理機能 ※ 下記7000番台にあるスタッフ管理機能個別設定が存在する場合は、個別設定権限の方が優先して適用されます。
8:予算管理機能
9:会員管理機能
10:スマレジ・ストア機能（1:使用不可または 4:すべてのみ）
11:値札発行機能（1:使用不可または 4:すべてのみ）（非推奨）※ 商品管理機能個別設定へ移行するため将来的に入力チェックでエラーとなる予定です。商品管理機能個別設定（2012:値札発行）の設定が存在する場合、個別設定権限の方が優先して適用されます。
12:各種設定機能
13:原価表示機能
14:一括削除機能
15:アプリ通知機能
16:PL管理機能
18:ポイント管理機能
19:集計パターン保存・削除権限（1:使用不可または 4:すべてのみ）
20:レジ端末印刷機能（1:使用不可または 2:閲覧または 4:すべてのみ）
2001:商品
2002:部門
2003:仕入先
2004:在庫調整
2005:お気に入り商品（アイコン）（1:使用不可または 4:すべてのみ）
2006:価格変更履歴（1:使用不可または 2:閲覧または 4:すべてのみ）
2007:セール
2008:オプショングループ
2009:バンドル販売
2010:販売商品パターン
2011:属性
2012:値札発行（1:使用不可または 4:すべてのみ）
7001:スタッフ
7002:役割・役職
7003:ログイン情報編集権限（1:使用不可または 4:すべてのみ）

string

controlDivision

制限区分：対象機能に対する制限区分です。（1:使用不可、2:閲覧、3:編集、4:すべて）
機能制限を設定する場合必須。

string

inventoryFunctionControls

対象プラン リテールビジネス
在庫機能制限：在庫機能における役割・役職に対する機能制限の一覧です。
※ IDが指定された機能の制限区分のみ変更されます。

Array<object>

object

functionId

機能ID：制限対象機能のIDです。
在庫機能制限を設定する場合必須。
1:発注管理機能
2:発注設定機能
3:入荷管理機能
4:出庫管理機能
5:入庫管理機能
6:棚卸機能
7:在庫分析機能
8:在庫高機能（1:使用不可または 2:閲覧のみ）
9:在庫一覧機能（1:使用不可または 2:閲覧または 4:すべてのみ）
10:ロス管理機能
11:出荷管理機能
12:棚卸完了権限（1:使用不可または 4:すべてのみ）

string

controlDivision

制限区分：対象機能に対する制限区分です。（1:使用不可、2:閲覧、3:編集、4:すべて）
在庫機能制限を設定する場合必須。

string

alertFunctionControls

対象プラン リテールビジネス
アラート機能制限：在庫アラートにおける役割・役職に対する機能制限の一覧です。
※ IDが指定された機能の制限区分のみ変更されます。

Array<object>

object

alertType

アラート種別：制限対象アラートの種別です。（1:在庫切れ、2:発注点）
アラート機能制限を設定する場合必須。

string

controlDivision

制限区分：対象機能に対する制限区分です。（0:使用不可、1:使用可）
アラート機能制限を設定する場合必須。

string

Example

{
  "roleId": "string",
  "roleName": "string",
  "note": "string",
  "insDateTime": "string",
  "updDateTime": "string",
  "functionControls": [
    {
      "functionId": "string",
      "controlDivision": "string"
    }
  ],
  "inventoryFunctionControls": [
    {
      "functionId": "string",
      "controlDivision": "string"
    }
  ],
  "alertFunctionControls": [
    {
      "alertType": "string",
      "controlDivision": "string"
    }
  ]
}

400

機能IDが機能制限内で重複した場合

機能IDが在庫機能制限内で重複した場合

アラート種別がアラート機能制限内で重複した場合

機能制限に対して設定できない制限区分が設定されている場合

在庫機能制限に対して設定できない制限区分が設定されている場合

役割・役職IDが 1:管理者の役割・役職に対して、機能制御に機能IDが 7:スタッフ管理機能の要素が含まれた場合

在庫機能制限の機能ID 2:発注設定機能に制限区分 3:編集でも 4:すべてでもない区分が指定されているか、機能ID 2:発注設定機能の要素は含まれておらずかつ既に登録された機能ID 2:発注設定機能の制限区分が 3:編集でも 4:すべてでもない場合で、アラート機能設定にて制限区分に 1:使用可が指定された要素が存在するか、既に登録されており当更新において変更されないアラート機能の制限区分に 1:使用可が設定されたものが存在する場合

object

type

required

string

title

required

string

detail

string

status

integer

Examples

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "同一の機能IDが複数の機能制限に対して設定されています。(機能ID-{機能ID})",
  "status": 400
}

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "同一の機能IDが複数の在庫機能制限に対して設定されています。(機能ID-{機能ID})",
  "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}, 制限区分-{制限区分})",
  "status": 400
}

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "役割・役職IDが 1:管理者 の役割・役職に対しては、機能ID 7:スタッフ管理機能及び個別設定の制限区分を変更することはできません。",
  "status": 400
}

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "在庫機能制限において 2:発注設定機能 が 3:編集 以上の制限区分の役割・役職に対してのみ、アラート機能制限の各機能の制限区分に 1:使用可 が設定できます。",
  "status": 400
}

403

プレミアムプラン未満で、役割・役職IDに 1:管理者以外を指定した場合
プレミアムプラン未満で、制御区分に 4:すべて以外を指定した場合

object

type

required

string

title

required

string

detail

string

status

integer

Examples

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "[id]ご利用の契約では、1:管理者 のみ指定可能です。",
  "status": 403
}

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "ご利用の契約では、制限区分は 4:すべて 以外指定できません。(機能ID-{機能ID}, 制限区分-{制限区分})",
  "status": 403
}

404

指定された役割・役職が存在しない場合

object

type

required

string

title

required

string

detail

string

status

integer

Examples

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

役割・役職更新

対象プラン

Authorizations

Parameters

Path Parameters

Request Body

Example

Responses

200

Example

400

Examples

403

Examples

404

Examples