従業員の兼務追加

OpenAPI説明

当該OpenAPIは従業員の兼務を新規追加する際に利用します。

制約・前提条件

部門との相関関係につき、
所属部門が部門マスタに登録済であること；
従業員の主務開始日は部門の有効開始日から終了日に含まれる必要があります；
Spendia上、兼務は期間（履歴）管理がされません。22年A部門、23年B部門兼務の場合、別々で二レコードが登録されます；
パラメータの開始終了期間内に、当従業員の配下に同じ会社・部門の主務・兼務が存在するかをチェックします。
存在した場合、新たに登録できません。更新APIをコールして既存情報の更新となります。

OpenAPI権限

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

リクエストURI

/api/openapi/users/secondary-post

リクエスト形式

POST

リクエスト例


{
    "employeeId": "EMP-001",
    "companyCode": "",
    "departmentCode":"",
    "fromDate": "2020-01-01",
    "toDate": "1990-01-01",
    "job": "01",
    "staffType": "01",
    "approvalLevel": "111",
    "staffLevel": "1",
    "managerEmployeeId": "EMP-2",
    "customFields": [
        {
            "fieldCode": "custom1",
            "value": "15"
        },
        {
            "fieldCode": "custom2",
            "value": "test"
        }
    ]
}

リクエスト項目

項目名	タイプ	必須	キー	規則	説明
employeeId	String	〇	〇		従業員番号
companyCode	String	〇	〇		会社コード
departmentCode	String	〇	〇		部門コード
fromDate	String	〇	〇	日付フォーマット：yyyy-MM-dd	開始日
toDate	String			日付フォーマット：yyyy-MM-dd	終了日
job	String			値セット:職務,最大50文字	職務
staffType	String			値セット:従業員タイプ,最大50文字	従業員タイプ
approvalLevel	String			値セット:承認レベル,最大10数字	承認レベル
staffLevel	String			値セット:ランク,最大100文字	ランク
managerEmployeeId	String				所属上役番号
customFields	CustomField[]			最大10個、イメージタイプをサポートしない	職務カスタマイズ項目リスト

CustomField

パラメータ名	タイプ	必須	キー	規則	説明
fieldCode	String	○	○	最大50文字	カスタマイズ項目コード
value	String			最大500文字	カスタマイズ項目値、カスタマイズ項目の設定が必須の場合はカスタマイズ項目値は必須入力です

OpenAPIリターン例

成功例

{
    "message": "success",
    "oid": "3249b50a-1e29-4cae-93ea-bfec4955fafa",
    "key": "TEC-1"
}

失敗例

{
    "message": "会社は存在しない",
    "errorCode": "121301"
}

項目説明

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

エラーコード説明

errorCode	message	説明
0013	パラメータ:{0}は{1}文字以内で指定してください
120001	テナントの権限がありません
120003	パラメータ:{0}は指定必須の項目です
120210	指定したメールアドレスが正しくありません
120222	従業員情報拡張項目は最大10個まで設定可能です
120223	従業員情報拡張項目のコードが必須入力です
120224	従業員情報拡張項目の検証に失敗しました:{0}
120225	従業員情報拡張項目の値が必須入力です
120227	従業員情報拡張項目のコードが重複しています
121301	会社は存在しない
121307	部門が存在しません
6013009	日付フォーマットはyyyy/MM/ddです
6047034	従業員番号は従業員が見つからない
6047060	所属上役の従業員番号は無効です
6047061	性別は存在しません
6047062	従業員タイプは存在しません
6047063	職務は存在しません
6047064	ランクは存在しません
6061005	カスタマイズ項目:{0} を入力してください
6061006	カスタマイズ項目:{0} の値は正しくありません
6061007	カスタマイズ項目:{0} の値は規則に従っていません
6061008	カスタマイズ項目:{0} の整数部は{0}桁以内で指定してください
6061009	カスタマイズ項目:{0} の小数部は{0}桁以内で指定してください
6061010	カスタマイズ項目:{0} が時間フォーマットではありません
6061011	カスタマイズ項目:{0} は日付フォーマットyyyy-MM-ddで指定してください
8702002	操作が失敗しました。会社が未指定の部門が存在します
8702003	社員の所属会社が所属部門の会社と一致していません
12458005	従業員IDは2０桁以内のアルファベット、数字だけです
12458006	入力された従業員IDは既に存在するので、改めて入力ください
136791004	20桁以内の文字を入力してください
6047055	無効な会社コードです
120103	部門は存在しない
6047068	承認レベルはNullです
120015	提出日付（自）は提出日付（至）より未来に設定することはできません
60390003	従業員の主務が存在しません(基準日{0})
60390008	開始日が{0}の所属情報が既に存在します
60390015	開始日を{0}から{1}へ変更するには、既存の所属期间({2}〜{3})を跨ぎます
6040005	会社は無効です
60390017	主務が所属情報の有効期間（{0}〜{1}）に無効です（{2}〜{3}に存在しません）
60390016	主務が所属情報の有効期間（{0}〜{1}）に無効です（{2}〜{3}に無効されました）
60390007	部門が所属情報の有効期間（{0}〜{1}）に無効です（{2}〜{3}に存在しません）	所属部門が兼務の有効期間に存在しないので、登録できません。
60390006	部門が所属情報の有効期間（{0}〜{1}）に無効です（{2}〜{3}に無効されました）	所属部門が兼務の有効期間に無効になっていますので、登録できません。
60390012	所属情報(期間：{0}〜{1})の会社と部門（期間：{2}〜{3}）の所属会社と一致しません	指定した会社と部門の所属会社と一致しないので、登録できません。
60390010	当従業員は、{0}〜{1}の期間内に、同一会社同一部門の有効な所属情報が既に存在します({2}〜{3})	当従業員の配下に、指定した会社コード、部門コードをキーに、開始終了範囲内に他に兼務をすでに存在します。登録できません。
6047054	無効な部門コードです。
9500006	{0} が有効な日付範囲外です。（1970/01/01 00：00:01～2038/01/19 03:14:07）
60390018	主務有効期間外の兼務が存在します({0}〜{1})	開始日が主務より前の兼務の登録を許容しないので、登録できません。
120226	個人情報拡張項目のコードが存在しません:{0}。
120252	最大10個まで設定可能です
6040014	メールアドレスは既に存在している
6047018	他の未知エラー
6047021	携帯番号は存在している
6047028	部門は無効でした
6047029	会社に合わない
6047044	従業員番号は既に存在している
6047049	部門コードは漢字を含むことができません
6047050	部門コードは不正な文字を含むことができません
6047051	部門コードは36位以上を超えることができません
6047054	無効な部門コードです。
6047056	退職日を入力してください。
6047057	退職予定の従業員番号が存在しません。
THIRD_PARTY_APPLICATION_004	認識できないクライアントマークまたはクライアントには権限がない

← 従業員情報個別取得従業員の兼務更新 →