# 人员批量新增（API名称：batchAdd）
#### 功能介绍
人员批量新增。
#### 相关接口
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到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](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的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   | 否        | 描述                                                                 |
| email                 | 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
}
```