新建待入职员工

POST

/TenantBaseExternal/api/v5/Employee/CreateForEntry

接口限制：100次/秒/企业 3000次/分钟/企业

适用场景：首次新建待入职员工

警告信息：-

tips：1.必填项：姓名、电子邮件、部门、入职日期、雇佣关系、试用期
2.外部ID标识（OriginalId字段），表示可以使用第三方系统唯一标识ID（非北森系统），系统中会自动创建一个外部ID和内部ID字段映射关系，供后续更新、删除等操作使用
3.XXX外部ID标识（XXXOriginalId字段，如HRBPOriginalId），表示可以使用第三方系统唯一标识ID（非北森系统），而不用使用北森内部的ID标识。系统中会自动根据已有的外部ID和内部ID字段映射关系，进行转换处理。前提是系统中已通过新增操作关联该外部ID，否则报错。

错误码示例

{
"data": null,
"code": "417",
"message": "电子邮箱与待入职的内部员工：Test_Inner_41232113（test_inner_4123213@qq.com）重复，请确认信息！"
}

请求参数

Body 参数application/json

示例

返回响应

🟢200核心人力操作结果

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://openapi.italent.cn/TenantBaseExternal/api/v5/Employee/CreateForEntry' \
--header 'Content-Type: application/json' \
--data-raw '{
    "employeeInformation": {
        "name": "testEmp1",
        "email": "testemp1@beisen.com",
        "idType": "1",
        "idNumber": "110101199003077096",
        "gender": 0,
        "birthday": "1990-03-07T00:00:00",
        "backupMail": "testemp1@beisen.com",
        "speciality": "学习",
        "emergencyContactPhone": "15645718874",
        "weiXin": "15645718874",
        "graduateDate": "2020-07-09T00:00:00",
        "homeAddress": "15645718874",
        "mobilePhone": "15645718874",
        "educationLevel": "1",
        "lastSchool": "清华大学",
        "homePhone": "15645718874",
        "constellation": "1",
        "inviteForActivation": true,
        "bloodType": "2",
        "domicileType": 2,
        "postalCode": "100101",
        "emergencyContact": "张三",
        "emergencyContactRelationship": "母子",
        "businessAddress": "北京市海淀区",
        "officeTel": "15645718874",
        "marryCategory": "2",
        "politicalStatus": "2",
        "nationality": 1,
        "nation": "1",
        "birthplace": "北京市东城区",
        "registAddress": "1100",
        "qq": "15645718874",
        "aboutMe": "www.beisen.com",
        "major": "软件工程",
        "customProperties": {
            "extbeizhua_127666_398499608": "这是一个备注字段"
        }
    },
    "employmentRecord": {
        "entryDate": "2021-07-08T00:00:00",
        "probation": 3,
        "oIdDepartment": 4744879,
        "employType": 0,
        "jobNumber": "bs8898",
        "isCharge": "0",
        "oIdOrganization": 900127666,
        "poIdEmpAdmin": 101178784,
        "poIdEmpReserve2": 101500687,
        "probationStartDate": "2021-07-08T00:00:00",
        "employmentSource": "d5c77d41-a8f4-4dae-9bca-d1f4cdb60520",
        "employmentForm": "db4e33b9-d83c-4a58-86ab-083e3b488d95",
        "employmentType": "05773898-47aa-4dee-85dc-0cfc85f6237b",
        "oIdJobPost": "2022",
        "oIdJobSequence": "371",
        "oIdJobPosition": "64c9a5b2-2c31-4f90-a547-990f3be1a513",
        "oIdJobLevel": "b410ef25-af77-4a4c-84e4-e6ca61ccc96d",
        "oidJobGrade": "8a82cd49-91fb-41ce-a2b4-e433714a8141",
        "place": "1108",
        "probationStopDate": "2021-10-07T00:00:00",
        "customProperties": {
            "extbeizhua_127666_398499608": "这是一个备注字段"
        }
    },
    "employmentContract": {
        "firstPartyCode": "c267b7f6-b849-4781-92da-321d69c7af7b",
        "contractType": 0,
        "contractDueTimeType": 0,
        "effectiveDate": "2021-07-08T00:00:00",
        "terminateDate": "2021-11-07T00:00:00",
        "code": "gdgh2148",
        "signingDate": "2021-07-10T00:00:00",
        "contactLength": 4,
        "customProperties": {
            "extbeizhua_127666_398499608": "这是一个备注字段"
        }
    }
}'

响应示例

{
    "data": {
        "employeeInformationId": "string",
        "employmentRecordId": "string",
        "userId": 0
    },
    "code": "string",
    "message": "string"
}

修改于 2021-10-13 10:54:24

完成审批

新建在职员工、外部人员、实习生

新建待入职员工

错误码示例#

请求参数

返回响应

错误码示例