人员批量新增（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
} 
