分贝通开放平台文档

# 接口说明

  • 1.最新接口
  • 2.如果存在部门概念，保存到部门下面,采用部门ID进行添加
  • 3.支持批量添加，批量不能大于50，因添加人员会关联相关各场景权限信息，若数量过大会导致添加返回超时
  • 4.字段说明:根据role_type判断员工的职级，不同职级员工已匹配好相应的国内机票，国际机票，用车，火车，酒店，采购，用餐,外卖的权限规则
  • 5.如果填写了邮箱（data.employee_list.email），用户会收到分贝通账户开通邮件
请求方式 请求地址
POST /openapi/func/employee/create

请求参数

字段 名称 类型 必填 描述
timestamp 时间戳 long Y 13位时间戳
access_token token string Y 登录 token
employee_id 用户ID string Y 第三方用户id，操作人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 17902029298
data.employee_list.role 员工权限角色 integer N 员工权限,2:普通管理员 3:普通员工(若不填则默认为管理后台的普通员工权限角色)
data.employee_list.role_type 员工权限类型 string N 员工权限类型，已切消费权限模板的用户填消费权限模板名称
data.employee_list.third_org_unit_id 员工部门ID string Y 部门ID，部门时则必填
data.employee_list.org_unit_name 部门名称(公司名称) string N 当人员添加到公司下时必填，需填写公司名称，部门名称不允许有/符号
data.employee_list.third_employee_id 第三方员工ID string Y 确保唯一性，例如，员工工号，系统登录名
data.employee_list.employee_number 员工工号 string N fbttest00001
data.employee_list.email 员工邮箱 string N 如果填写了邮箱，用户会收到分贝通账户开通邮件
data.employee_list.gender 性别 integer N 1:男 2:女 如果证件类型为身份证，则从身份证中获取。其他证件类型需传递该字段
data.employee_list.birth_date 出生日期 string N 格式:yyyyMMdd ,20191203,如果证件类型为身份证，则从身份证中获取。其他证件类型需传递该字段
data.employee_list.cert_list 证件信息 jsonarray N 证件信息
data.employee_list.cert_list.cert_type 证件类型 integer N 1:身份证;2:护照;3:回乡证;4:台胞证;5:往来港澳通行证;6: 大陆居民往来台湾通行证
data.employee_list.cert_list.cert_no 证件号码 string N 63845687
data.employee_list.expand_json 扩展属性 jsonobject N 该字段用于同步人员的扩展内容,{}
data.employee_list.rank_id 职级id string N 职级id，字段值从3.4.1查询职级列表接口中获取
data.employee_list.rank_name 职级名称 string N 职级名称，字段值从3.4.1查询职级列表接口中获取
data.employee_list.template_id 消费权限模板id string N 消费权限模板id，字段值从3.4.2查询消费权限模版列表接口中获取
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":"0",
"data":{
    "employee_list":[
        {
            "name":"张三",
            "phone":"13935517238",
            "third_org_unit_id":"5747fbc10f0e60e0709d8d7d",
            "third_employee_id":"57ab054c2528226a805bd5e1",
            "employee_number":"fbttest000001",
            "email":"fbttest@gmail.com",
            "gender":1,
            "birth_date":"19881224",
            "cert_list":[
                {
                    "cert_type":1,
                    "cert_no":"140481197111019879"
                }
            ],
            "expand_json":{

            },
            "rank_id":"601913fc72af41394159d7dd1",
            "rank_name":"测试职级1",
            "template_id":"60ec221972af41caf130e42f",
            "role":3,
            "third_legal_entity_id":"5767878989",
            "location_code_list":[
                "001",
                "002"
            ]
        },
        {
            "name":"李四",
            "phone":"13935517239",
            "third_org_unit_id":"5747fbc10f0e60e0709d8d7d",
            "third_employee_id":"57ab054c2528226a805bd5e1",
            "email":"fbttest@gmail.com",
            "gender":1,
            "birth_date":"19881224",
            "cert_list":[
                {
                    "cert_type":1,
                    "cert_no":"140481197111019870"
                }
            ],
            "expand_json":{

            },
            "customize_list":[
                {
                    "field_id":"9898989898",
                    "value":"testvalue"
                }
            ],
            "role":3,
            "third_legal_entity_id":"5767878989",
            "location_code_list":[
                "001",
                "002"
            ]
        }
    ]
}
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
54
55
56
57
58
59
60
61
62
63
64
65
66

返回结果

{
	"request_id": "LaZNvBntsBD20nJ7ekgn",
	"code": 0,
	"msg": "success"
}
1
2
3
4
5
{
    "code": 0,
    "msg": "success",
    "data": {
        "result": [
            {
                "companyId": "601fb4c8aa422780b31210be",
                "phone": "13935517238",
                "name": "张三",
                "thirdEmployeeId": "57ab054c2528226a805bd5e1",
                "errorMsg": "身份证号不正确"
            },
            {
                "companyId": "601fb4c8aa422780b31210be",
                "phone": "13935517239",
                "name": "李四",
                "thirdEmployeeId": "57ab054c2528226a805bd5e1",
                "errorMsg": "身份证号不正确"
            }
        ]
    },
    "request_id": "XBb8HokpyM07mV9x"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
errorMsg详细说明:
会存在以下几种情况
1."手机号已经存在，请使用其他手机号" 原因:人员手机号已被其他员工使用
2。"第三方ID已经被其它用户绑定" 原因:人员ID已被其他员工使用
3."部门信息参数不正确" 原因:人员所属部门没有同步到分贝通
4."公司信息不存在，请使用正确参数" 原因:公司ID错误
5."保存规则接口异常!" 原因：规则ID错误
6."当前第三方部门ID不存在" 原因:人员所属部门没有同步到分贝通
7."当前部门信息正在被其他用户操作" 原因:多个用户同时操作该人员ID
1
2
3
4
5
6
7
8
9
lastUpdate: 1/16/2024, 6:13:43 PM

← 3.2.3.更新员工 →