{
  "paths": {
    "/api/v1/users/me": {
      "get": {
        "summary": "ログインユーザーの取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>このリクエストの認可セッションにおけるログインユーザーの情報を返します。</p>\n<p>freee人事労務では一人のログインユーザーを複数の事業所に関連付けられるため、このユーザーと関連のあるすべての事業所の情報をリストで返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>他のAPIのパラメータとしてcompany_idが求められる場合は、このAPIで取得したcompany_idを使用します。</li>\n  <li>給与計算対象外の従業員のemployee_idとdisplay_nameは取得できません。</li>\n</ul>"
      }
    },
    "/api/v1/companies/{company_id}/employees": {
      "get": {
        "summary": "全期間の従業員一覧の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所に所属する従業員をリストで返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n  <li>退職ユーザーも含めて取得可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 100)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          },
          {
            "name": "company_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "with_no_payroll_calculation",
            "in": "query",
            "type": "boolean",
            "description": "trueを指定すると給与計算対象外の従業員情報をレスポンスに含めます。"
          }
        ]
      }
    },
    "/api/v1/employees": {
      "get": {
        "summary": "従業員一覧の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した対象年月に事業所に所属する従業員をリストで返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n  <li>指定した年月に退職済みユーザーは取得できません。</li>\n  <li>保険料計算方法が自動計算の場合、対応する保険料の直接指定金額は無視されnullが返されます。(例: 給与計算時の健康保険料の計算方法が自動計算の場合、給与計算時の健康保険料の直接指定金額はnullが返されます)</li>\n  <li>事業所が定額制の健康保険組合に加入している場合、保険料の直接指定金額は無視されnullが返されます。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい年"
          },
          {
            "name": "month",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい月<br>\n締め日支払い日設定が翌月払いの従業員情報の場合は、 指定したmonth + 1の値が検索結果として返します。<br>\n翌月払いの従業員の2022/01の従業員情報を取得する場合は、year=2021,month=12を指定してください。<br>"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 100)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          },
          {
            "name": "with_no_payroll_calculation",
            "in": "query",
            "type": "boolean",
            "description": "trueを指定すると給与計算対象外の従業員情報をレスポンスに含めます。"
          }
        ]
      },
      "post": {
        "summary": "従業員の作成",
        "description": "<h2 id=\"\">概要</h2>\n<p>従業員を新規作成します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/v1/employees/{id}": {
      "get": {
        "summary": "従業員の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定したIDの従業員を返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n  <li>指定した年月に退職済みユーザーは取得できません。</li>\n  <li>保険料計算方法が自動計算の場合、対応する保険料の直接指定金額は無視されnullが返されます。(例: 給与計算時の健康保険料の計算方法が自動計算の場合、給与計算時の健康保険料の直接指定金額はnullが返されます)</li>\n  <li>事業所が定額制の健康保険組合に加入している場合、保険料の直接指定金額は無視されnullが返されます。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい年"
          },
          {
            "name": "month",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい月<br>\n締め日支払い日設定が翌月払いの従業員情報の場合は、 指定したmonth + 1の値が検索結果として返します。<br>\n翌月払いの従業員の2022/01の従業員情報を取得する場合は、year=2021,month=12を指定してください。<br>"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ]
      },
      "put": {
        "summary": "従業員の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の情報を更新します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "従業員の削除",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定したIDの従業員を削除します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/v1/employees/{employee_id}/profile_rule": {
      "get": {
        "summary": "従業員の姓名・住所などの取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員・日付の姓名などの情報を返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>本APIは、給与計算対象外の従業員には非対応です。employee_idに給与計算対象外の従業員IDを指定した場合、本APIを利用できません。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい年"
          },
          {
            "name": "month",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい月<br>\n締め日支払い日設定が翌月払いの従業員情報の場合は、指定したmonth + 1の値が検索結果として返します。<br>\n翌月払いの従業員の2022/01の従業員情報を取得する場合は、year=2021,month=12を指定してください。<br>"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ]
      },
      "put": {
        "summary": "従業員の姓名・住所などの更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の姓名・住所などを更新します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>本APIは、給与計算対象外の従業員には非対応です。employee_idに給与計算対象外の従業員IDを指定した場合、本APIを利用できません。</li>\n</ul>",
        "parameters": [
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/employees/{employee_id}/health_insurance_rule": {
      "get": {
        "summary": "従業員の健康保険の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員・日付の健康保険情報を返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n  <li>保険料計算方法が自動計算の場合、対応する保険料の直接指定金額は無視されnullが返されます。(例: 給与計算時の健康保険料の計算方法が自動計算の場合、給与計算時の健康保険料の直接指定金額はnullが返されます)</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい年"
          },
          {
            "name": "month",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい月<br>\n締め日支払い日設定が翌月払いの従業員情報の場合は、 指定したmonth + 1の値が検索結果として返します。<br>\n翌月払いの従業員の2022/01の従業員情報を取得する場合は、year=2021,month=12を指定してください。<br>"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ]
      },
      "put": {
        "summary": "従業員の健康保険の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の健康保険情報を更新します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n  <li>保険料計算方法が自動計算の場合、対応する保険料の直接指定金額は無視されnullが返されます。(例: 給与計算時の健康保険料の計算方法が自動計算の場合、給与計算時の健康保険料の直接指定金額はnullが返されます)</li>\n  <li>事業所が定額制の健康保険組合に加入している場合、保険料の直接指定金額は無視されnullが返されます。</li>\n  <li>事業所が定額制の健康保険組合に加入している場合、保険料の計算方法と保険料の更新はできません。</li>\n</ul>",
        "parameters": [
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/employees/{employee_id}/welfare_pension_insurance_rule": {
      "get": {
        "summary": "従業員の厚生年金保険の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員・日付の厚生年金保険情報を返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n  <li>保険料計算方法が自動計算の場合、対応する保険料の直接指定金額は無視されnullが返されます。(例: 給与計算時の厚生年金保険料の計算方法が自動計算の場合、給与計算時の厚生年金保険料の直接指定金額はnullが返されます)</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい年"
          },
          {
            "name": "month",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい月<br>\n締め日支払い日設定が翌月払いの従業員情報の場合は、 指定したmonth + 1の値が検索結果として返します。<br>\n翌月払いの従業員の2022/01の従業員情報を取得する場合は、year=2021,month=12を指定してください。<br>"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ]
      },
      "put": {
        "summary": "従業員の厚生年金保険の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の厚生年金保険情報を更新します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n  <li>保険料計算方法が自動計算の場合、対応する保険料の直接指定金額は無視されnullが返されます。(例: 給与計算時の厚生年金保険料の計算方法が自動計算の場合、給与計算時の厚生年金保険料の直接指定金額はnullが返されます)</li>\n</ul>",
        "parameters": [
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/employees/{employee_id}/dependent_rules": {
      "get": {
        "summary": "従業員の家族情報の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員・日付の家族情報を返します。</p>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい年"
          },
          {
            "name": "month",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい月<br>\n締め日支払い日設定が翌月払いの従業員情報の場合は、 指定したmonth + 1の値が検索結果として返します。<br>\n翌月払いの従業員の2022/01の従業員情報を取得する場合は、year=2021,month=12を指定してください。<br>"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ]
      }
    },
    "/api/v1/employees/{employee_id}/dependent_rules/bulk_update": {
      "put": {
        "summary": "従業員の家族情報の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の家族情報を更新します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>idがない場合は新規作成、destroyがtrueの場合は削除になります。</li>\n  <li>residence_type=live_in: 同居の場合、以下のパラメータに指定した値はWebに反映されません。</li>\n  <ul>\n    <li>zipcode1</li>\n    <li>zipcode2</li>\n    <li>prefecture_code</li>\n    <li>address</li>\n    <li>address_kana</li>\n    <li>annual_remittance_amount</li>\n  </ul>\n  <li>residence_type=non_resident: 別居(国外)の場合、以下のパラメータに指定した値はWebに反映されません。</li>\n  <ul>\n    <li>prefecture_code</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/employees/{employee_id}/bank_account_rule": {
      "get": {
        "summary": "従業員の銀行口座の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員・日付の銀行口座情報を返します。</p>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい年"
          },
          {
            "name": "month",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい月<br>\n締め日支払い日設定が翌月払いの従業員情報の場合は、 指定したmonth + 1の値が検索結果として返します。<br>\n翌月払いの従業員の2022/01の従業員情報を取得する場合は、year=2021,month=12を指定してください。<br>"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ]
      },
      "put": {
        "summary": "従業員の銀行口座の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の銀行口座1の情報を更新します。</p>",
        "parameters": [
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/employees/{employee_id}/basic_pay_rule": {
      "get": {
        "summary": "従業員の基本給の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員・日付の基本給情報を返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい年"
          },
          {
            "name": "month",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい月<br>\n締め日支払い日設定が翌月払いの従業員情報の場合は、 指定したmonth + 1の値が検索結果として返します。<br>\n翌月払いの従業員の2022/01の従業員情報を取得する場合は、year=2021,month=12を指定してください。<br>"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ]
      },
      "put": {
        "summary": "従業員の基本給の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の基本給情報を更新します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/employees/{employee_id}/allowance_rules": {
      "get": {
        "summary": "従業員の手当情報の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の手当情報をリストで返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい年"
          },
          {
            "name": "month",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい月<br>\n締め日支払い日設定が翌月払いの従業員情報の場合は、 指定したmonth + 1の値が検索結果として返します。<br>\n翌月払いの従業員の2022/01の従業員情報を取得する場合は、year=2021,month=12を指定してください。<br>"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ]
      },
      "put": {
        "summary": "従業員の手当情報の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の手当情報を更新します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n  <li>賞与に紐づく手当（frequency=bonus）の場合、対象年月に賞与情報が登録されている必要があります。</li>\n</ul>",
        "parameters": [
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/employees/{employee_id}/allowance_rules/{id}": {
      "delete": {
        "summary": "従業員の手当情報の削除",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の手当情報を削除します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "削除対象の手当ルールを判定する締め年"
          },
          {
            "name": "month",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "削除対象の手当ルールを判定する締め月<br>\n翌月払いの従業員でも、支給月ではなく締め年月を指定してください。<br>\n例: 翌月払い従業員の 2022/01 支給分を対象にする場合は year=2021, month=12 を指定します。<br>"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員手当ID"
          }
        ]
      }
    },
    "/api/v1/employees/{employee_id}/deduction_rules": {
      "get": {
        "summary": "従業員の控除情報の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の控除情報をリストで返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい年"
          },
          {
            "name": "month",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい月<br>\n締め日支払い日設定が翌月払いの従業員情報の場合は、 指定したmonth + 1の値が検索結果として返します。<br>\n翌月払いの従業員の2022/01の従業員情報を取得する場合は、year=2021,month=12を指定してください。<br>"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ]
      },
      "put": {
        "summary": "従業員の控除情報の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の控除情報を更新します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n  <li>賞与に紐づく控除（frequency=bonus）の場合、対象年月に賞与情報が登録されている必要があります。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "更新対象の控除ルールを判定する締め年"
          },
          {
            "name": "month",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "更新対象の控除ルールを判定する締め月<br>\n翌月払いの従業員でも、支給月ではなく締め年月を指定してください。<br>\n例: 翌月払い従業員の 2022/01 支給分を対象にする場合は year=2021, month=12 を指定します。<br>"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/employees/{employee_id}/deduction_rules/{id}": {
      "delete": {
        "summary": "従業員の控除情報の削除",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の控除情報を削除します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "削除対象の控除ルールを判定する締め年"
          },
          {
            "name": "month",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "削除対象の控除ルールを判定する締め月<br>\n翌月払いの従業員でも、支給月ではなく締め年月を指定してください。<br>\n例: 翌月払い従業員の 2022/01 支給分を対象にする場合は year=2021, month=12 を指定します。<br>"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員控除ID"
          }
        ]
      }
    },
    "/api/v1/employees/{employee_id}/profile_custom_fields": {
      "get": {
        "summary": "従業員のカスタム項目の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員・日付のカスタム項目情報を返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n  <li>指定年月に在籍していない従業員および給与計算対象外の従業員ではデータが存在しないため、空の配列が返ります。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい年"
          },
          {
            "name": "month",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい月<br>\n締め日支払い日設定が翌月払いの従業員情報の場合は、 指定したmonth + 1の値が検索結果として返します。<br>\n翌月払いの従業員の2022/01の従業員情報を取得する場合は、year=2021,month=12を指定してください。<br>"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ]
      }
    },
    "/api/v1/employees/{employee_id}/work_records/{date}": {
      "get": {
        "summary": "勤怠の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員・日付の勤怠情報を返します。</p>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          },
          {
            "name": "date",
            "in": "path",
            "type": "string",
            "required": true,
            "description": "従業員情報を取得したい年月日(YYYY-MM-DD)(例:2018-08-01)"
          }
        ]
      },
      "put": {
        "summary": "勤怠の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の勤怠情報を更新します。</p>\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>振替出勤・振替休日・代休出勤・代休の登録はAPIでは行うことができません。</li>\n</ul>\n\n<h2 id=\"_2\">examples</h2>\n<ul>\n  <li>出勤日について出退勤時刻および休憩時間を更新する場合は以下のようなパラメータをリクエストします。\n    <pre>\n      <code>\n      {\n        \"company_id\": 1,\n        \"break_records\": [\n          {\n            \"clock_in_at\": \"2017-05-25 12:00:00\",\n            \"clock_out_at\": \"2017-05-25 13:00:00\"\n          }\n        ],\n        \"work_record_segments\": [\n          {\n            \"clock_in_at\": \"2017-05-25 09:10:00\",\n            \"clock_out_at\": \"2017-05-25 18:20:00\"\n          }\n        ]\n      }\n      </code>\n    </pre>\n  </li>\n\n  <li>勤務パターンや既定の所定労働時間を変更する場合は use_default_work_pattern に false を指定するとともに、各設定を上書きするパラメータをリクエストします。\n    <pre>\n      <code>\n      {\n        \"company_id\": 1,\n        \"break_records\": [\n          {\n            \"clock_in_at\": \"2017-05-25 12:00:00\",\n            \"clock_out_at\": \"2017-05-25 13:00:00\"\n          }\n        ],\n        \"work_record_segments\": [\n          {\n            \"clock_in_at\": \"2017-05-25 09:10:00\",\n            \"clock_out_at\": \"2017-05-25 18:20:00:00\"\n          }\n        ],\n        \"day_pattern\": \"normal_day\",\n        \"normal_work_clock_in_at\": \"2017-05-25 11:00:00\",\n        \"normal_work_clock_out_at\": \"2017-12-20 20:00:00\",\n        \"normal_work_mins\": 0,\n        \"use_default_work_pattern\": false\n      }\n      </code>\n    </pre>\n  </li>\n\n  <li>有給取得時の連携について半休の場合は通常勤務のように勤務開始・終了時間を指定しつつ、加えて以下の要素を指定することで API での勤怠をつけることができます。\n    <pre>\n      <code>\n      {\n        \"company_id\": 1,\n        \"break_records\": [\n          {\n            \"clock_in_at\": \"2023-12-22 12:00:00\",\n            \"clock_out_at\": \"2023-12-22 13:00:00\"\n          }\n        ],\n        \"work_record_segments\": [\n          {\n            \"clock_in_at\": \"2017-05-25 09:10:00\",\n            \"clock_out_at\": \"2017-05-25 18:20:00:00\"\n          }\n        ],\n        \"paid_holidays\": [\n          {\n            \"type\": \"half\"\n            \"mins\": 240\n          }\n        ]\n      }\n      </code>\n    </pre>\n  </li>\n\n  <li>有給取得時の連携について午前休または午後休の場合は通常勤務のように勤務開始・終了時間を指定しつつ、加えて以下の要素を指定することで API での勤怠をつけることができます。\n    <pre>\n      <code>\n      {\n        \"company_id\": 1,\n        \"break_records\": [\n          {\n            \"clock_in_at\": \"2023-12-22 16:00:00\",\n            \"clock_out_at\": \"2023-12-22 16:30:00\"\n          }\n        ],\n        \"clock_in_at\": \"2023-12-22 14:00:00\",\n        \"clock_out_at\": \"2023-12-22 18:00:00\",\n        \"paid_holidays\": [\n          {\n            \"type\": \"morning_off\"\n          }\n        ]\n      }\n      </code>\n    </pre>\n  </li>\n\n  <li>有給取得時の連携について半日単位の年次有給休暇と時間単位の年次有給休暇を同日に取得する場合は通常勤務のように勤務開始・終了時間を指定しつつ、加えて以下の要素を指定することで API での勤怠をつけることができます。\n    <pre>\n      <code>\n      {\n        \"company_id\": 1,\n        \"break_records\": [\n          {\n            \"clock_in_at\": \"2023-12-22 16:00:00\",\n            \"clock_out_at\": \"2023-12-22 16:30:00\"\n          }\n        ],\n        \"clock_in_at\": \"2023-12-22 14:00:00\",\n        \"clock_out_at\": \"2023-12-22 18:00:00\",\n        \"paid_holidays\": [\n          {\n            \"type\": \"half\",\n            \"mins\": 240\n          },\n          {\n            \"type\": \"hourly\",\n            \"mins\": 120\n          },\n        ]\n      }\n      </code>\n    </pre>\n  </li>\n\n  <li>特別休暇取得時の連携について全休の場合は以下の要素を指定することで API での勤怠をつけることができます。\n    <ul>\n      <li>special_holiday (全休の場合1.0を指定します)</li>\n      <li>special_holiday_setting_id (特別休暇設定IDを指定します)</li>\n    </ul>\n    <pre>\n      <code>\n      {\n        \"company_id\": 1,\n        \"special_holiday\": 1.0\n        \"special_holiday_setting_id\": 1\n      }\n      </code>\n    </pre>\n  </li>\n\n  <li>特別休暇取得時の連携について時間休の場合は通常勤務のように勤務開始・終了時間を指定しつつ、加えて以下の要素を指定することで API での勤怠をつけることができます。\n    <ul>\n      <li>special_holiday_setting_id (特別休暇設定IDを指定します)</li>\n      <li>hourly_special_holiday_mins (時間休により計上される所定労働時間を分で指定します)</li>\n    </ul>\n    <pre>\n      <code>\n      {\n        \"company_id\": 1,\n        \"break_records\": [\n          {\n            \"clock_in_at\": \"2023-12-22 12:00:00\",\n            \"clock_out_at\": \"2023-12-22 13:00:00\"\n          }\n        ],\n        \"work_record_segments\": [\n          {\n            \"clock_in_at\": \"2017-05-25 09:10:00\",\n            \"clock_out_at\": \"2017-05-25 18:20:00:00\"\n          }\n        ],\n        \"special_holiday_setting_id\": 1,\n        \"hourly_special_holiday_mins\": 120\n      }\n      </code>\n    </pre>\n  </li>\n\n  <li>特別休暇取得時の連携について午前休または午後休の場合は通常勤務のように勤務開始・終了時間を指定しつつ、加えて以下の要素を指定することで API での勤怠をつけることができます。\n    <ul>\n      <li>special_holiday_setting_id (特別休暇設定IDを指定します)</li>\n      <li>half_holiday_type (morning_off または afternoon_off を指定します)</li>\n    </ul>\n    <pre>\n      <code>\n      {\n        \"company_id\": 1,\n        \"break_records\": [\n          {\n            \"clock_in_at\": \"2023-12-22 12:00:00\",\n            \"clock_out_at\": \"2023-12-22 12:30:00\"\n          }\n        ],\n        \"clock_in_at\": \"2023-12-22 09:00:00\",\n        \"clock_out_at\": \"2023-12-22 13:00:00\",\n        \"special_holiday_setting_id\": 1,\n        \"half_holiday_type\": \"afternoon_off\"\n      }\n      </code>\n    </pre>\n  </li>\n\n  <li>欠勤を付ける場合は company_idとis_absence 以外のパラメータは必要ありません。\n    <pre>\n      <code>\n      {\n        \"company_id\": 1,\n        \"is_absence\": true\n      }\n      </code>\n    </pre>\n  </li>\n\n</ul>",
        "parameters": [
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          },
          {
            "name": "date",
            "in": "path",
            "type": "string",
            "required": true,
            "description": "更新対象年月日(YYYY-MM-DD)(例:2018-08-01)"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "勤怠の削除",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の勤怠情報を削除します。</p>",
        "parameters": [
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          },
          {
            "name": "date",
            "in": "path",
            "type": "string",
            "required": true,
            "description": "削除対象年月日(YYYY-MM-DD)(例:2018-08-01)"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/v1/employees/{employee_id}/work_record_summaries/{year}/{month}": {
      "get": {
        "summary": "勤怠情報月次サマリの取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員、月の勤怠情報のサマリを返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>work_recordsオプションにtrueを指定することで、明細となる日次の勤怠情報もあわせて返却します。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "work_records",
            "in": "query",
            "type": "boolean",
            "description": "サマリ情報に日次の勤怠情報を含める(true/false)(デフォルト: false)"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          },
          {
            "name": "year",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい年"
          },
          {
            "name": "month",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい月"
          }
        ]
      },
      "put": {
        "summary": "勤怠情報月次サマリの更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員、月の勤怠情報のサマリを更新します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n  <li>日毎の勤怠の更新はこのAPIではできません。日毎の勤怠の操作には勤怠APIを使用して下さい。</li>\n  <li>勤怠データが存在しない場合は新規作成、既に存在する場合は上書き更新されます。</li>\n  <li>値が設定された項目のみ更新されます。値が設定されなかった場合は自動的に0が設定されます。</li>\n</ul>",
        "parameters": [
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          },
          {
            "name": "year",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "更新対象年"
          },
          {
            "name": "month",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "更新対象月"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/employees/{employee_id}/time_clocks": {
      "get": {
        "summary": "打刻一覧の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員・期間の打刻情報を返します。</p>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "from_date",
            "in": "query",
            "type": "string",
            "description": "取得する打刻期間の開始日(YYYY-MM-DD)(例:2018-08-01)(デフォルト: 当月の打刻開始日)"
          },
          {
            "name": "to_date",
            "in": "query",
            "type": "string",
            "description": "取得する打刻期間の終了日(YYYY-MM-DD)(例:2018-08-31)(デフォルト: 当日)"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 100)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ]
      },
      "post": {
        "summary": "打刻の登録",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の打刻情報を登録します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>休憩開始の連続や退勤のみなど、整合性の取れていない打刻は登録できません。\n打刻可能種別の取得APIを呼ぶことで、その従業員がその時点で登録可能な打刻種別が取得できます。</li>\n\n  <li>出勤の打刻は</li>\n  <ul>\n    <li>前日の出勤時刻から24時間以内の場合、前日の退勤打刻が必須です。</li>\n    <li> 前日の出勤時刻から24時間経過している場合は、前日の退勤打刻がなくとも出勤打刻を登録することができます。</li>\n  </ul>\n\n  <li>退勤の打刻は</li>\n  <ul>\n    <li><a href=\\\"https://support.freee.co.jp/hc/ja/articles/900004490226-%E5%8B%A4%E6%80%A0%E5%9F%BA%E6%9C%AC%E8%A8%AD%E5%AE%9A%E3%82%92%E8%A1%8C%E3%81%86#h_01EYPYTR9HZ7YB8V5F18VMD1BT\"target=\\\"_blank\\\">『退勤を自動打刻する』</a>の設定を使用している場合は、出勤打刻から24時間経過しても退勤打刻がない場合に、退勤打刻が自動で登録されます。</li>\n    <li>すでに登録されている退勤打刻よりも後の時刻であれば上書き登録することができます。</li>\n  </ul>\n\n  <li>打刻が日をまたぐ場合は、base_date(打刻日)に前日の日付を指定してください。</li>\n\n  <li>datetime(打刻日時)を指定できるのは管理者の権限を持ったユーザーのみです。</li>\n</ul>",
        "parameters": [
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/employees/{employee_id}/time_clocks/{id}": {
      "get": {
        "summary": "打刻の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員・指定した打刻の詳細情報を返します。</p>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "打刻ID"
          }
        ]
      }
    },
    "/api/v1/employees/{employee_id}/time_clocks/available_types": {
      "get": {
        "summary": "打刻可能種別の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員・日付の打刻可能種別と打刻基準日を返します。</p>\n<p>例: すでに出勤した状態だと、休憩開始、退勤が配列で返ります。</p>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "date",
            "in": "query",
            "type": "string",
            "description": "従業員情報を取得したい年月日(YYYY-MM-DD)(例:2018-08-01)(デフォルト：当日)"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ]
      }
    },
    "/api/v1/employees/{employee_id}/special_holidays": {
      "get": {
        "summary": "従業員の特別休暇一覧の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員に付与された特別休暇情報をリストで返します。</p>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          },
          {
            "name": "date",
            "in": "query",
            "type": "string",
            "description": "対象日"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "対象開始日"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "対象終了日"
          }
        ]
      }
    },
    "/api/v1/employees/{employee_id}/attendance_tag_summaries/{year}/{month}": {
      "get": {
        "summary": "勤怠タグ月次サマリの取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>\n  指定した従業員・年月の勤怠タグサマリの一覧を返します。<br />\n  年月は給与支払い月を指定してください。\n</p>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          },
          {
            "name": "year",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "勤怠タグサマリを取得したい年"
          },
          {
            "name": "month",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "勤怠タグサマリを取得したい月"
          }
        ]
      },
      "put": {
        "summary": "勤怠タグ月次サマリの更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>\n  指定した従業員・年月の勤怠タグサマリを更新します。<br />\n  年月は給与支払い月を指定してください。\n</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n  <li>指定した従業員・年月の勤怠タグサマリが存在する場合は、上書き更新されます。</li>\n  <li>指定がなかった勤怠タグは自動的に0が設定されます。</li>\n</ul>",
        "parameters": [
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          },
          {
            "name": "year",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "勤怠タグサマリを更新したい年"
          },
          {
            "name": "month",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "勤怠タグサマリを更新したい月"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/employees/{employee_id}/attendance_tags": {
      "get": {
        "summary": "勤怠タグ一覧の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の利用可能な勤怠タグの一覧を返します。</p>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ]
      }
    },
    "/api/v1/employees/{employee_id}/attendance_tags/{date}": {
      "get": {
        "summary": "勤怠タグと利用回数の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員・日付の勤怠タグと利用回数の一覧を返します。</p>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          },
          {
            "name": "date",
            "in": "path",
            "type": "string",
            "required": true,
            "description": "対象年月日(YYYY-MM-DD)(例:2018-08-01)"
          }
        ]
      },
      "put": {
        "summary": "勤怠タグの更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員・日付の勤怠タグを更新します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>指定した従業員・日付の勤怠タグが存在する場合は、上書き更新されます。</li>\n  <li>指定がなかった勤怠タグは削除されます。</li>\n</ul>",
        "parameters": [
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          },
          {
            "name": "date",
            "in": "path",
            "type": "string",
            "required": true,
            "description": "更新対象年月日(YYYY-MM-DD)(例:2018-08-01)"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/salaries/employee_payroll_statements": {
      "get": {
        "summary": "給与明細一覧の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所に所属する従業員の給与明細をリストで返します。</p>\n<p>指定した年月に支払いのある給与明細が返されます。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>複数時給を設定している場合はpaymentsに内訳が返されます。</li>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n  <li>給与計算中の場合は、各パラメータはnullおよび空配列が返ります。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい年"
          },
          {
            "name": "month",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい月"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 100)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          }
        ]
      }
    },
    "/api/v1/salaries/employee_payroll_statements/{employee_id}": {
      "get": {
        "summary": "給与明細の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員ID、年月の給与明細を返します。</p>\n<p>指定した年月に支払いのある給与明細が返されます。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>複数時給を設定している場合はpaymentsに内訳が返されます。</li>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n  <li>給与計算中の場合は、各パラメータはnullおよび空配列が返ります。</li>\n</ul>\n\n<h2 id=\"_2\">examples</h2>\n<pre>\n  <code>\n  {\n  \"employee_payroll_statement\": {\n    \"id\": 1,\n    \"company_id\": 1,\n    \"employee_id\": 1,\n    \"employee_name\": \"給与 太郎\",\n    \"employee_display_name\": \"給与 太郎\",\n    \"employee_num\": \"001\",\n    \"pay_date\": \"2018-02-25\",\n    \"start_date\": \"2018-02-01\",\n    \"closing_date\": \"2018-02-28\",\n    \"variable_pay_start_date\": \"2018-01-01\",\n    \"variable_pay_closing_date\": \"2018-01-31\",\n    \"fixed\": true,\n    \"calc_status\": \"calculated\",\n    \"calculated_at\": \"2018-09-27T05:06:45.315Z\",\n    \"pay_calc_type\": \"monthly\",\n    \"board_member_remuneration_amount\": \"400000.0\",\n    \"basic_pay_amount\": \"300000.0\",\n    \"work_days\": \"21.0\",\n    \"normal_work_time\": \"8.0\",\n    \"normal_work_days\": \"21.0\",\n    \"work_mins_by_paid_holiday\": \"480.0\",\n    \"num_paid_holidays\": \"1.0\",\n    \"is_board_member\": true,\n    \"total_attendance_deduction_amount\": \"0.0\",\n    \"total_allowance_amount\": \"0.0\",\n    \"total_deduction_amount\": \"23830.0\",\n    \"total_deduction_employer_share\": \"16830.0\",\n    \"net_payment_amount\": \"277170.0\",\n    \"gross_payment_amount\": \"301000.0\",\n    \"total_worked_days_count\": \"21.0\",\n    \"total_taxable_payment_amount\": \"301000.0\",\n    \"total_expense_amount\": \"0.0\",\n    \"total_transfer_amount\": \"277170.0\",\n    \"total_annual_payment_amount\": \"600000.0\",\n    \"payments\": [{ \"name\": \"基本給\", \"amount\": \"300000.0\"},{ \"name\": \"残業代\", \"amount\": \"1000.0\"}],\n    \"deductions\": [{\"name\": \"所得税\", \"amount\": \"7000.0\"}, {\"name\": \"健康保険料\", \"amount\": \"16830.0\"}],\n    \"deductions_emloyers_share\": [{\"name\": \"健康保険料(会社負担分)\", \"amount\": \"16830.0\"}],\n    \"attendances\": [{\"name\": \"遅刻・早退\", \"time\": \"0.0\", \"amount\": \"0.0\"}],\n    \"overtime_pays\": [{ \"name\": \"時間外労働\", \"time\": \"60.0\", \"amount\": \"1000.0\", \"code\": null }, { \"name\": \"カスタム固定残業代\", \"time\": null, \"amount\": \"10000.0\", \"code\": \"a001\" }],\n    \"remark\": \"備考\"\n    }\n  }\n  </code>\n</pre>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい年"
          },
          {
            "name": "month",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい月"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ]
      }
    },
    "/api/v1/salaries/employee_payroll_statements/{employee_id}/remark": {
      "put": {
        "summary": "給与明細の備考の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の給与明細の備考を更新します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/bonuses/employee_payroll_statements": {
      "get": {
        "summary": "賞与明細一覧の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所に所属する従業員の賞与明細をリストで返します。</p>\n<p>指定した年月に支払いのある賞与明細が返されます。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい年"
          },
          {
            "name": "month",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい月"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 100)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          }
        ]
      }
    },
    "/api/v1/bonuses/employee_payroll_statements/{employee_id}": {
      "get": {
        "summary": "賞与明細の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員ID、年月の賞与明細を返します。</p>\n<p>指定した年月に支払いのある賞与明細が返されます。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>\n\n<h2 id=\"_2\">examples</h2>\n<pre>\n  <code>\n    {\n    \"employee_payroll_statement\": {\n      \"id\": 1,\n      \"company_id\": 1,\n      \"employee_id\": 1,\n      \"employee_name\": \"給与 太郎\",\n      \"employee_display_name\": \"給与 太郎\",\n      \"employee_num\": \"001\",\n      \"closing_date\": \"2018-03-31\",\n      \"pay_date\": \"2018-03-31\",\n      \"fixed\": true,\n      \"calc_status\": \"calculated\",\n      \"calculated_at\": \"2018-09-27T05:06:45.315Z\",\n      \"bonus_amount\": \"300000.0\",\n      \"total_allowance_amount\": \"0.0\",\n      \"total_deduction_amount\": \"23830.0\",\n      \"net_payment_amount\": \"268000.0\",\n      \"gross_payment_amount\": \"330000.0\",\n      \"total_taxable_payment_amount\": \"330000.0\",\n      \"allowances\": [{\"name\": \"地域手当\", \"amount\": \"30000.0\"}],\n      \"deductions\": [{\"name\": \"所得税\", \"amount\": \"46000.0\"}, {\"name\": \"健康保険料\", \"amount\": \"16000.0\"}],\n      \"remark\": \"備考\"\n    }\n    }\n  </code>\n</pre>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい年"
          },
          {
            "name": "month",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "従業員情報を取得したい月"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ]
      }
    },
    "/api/v1/employee_group_memberships": {
      "get": {
        "summary": "所属一覧の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の指定日付時点における所属情報をリストで返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "base_date",
            "in": "query",
            "type": "string",
            "required": true,
            "description": "指定日。指定日付時点における所属情報をリストで返します。(YYYY-MM-DD)(例:2018-07-31)"
          },
          {
            "name": "with_no_payroll_calculation",
            "in": "query",
            "type": "boolean",
            "description": "trueを指定すると給与計算対象外の従業員情報をレスポンスに含めます。"
          },
          {
            "name": "employee_ids",
            "in": "query",
            "type": "string",
            "description": "取得対象とする従業員IDを指定することができます。指定しない場合は全従業員が対象となります。\n(例:1,2,3,4,5)\n"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 100)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          }
        ]
      }
    },
    "/api/v1/employees/{employee_id}/group_memberships": {
      "get": {
        "summary": "従業員の所属取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の所属情報をリストで返します。</p>\n<p>base_dateを指定した場合は指定日付時点の所属情報を、base_dateを省略した場合は全期間の所属履歴を返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "base_date",
            "in": "query",
            "type": "string",
            "required": false,
            "description": "指定日。指定日付時点における所属情報を返します。(YYYY-MM-DD)(例:2018-07-31)\n省略した場合は全期間の所属履歴を返します。\n"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "required": false,
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 100)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "required": false,
            "description": "取得レコードのオフセット (デフォルト: 0)"
          }
        ]
      }
    },
    "/api/v1/groups": {
      "get": {
        "summary": "部門一覧の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の指定日付時点における部門情報をリストで返します。</p>\n<p>部門APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/groups-api-hierarchy\" target=\"_blank\">部門APIを利用した組織図の取得について</a> をご参照ください。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      },
      "post": {
        "summary": "部門の作成",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の部門を新規作成します。</p>\n<p>部門APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/groups-api-hierarchy\" target=\"_blank\">部門APIを利用した組織図の取得について</a> をご参照ください。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/v1/groups/{id}": {
      "put": {
        "summary": "部門の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の部門の情報を更新します。</p>\n<p>部門APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/groups-api-hierarchy\" target=\"_blank\">部門APIを利用した組織図の取得について</a> をご参照ください。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "部門ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "部門の削除",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の部門の情報を削除します。</p>\n<p>部門APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/groups-api-hierarchy\" target=\"_blank\">部門APIを利用した組織図の取得について</a> をご参照ください。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "部門ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/v1/allowances": {
      "get": {
        "summary": "その他手当一覧の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所のその他手当情報をリストで返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "frequency",
            "in": "query",
            "type": "string",
            "required": false,
            "description": "支給頻度フィルタ（省略で全件取得）"
          },
          {
            "name": "is_active",
            "in": "query",
            "type": "boolean",
            "required": false,
            "description": "表示状態フィルタ（省略で全件取得）"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "required": false,
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 100)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "required": false,
            "description": "取得レコードのオフセット (デフォルト: 0)"
          }
        ]
      },
      "post": {
        "summary": "その他手当の作成",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所のその他手当を新規作成します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/allowances/{id}": {
      "get": {
        "summary": "その他手当の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所のその他手当情報を返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "その他手当ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/v1/deductions": {
      "get": {
        "summary": "その他控除一覧の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所のその他控除情報をリストで返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "frequency",
            "in": "query",
            "type": "string",
            "required": false,
            "description": "支給頻度フィルタ（省略で全件取得）"
          },
          {
            "name": "is_active",
            "in": "query",
            "type": "boolean",
            "required": false,
            "description": "表示状態フィルタ（省略で全件取得）"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "required": false,
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 100)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "required": false,
            "description": "取得レコードのオフセット (デフォルト: 0)"
          }
        ]
      },
      "post": {
        "summary": "その他控除の作成",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所のその他控除を新規作成します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/deductions/{id}": {
      "get": {
        "summary": "その他控除の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所のその他控除情報を返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "その他控除ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/v1/positions": {
      "get": {
        "summary": "役職一覧の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の指定日付時点における役職情報をリストで返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      },
      "post": {
        "summary": "役職の作成",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の役職を新規作成します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/v1/positions/{id}": {
      "put": {
        "summary": "役職の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の役職の情報を更新します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "役職ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "役職の削除",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の役職の情報を削除します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>管理者権限を持ったユーザーのみ実行可能です。</li>\n  <li>従業員に役職が適用されている場合、従業員の役職情報も削除されます。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "役職ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/v1/approval_requests/monthly_attendances": {
      "get": {
        "summary": "月次勤怠締め申請一覧の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の指定日付時点における月次勤怠締め申請情報をリストで返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "status",
            "in": "query",
            "type": "string",
            "description": "申請ステータス\n- `draft` - 下書き\n- `in_progress` - 申請中\n- `approved` - 承認済\n- `feedback` - 差戻し"
          },
          {
            "name": "application_number",
            "in": "query",
            "type": "integer",
            "description": "申請No"
          },
          {
            "name": "start_issue_date",
            "in": "query",
            "type": "string",
            "description": "申請開始日"
          },
          {
            "name": "end_issue_date",
            "in": "query",
            "type": "string",
            "description": "申請終了日"
          },
          {
            "name": "approver_id",
            "in": "query",
            "type": "integer",
            "description": "現在承認ステップの承認者のユーザーID\n\napprover_idに値を指定する場合、指定なしの申請経路を利用した申請は返却されません\n"
          },
          {
            "name": "applicant_id",
            "in": "query",
            "type": "integer",
            "description": "申請者のユーザーID"
          },
          {
            "name": "start_target_date",
            "in": "query",
            "type": "string",
            "description": "対象開始日"
          },
          {
            "name": "end_target_date",
            "in": "query",
            "type": "string",
            "description": "対象終了日"
          },
          {
            "name": "passed_auto_check",
            "in": "query",
            "type": "boolean",
            "description": "自動チェック結果\n- trueを指定した場合、自動チェック結果がtrueの申請のみ返却します。\n- falseを指定した場合、自動チェック結果がfalseの申請のみ返却します。\n- キーごと指定しない場合、すべての申請を返却します。"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 100)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          }
        ]
      },
      "post": {
        "summary": "月次勤怠締め申請の作成",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の月次勤怠締め申請を新規作成します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/v1/approval_requests/monthly_attendances/{id}": {
      "get": {
        "summary": "月次勤怠締め申請の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の月次勤怠締め申請情報を取得します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "月次勤怠締め申請ID"
          }
        ]
      },
      "put": {
        "summary": "月次勤怠締め申請の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の月次勤怠締め申請情報を更新します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "月次勤怠締め申請ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "月次勤怠締め申請の削除",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の月次勤怠締め申請情報を削除します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "月次勤怠締め申請ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/v1/approval_requests/monthly_attendances/{id}/actions": {
      "post": {
        "summary": "月次勤怠締め申請の承認操作",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の月次勤怠締め申請情報を承認操作します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "月次勤怠締め申請ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/approval_requests/work_times": {
      "get": {
        "summary": "勤務時間修正申請一覧の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の指定日付時点における勤務時間修正申請情報をリストで返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "status",
            "in": "query",
            "type": "string",
            "description": "申請ステータス\n- `draft` - 下書き\n- `in_progress` - 申請中\n- `approved` - 承認済\n- `feedback` - 差戻し"
          },
          {
            "name": "application_number",
            "in": "query",
            "type": "integer",
            "description": "申請No"
          },
          {
            "name": "start_issue_date",
            "in": "query",
            "type": "string",
            "description": "申請開始日"
          },
          {
            "name": "end_issue_date",
            "in": "query",
            "type": "string",
            "description": "申請終了日"
          },
          {
            "name": "approver_id",
            "in": "query",
            "type": "integer",
            "description": "現在承認ステップの承認者のユーザーID\napprover_idに値を指定する場合、指定なしの申請経路を利用した申請は返却されません\n"
          },
          {
            "name": "applicant_id",
            "in": "query",
            "type": "integer",
            "description": "申請者のユーザーID"
          },
          {
            "name": "start_target_date",
            "in": "query",
            "type": "string",
            "description": "対象開始日"
          },
          {
            "name": "end_target_date",
            "in": "query",
            "type": "string",
            "description": "対象終了日"
          },
          {
            "name": "passed_auto_check",
            "in": "query",
            "type": "boolean",
            "description": "自動チェック結果\n- trueを指定した場合、自動チェック結果がtrueの申請のみ返却します。\n- falseを指定した場合、自動チェック結果がfalseの申請のみ返却します。\n- キーごと指定しない場合、すべての申請を返却します。"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 100)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          }
        ]
      },
      "post": {
        "summary": "勤務時間修正申請の作成",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の勤務時間修正を新規作成します。</p>\n\n<h2 id=\"_2\">examples</h2>\n<ul>\n  <li>勤務時間を修正する場合は以下のようなパラメータを指定します。\n    <pre>\n      <code>\n        {\n          \"company_id\": 1,\n          \"target_date\": \"2017-05-25\",\n          \"break_records\": [\n            {\n              \"clock_in_at\": \"2017-05-25 12:00:00\",\n              \"clock_out_at\": \"2017-05-25 13:00:00\"\n            }\n          ],\n          \"work_records\": [\n            {\n              \"clock_in_at\": \"2017-05-25 09:10:00\",\n              \"clock_out_at\": \"2017-05-25 18:20:00\"\n            }\n          ],\n          \"approval_flow_route_id\": 1\n        }\n      </code>\n    </pre>\n  </li>\n</ul>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/v1/approval_requests/work_times/{id}": {
      "get": {
        "summary": "勤務時間修正申請の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の勤務時間修正申請情報を取得します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "勤務時間修正申請ID"
          }
        ]
      },
      "put": {
        "summary": "勤務時間修正申請の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の勤務時間修正申請情報を更新します。</p>\n\n<h2 id=\"_2\">examples</h2>\n<ul>\n  <li>勤務時間を修正する場合は以下のようなパラメータを指定します。\n    <pre>\n      <code>\n        {\n          \"company_id\": 1,\n          \"target_date\": \"2017-05-25\",\n          \"break_records\": [\n            {\n              \"clock_in_at\": \"2017-05-25 12:00:00\",\n              \"clock_out_at\": \"2017-05-25 13:00:00\"\n            }\n          ],\n          \"work_records\": [\n            {\n              \"clock_in_at\": \"2017-05-25 09:10:00\",\n              \"clock_out_at\": \"2017-05-25 18:20:00\"\n            }\n          ],\n          \"approval_flow_route_id\": 1\n        }\n      </code>\n    </pre>\n  </li>\n</ul>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "勤務時間修正申請ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "勤務時間修正申請の削除",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の勤務時間修正申請情報を削除します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "勤務時間修正申請ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/v1/approval_requests/work_times/{id}/actions": {
      "post": {
        "summary": "勤務時間修正申請の承認操作",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の勤務時間修正申請情報を承認操作します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "勤務時間修正申請ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/approval_requests/paid_holidays": {
      "get": {
        "summary": "有給休暇申請一覧の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の指定日付時点における有給休暇申請情報をリストで返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "status",
            "in": "query",
            "type": "string",
            "description": "申請ステータス\n- `draft` - 下書き\n- `in_progress` - 申請中\n- `approved` - 承認済\n- `feedback` - 差戻し"
          },
          {
            "name": "application_number",
            "in": "query",
            "type": "integer",
            "description": "申請No"
          },
          {
            "name": "start_issue_date",
            "in": "query",
            "type": "string",
            "description": "申請開始日"
          },
          {
            "name": "end_issue_date",
            "in": "query",
            "type": "string",
            "description": "申請終了日"
          },
          {
            "name": "approver_id",
            "in": "query",
            "type": "integer",
            "description": "現在承認ステップの承認者のユーザーID\n\napprover_idに値を指定する場合、指定なしの申請経路を利用した申請は返却されません\n"
          },
          {
            "name": "applicant_id",
            "in": "query",
            "type": "integer",
            "description": "申請者のユーザーID"
          },
          {
            "name": "start_target_date",
            "in": "query",
            "type": "string",
            "description": "対象開始日"
          },
          {
            "name": "end_target_date",
            "in": "query",
            "type": "string",
            "description": "対象終了日"
          },
          {
            "name": "passed_auto_check",
            "in": "query",
            "type": "boolean",
            "description": "自動チェック結果\n- trueを指定した場合、自動チェック結果がtrueの申請のみ返却します。\n- falseを指定した場合、自動チェック結果がfalseの申請のみ返却します。\n- キーごと指定しない場合、すべての申請を返却します。"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 100)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          }
        ]
      },
      "post": {
        "summary": "有給休暇申請の作成",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の有給休暇申請を新規作成します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/v1/approval_requests/paid_holidays/{id}": {
      "get": {
        "summary": "有給休暇申請の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の有給休暇申請情報を取得します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "有給休暇申請ID"
          }
        ]
      },
      "put": {
        "summary": "有給休暇申請の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の有給休暇申請情報を更新します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "有給休暇申請ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "有給休暇申請の削除",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の有給休暇申請情報を削除します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "有給休暇申請ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/v1/approval_requests/paid_holidays/{id}/actions": {
      "post": {
        "summary": "有給休暇申請の承認操作",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の有給休暇申請情報を承認操作します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>全休の有給休暇申請は承認されると申請者の有給の残数が減ります。</li>\n  <li>半休と時間休の有給休暇申請は承認されても申請者の有給の残数が減らない場合があります。以下の条件を満たす場合、申請者の有給の残数が減ります。</li>\n  <ul>\n    <li>申請承認後、申請者が申請の対象日に出勤打刻と退勤打刻をする。</li>\n    <li>申請承認前に、申請者が申請の対象日に勤怠を登録している。</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "有給休暇申請ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/approval_requests/special_holidays": {
      "get": {
        "summary": "特別休暇申請一覧の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の指定日付時点における特別休暇申請情報をリストで返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "status",
            "in": "query",
            "type": "string",
            "description": "申請ステータス\n- `draft` - 下書き\n- `in_progress` - 申請中\n- `approved` - 承認済\n- `feedback` - 差戻し"
          },
          {
            "name": "application_number",
            "in": "query",
            "type": "integer",
            "description": "申請No"
          },
          {
            "name": "start_issue_date",
            "in": "query",
            "type": "string",
            "description": "申請開始日"
          },
          {
            "name": "end_issue_date",
            "in": "query",
            "type": "string",
            "description": "申請終了日"
          },
          {
            "name": "approver_id",
            "in": "query",
            "type": "integer",
            "description": "現在承認ステップの承認者のユーザーID\n\napprover_idに値を指定する場合、指定なしの申請経路を利用した申請は返却されません\n"
          },
          {
            "name": "applicant_id",
            "in": "query",
            "type": "integer",
            "description": "申請者のユーザーID"
          },
          {
            "name": "start_target_date",
            "in": "query",
            "type": "string",
            "description": "対象開始日"
          },
          {
            "name": "end_target_date",
            "in": "query",
            "type": "string",
            "description": "対象終了日"
          },
          {
            "name": "passed_auto_check",
            "in": "query",
            "type": "boolean",
            "description": "自動チェック結果\n- trueを指定した場合、自動チェック結果がtrueの申請のみ返却します。\n- falseを指定した場合、自動チェック結果がfalseの申請のみ返却します。\n- キーごと指定しない場合、すべての申請を返却します。"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 100)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          }
        ]
      },
      "post": {
        "summary": "特別休暇申請の作成",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の特別休暇申請を新規作成します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/v1/approval_requests/special_holidays/{id}": {
      "get": {
        "summary": "特別休暇申請の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の特別休暇申請情報を取得します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "特別休暇申請ID"
          }
        ]
      },
      "put": {
        "summary": "特別休暇申請の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の特別休暇申請情報を更新します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "特別休暇申請ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "特別休暇申請の削除",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の特別休暇申請情報を削除します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "特別休暇申請ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/v1/approval_requests/special_holidays/{id}/actions": {
      "post": {
        "summary": "特別休暇申請の承認操作",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の特別休暇申請情報を承認操作します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>全休の特別休暇申請は承認されると申請者の特別休暇の残数が減ります。</li>\n  <li>半休と時間休の特別休暇申請は承認されても申請者の特別休暇の残数が減らない場合があります。以下の条件を満たす場合、申請者の特別休暇の残数が減ります。</li>\n  <ul>\n    <li>申請承認後、申請者が申請の対象日に出勤打刻と退勤打刻をする。</li>\n    <li>申請承認前に、申請者が申請の対象日に勤怠を登録している。</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "特別休暇申請ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/approval_requests/overtime_works": {
      "get": {
        "summary": "残業申請一覧の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の指定日付時点における残業申請情報をリストで返します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "status",
            "in": "query",
            "type": "string",
            "description": "申請ステータス\n- `draft` - 下書き\n- `in_progress` - 申請中\n- `approved` - 承認済\n- `feedback` - 差戻し"
          },
          {
            "name": "application_number",
            "in": "query",
            "type": "integer",
            "description": "申請No"
          },
          {
            "name": "start_issue_date",
            "in": "query",
            "type": "string",
            "description": "申請開始日"
          },
          {
            "name": "end_issue_date",
            "in": "query",
            "type": "string",
            "description": "申請終了日"
          },
          {
            "name": "approver_id",
            "in": "query",
            "type": "integer",
            "description": "現在承認ステップの承認者のユーザーID\n\napprover_idに値を指定する場合、指定なしの申請経路を利用した申請は返却されません\n"
          },
          {
            "name": "applicant_id",
            "in": "query",
            "type": "integer",
            "description": "申請者のユーザーID"
          },
          {
            "name": "start_target_date",
            "in": "query",
            "type": "string",
            "description": "対象開始日"
          },
          {
            "name": "end_target_date",
            "in": "query",
            "type": "string",
            "description": "対象終了日"
          },
          {
            "name": "passed_auto_check",
            "in": "query",
            "type": "boolean",
            "description": "自動チェック結果\n- trueを指定した場合、自動チェック結果がtrueの申請のみ返却します。\n- falseを指定した場合、自動チェック結果がfalseの申請のみ返却します。\n- キーごと指定しない場合、すべての申請を返却します。"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 100)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          }
        ]
      },
      "post": {
        "summary": "残業申請の作成",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の残業申請を新規作成します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請の内容を勤怠に反映させるかの設定次第でリクエスト時に指定するパラメータが異なります。残業申請に必要な設定情報の取得APIで確認してください。</li>\n  <ul>\n    <li>勤怠に反映する設定の場合</li>\n    <ul>\n      <li>設定情報の取得APIで受け取った値を用いてパラメータを指定します。</li>\n      <li>早出（early_work_start_at, early_work_end_at）か残業（overtime_work_start_at, overtime_work_end_at）のどちらか、もしくは両方を指定してください。</li>\n      <ul>\n        <li>早出・残業両方とも指定しなかった場合は取り消し申請となります。対象日の承認済み残業申請は全て取り消され、打刻データがあれば勤怠に反映し直します。</li>\n      </ul>\n      <li>早出の終了時刻（early_work_end_at）は所定の出勤時刻と同じ、残業の開始時刻（overtime_work_start_at）は所定の退勤時刻と同じ時刻を指定する必要があります。</li>\n      <li>早出・残業の時刻に指定できる分の単位はそれぞれ設定（early_work_mins_unit, overtime_work_mins_unit）の通りです。</li>\n    </ul>\n    <li>勤怠に反映しない設定の場合</li>\n    <ul>\n      <li>残業開始（start_at）と残業終了（end_at）を指定してください。</li>\n    </ul>\n  </ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/v1/approval_requests/overtime_works/{id}": {
      "get": {
        "summary": "残業申請の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の残業申請情報を取得します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "残業申請ID"
          }
        ]
      },
      "put": {
        "summary": "残業申請の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の残業申請情報を更新します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請の内容を勤怠に反映させるかの設定次第でリクエスト時に指定するパラメータが異なります。残業申請に必要な設定情報の取得APIで確認してください。</li>\n  <ul>\n    <li>勤怠に反映する設定の場合</li>\n    <ul>\n      <li>設定情報の取得APIで受け取った値を用いてパラメータを指定します。</li>\n      <li>早出（early_work_start_at, early_work_end_at）か残業（overtime_work_start_at, overtime_work_end_at）のどちらか、もしくは両方を指定してください。</li>\n      <ul>\n        <li>早出・残業両方とも指定しなかった場合は取り消し申請となります。対象日の承認済み残業申請は全て取り消され、打刻データがあれば勤怠に反映し直します。</li>\n      </ul>\n      <li>早出の終了時刻（early_work_end_at）は所定の出勤時刻と同じ、残業の開始時刻（overtime_work_start_at）は所定の退勤時刻と同じ時刻を指定する必要があります。</li>\n      <li>早出・残業の時刻に指定できる分の単位はそれぞれ設定（early_work_mins_unit, overtime_work_mins_unit）の通りです。</li>\n    </ul>\n    <li>勤怠に反映しない設定の場合</li>\n    <ul>\n      <li>残業開始（start_at）と残業終了（end_at）を指定してください。</li>\n    </ul>\n  </ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "残業申請ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "残業申請の削除",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の残業申請情報を削除します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "残業申請ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/v1/approval_requests/overtime_works/{id}/actions": {
      "post": {
        "summary": "残業申請の承認操作",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の残業申請情報を承認操作します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n  <li>申請者と承認者が同一ユーザーの場合、feedback(差戻し)をするとレスポンスは以下のようになります。</li>\n  <ul>\n    <li>status: draft</li>\n    <li>approval_flow_logs.action: cancel</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "残業申請ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/approval_requests/overtime_works/setting": {
      "get": {
        "summary": "残業申請に必要な設定情報の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員・日付の残業申請に必要な設定情報を取得します。</p>\n<ul>\n  <li>取得できる設定の一覧</li>\n  <ul>\n    <li>勤怠カレンダーに申請を反映するかどうかの設定</li>\n    <ul>\n      <li>この設定により、残業申請の作成や更新のリクエスト時に使用するパラメータが変わります。詳細は、残業申請の作成や更新の仕様を参照してください。</li>\n    </ul>\n    <li>所定の出退勤時間</li>\n    <ul>\n      <li>反映あり申請の場合、残業申請の作成や更新のリクエスト時に所定の出退勤時間が必要になります。詳細は、残業申請の作成や更新の仕様を参照してください。</li>\n    </ul>\n    <li>申請で指定できる分の単位</li>\n    <ul>\n      <li>反映あり申請の場合、勤務賃金設定の申請の単位設定によって、残業申請できる分単位が変わります。</li>\n    </ul>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "date",
            "in": "query",
            "type": "string",
            "required": true,
            "description": "対象日(YYYY-MM-DD)(例:2018-08-01)\n- 申請の対象日を指定してください。"
          }
        ]
      }
    },
    "/api/v1/approval_flow_routes": {
      "get": {
        "summary": "申請経路一覧の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の申請経路一覧を取得する。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>指定した事業所の従業員に紐づくユーザーのみ実行可能です。</li>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "included_user_id",
            "in": "query",
            "type": "integer",
            "description": "経路に含まれるユーザーのユーザーID"
          },
          {
            "name": "usage",
            "in": "query",
            "type": "string",
            "description": "申請種別（申請経路を使用できる申請種別を示します。例えば、AttendanceWorkflow の場合は、勤怠申請で使用できる申請経路です。）\n- `AttendanceWorkflow` - 勤怠申請\n- `PersonalDataWorkflow` - 身上変更申請"
          }
        ]
      }
    },
    "/api/v1/approval_flow_routes/{id}": {
      "get": {
        "summary": "申請経路の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の申請経路を取得する。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>指定した事業所の従業員に紐づくユーザーのみ実行可能です。</li>\n  <li>申請経路、承認者の指定として部門役職データ連携を活用し、以下のいずれかを利用している申請と申請経路はAPI経由で参照は可能ですが、作成と更新、承認ステータスの変更ができません。</li>\n  <ul>\n    <li>役職指定（申請者の所属部門）</li>\n    <li>役職指定（申請時に部門指定）</li>\n    <li>部門および役職指定</li>\n  </ul>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "申請経路ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/v1/yearend_adjustments/{year}/employees": {
      "get": {
        "summary": "年末調整対象一覧の取得",
        "description": "\n指定した年の年末調整対象のリスト返します。",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "年末調整対象を取得したい年"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 100)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          }
        ]
      }
    },
    "/api/v1/yearend_adjustments/{year}/employees/{employee_id}": {
      "get": {
        "summary": "年末調整の取得",
        "description": "指定した年、従業員IDの年末調整の詳細内容を返します。<br>\n年末調整対象外の従業員は、本人情報、給与・賞与、前職情報のみが取得できます。",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "年末調整を取得したい年"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ]
      },
      "put": {
        "summary": "年末調整従業員情報の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の姓名・住所などを更新します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>本APIは、年末調整が確定済みの従業員には非対応です。</li>\n</ul>",
        "parameters": [
          {
            "name": "year",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "更新対象年"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/yearend_adjustments/{year}/payroll_and_bonus/{employee_id}": {
      "put": {
        "summary": "年末調整従業員給与・賞与の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の給与・賞与を更新します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>本APIは、年末調整が確定済みの従業員には非対応です。</li>\n</ul>",
        "parameters": [
          {
            "name": "year",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "更新対象年"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/yearend_adjustments/{year}/dependents/{employee_id}": {
      "put": {
        "summary": "年末調整家族情報の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した年末調整の家族情報を更新します。</p>\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>本APIは、年末調整が確定済みの従業員には非対応です。</li>\n  <li>idがない場合は新規作成、destroyがtrueの場合は削除になります。</li>\n</ul>",
        "parameters": [
          {
            "name": "year",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "更新対象年"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/yearend_adjustments/{year}/previous_jobs/{employee_id}": {
      "put": {
        "summary": "年末調整従業員前職情報の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の前職情報を更新します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>本APIは、年末調整が確定済みの従業員には非対応です。</li>\n</ul>",
        "parameters": [
          {
            "name": "year",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "更新対象年"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "年末調整従業員前職情報の削除",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の前職情報を削除します。</p>\n\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>本APIは、年末調整が確定済みの従業員には非対応です。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "更新対象年"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ]
      }
    },
    "/api/v1/yearend_adjustments/{year}/insurances/{employee_id}": {
      "post": {
        "summary": "年末調整従業員保険料情報の作成",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の保険料情報を作成します。</p>\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>本APIは、年末調整が確定済みの従業員には非対応です。</li>\n</ul>",
        "parameters": [
          {
            "name": "year",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "作成対象年"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/yearend_adjustments/{year}/insurances/{employee_id}/{id}": {
      "put": {
        "summary": "年末調整従業員保険料情報の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の保険料情報を更新します。</p>\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>本APIは、年末調整が確定済みの従業員には非対応です。</li>\n  <li>certification_type=\"xml\"の場合、recipient_first_name、recipient_last_name、recipient_relationshipのみが更新の対象となります。</li>\n</ul>",
        "parameters": [
          {
            "name": "year",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "更新対象年"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "保険料ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "年末調整従業員保険料情報の削除",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の保険料情報を削除します。</p>\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>本APIは、年末調整が確定済みの従業員には非対応です。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "更新対象年"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "保険料ID"
          }
        ]
      }
    },
    "/api/v1/yearend_adjustments/{year}/housing_loan_deductions/{employee_id}": {
      "put": {
        "summary": "年末調整従業員住宅ローン控除額の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の住宅ローン控除額を更新します。</p>\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>本APIは、年末調整が確定済みの従業員には非対応です。</li>\n</ul>",
        "parameters": [
          {
            "name": "year",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "更新対象年"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/yearend_adjustments/{year}/housing_loans/{employee_id}": {
      "post": {
        "summary": "年末調整従業員住宅ローンの作成",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の住宅ローンを作成します。</p>\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>本APIは、年末調整が確定済みの従業員には非対応です。</li>\n</ul>",
        "parameters": [
          {
            "name": "year",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "作成対象年"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/v1/yearend_adjustments/{year}/housing_loans/{employee_id}/{id}": {
      "put": {
        "summary": "年末調整従業員住宅ローンの更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の住宅ローンを更新します。</p>\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>本APIは、年末調整が確定済みの従業員には非対応です。</li>\n</ul>",
        "parameters": [
          {
            "name": "year",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "更新対象年"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "住宅ローンID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "年末調整従業員住宅ローンの削除",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した従業員の住宅ローンを削除します。</p>\n<h2 id=\"_1\">注意点</h2>\n<ul>\n  <li>本APIは、年末調整が確定済みの従業員には非対応です。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "year",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "更新対象年"
          },
          {
            "name": "employee_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "従業員ID"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "住宅ローンID"
          }
        ]
      }
    }
  }
}