添加人员账号（API名称：person/batchUpdatePerson）
功能介绍
添加人员账号。
相关接口
|
接口名称 |
调用说明 |
|---|---|
|
调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。 |
URL
|
请求方式 |
HTTPS地址 |
服务架构 |
消息体类型 |
|---|---|---|---|
|
POST |
https://isdp+域名/openapi/v1/person/batchUpdatePerson |
OpenAPI |
application/json |
请求头
|
KEY |
VALUE |
是否必填 |
描述 |
|---|---|---|---|
|
Content-Type |
application/json |
是 |
无 |
|
Authorization |
bearer ${access_token} |
是 |
bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
|
参数 |
类型 |
是否必填 |
描述 |
|---|---|---|---|
|
personList |
List<Map<String,Object>> |
是 |
人员列表（一次最多支持100条数据更新，可配置saas.person.max-persons来设置最大条数） |
personList参数：
|
参数 |
类型 |
是否必填 |
描述 |
|---|---|---|---|
|
personGroupId |
Long |
否 |
人员分组id |
|
personCode |
String |
是 |
人员编码（注意该接口会为入参的编码后面增加@hw并校验，例如：入参：personCode: 12345@@，那么会对人员编码为12345@@@hw的人员进行更新） |
|
firstName |
String |
否 |
姓 |
|
lastName |
String |
否 |
名 |
|
personName |
String |
否 |
人员姓名 |
|
qualificationCode |
String |
否 |
作业资质id(多个用英文逗号分隔，必须为数字，且存在该作业资质) |
|
personType |
String |
否 |
人员类型 |
|
description |
String |
否 |
描述 |
|
|
String |
否 |
邮箱 |
|
phone |
String |
否 |
电话号码（op场景下不存在手机号的时候，可以更新） |
|
customerCode |
String |
否 |
所属客户编码 |
|
supplierCode |
String |
否 |
所属分包商编码 |
|
openAccount |
Integer |
否 |
是否开户 |
|
headFileId |
Long |
否 |
头像 |
|
faceFileId |
Long |
否 |
人脸信息 |
|
status |
Integer |
否 |
状态 |
|
integrationAccount |
String |
否 |
集成账户 |
|
udfExtend1 |
String |
否 |
扩展字段1（扩展字段必须启用，才能更新成功） |
|
udfExtend2 |
String |
否 |
扩展字段2（扩展字段必须启用，才能更新成功） |
|
udfExtend3 |
String |
否 |
扩展字段3（扩展字段必须启用，才能更新成功） |
|
udfExtend4 |
String |
否 |
扩展字段4（扩展字段必须启用，才能更新成功） |
|
udfExtend5 |
datetime |
否 |
扩展字段5（扩展字段必须启用，才能更新成功） |
|
udfExtend6 |
datetime |
否 |
扩展字段6（扩展字段必须启用，才能更新成功） |
|
udfExtend7 |
String |
否 |
扩展字段7（扩展字段必须启用，才能更新成功） |
|
udfExtend8 |
String |
否 |
扩展字段8（扩展字段必须启用，才能更新成功） |
|
udfExtend9 |
String |
否 |
扩展字段9（扩展字段必须启用，才能更新成功） |
|
udfExtend10 |
String |
否 |
扩展字段10（扩展字段必须启用，才能更新成功） |
|
isSmartDevice |
Interger |
否 |
是否是智能设备 |
|
registerFace |
Integer |
否 |
0-未注册，1-已注册 |
|
blackList |
Integer |
否 |
黑名单：0-否，1-是 |
|
reason |
String |
否 |
原因 |
|
electronicSignatureId |
Long |
否 |
电子签名id |
|
language |
String |
否 |
人员语言 |
|
certificateType |
String |
否 |
证件类型 |
|
certificateNo |
String |
否 |
证件号码 |
|
roleNo |
String |
否 |
角色编码（多给以逗号分隔） |
响应参数
|
参数 |
类型 |
描述 |
|---|---|---|
|
Status |
String |
状态描述，请求是否成功 |
|
Msg |
String |
报错信息 |
|
Failed |
Boolean |
请求失败标识 |
|
Success |
Boolean |
请求成功标识 |
|
data |
Map |
返回的数据 |
请求示例
{
"personList": [
{
"orgNo": "robin_test_4_0",
"personCode": "h007996952",
"personName": "测试人员批量更新",
"qualificationCode": "61",
"personType": "Employee",
"roleNo": "test Role1,robin_test_func",
"positionCode": "test012,robin_test_postion_01",
"udfExtend1": "AAA",
"udfExtend4": "AAA",
"firstName": "A",
"lastName": "B",
"description": "测试人员批量更新",
"email": "hsc@xxxx.com",
"phone": "135*******1",
"customerCode": "客户编码3-测试",
"supplierCode": "T001",
"openAccount": "1",
"headFileId": "1",
"faceFileId": "1",
"status": "1",
"integrationAccount": "hw",
"isSmartDevice": "N",
"registerFace": 1,
"blackList": 1,
"reason": "reason",
"electronicSignatureId": "1",
"language": "zh_CN",
"certificateType": "ID_CARD",
"certificateNo": "50010********36114"
}
]
}
响应示例
{
"status": "success",
"msg": null,
"data": null,
"success": true,
"failed": false
}
