更新部分员工信息

  • 接口:/employee/part/update
  • Method:POST
  • 数据格式:JSON
  • 接口说明:每批最多处理300个数据
请求参数
参数 类型 必须 默认值 主键 描述
mobile string Y/N 手机号码(也可提供邮箱
email 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":"缺少部门信息"}
    ...
}

results matching ""

    No results matching ""