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

POST

/TenantBaseExternal/api/v5/Employee/Create

接口限制：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_4123211（test_inner_4123211@qq.com）重复，请确认信息！"
}

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://openapi.italent.cn/TenantBaseExternal/api/v5/Employee/Create' \
--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"
}

请求参数

Body 参数application/json

employeeInformation

object

必需

name

string

必需

姓名，必填，如张三

string

必需

电子邮件，必填，如 zhangsan@beisentest.com

originalId

string

可选

外部ID标识，第三方系统唯一标识ID（非北森系统），示例：8785dd30-7b2d-4fce-8fd3-df0e4be79f46,123等字符串

iDType

string

可选

证件类型，查看可用选项

iDNumber

string

可选

证件号码，示例：18位身份证等

gender

integer <int32> | null

可选

性别：合理值为空或男、女查看可用选项

birthday

string <date-time> | null

可选

出生日期，必须为null或大于等于1900-01-01且小于等于9999-12-31，如 2001-01-02

backupMail

string

可选

个人邮箱，如 zhangsan9020@163.com

speciality

string

可选

特长,如羽毛球、足球、书法（文本描述即可）

emergencyContactPhone

string

可选

联系电话，如 131****3356

weiXin

string

可选

微信，微信号、昵称均可

graduateDate

string <date-time> | null

可选

毕业时间，必须为null或大于等于1900-01-01且小于等于9999-12-31，示例：2016-7-1

homeAddress

string

可选

联系地址，如北京市海淀区上地东路35号

mobilePhone

string

可选

手机号码，如 134****3356

educationLevel

string

可选

最高学历，查看可用选项

lastSchool

string

可选

毕业学校，示例：清华大学

homePhone

string

可选

家庭电话,如 010-534**567

passportNumber

string

可选

护照号码,如 G64***593

constellation

string

可选

星座查看可用选项

region

integer <int32> | null

可选

区域查看可用选项

synopsis

string

可选

简介，如本人性格开朗，待人友好，为人诚实谦虚

inviteForActivation

boolean | null

可选

邀请激活账号布尔类型，必须为null或true/false，如true

certificateValidityTerm

string <date-time> | null

可选

证件有效期日期类型必须为null或大于等于1900-01-01且小于等于9999-12-31，如 2017-07-01

workEmail

string

可选

电子邮件（工作）如 zhangsan@beisentest.com

bloodType

string

可选

血型查看可用选项

technicalLevelID

integer <int32> | null

可选

专业技术级别查看可用选项

residenceAddress

string

可选

户籍地址，如北京市朝阳区

joinPartyDate

string <date-time> | null

可选

入党/团日期，必须为null或大于等于1900-01-01且小于等于9999-12-31，如 2017-07-01

domicileType

integer <int32> | null

可选

户口类别，查看可用选项

postalCode

string

可选

邮政编码,如 100075

emergencyContact

string

可选

紧急联系人，如王武

emergencyContactRelationship

string

可选

与本人关系，如同学、家人、朋友等

businessAddress

string

可选

办公地址，如北京市海淀区上地东路35号

officeTel

string

可选

办公电话，如 010-87***177-699

engName

string

可选

其他语言姓名，如 Dennis、Johy 等

workDate

string <date-time> | null

可选

参加工作日期，必须为null或大于等于1900-01-01且小于等于9999-12-31，如2015-07-01

marryCategory

string

可选

婚姻状况，查看可用选项

politicalStatus

string

可选

政治面貌，查看可用选项

nationality

integer <int32> | null

可选

国家(地区)，查看可用选项

nation

string

可选

民族，查看可用选项

birthplace

string

可选

户籍所在地，示例：北京市

registAddress

string

可选

籍贯，查看可用选项

blog

string

可选

博客, 示例 www.xxx.com

healthStatusID

integer <int32> | null

可选

健康状况，查看可用选项

iDPhoto

string

可选

照片，DFS附件路径,如 dfs://TenantBaseFile/110006/fc432a3e2********be628813.jpg

string

可选

QQ，如 121***3452

aboutMe

string

可选

关于我（文本描述即可），如严以律己，用心做事；认真生活，快乐工作等

major

string

专业，如英语专业

可选

sourceType

integer <int32>

可选

类型（招聘团队用），查看可用选项

optionalSysProperties

object

可选

非必填（可选）标准字段Key（字段编码）-Value（字段值）字典，暂不使用，仅预留方便后续扩展使用。(区分大小写，自动忽略自定义字段和不存在的字段)，若有同名属性，则优先使用属性值。示例：key=Remarks,value="可选标准字段"

customProperties

object

可选

租户级别自定义字段Key（字段编码）-Value（字段值）字典(区分大小写，自动忽略非自定义字段和不存在的字段)，示例：key=exthtxybeizhua_127666_1123139652,value="自定义字段"

employmentRecord

object

必需

entryDate

string <date-time> | null

必需

入职操作时，任职记录的入职日期，用于任职记录的时间轴，必填，必须大于等于1900-01-01，示例：2020-1-12

probation

integer <int32> | null

必需

试用期（月），范围：0-12，0表示无试用期。外部员工、实习生不存在试用期，赋值0。必填，示例：3

oIdDepartment

integer <int32> | null

可选

任职部门（如技术部）OId，对应于组织单元业务实体关联的部门OId字段值，两个ID（OIdDepartment、OIdDepartmentOriginalId）必须有且仅有一个有值。示例：067407

oIdDepartmentOriginalId

string

可选

任职部门外部ID标识，第三方系统唯一标识ID（非北森系统），两个ID（OIdDepartment、OIdDepartmentOriginalId）必须有且仅有一个有值示例：8785dd30-7b2d-4fce-8fd3-df0e4be79f46,123等字符串

employType

integer <int32>

必需

雇佣关系：必填，默认为0内部员工查看可用选项

jobNumber

string

可选

工号，示例：s00000365

isCharge

string

可选

是否部门负责人，可为空查看可用选项

oIdOrganization

integer <int32> | null

可选

任职机构（如子公司），对应于组织单元业务实体关联的机构OId字段值，为空或大于等于0，如 900110006

oIdOrganizationOriginalId

string

可选

任职机构（如子公司）外部ID标识，第三方系统唯一标识ID（非北森系统），示例：8785dd30-7b2d-4fce-8fd3-df0e4be79f46,123等字符串

pOIdEmpAdmin

integer <int32> | null

可选

直线经理的userid，为空或大于等于0，如 131789932

pOIdEmpAdminOriginalId

string

可选

直线经理外部ID标识，第三方系统唯一标识ID（非北森系统），示例：8785dd30-7b2d-4fce-8fd3-df0e4be79f46,123等字符串

pOIdEmpReserve2

integer <int32> | null

可选

虚线经理，为空或大于等于0，如 131689132

pOIdEmpReserve2OriginalId

string

可选

虚线经理外部ID标识，第三方系统唯一标识ID（非北森系统），示例：8785dd30-7b2d-4fce-8fd3-df0e4be79f46,123等字符串

probationStartDate

string <date-time> | null

可选

试用开始日期，必须大于等于1900-01-01，示例：2020-1-12

probationStopDate

string <date-time> | null

可选

预计试用结束日期，默认根据Probation联动赋值，必须为空或大于等于1900-01-01，可手工赋值，如2021-03-01

employmentSource

string

可选

人员来源实体对象（实体编码：TenantBase.EmploymentSource）业务数据GUID 查看可用选项

employmentForm

string

可选

用工形式实体对象（实体编码：TenantBase.EmploymentForm）业务数据GUID 查看可用选项

employmentType

string

可选

人员类别实体对象（实体编码：TenantBase.EmploymentType）业务数据GUID 查看可用选项

oIdJobPost

string

可选

职务实体（实体编码：TenantBase.JobPost）OId字段的值，必须为空或数字，示例：62797 查看可用选项

oIdJobSequence

string

可选

职务序列实体（实体编码：TenantBase.JobSequence）OId字段的值，必须为空或数字，示例：1459 查看可用选项

oIdJobPosition

string

可选

职位实体（实体编码：TenantBase.JobPosition）OId字段的值，必须为空或GUID

oIdJobLevel

string

可选

职级实体（实体编码：TenantBase.JobLevel）OId字段的值，必须为空或GUID

oidJobGrade

string

可选

职等（实体编码：TenantBase.JobGrade）OId字段的值，必须为空或GUID，示例：8785dd30-7b2d-4fce-8fd3-df0e4be79f46

place

string

可选

工作地点，查看可用选项

remarks

string

可选

备注如：xxx的A部门任职

pOIdEmpReserve3

integer <int32> | null

可选

预留维度3，对应于组织单元业务实体关联的机构OId字段值，为空或大于等于0，如 13168

pOIdEmpReserve3OriginalId

string

可选

预留维度3 外部ID标识，第三方系统唯一标识ID（非北森系统），示例：8785dd30-7b2d-4fce-8fd3-df0e4be79f46,123等字符串

pOIdEmpReserve4

integer <int32> | null

可选

预留维度4，对应于组织单元业务实体关联的机构OId字段值，为空或大于等于0，如 13168

pOIdEmpReserve4OriginalId

string

可选

预留维度4 外部ID标识，第三方系统唯一标识ID（非北森系统），示例：8785dd30-7b2d-4fce-8fd3-df0e4be79f46,123等字符串

pOIdEmpReserve5

integer <int32> | null

可选

预留维度5，对应于组织单元业务实体关联的机构OId字段值，为空或大于等于0，如 13168

pOIdEmpReserve5OriginalId

string

可选

预留维度5 外部ID标识，第三方系统唯一标识ID（非北森系统），示例：8785dd30-7b2d-4fce-8fd3-df0e4be79f46,123等字符串

optionalSysProperties

object

可选

customProperties

object

可选

employmentContract

object

可选

firstPartyCode

string

可选

法人公司实体对象（实体编码：TenantBase.Corporation）业务数据GUID 查看可用选项

contractType

integer <int32> | null

可选

类型查看可用选项

contractDueTimeType

integer <int32> | null

可选

期限类型查看可用选项

effectiveDate

string <date-time> | null

可选

生效日期，必填，必须大于等于1900-01-01，示例：2020-1-12

terminateDate

string <date-time> | null

可选

终止日期，无固定期限合同，可不填写终止日期，其他情况必填，必须大于等于1900-01-01，示例：2020-1-12

code

string

可选

编号，示例：A001

signingDate

string <date-time> | null

可选

签订日期，必须大于等于1900-01-01，示例：2020-1-12

contactLength

integer <int32> | null

可选

合同期限（月），示例：2

probationStartDate

string <date-time> | null

可选

试用期开始时间，必须大于等于1900-01-01，示例：2020-1-12

probationStopDate

string <date-time> | null

可选

试用期结束时间，必须大于等于1900-01-01，示例：2020-1-12

probationSalary

number <double> | null

可选

试用期工资，浮点型，示例：8888.88

salary

number <double> | null

可选

试用期满工资，浮点型，示例8888.88

optionalSysProperties

object

可选

customProperties

object

可选

示例

返回响应

🟢200核心人力操作结果

application/json

Body

data

object

可选

employeeInformationId

string

可选

员工信息实体主键GUID，如 7FA89C42-15E5-6001-9915-C418FD79C41F

employmentRecordId

string

可选

任职记录实体主键GUID，如 7FA89C42-15E5-6001-9915-C418FD79C41F

userId

integer <int32>

可选

员工信息实体UserID，如 113103851

code

string

可选

响应码（正常情况必须200）或异常错误编码（异常情况）：200-OK，417-参数异常、业务不合法，500-内部服务器异常。示例："200"

message

string

结果消息

可选

新建待入职员工

直接退休正式员工

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

错误码示例#

请求参数

返回响应

错误码示例