有給休暇
有給休暇API

Supported Formats

json
>>>

GET /paid_holidays/list
社員毎の有給休暇の付与、取得の状況を返します。

入退社状態が退社の社員は返しません。
〈役員区分〉に役員を設定した社員は労働基準法の管轄外のため返しません。
有給残日数は、実行日時点での残日数です。

サポートフォーマット

json

エラー

エラーコード エラー説明
401 Not Authorizedアクセストークンが送られていないか正しくありません。もしくはクライアント認証トークンが正しくありません。
403 Forbiddenそのリクエストに必要な権限がありません。
404 Not found指定されたパスは正しくないか、リソースが見つかりません。
422 Unprocessable Entity1つ以上のパラメータが正しくないか不足しています。エラーメッセージで原因が判別できます。
500 Internal Server Errorサーバーで何らかのエラーが起こりました。
503 Service Unavailableあなたの IP アドレスから非常に多くのリクエストがあった場合、このエラーが発生します。次のリクエストまで少し時間を開けてください。

例

[
  {
    "staff_id": 201,
    "staff_code": "EP0006",
    "staff_name": "萩原 茂",
    "director_segment": "2",
    "enrolled_from": "2003/04/01",
    "enrolled_month": "18年10ヶ月",
    "next_grant_ymd": "2022/02/09",
    "next_grant_count": 10.5,
    "remains_count": 18,
    "used_ratio": "137.0%",
    "has_application_in_progress": 1
  },
  {
    "staff_id": 2000,
    "staff_code": "EP2000",
    "staff_name": "山川 太郎",
    "director_segment": "2",
    "enrolled_from": "2001/01/01",
    "enrolled_month": "21年1ヶ月",
    "next_grant_ymd": null,
    "next_grant_count": null,
    "remains_count": 13.5,
    "used_ratio": "-0.0%",
    "has_application_in_progress": 0
  }
]

Returns

コード: 200

説明:

社員毎の有給休暇の付与、取得の状況を返します。

パラメータ名 説明
staff_id
任意

社員ID

Validations:

  • Must be a Integer
staff_code
任意

社員コード

Validations:

  • Must be a String
staff_name
任意

社員名

Validations:

  • Must be a String
director_segment
任意

役員区分 2:社員（契約社員を含む）, 3:使用人兼務役員, 4:パート・アルバイト

Validations:

  • Must be a String
enrolled_from
任意

入社日

Validations:

  • Must be a String
enrolled_month
任意

勤続年数

Validations:

  • Must be a String
next_grant_ymd
任意

次回有給付与日

Validations:

  • Must be a String
next_grant_count
任意

次回有給付与日数

Validations:

  • Must be a Float
remains_count
任意

有給残日数

Validations:

  • Must be a Float
used_ratio
任意

取得率

Validations:

  • Must be a String
has_application_in_progress
任意

申請状況 1:作成・申請中, 0:申請なし

Validations:

  • Must be a Integer
>>>

GET /paid_holidays/list_forms/:staff_id
指定した社員の有給休暇申請一覧を返します。

有給残日数は、実行日時点での残日数です。

サポートフォーマット

json

エラー

エラーコード エラー説明
401 Not Authorizedアクセストークンが送られていないか正しくありません。もしくはクライアント認証トークンが正しくありません。
403 Forbiddenそのリクエストに必要な権限がありません。
404 Not found指定されたパスは正しくないか、リソースが見つかりません。
422 Unprocessable Entity1つ以上のパラメータが正しくないか不足しています。エラーメッセージで原因が判別できます。
500 Internal Server Errorサーバーで何らかのエラーが起こりました。
503 Service Unavailableあなたの IP アドレスから非常に多くのリクエストがあった場合、このエラーが発生します。次のリクエストまで少し時間を開けてください。

例

{
  "staff_id": "yamakawa",
  "staff_code": "EP2000",
  "staff_name": "山川 太郎",
  "remains_count": -3.5,
  "forms": [
    {
      "id": 299982811,
      "application_type": 2,
      "days_count": 13.5,
      "start_timestamp": "2021/01/01 00:00:00 +0900",
      "finish_timestamp": "2021/01/14 23:59:59 +0900",
      "memo": "私用のため",
      "status": "承認済",
      "created_at": "2022/02/02 16:14:57 +0900",
      "regist_user_code": "admin",
      "updated_at": "2022/02/02 16:16:17 +0900",
      "update_user_code": "admin"
    },
    {
      "id": 1071568100,
      "application_type": 1,
      "days_count": 10,
      "start_timestamp": "2022/01/28 00:00:00 +0900",
      "finish_timestamp": "2022/01/28 23:59:59 +0900",
      "memo": "付与または取消",
      "status": "完了",
      "created_at": "2022/01/28 05:52:29 +0900",
      "regist_user_code": "admin",
      "updated_at": "2022/01/28 05:52:29 +0900",
      "update_user_code": null
    }
  ]
}

Returns

コード: 200

説明:

指定した社員の有給休暇申請一覧を返します。

パラメータ名 説明
staff_id
任意

社員ID

Validations:

  • Must be a Integer
staff_code
任意

社員コード

Validations:

  • Must be a String
staff_name
任意

社員名

Validations:

  • Must be a String
remains_count
任意

有給残日数

Validations:

  • Must be a Float
forms
任意

Validations:

  • Must be an Array of nested elements
forms[id]
任意

レコードId

Validations:

  • Must be a Integer
forms[application_type]
任意

種別 1:付与, 2:消化または取消

Validations:

  • Must be a Integer
forms[days_count]
任意

付与・消化日数

Validations:

  • Must be a Float
forms[start_timestamp]
任意

有休開始日

Validations:

  • Must be a String
forms[finish_timestamp]
任意

有休終了日

Validations:

  • Must be a String
forms[memo]
任意

備考

Validations:

  • Must be a String
forms[status]
任意

ステータス

Validations:

  • Must be a String
forms[created_at]
任意

登録日時 (YYYY/MM/DD hh:mm:ss)

Validations:

  • Must be a String
forms[regist_user_code]
任意

登録者

Validations:

  • Must be a String
forms[updated_at]
任意

更新日時 (YYYY/MM/DD hh:mm:ss)

Validations:

  • Must be a String
forms[update_user_code]
任意

更新者

Validations:

  • Must be a String
>>>

POST /paid_holidays/create
1レコードの有給休暇申請を作成します。

サポートフォーマット

json

エラー

エラーコード エラー説明
401 Not Authorizedアクセストークンが送られていないか正しくありません。もしくはクライアント認証トークンが正しくありません。
403 Forbiddenそのリクエストに必要な権限がありません。
404 Not found指定されたパスは正しくないか、リソースが見つかりません。
422 Unprocessable Entity1つ以上のパラメータが正しくないか不足しています。エラーメッセージで原因が判別できます。
500 Internal Server Errorサーバーで何らかのエラーが起こりました。
503 Service Unavailableあなたの IP アドレスから非常に多くのリクエストがあった場合、このエラーが発生します。次のリクエストまで少し時間を開けてください。

例

{
  "id": 1071568098,
  "application_type": 2,
  "days_count": 2.5,
  "start_timestamp": "2020/08/05 00:00:00 +0900",
  "finish_timestamp": "2020/08/07 23:59:59 +0900",
  "memo": "夏期休暇",
  "status": "作成中",
  "created_at": "2022/02/07 13:55:59 +0900",
  "regist_user_code": "yamakawa",
  "updated_at": "2022/02/07 13:55:59 +0900",
  "update_user_code": null
}

パラメータ

パラメータ名 説明
full_or_half
任意

全休か半休か, full:全休, half:半休

Validations:

  • Must be a String
staff_id
必須

社員ID

Validations:

  • Must be a Integer
holiday
任意

Validations:

  • Must be a Hash
holiday[start_timestamp]
任意

有休開始日

Validations:

  • Must be a String
holiday[finish_timestamp]
任意

有休終了日

Validations:

  • Must be a String
holiday[memo]
任意

備考

Validations:

  • Must be a String

Returns

コード: 200

説明:

1レコードの有給休暇申請を作成します。

パラメータ名 説明
id
任意

レコードId

Validations:

  • Must be a Integer
application_type
任意

種別 1:付与, 2:消化または取消

Validations:

  • Must be a Integer
days_count
任意

付与・消化日数

Validations:

  • Must be a Float
start_timestamp
任意

有休開始日

Validations:

  • Must be a String
finish_timestamp
任意

有休終了日

Validations:

  • Must be a String
memo
任意

備考

Validations:

  • Must be a String
status
任意

ステータス

Validations:

  • Must be a String
created_at
任意

登録日時 (YYYY/MM/DD hh:mm:ss)

Validations:

  • Must be a String
regist_user_code
任意

登録者

Validations:

  • Must be a String
updated_at
任意

更新日時 (YYYY/MM/DD hh:mm:ss)

Validations:

  • Must be a String
update_user_code
任意

更新者

Validations:

  • Must be a String
>>>

POST /paid_holidays/update/:id
1レコードの有給休暇申請を更新します。

サポートフォーマット

json

エラー

エラーコード エラー説明
401 Not Authorizedアクセストークンが送られていないか正しくありません。もしくはクライアント認証トークンが正しくありません。
403 Forbiddenそのリクエストに必要な権限がありません。
404 Not found指定されたパスは正しくないか、リソースが見つかりません。
422 Unprocessable Entity1つ以上のパラメータが正しくないか不足しています。エラーメッセージで原因が判別できます。
500 Internal Server Errorサーバーで何らかのエラーが起こりました。
503 Service Unavailableあなたの IP アドレスから非常に多くのリクエストがあった場合、このエラーが発生します。次のリクエストまで少し時間を開けてください。

例

{
  "id": 1071568098,
  "application_type": 2,
  "days_count": 2.5,
  "start_timestamp": "2020/08/05 00:00:00 +0900",
  "finish_timestamp": "2020/08/07 23:59:59 +0900",
  "memo": "夏期休暇",
  "status": "承認待(申請済)",
  "created_at": "2022/02/07 13:55:59 +0900",
  "regist_user_code": "yamakawa",
  "updated_at": "2022/02/07 16:37:24 +0900",
  "update_user_code": "yamakawa"
}

パラメータ

パラメータ名 説明
holiday
任意

Validations:

  • Must be a Hash
holiday[is_ok]
任意

申請・承認ステータス 0:作成中 1:承認待(申請済), 2:承認済, 3:却下済

Validations:

  • Must be a String
holiday[start_timestamp]
任意

有休開始日

Validations:

  • Must be a String
holiday[finish_timestamp]
任意

有休終了日

Validations:

  • Must be a String
holiday[memo]
任意

備考

Validations:

  • Must be a String
full_or_half
任意

全休か半休か, full:全休, half:半休

Validations:

  • Must be a String

Returns

コード: 200

説明:

1レコードの有給休暇申請を更新します。

パラメータ名 説明
id
任意

レコードId

Validations:

  • Must be a Integer
application_type
任意

種別 1:付与, 2:消化または取消

Validations:

  • Must be a Integer
days_count
任意

付与・消化日数

Validations:

  • Must be a Float
start_timestamp
任意

有休開始日

Validations:

  • Must be a String
finish_timestamp
任意

有休終了日

Validations:

  • Must be a String
memo
任意

備考

Validations:

  • Must be a String
status
任意

ステータス

Validations:

  • Must be a String
created_at
任意

登録日時 (YYYY/MM/DD hh:mm:ss)

Validations:

  • Must be a String
regist_user_code
任意

登録者

Validations:

  • Must be a String
updated_at
任意

更新日時 (YYYY/MM/DD hh:mm:ss)

Validations:

  • Must be a String
update_user_code
任意

更新者

Validations:

  • Must be a String
>>>

POST /paid_holidays/destroy/:id
1レコードの有給休暇申請を削除します。

サポートフォーマット

json

エラー

エラーコード エラー説明
401 Not Authorizedアクセストークンが送られていないか正しくありません。もしくはクライアント認証トークンが正しくありません。
403 Forbiddenそのリクエストに必要な権限がありません。
404 Not found指定されたパスは正しくないか、リソースが見つかりません。
422 Unprocessable Entity1つ以上のパラメータが正しくないか不足しています。エラーメッセージで原因が判別できます。
500 Internal Server Errorサーバーで何らかのエラーが起こりました。
503 Service Unavailableあなたの IP アドレスから非常に多くのリクエストがあった場合、このエラーが発生します。次のリクエストまで少し時間を開けてください。

Returns

コード: 204

説明:

No content

パラメータ名 説明