2.2.2.2 更新第三方员工
接口说明
- 1.最新接口
- 2.企业授权负责人无法通过此接口进行更新操作
- 3.支持批量更新,批量不能大于200,因添加人员会关联相关各场景权限信息,若数量过大会导致添加返回超时
- 4.字段说明:air_rule_id:当air_priv_flag和air_rule_limit_flag为true时,air_rule_id必须指定规则ID,进行绑定相应的规则。当air_priv_flag为false时,代表业务权限关闭,其他字段都设置为相应的不可用状态即可。其他业务线字段设置相同,参照机票权限规则即可
请求方式 | 请求地址 |
---|---|
POST | /open/api/third/employees/v2/update |
请求参数
字段 | 名称 | 类型 | 必填 | 描述 | ||
---|---|---|---|---|---|---|
access_token | api鉴权Token | string | Y | |||
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 | 员工权限类型 | integer | N | 员工权限类型 | ||
data.employee_list.gender | 性别 | integer | N | 1:男 2:女 如果证件类型为身份证,则从身份证中获取。其他证件类型需传递该字段 | ||
data.employee_list.birth_date | 出生日期 | string | N | 格式:yyyyMMdd ,20191203,如果证件类型为身份证,则从身份证中获取。其他证件类型需传递该字段 | ||
data.employee_list.update_flag | 更新标识 | boolean | N | 证件信息不传是否删除? 为true,则删除组织架构内的证件信息,以最新传递的数据为准,若为false,则组织架构内的身份信息为增量添加 | ||
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_rule_limit_flag | 是否限制规则 | boolean | N | true | ||
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_rule_limit_flag | 是否限制规则 | boolean | N | true | ||
intl_air_policy.air_rule_id | 规则id | string | N | 575263e982f80987654321 | ||
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_rule_limit_flag | 是否限制规则 | boolean | N | false | ||
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.oneself_limit | 仅允许为本人预定 | Integer | N | 0 不限制,1 限制,新建差旅信息时做限制使用 | ||
train_policy.train_verify_flag | 是否需要审批 | boolean | N | false | ||
train_policy.train_rule_limit_flag | 是否限制规则 | boolean | N | false | ||
train_policy.train_rule_id | 规则id | string | N | 575263e982f882134567 | ||
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_id | 规则id | integer | N | 2 | ||
car_policy.allowShuttle | 用车接送机权限 | 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":"张5s",
"phone":"13718432812",
"third_org_unit_id":"5747fbc10f0e60e0709d8d7d",
"third_employee_id":"57ab054c2528226a805bd5e1",
"email":"test@gmail.com",
"gender": 1,
"birth_date": "19881224",
"employee_number":"fbttest000001",
"update_flag":false,//证件信息不传是否删除? 为true,则删除组织架构内的证件信息,以最新传递的数据为准,若为false,则组织架构内的身份信息为增量添加
"cert_list": [{
"cert_type": 1,
"cert_no": "2211239012r28351"
}],
"role":3,
"air_policy": { //飞机权限
"unemployee_air": false, //限制非企业员工预定机票标识
"air_other_flag": false, //是否允许为其他员工订机票 // 2.0.1新增
"air_priv_flag": false, //是否允许订机票
"air_verify_flag": true, //是否需要审批
"oneself_limit":0,
"air_rule_limit_flag": true, //是否限制规则
"air_rule_id": "575263e982f880a6d686ce11", //规则id
"exceed_buy_type": 1 //1:禁止 2:超规填写理由下单 3:超规需要提交费用审批
},
"intl_air_policy": { //国际飞机权限
"unemployee_air":false, //限制非企业员工预定机票标识
"air_other_flag": false, //是否允许为其他员工订机票 // 2.0.1新增
"air_priv_flag": false, //是否允许订机票
"air_verify_flag": true, //是否需要审批
"oneself_limit":0,
"air_rule_limit_flag": true, //是否限制规则
"air_rule_id": "575263e982f880a6d686ce11", //规则id
"exceed_buy_type": 1 //1:禁止 2:超规填写理由下单 3:超规需要提交费用审批
},
"hotel_policy": { //酒店权限
"unemployee_hotel": false, //限制非企业员工预定酒店标识
"hotel_other_flag": true, //是否允许为其他员工预定酒店 // 2.0.1新增
"hotel_priv_flag": true,
"hotel_verify_flag": false,
"oneself_limit":0,
"hotel_rule_limit_flag": true, //是否限制规则
"hotel_rule_id": "575263e982f880a6d686ce11", //规则id
"exceed_buy_type": 1 //1:禁止 2:超规填写理由下单 3:超规需要提交费用审批
},
"train_policy": { //火车权限
"unemployee_train": false, //限制非企业员工预定火车标识
"train_other_flag": true, //是否允许为其他员工预定火车 // 2.0.1新增
"train_priv_flag": true,
"oneself_limit":0,
"train_verify_flag": false,
"train_rule_limit_flag": true, //是否限制规则
"train_rule_id": "575263e982f880a6d686ce11", //规则id
"exceed_buy_type": 1 //1:禁止 2:超规填写理由下单 3:超规需要提交费用审批
},
"car_policy": { //用车权限,APP端添加员工时不能上送该key,修改时续上送
"car_priv_flag": true,
"rule_limit_flag": true,
"rule_id": 2, //规则id
"exceed_buy_type": 1, //1:禁止 2:超规填写理由下单 3:超规个人支付
"allowShuttle": false //用车接送机权限
},
"mall_policy": { //采购权限,APP端添加员工时不能上送该key,修改时续上送
"mall_priv_flag": true,
"rule_limit_flag": true,
"rule_id": "ofaijwf", //规则id
"personal_pay" : true //个人支付开关 2.1.0 新增
"exceed_buy_flag": false //是否可以超标下单
},
"dinners_policy":{ //新版用餐权限 2.5.1新增(美团)
"rule_priv_flag": true, //是否开启权限
"rule_limit_flag": true, //是否限制规则
"rule_id": "ofaijwf", //规则id
"dinner_policy": { //口碑权限
"exceed_buy_flag": 1 //默认值为1, 1:禁止 2:超规填写理由下单 3:提交订单审批
},
"meishi_policy": { //美团权限
"exceed_buy_type": 1, //是否可以超标下单 1:禁止下单 2:填写理由后允许下单
"personal_pay":true //个人支付开关
}
}
,
"shansong_policy": { //闪送权限
"shansong_priv_flag": true //权限开关
}
},
{
"name":"张5",
"phone":"13718432992",
"org_unit_id":"5747fbc10f0e60e0709d8d7d",
"third_employee_id":"57ab054c2528226a805bd500",
"gender": 1,
"birth_date": "19881224",
"air_policy": { //飞机权限
"unemployee_air": false, //限制非企业员工预定机票标识
"air_priv_flag": false, //是否允许订机票
"air_verify_flag": true, //是否需要审批
"air_rule_limit_flag": true, //是否限制规则
"air_rule_id": "575263e982f880a6d686ce11", //规则id
"exceed_buy_type": 1 //1:禁止 2:超规填写理由下单 3:超规需要提交费用审批
},
"intl_air_policy": { //国际飞机权限
"unemployee_air":false, //限制非企业员工预定机票标识
"air_priv_flag": false, //是否允许订机票
"air_verify_flag": true, //是否需要审批
"air_rule_limit_flag": true, //是否限制规则
"air_rule_id": "575263e982f880a6d686ce11", //规则id
"exceed_buy_type": 1 //1:禁止 2:超规填写理由下单 3:超规需要提交费用审批
},
"hotel_policy": { //酒店权限
"unemployee_hotel": false, //限制非企业员工预定酒店标识
"hotel_priv_flag": true,
"hotel_verify_flag": false,
"hotel_rule_limit_flag": true, //是否限制规则
"hotel_rule_id": "575263e982f880a6d686ce11", //规则id
"exceed_buy_type": 1 //1:禁止 2:超规填写理由下单 3:超规需要提交费用审批
},
"train_policy": { //火车权限
"unemployee_train": false, //限制非企业员工预定火车标识
"train_priv_flag": true,
"train_verify_flag": false,
"train_rule_limit_flag": true, //是否限制规则
"train_rule_id": "575263e982f880a6d686ce11", //规则id
"exceed_buy_type": 1 //1:禁止 2:超规填写理由下单 3:超规需要提交费用审批
},
"car_policy": { //用车权限,APP端添加员工时不能上送该key,修改时续上送
"car_priv_flag": true,
"rule_limit_flag": true,
"rule_id": 2, //规则id
"exceed_buy_type": 1, //1:禁止 2:超规填写理由下单 3:超规个人支付
"allowShuttle": false //用车接送机权限
},
"mall_policy": { //采购权限,APP端添加员工时不能上送该key,修改时续上送
"mall_priv_flag": true,
"rule_limit_flag": true,
"rule_id": "ofaijwf", //规则id
"exceed_buy_flag": false //是否可以超标下单
},
"dinners_policy":{ //新版用餐权限 2.5.1新增(美团)
"rule_priv_flag": true, //是否开启权限
"rule_limit_flag": true, //是否限制规则
"rule_id": "ofaijwf", //规则id
"dinner_policy": { //口碑权限
"exceed_buy_flag": 1 //默认值为1, 1:禁止 2:超规填写理由下单 3:提交订单审批
},
"meishi_policy": { //美团权限
"exceed_buy_type": 1, //是否可以超标下单 1:禁止下单 2:填写理由后允许下单
"personal_pay":true //个人支付开关
}
}
,
"shansong_policy": { //闪送权限
"shansong_priv_flag": true //权限开关
}
}
]
}
返回结果
{
"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": "授权负责人手机号不能修改"
}
]
}
}
errorMsg详细说明:
会存在一下几种情况
1."手机号已存在"
2."用户不存在"
3."第三方ID不存在"
4."授权负责人手机号不能修改"
5."系统修改异常,请稍后重试!"
6."修改规则接口异常!"