従業員所属事業所登録・更新

PUT

/staffs/{staff_id}/staff_stores/{store_id}

• サンドボックス
• 本番

指定した従業員の所属事業所を登録・更新します（upsert）。

指定した staff_id × store_id の所属が未存在の場合は登録し（201）、 既存の場合は更新します（200）。

対象

• プラン
  • スタンダード
  • プレミアム
  • プレミアムプラス
  • エンタープライズ

対象ユーザー権限

• 従業員管理編集（全て）
• 従業員管理編集（給与情報除く）

Authorizations

• AppAccessToken
  timecard.staffs:write
• UserAccessToken
  timecard.staffs:write

Parameters

Path Parameters

staff_id

required

string

従業員ID

Example

1

store_id

required

string

事業所ID

Example

1

Request Body ^required

object

roleId

required

役割ID

string

applicationDisplayFlag

required

アプリ表示設定

boolean

mailFlag

required

事業所からのメール受信設定

boolean

Example

{
  "roleId": "2",
  "applicationDisplayFlag": true,
  "mailFlag": false
}

Responses

200

更新成功

object

staffId

従業員ID

string

storeId

事業所ID

string

roleId

役割ID

string

applicationDisplayFlag

アプリ表示設定

boolean

mailFlag

事業所からのメール受信設定

boolean

Example

{
  "staffId": "123",
  "storeId": "1",
  "roleId": "2",
  "applicationDisplayFlag": true,
  "mailFlag": false
}

201

作成成功

object

staffId

従業員ID

string

storeId

事業所ID

string

roleId

役割ID

string

applicationDisplayFlag

アプリ表示設定

boolean

mailFlag

事業所からのメール受信設定

boolean

Example

{
  "staffId": "123",
  "storeId": "1",
  "roleId": "2",
  "applicationDisplayFlag": true,
  "mailFlag": false
}

400

• リクエスト形式が不正な場合
• 参照整合性・業務制約に違反する場合

object

type

エラータイプを識別するURI、もしくはabout:blank

string

title

エラーの概要

string

detail

エラーの詳細

string

Example

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "roleId が指定された事業所に属していません。"
}

404

• 指定した従業員IDのデータが存在しない場合
• 指定した事業所IDが存在しない場合

object

type

エラータイプを識別するURI、もしくはabout:blank

string

title

エラーの概要

string

detail

エラーの詳細

string

Example

{
  "type": "about:blank",
  "title": "Not Found",
  "detail": "指定した従業員IDまたは事業所IDのデータが確認できませんでした。"
}