部門情報削除
OpenAPI説明
当該OpenAPIは部門の論理削除に利用します。
制約・前提条件
配下の従業員を移動・離職した後に、部門の削除を行うこと
OpenAPI権限
当該OpenAPIはテナント権限が必要です。
リクエストURI
/api/openapi/departments
リクエスト形式
DELETE
リクエストパラメータ例
- /api/openapi/departments?departmentCode=TEC-1&fromDate=2021-01-01
- /api/openapi/departments?departmentOID=58516027-c0c9-420a-aedf-f9d74ca4b2ed&fromDate=2021-01-01
リクエストパラメータ説明
departmentCodeとdepartmentOIDの片方をご指定
| パラメータ名 | タイプ | 必須 | キー | 規則 | 説明 |
|---|---|---|---|---|---|
| departmentCode | String | ○ | 最大36文字 | 部門コード。最大36文字 | |
| departmentOID | UUID | 最大36文字 | 部門OID。最大50文字 | ||
| fromDate | String | 日付フォーマット：yyyy-MM-dd | 無効開始日 |
OpenAPIリターン例
成功例
{
"message": "success",
"oid": "3249b50a-1e29-4cae-93ea-bfec4955fafa",
"key": "TEC-1"
}
失敗例
{
"message": "部門が存在しません",
"errorCode": "120103"
}
項目説明
| 項目名 | タイプ | 説明 |
|---|---|---|
| message | String | メッセージを返す |
| errorCode | String | エラーコードを返す |
| oid | UUID | 部門OID |
| key | String | 部門コード |
エラーコード説明
| エラーコード | メッセージ | 説明 |
|---|---|---|
| 120001 | テナントの権限がありません | |
| 6044010 | 部門コードは必須項目です | |
| 6044003 | 部門には従業員が存在しています | |
| 9312009 | 部門が無効または存在しません | |
| 6044011 | 有効な下位部門が存在します(部門名:{0}、 開始日:{1})、無効化処理が失敗しました。 |