员工批量同步接口

业务场景

该接口用于批量新增或更新员工。

接口限制

 1. 10次/秒;
 2. 单次导入限制为200条数据;

接口说明

1. 单条失败模式。即传入的每条数据互不影响。某条失败,不会影响其他数据执行。
2. 该接口工号作为唯一标识,如果客户工号变更,同步后会出现一条新记录
3. 同步时,不会校验英文大小写问题(即若更新的工号内容一致,仅大小写区别,系统将认为是同一个employeeId,并将系统内employeeId更新为最新导入的值)

接口地址

员工批量同步接口

/api/platform/employee/batch

请求类型

POST

请求参数

参数说明

参数名称 类型 是否必填 参数说明
entCode String(50) 企业编号
operator String(50) 操作人编号
employees List<EmployeeForm> 员工请求信息

参数样例

{
  "entCode" :"EC30GQQG0VB9JO",
  "operator":"test",
  "employees":[
    {
      "employeeId": "E10001",
      "employeeName": "luo1",
      "email": "luo1@maycur.com",
      "phoneNo": "12345678901",
      "employeeNickName": "花名",
      "roleNames": [
        "root"
      ],
      "departments": [
        {
          "businessCode": "10001",
          "defaultDepartment": true
        }
      ],
      "residences": [
        {
          "placeCode": "330101"
        }
      ],
      "customObject": {
        "CF1395": 1,
        "CF1396": {
          "currencyCode": "CNY",
          "amount": "1.00"
        },
        "CF1397": {
          "currentTime": 1566204741186
        }
      }
    }
  ]
}

响应参数

响应参数说明

参数名称 类型 是否必填 参数说明
response_code int 响应码
response_message String 错误信息
data String 响应体

response_code - 响应码说明

平台级接口响应码说明

参数样例

  1. 正常响应参数示例
    {
    "response_code": 0,
    "response_message": "",
    "data": null
    }
    
  2. 错误返回示例
    {
    "response_code": 9999,
    "response_message": "",
    "data": 
    {
     "errorData": [
       {
         "key": "E100011",
         "errorCode": "110005",
         "errorMessage": "当前员工常驻地设置只支持一个常驻地"
       }
     ]
    }
    }
    

    errorData中的errorCode说明

    错误码说明

修改记录

2023-04-25 新增
Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2024-11-20 10:52:00

results matching ""

    No results matching ""

    results matching ""

      No results matching ""