# 接口说明

  • 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

返回结果

{
    "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
errorMsg详细说明:
会存在一下几种情况
1."手机号已存在" 原因:人员手机号已被其他员工使用
2."用户不存在" 原因:人员未同步到分贝通,检查人员是否已同步
3."第三方ID不存在" 原因:人员未同步到分贝通,检查人员是否已同步
4."授权负责人手机号不能修改" 原因:公司授权负责人的手机号无法通过接口进行变更
5."修改规则接口异常!" 原因:公司配置的规则信息不正确,检查规则ID是否正确
1
2
3
4
5
6
7
lastUpdate: 1/16/2024, 6:13:43 PM