月別賞与一覧取得

GET

/bonuses/monthly

サンドボックス
本番

月別賞与一覧を取得します

対象

プラン
- プレミアム
- プレミアムプラス
- エンタープライズ、旧有料

対象ユーザー権限

給与管理閲覧

Authorizations

AppAccessToken
timecard.salaries:read
UserAccessToken
timecard.salaries:read

Parameters

Query Parameters

year

required

string

/^\d{4}$/

対象年 [YYYY]

Example

month

required

string

/^\d{2}$/

対象月 [MM]

Example

staff_name

string

従業員名

Example

スマレジ太郎

staff_group_code

string

従業員グループコード（カンマ区切りで複数指定可）

Examples

単一指定

複数指定

1,2

limit

integer

default: 30 >= 1 <= 100

上限値

Example

page

integer

default: 1 >= 1

検索対象ページ番号

Example

Responses

200

取得成功

object

count

件数

number

page

現在のページ番号

number

pageCount

総ページ数

number

bonusesMonthly

従業員別の月別賞与情報リスト

Array<object>

object

staffId

従業員ID

string

allowanceAmount

支給額

string

deductingAmount

控除額

string

taxableAmount

課税対象額

string

netPay

差引支給額

string

staffName

従業員名

string

staffCode

社員番号

string

bonusesMonthlyTotal

月別賞与合計

object

totalAllowanceAmount

支給額合計

string

totalDeductingAmount

控除額合計

string

totalNetPay

差引支給額合計

string

Example

{
  "count": 2,
  "page": 1,
  "pageCount": 1,
  "bonusesMonthly": [
    {
      "staffId": "1",
      "allowanceAmount": "50000",
      "deductingAmount": "5000",
      "taxableAmount": "45000",
      "netPay": "45000",
      "staffName": "スマレジ太郎",
      "staffCode": "A001"
    },
    {
      "staffId": "2",
      "allowanceAmount": "30000",
      "deductingAmount": "3000",
      "taxableAmount": "27000",
      "netPay": "27000",
      "staffName": "スマレジ花子",
      "staffCode": ""
    }
  ],
  "bonusesMonthlyTotal": {
    "totalAllowanceAmount": "80000",
    "totalDeductingAmount": "8000",
    "totalNetPay": "72000"
  }
}

Headers

Link

string

<前のURI>; rel="prev", <次のURI>; rel="next"

400

リクエストの形式が不正な場合

object

type

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

string

title

エラーの概要

string

detail

エラーの詳細

string

Example

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "月は2桁で入力してください。"
}