# 接口说明
- 1.最新接口
- 2.企业授权负责人无法通过此接口进行更新操作
- 3.支持批量更新,批量不能大于50,因添加人员会关联相关各场景权限信息,若数量过大会导致添加返回超时
- 4.字段说明:根据role_type判断员工的职级,不同职级员工已匹配好相应的国内机票,国际机票,用车,火车,酒店,采购,用餐,外卖的权限规则
| 请求方式 | 请求地址 |
|---|---|
| POST | /openapi/func/employee/update |
请求参数
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| access_token | api鉴权Token | string | Y | 登录 token |
| sign | 签名 | string | Y | 907943uf |
| timestamp | 时间戳 | long | Y | 13位时间戳 |
| employee_id | 用户ID | string | Y | 第三方用户id |
| employee_type | 用户类型 | string | Y | 类型,0为分贝用户,1为第三方用户 |
| data | 请求数据 | jsonstring | Y | 请求数据 |
| data.employee_list | 员工信息 | jsonarray | Y | 员工请求数据 |
| data.employee_list.name | 员工姓名 | string | Y | 张三 |
| data.employee_list.phone | 员工手机号 | string | Y | 16090190901 |
| data.employee_list.third_employee_id | 第三方员工ID | string | Y | 34567 |
| data.employee_list.third_org_unit_id | 部门ID | string | Y | 员工部门ID,874890934ghgdytuyjg |
| data.employee_list.org_unit_name | 部门名称 | string | N | 员工部门名称,分贝通科技有限公司/研发部/后端服务(可以不填) |
| data.employee_list.employee_number | 员工工号 | string | N | fbttest00001 |
| data.employee_list.email | 员工邮箱 | string | N | fbttest@gmail.com |
| data.employee_list.role | 员工权限角色 | integer | N | 员工权限,2:普通管理员 3:普通员工(若不填则默认为管理后台的普通员工权限) |
| data.employee_list.role_type | 员工权限类型 | string | N | 员工权限类型 |
| data.employee_list.gender | 性别 | integer | N | 1:男 2:女 如果证件类型为身份证,则从身份证中获取。其他证件类型需传递该字段 |
| data.employee_list.birth_date | 出生日期 | string | N | 格式:yyyyMMdd ,20191203,如果证件类型为身份证,则从身份证中获取。其他证件类型需传递该字段 |
| data.employee_list.status | 员工状态 | integer | N | 1启用 2禁用 |
| data.employee_list.update_flag | 更新标识 | boolean | N | 证件信息不传是否删除? 为true,则删除组织架构内的证件信息,以最新传递的数据为准,若为false,则组织架构内的身份信息为增量添加 |
| data.employee_list.cert_list | 证件信息 | jsonarray | N | 1:身份证;2:护照;3:回乡证;4:台胞证;5:往来港澳通行证;6:大陆居民往来台湾通行证 |
| data.expand_json | 扩展属性 | jsonobject | N | 该字段用于同步人员的扩展内容,{} |
| data.employee_list.rank_id | 职级id | string | N | 职级id |
| data.employee_list.rank_name | 职级名称 | string | N | 职级名称 |
| data.employee_list.template_id | 消费权限模板id | string | N | 消费权限模板id |
| data.employee_list.customize_list | 自定义字段列表 | jsonarray | N | 自定义字段列表 |
| data.employee_list.customize_list.field_id | 自定义字段列id | string | N | 自定义字段列id,通过查询自定义字段接口获取 |
| data.employee_list.customize_list.value | 自定义字段值 | string | N | 自定义字段值 |
| data.employee_list.third_legal_entity_id | 员工三方法人主体id | string | N | 员工三方法人主体id |
| data.employee_list.location_code_list | 城市常驻地code码 | jsonarray | N | 城市常驻地code码 |
| data.employee_list.third_direct_sup_id | 直属上级三方id | string | N | 直属上级三方id |
请求示例
"access_token": "xxx.xxx.xxx",
"timestamp": 1596697247000,
"employee_id":"third_jianyuan",
"employee_type":"1",
"data":{
"employee_list":[
{
"name":"张5s",
"phone":"13718432812",
"third_org_unit_id":"5747fbc10f0e60e0709d8d7d",
"third_employee_id":"57ab054c2528226a805bd5e1",
"email":"test@gmail.com",
"gender":1,
"status":1,
"birth_date":"19881224",
"employee_number":"fbttest000001",
"update_flag":false, //证件信息不传是否删除? 为true,则删除组织架构内的证件信息,以最新传递的数据为准,若为false,则组织架构内的身份信息为增量添加
"cert_list":[
{
"cert_type":1,
"cert_no":"2211239012r28351"
}
],
"expand_json":{
},
"customize_list":[
{
"field_id":"9898989898",
"value":"testvalue"
}
],
"rank_id":"601913fc72af41394159d7dd1",
"rank_name":"测试职级1",
"template_id":"60ec221972af41caf130e42f",
"role":3,
"role_type":"1",
"third_legal_entity_id":"5767878989",
"location_code_list":[
"001",
"002"
]
},
{
"name":"张5",
"phone":"13718432992",
"org_unit_id":"5747fbc10f0e60e0709d8d7d",
"third_employee_id":"57ab054c2528226a805bd500",
"gender":1,
"birth_date":"19881224"
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
返回结果
{
"request_id":"LaZNvBntsBD20nJ7ekgn",
"code":0,
"msg":"success",
"data":{
}
}
{
"request_id":"LaZNvBntsBD20nJ7ekgn",
"code":0,
"msg":"success",
"data":{
"result":[
{
"name":"张三(姓名)",
"phone":"13718432817(手机号)",
"companyId":"57ab054c2528226a805bd5e1(公司id)",
"thirdEmployeeId":"57ab054c2528226a805bd5e1(第三方用户id)",
"errorMsg":"手机号已存在"
}
]
}
}
{
"request_id":"piVFVuQqyE0I9CFDWzY7",
"code":0,
"type":0,
"msg":"success",
"data":{
"result":[
{
"companyId":"5747fbc10f0e60e0709d8d7d",
"phone":"17080151666",
"name":"谷健",
"thirdEmployeeId":"gujianbo-123",
"errorMsg":"授权负责人手机号不能修改"
}
]
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
errorMsg详细说明:
会存在一下几种情况
1."手机号已存在" 原因:人员手机号已被其他员工使用
2."用户不存在" 原因:人员未同步到分贝通,检查人员是否已同步
3."第三方ID不存在" 原因:人员未同步到分贝通,检查人员是否已同步
4."授权负责人手机号不能修改" 原因:公司授权负责人的手机号无法通过接口进行变更
5."修改规则接口异常!" 原因:公司配置的规则信息不正确,检查规则ID是否正确
1
2
3
4
5
6
7
2
3
4
5
6
7
← 3.2.2.添加员工 3.2.4.删除员工 →