人员批量新增（API名称：batchAdd）
功能介绍
人员批量新增。
相关接口
接口名称 | 调用说明 |
|---|---|
调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。 |
URL
请求方式 | HTTPS地址 | 服务架构 | 消息体类型 |
|---|---|---|---|
POST | https://isdp+域名/openapi/v1/person/batchAdd | 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 | 是 | 人员编码 |
firstName | String | 否 | 姓 |
lastName | String | 否 | 名 |
personName | String | 否 | 人员姓名 |
qualificationCode | String | 否 | 作业资质id(多个用英文逗号分隔，必须为数字，且存在该作业资质) |
personType | String | 否 | 人员类型，可选项Admin、Customer、Employee、Supplier、Other |
description | String | 否 | 描述 |
String | 否 | 邮箱 | |
phone | String | 否 | 电话号码 |
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 | 否 | 证件类型，增加证件时必填，可选项： PASSPORTS、ID_CARD |
certificateNo | String | 否 | 证件号码 |
roleNo | String | 否 | 角色编码（多给以逗号分隔，不能超过5个，不传默认为NormalUser） |
响应参数
参数 | 类型 | 描述 |
|---|---|---|
Status | String | 状态描述，请求是否成功 |
Msg | String | 报错信息 |
Failed | Boolean | 请求失败标识 |
Success | Boolean | 请求成功标识 |
data | Map | 返回的数据 |
请求示例
{
"personList": [
{
"orgNo": "robin_test_4_0",
"personCode": "h0079969522",
"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******91",
"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": "500********4236113"
}
]
} 响应示例
{
"status": "success",
"msg": null,
"data": null,
"success": true,
"failed": false
} 
