Spendia Open API

従業員離職

OpenAPI説明

当該OpenAPIは従業員を離職する際に利用します。従業員の実際離職日付は、当該OpenAPIコール日付 + 離職発効時間とする。 離職日付は指定日付の23:59:59になる。

離職発効時間は【管理員モード】-> 【グループモード】-> 【設定】-> 【セキュリティー設定】にて設定が可能です。

OpenAPI権限

当該OpenAPIはテナント権限が必要です

リクエストURI

/api/openapi/users/leave

リクエスト形式

DELETE

リクエスト例

{
    "employeeId": "EMP-001",
    "leavingDate": "2020-1-1"
}

リクエスト項目

項目名 タイプ 必須 キー 規則 説明
employeeId String ○ ○ 従業員番号
leavingDate String 日付フォーマット: yyyy-MM-dd 従業員が離職する日付を入力する。
空白の場合，離職日 ＝ 当該OpenAPIコール日付 + 離職発効時間。
離職発効時間は【管理員モード】-> 【グループモード】-> 【設定】-> 【セキュリティー設定】にて設定が可能です。

OpenAPIリターン例

成功例

{
    "message": "success",
    "oid": "cbd0bf2f-b355-4c2b-818b-6811d683ed40",
    "key": "EMP-001"
}

失敗例

{
    "message": "テナントの権限がありません",
    "errorCode": "120001"
}

項目説明

項目名 タイプ 説明
message String エラーメッセージを返す
errorCode String エラーコードを返す
oid UUID 従業員OID
key String 従業員番号

エラーコード説明

errorCode message 説明
120001 テナントの権限がありません
120003 パラメータ:{0}は指定必須の項目です
6013009 日付フォーマットはyyyy-MM-ddです
6047034 従業員番号は従業員が見つからない
6040015 従業員は存在しない
6040019 従業員番号を空白にしているので、退職できません
2009 clientIdの取得に失敗しました。
THIRD_PARTY_APPLICATION_004 認識できないクライアントマークまたはクライアントには権限がない

← 離職従業員の再入職 →