上長情報更新

OpenAPI説明

当該OpenAPIでは、既存の部門に上長情報を設定する際に利用します。

制約・前提条件

対象の上長情報を従業員マスタに登録済であること；
パラメータの開始日につき、
入力なしの場合、履歴管理をせず、ロールコードをキーに、上書きで更新となります、同一部門同一ロールに上長が一人しか設定できません；
入力有りの場合、更新キーはロールコードと上長番号と開始日の組み合わせになり、同一部門同一ロールに上長が複数設定可能です。

OpenAPI権限

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

リクエストURI

/api/openapi/department/roles

リクエスト形式

PUT

リクエスト例

{
    "departmentCode": "3001",
    "departmentRoles": [
        {
            "departmentRoleCode": "6101",
            "employeeId": "EMP-001",
            "fromDate":"2021-03-03",
            "toDate":"2021-03-04",
            "isDelete":false
        },
        {
            "departmentRoleCode": "3002",
            "employeeId": "EMP-002",
            "fromDate":"2021-03-03",
            "toDate":"2021-03-04",
            "isDelete":false
        }
    ]
}

リクエスト項目

パラメータ名	タイプ	必須	キー	規則	説明
departmentCode	String	○	○	最大36文字	部門コード
departmentRoles	departmentRoles[]	○			部門ロールリスト

DepartmentRole

パラメータ名	タイプ	必須	キー	規則	説明
departmentRoleCode	String	○	○	最大20文字	部門ロールコード。部門マネージャーコードは6101
employeeId	String	○	○	最大32文字	従業員番号
fromDate	String			日付フォーマット：yyyy-MM-dd	開始日。パラメータ"isDelete"を使用する場合は必須項目
toDate	String			日付フォーマット：yyyy-MM-dd	終了日
isDelete	Boolean				削除フラグ

OpenAPIリターン例

成功例

{
    "message": "success",
    "oid": "d1de43ba-7cd6-496b-b07b-e16a2a5da7b9",
    "key": "TEC-1"
}

失敗例

{
    "message": "部門は存在しない",
    "errorCode": "6061002"
}

項目説明

項目名	タイプ	説明
message	String	エラーメッセージを返す
errorCode	String	エラーコードを返す
oid	UUID	部門OID
key	String	部門コード

エラーコード説明

errorCode	message	説明
120001	テナントの権限がありません
120003	{0}は指定必須の項目です
120115	有効な部門ロールが存在しません。
120116	ロールコードが重複しています。
1202071	従業員番号は存在しません:{0}
6013009	日付フォーマットはyyyy-MM-ddです
6047054	無効な部門コードです。	開始日時点（空白ならシステム日付を利用）に、当部門がまだ存在しない場合、エラーで更新失敗になります。
61000014	上長が存在しません	従業員マスタに、指定した上長が存在しません。
120015	開始日は終了日より未来に設定することはできません。