更新部分员工信息
- 接口:/employee/part/update
- Method:POST
- 数据格式:JSON
- 接口说明:每批最多处理300个数据
请求参数
参数 | 类型 | 必须 | 默认值 | 主键 | 描述 |
---|---|---|---|---|---|
mobile | string | Y/N | 手机号码(也可提供邮箱 | ||
string | Y/N | 邮箱(也可提供手机号码) | |||
name | string | Y/N | 员工姓名 | ||
employeeId | string | Y | Y | 员工工号 | |
rank | string | 员工职级名称, (如果系统无该职级,将自动创建该职级) | |||
position | string | 员工职务编码 | |||
departments | array | Y/N | 员工所属部门,及部门上级,详见下表 | ||
status | string | ENABLE | 员工在职状态, 可以选择ENABLE, DISABLE | ||
defaultSubsidiaryBizCode | string | 员工默认业务实体 | |||
defaultDepartmentBizCode | string | 员工默认部门 | |||
hireDate | long | 入职时间,填时间戳,精确到毫秒,例如:1569569158000 | |||
tag | string | 属性,可被用于流程 | |||
source | string | 外联平台,可选值 WEIXIN、DING_TALK | |||
sourceId | string | 外联平台key 格式:外联平台的企业ID+"_"+外联平台的用户ID | |||
residenceCode | string | 常驻地,传入每刻地址编码,具体见备注 | |||
custField1 | string | 自定义字段1 | |||
custField2 | string | 自定义字段2 | |||
custField3 | string | 自定义字段3 | |||
custField4 | string | 自定义字段4 | |||
custField5 | string | 自定义字段5 | |||
custField6 | string | 自定义字段6 | |||
custField7 | string | 自定义字段7 | |||
custField8 | string | 自定义字段8 | |||
custField9 | string | 自定义字段9 | |||
custField10 | string | 自定义字段10 | |||
note | string | 备注 | |||
firstName | string | 名 | |||
middleName | string | 多为非中国人填写使用 | |||
lastName | string | 姓 | |||
restrictSubsidiaryBizCodes | array | 限定的业务实体 | |||
identityCardNo | string | 身份证号码 |
部门列表
参数 | 类型 | 必须 | 默认值 | 主键 | 描述 |
---|---|---|---|---|---|
departmentBizCode | string | Y | 部门编码 | ||
managerId | string | N | 部门内上级工号 | ||
cover | string | N | Y | 是否承担部门, 如果不是承担部门,请输入 N | |
positionBizCode | string | N | 职务编码 |
返回数据
字段 | 类型 | 描述 |
---|---|---|
code | string | 系统内唯一主键 |
employeeId | string | 员工工号 |
备注
- 如果员工不存在则新增员工。如果员工存在,则只更新传入的参数,没传入的参数保持不变
- 新增员工的情况下,Y/N表示该参数必填。更新员工的情况下,Y/N表示,该参数可以不传,如果要传则不能传null,空字符串,空数组等
- 该接口严格检查参数类型,会返回类似"参数类型有误,请检查"这种错误信息
- 该接口采用单条失败的处理方式,即整批数据中,如果只有其中的几条因为各种原因失败,那么只有那几条数据不会被保存;其它的数据仍然会被正常处理;错误数据的主键(employeeId)会被放在errorData里面;errorData为结构体, 包含出错记录主键(employeeId), 以及与之对应的出错信息; 类似 {"employeeId": "错误信息"}; 具体参见失败示例;如果有错误信息,则返回的code为NACK,然后错误信息会放在errorData里,只有全部成功返回的code为ACK。
请求数据
{
"timestamp": 123456,
"data": [
{
"employeeId": "001",
"name": "测试B",
"rank": "P1",
"position": "EMPLOYEE",
"status": "ENABLE",
"departments": [
{
"departmentBizCode": "YFB",
"managerId": "000"
}
],
}
]
}
返回数据(成功)
{
"code": "ACK",
"message": "",
"data": [
{
"code": "ABCDAAFA1234",
"employeeId": "001"
}
]
}
返回数据(失败)
{
"code": "NACK",
"message": null,
"errorData":{"001":"缺少部门信息"}
...
}