従業員賃金設定更新

PUT

/staffs/{staff_id}/wage_apply/{wage_apply_id}

curl --request PUT \
  --url https://api.smaregi.dev/TARGET-CONTRACT-ID/timecard/staffs/1/wage_apply/10 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "division": 0, "effectiveDate": "2026-03-01", "storeId": "10", "wage": 1200 }'

• サンドボックス
• 本番

従業員の賃金設定を更新します。
既存の従業員取得 API 互換のため、営業時間帯別時給は division=3 でも更新できます。

対象

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

対象ユーザー権限

• 従業員管理編集（全て）

Authorizations

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

Parameters

Path Parameters

staff_id

required

string

従業員ID

Example

1

wage_apply_id

required

string

賃金設定ID

Example

10

Request Body^required

Media typeapplication/json

One of:

時給による更新

時給による更新

object

division

required

給与形態区分

• 0: 時給

integer

Allowed values: 0

effectiveDate

required

適用開始時期 [YYYY-MM-DD] 1970-01-01以降を指定してください

string format: date

storeId

事業所ID

string

nullable

businessHourId

営業時間帯ID（storeId を指定して省略した場合、または null を指定した場合は、「すべての営業時間帯」として扱います）

string

nullable

wage

required

賃金

integer

holidayWage

休日賃金

integer

nullable

Example

{
  "division": 0,
  "effectiveDate": "2026-03-01",
  "storeId": "10",
  "wage": 1200
}

営業時間帯別時給による更新

営業時間帯別時給による更新

object

division

required

給与形態区分

• 3: 時給（営業時間帯別時給。互換更新のみ）

integer

Allowed values: 3

effectiveDate

required

適用開始時期 [YYYY-MM-DD] 1970-01-01以降を指定してください

string format: date

storeId

required

事業所ID

string

businessHourId

required

営業時間帯ID

string

wage

required

賃金

integer

holidayWage

休日賃金

integer

nullable

Example

{
  "division": 3,
  "effectiveDate": "2026-03-01",
  "storeId": "10",
  "businessHourId": "2",
  "wage": 1300
}

日給による更新

日給による更新

object

division

required

給与形態区分

• 1: 日給

integer

Allowed values: 1

effectiveDate

required

適用開始時期 [YYYY-MM-DD] 1970-01-01以降、日給は月初日を指定してください

string format: date

storeId

事業所ID

string

nullable

wage

required

賃金

integer

Example

{
  "division": 1,
  "effectiveDate": "2026-03-01",
  "storeId": "10",
  "wage": 8000
}

月給による更新

月給による更新

object

division

required

給与形態区分

• 2: 月給

integer

Allowed values: 2

effectiveDate

required

適用開始時期 [YYYY-MM-DD] 1970-01-01以降、月給は月初日を指定してください

string format: date

wage

required

賃金

integer

fixedWage

object

amount

required

固定残業代金額

integer

>= 1

rules

required

固定残業代に含める割増種別一覧

Array<object>

<= 6 items unique items

object

ruleType

required

固定残業代に含める割増種別

• statutoryOvertime: 法定時間外
• midnight: 深夜
• prescribedHoliday: 所定休日
• statutoryHoliday: 法定休日
• month45HourOvertime: 月45時間超の時間外
• month60HourOvertime: 月60時間超の時間外

string

Allowed values: statutoryOvertime midnight prescribedHoliday statutoryHoliday month45HourOvertime month60HourOvertime

Example

{
  "division": 2,
  "effectiveDate": "2026-03-01",
  "wage": 250000,
  "fixedWage": {
    "amount": 30000,
    "rules": [
      {
        "ruleType": "statutoryOvertime"
      }
    ]
  }
}

Responses

200

更新成功

Media typeapplication/json

object

staffId

従業員ID

string

wageApplyId

賃金設定ID

string

>= 1 characters

Example

{
  "staffId": "1",
  "wageApplyId": "10"
}

400

• リクエスト形式が不正な場合
• 1970-01-01 より前の適用開始時期を指定した場合
• 日給・月給で月初日以外の適用開始時期を指定した場合
• 一意性制約・整合性制約に違反する場合（例: 同一適用開始日の重複、同一適用開始時期の既存設定と矛盾する給与形態区分/事業所ID/営業時間帯IDの指定）

Media typeapplication/json

object

type

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

string

title

エラーの概要

string

detail

エラーの詳細

string

Examples

1970-01-01 より前の適用開始時期

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "effectiveDate は 1970-01-01 以降の日付を指定してください。"
}

日給・月給で月初日以外の適用開始時期

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "effectiveDate は日給・月給の場合は月初日を指定してください。"
}

同一適用開始日の重複

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "同一適用開始日に重複する賃金設定が存在します。"
}

同一適用開始時期グループとの整合性違反

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "同一適用開始時期の既存賃金設定と整合しないため更新できません。"
}

404

• 指定した従業員IDのデータが存在しない場合
• 指定した賃金設定IDが存在しない、または従業員に紐づかない場合

Media typeapplication/json

object

type

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

string

title

エラーの概要

string

detail

エラーの詳細

string

Examples

従業員IDが存在しない場合

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

賃金設定IDが存在しない、または従業員に紐づかない場合

{
  "type": "about:blank",
  "title": "Not Found",
  "detail": "データが確認できませんでした。wageApplyId: 999"
}