2.2.1.2 添加第三方员工
接口说明
- 1.最新接口
- 2.如果存在部门概念,保存到部门下面,采用部门ID进行添加
- 3.支持批量添加,批量不能大于200,因添加人员会关联相关各场景权限信息,若数量过大会导致添加返回超时
- 4.添加时可以根据不同的需求进行权限的开关操作(包括国内机票,国际机票,用车,火车,酒店,采购,用餐,外卖权限,可以进行差异化的权限分配
- 5.字段说明:air_rule_id:当air_priv_flag和air_rule_limit_flag为true时,air_rule_id必须指定规则ID,进行绑定相应的规则。当air_priv_flag为false时,代表业务权限关闭,其他字段都设置为相应的不可用状态即可。其他业务线字段设置相同,参照机票权限规则即可
请求方式 | 请求地址 |
---|---|
POST | /open/api/auth/third/user/batch/org_save |
请求参数
字段 | 名称 | 类型 | 必填 | 描述 |
---|---|---|---|---|
timestamp | 时间戳 | long | Y | 13位时间戳 |
access_token | token | string | Y | 登录 token |
employee_id | 操作人id | string | N | 操作人id,调用接口人 id |
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 | 员工权限类型 | integer | 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 | fbttest@gmail.com |
data.employee_list.gender | 性别 | integer | N | 1:男 2:女 如果证件类型为身份证,则从身份证中获取。其他证件类型需传递该字段 |
data.employee_list.birth_date | 出生日期 | string | N | 格式:yyyyMMdd ,20191203,如果证件类型为身份证,则从身份证中获取。其他证件类型需传递该字段 |
data.employee_list.cert_list | 证件信息 | jsonarray | N | 1:身份证;2:护照;3:回乡证;4:台胞证;5:往来港澳通行证;6: 大陆居民往来台湾通行证 |
employee_list.air_policy | 飞机权限 | jsonobject | N | 机票数据 |
air_policy.unemployee_air | 限制非企业员工预定机票标识 | boolean | N | false |
air_policy.air_priv_flag | 是否允许订机票 | boolean | N | false |
air_policy.air_verify_flag | 是否需要审批 | boolean | N | false |
air_policy.oneself_limit | 仅允许为本人预定 | Integer | N | 0 不限制,1 限制,新建差旅信息时做限制使用 |
air_policy.air_other_flag | 是否允许为其他员工订机票 | boolean | N | false |
air_policy.air_rule_limit_flag | 是否限制规则 | boolean | N | true |
air_policy.refund_ticket_type | 退订控制 | integer | N | 0:不限制 1:填写原因 2:提交审批 |
air_policy.changes_ticket_type | 改签控制 | integer | N | 0:不限制 1:填写原因 2:提交审批 |
air_policy.air_rule_id | 规则id | string | N | 575263e982f880a6d686ce11 |
air_policy.exceed_buy_type | 超规则下单 | integer | N | 1:禁止(如果超出规则,则不允许下单操作) 2:超规填写理由下单(当有规则限制时,如果超出规则 的规定可以需下单,但是需要填写超规下单的理由) 3:超规需要提交费用审批(如果有审批的概念) |
employee_list.intl_air_policy | 国际飞机权限 | jsonobject | N | 国际机票数据 |
intl_air_policy.unemployee_air | 限制非企业员工预定机票标识 | boolean | N | false |
intl_air_policy.air_priv_flag | 是否允许订机票 | boolean | N | false |
intl_air_policy.air_verify_flag | 是否需要审批 | boolean | N | false |
intl_air_policy.oneself_limit | 仅允许为本人预定 | Integer | N | 0 不限制,1 限制,新建差旅信息时做限制使用 |
intl_air_policy.air_other_flag | 是否允许为其他员工订机票 | boolean | N | false |
intl_air_policy.air_rule_limit_flag | 是否限制规则 | boolean | N | true |
intl_air_policy.refund_ticket_type | 退订控制 | integer | N | 0:不限制 1:填写原因 2:提交审批 |
intl_air_policy.changes_ticket_type | 改签控制 | integer | N | 0:不限制 1:填写原因 2:提交审批 |
intl_air_policy.air_rule_id | 规则id | string | N | 575263e982f880a6d686ce11 |
intl_air_policy.exceed_buy_type | 超规则下单 | integer | N | 1:禁止(如果超出规则,则不允许下单操作) 2:超规填写理由下单(当有规则限制时,如果超出规则 的规定可以需下单,但是需要填写超规下单的理由) 3:超规需要提交费用审批(如果有审批的概念) |
employee_list.hotel_policy | 酒店权限 | jsonobject | N | 酒店数据 |
hotel_policy.unemployee_hotel | 限制非企业员工预定酒店标识 | boolean | N | false |
hotel_policy.hotel_priv_flag | 是否允许订酒店 | boolean | N | false |
hotel_policy.hotel_verify_flag | 是否需要审批 | boolean | N | false |
hotel_policy.oneself_limit | 仅允许为本人预定 | Integer | N | 0 不限制,1 限制,新建差旅信息时做限制使用 |
hotel_policy.hotel_other_flag | 是否允许为其他员工订酒店 | boolean | N | false |
hotel_policy.hotel_rule_limit_flag | 是否限制规则 | boolean | N | false |
hotel_policy.refund_ticket_type | 退订控制 | integer | N | 0:不限制 1:填写原因 2:提交审批 |
hotel_policy.hotel_rule_id | 规则id | string | N | 575263e982f880a6d686ce11 |
hotel_policy.exceed_buy_type | 超规则下单 | integer | N | 1:禁止(如果超出规则,则不允许下单操作) 2:超规填写理由下单(当有规则限制时,如果超出规则 的规定可以需下单,但是需要填写超规下单的理由) 3:超规需要提交费用审批(如果有审批的概念) |
employee_list.train_policy | 火车权限 | jsonobject | N | 火车数据 |
train_policy.unemployee_train | 限制非企业员工预定火车标识 | boolean | N | false |
train_policy.train_priv_flag | 是否允许订火车票 | boolean | N | false |
train_policy.train_verify_flag | 是否需要审批 | boolean | N | false |
train_policy.oneself_limit | 仅允许为本人预定 | Integer | N | 0 不限制,1 限制,新建差旅信息时做限制使用 |
train_policy.train_other_flag | 是否允许为其他员工订火车 | boolean | N | false |
train_policy.train_rule_limit_flag | 是否限制规则 | boolean | N | false |
train_policy.refund_ticket_type | 退订控制 | integer | N | 0:不限制 1:填写原因 2:提交审批 |
train_policy.changes_ticket_type | 改签控制 | integer | N | 0:不限制 1:填写原因 2:提交审批 |
train_policy.train_rule_id | 规则id | string | N | ssfl89u3487yihkre |
train_policy.exceed_buy_type | 超规则下单 | integer | N | 1:禁止(如果超出规则,则不允许下单操作) 2:超规填写理由下单(当有规则限制时,如果超出规则 的规定可以需下单,但是需要填写超规下单的理由) 3:超规需要提交费用审批(如果有审批的概念) |
employee_list.car_policy | 用车权限 | jsonobject | N | 用车数据 |
car_policy.car_priv_flag | 是否允许员工用车权限标识 | boolean | N | false |
car_policy.rule_limit_flag | 是否允许打车 | boolean | N | false |
car_policy.rule_ids | 规则id集合 | jsonarray | N | rule_limit_flag=true时 规则id不可为空,包括用车规则和审批用车规则ID |
car_policy.allow_shuttle | 用车接送机权限 | boolean | N | false |
car_policy.personal_pay | 个人支付开关 | boolean | N | false |
car_policy.exceed_buy_type | 超规则下单 | integer | N | 1:禁止(如果超出规则,则不允许下单操作) 2:超规填写理由下单(当有规则限制时,如果超出规则 的规定可以需下单,但是需要填写超规下单的理由) 3:超规需要提交费用审批(如果有审批的概念) |
employee_list.mall_policy | 采购权限 | jsonobject | N | 采购数据 |
mall_policy.mall_priv_flag | 是否允许员工采购标识 | boolean | N | false |
mall_policy.rule_limit_flag | 是否允许采购 | boolean | N | false |
mall_policy.rule_id | 规则id | string | N | ofaijwf |
mall_policy.exceed_buy_flag | 超规则下单 | integer | N | 1:禁止(如果超出规则,则不允许下单操作) 2:超规填写理由下单(当有规则限制时,如果超出规则 的规定可以需下单,但是需要填写超规下单的理由) 3:超规需要提交费用审批(如果有审批的概念) |
employee_list.dinners_policy | 用餐权限 | jsonobject | N | 用餐数据 |
dinners_policy.dinner_priv_flag | 限制非企业员工用餐标识 | boolean | N | false |
dinners_policy.rule_limit_flag | 是否限制规则 | boolean | N | false |
dinners_policy.rule_id | 规则id | string | N | ofaisfasjwf |
dinners_policy.meishi_policy | 用餐权限信息 | jsonobject | N | 用餐权限信息 |
meishi_policy.exceed_buy_type | 超规则下单 | integer | N | 1:禁止(如果超出规则,则不允许下单操作) 2:超规填写理由下单(当有规则限制时,如果超出规则 的规定可以需下单,但是需要填写超规下单的理由) |
meishi_policy.personal_pay | 个人支付开关 | boolean | N | true,false |
dinners_policy.dinner_policy | 用餐权限 | jsonobject | N | 用餐权限 固定值 |
dinner_policy.exceed_buy_flag | 超规则下单 | integer | N | 固定值1 |
employee_list.takeaway_policy | 外卖权限 | jsonobject | N | 外卖数据 |
takeaway_policy.takeaway_priv_flag | 是否允许员工外卖标识 | boolean | N | false |
takeaway_policy.takeaway_rule_limit_flag | 是否限制规则 | boolean | N | false |
takeaway_policy.takeaway_rule_id | 规则id | integer | N | 111 |
takeaway_policy.exceed_buy_type | 超规控制 | integer | N | (1:禁止下单 2: 填写理由) |
takeaway_policy.personal_pay | 个人支付开关 | boolean | N | true,false |
employee_list.shansong_policy | 闪送权限 | jsonobject | N | 闪送数据 |
shansong_policy.shansong_priv_flag | 是否允许员工闪送标识 | boolean | N | false |
请求示例
"access_token": "xxx.xxx.xxx",
"timestamp": 123456789,
"employee_id":784kuf873jf9834uiy98e"",
"data":{
"employee_list": [
{
"name": "张三",
"phone": "17080151667",
"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": "2211239012r28351"
}],
"role": 3,
"takeaway_policy": {//外卖权限
"takeaway_priv_flag": true, //是否开启
"takeaway_rule_limit_flag": true,//是否限制规则
"takeaway_rule_id": 111, //规则ID
"exceed_buy_type": 1,//超规控制 (1:禁止下单 2: 填写理由)
"personal_pay": true//个人支付开关
},
"air_policy": {
"unemployee_air": false,
"air_priv_flag": false,
"air_other_flag": false,//是否允许为其他员工订机票
"air_verify_flag": true,
"oneself_limit":0,
"air_rule_limit_flag": true,
"air_rule_id": "575263e982f880a6d686ce11",
"exceed_buy_type": 1,//1:禁止 2:超规填写理由下单 3:超规需要提交费用审批
"refund_ticket_type": 1,//退订控制 0:不限制 1:填写原因 2:提交审批 230新增
"changes_ticket_type": 1//改签控制 0:不限制 1:填写原因 2:提交审批 230新增
},
"intl_air_policy": {
"unemployee_air": false,
"air_priv_flag": false,
"air_other_flag": false,
"oneself_limit":0,
"air_verify_flag": true,
"air_rule_limit_flag": true,
"air_rule_id": "575263e982f880a6d686ce11",
"exceed_buy_type": 1,
"air_order_verify_flag": false
},
"hotel_policy": {
"unemployee_hotel": false,
"hotel_priv_flag": true,
"hotel_other_flag": true,
"hotel_verify_flag": false,
"oneself_limit":0,
"hotel_rule_limit_flag": true,
"hotel_rule_id": "575263e982f880a6d686ce11",
"exceed_buy_type": 1,
"personal_pay": true,
"refund_ticket_type": 1
},
"train_policy": {
"unemployee_train": false,
"train_priv_flag": true,
"train_other_flag": true,
"train_verify_flag": false,
"oneself_limit":0,
"train_rule_limit_flag": true,
"train_rule_id": "575263e982f880a6d686ce11",
"exceed_buy_type": 1,
"refund_ticket_type": 1,
"changes_ticket_type": 1
},
"car_policy": {
"car_priv_flag": true,
"rule_limit_flag": true,
"rule_ids": [
{
"rule_id": [
111,
2222
],
"type": 1
},
{
"type": 2,
"rule_id": [
5555,
6666
]
}
],
"exceed_buy_type": 1,
"allow_shuttle": false,
"personal_pay": true
},
"mall_policy": {
"mall_priv_flag": true,
"rule_limit_flag": true,
"rule_id": "ofaijwf",
"exceed_buy_flag": false
},
"dinners_policy": {
"rule_priv_flag": true,
"rule_limit_flag": true,
"rule_id": "5d492a7123445f227a77b830",
"meishi_policy": {
"exceed_buy_type": 1,
"personal_pay": true
},
"dinner_policy": {
"exceed_buy_flag": 1
}
}
},
{
"name": "李四",
"phone": "17080151667",
"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": "2211239012r28351"
}],
"role": 3,
"takeaway_policy": {
"takeaway_priv_flag": true,
"takeaway_rule_limit_flag": true,
"takeaway_rule_id": 111,
"exceed_buy_type": 1,
"personal_pay": true
},
"air_policy": {
"unemployee_air": false,
"air_priv_flag": false,
"air_other_flag": false,
"air_verify_flag": true,
"air_rule_limit_flag": true,
"air_rule_id": "575263e982f880a6d686ce11",
"exceed_buy_type": 1,
"refund_ticket_type": 1,
"changes_ticket_type": 1
},
"intl_air_policy": {
"unemployee_air": false,
"air_priv_flag": false,
"air_other_flag": false,
"air_verify_flag": true,
"air_rule_limit_flag": true,
"air_rule_id": "575263e982f880a6d686ce11",
"exceed_buy_type": 1,
"air_order_verify_flag": false
},
"hotel_policy": {
"unemployee_hotel": false,
"hotel_priv_flag": true,
"hotel_other_flag": true,
"hotel_verify_flag": false,
"hotel_rule_limit_flag": true,
"hotel_rule_id": "575263e982f880a6d686ce11",
"exceed_buy_type": 1,
"personal_pay": true,
"refund_ticket_type": 1
},
"train_policy": {
"unemployee_train": false,
"train_priv_flag": true,
"train_other_flag": true,
"train_verify_flag": false,
"train_rule_limit_flag": true,
"train_rule_id": "575263e982f880a6d686ce11",
"exceed_buy_type": 1,
"refund_ticket_type": 1,
"changes_ticket_type": 1
},
"car_policy": {
"car_priv_flag": true,
"rule_limit_flag": true,
"rule_ids": [
{
"rule_id": [
111,
2222
],
"type": 1
},
{
"type": 2,
"rule_id": [
555
]
}
],
"exceed_buy_type": 1,
"allow_shuttle": false,
"personal_pay": true
},
"mall_policy": {
"mall_priv_flag": true,
"rule_limit_flag": true,
"rule_id": "ofaijwf",
"exceed_buy_flag": false
},
"dinners_policy": {
"rule_priv_flag": true,
"rule_limit_flag": true,
"rule_id": "5d492a7123445f227a77b830",
"meishi_policy": {
"exceed_buy_type": 1,
"personal_pay": true
},
"dinner_policy": {
"exceed_buy_flag": 1
}
},
"shansong_policy": { //闪送权限
"shansong_priv_flag": true //权限开关
}
}
]
}
返回结果
{
"request_id": "LaZNvBntsBD20nJ7ekgn",
"code": 0,
"msg": "success"
}
{
"request_id": "MzWkSvZ3sVC2FYg9bCLt",
"code": 0,
"msg": "success",
"data": {
"result": [
{
"companyId": "59ce56d02798633485e206a9",
"phone": "17080151661",
"name": "李四",
"thirdEmployeeId": "ddd-test-A",
"errorMsg": "第三方用户ID已经被绑定"
}
]
}
}
{
"request_id": "zgubWmjt4y9c5AWcOwgs",
"code": 0,
"msg": "success",
"data": {
"result": [
{
"companyId": "59df06662798635263b8414c",
"phone": "17004531919",
"name": "张三",
"thirdEmployeeId": "888s0lll",
"errorMsg": "手机号已经存在,请使用其他手机号"
},
{
"companyId": "59df06662798635263b8414c",
"phone": "17004531918",
"name": "赵六",
"thirdEmployeeId": "h99k4lll",
"errorMsg": "手机号已经存在,请使用其他手机号"
}
]
}
}
{
"request_id": "FqVKD698g0SdA7sr6O5i",
"code": 0,
"msg": "success",
"data": {
"result": [
{
"companyId": "5747fbc10f0e60e0709d8d7d",
"phone": "17004531917",
"name": "王五",
"thirdEmployeeId": "100991",
"errorMsg": "部门信息参数不正确"
}
]
}
}
errorMsg详细说明:
会存在以下几种情况
1."手机号已经存在,请使用其他手机号"
2。"第三方ID已经被其它用户绑定"
3."部门信息参数不正确"
4."公司信息不存在,请使用正确参数"
5."保存规则接口异常!"
6."当前第三方部门ID不存在"