文档首页/ ISDP/ API参考/ API接口/ 人员管理/ 添加人员账号（API名称：person/batchUpdatePerson）
更新时间：2025-04-14 GMT+08:00
查看PDF
分享

添加人员账号（API名称：person/batchUpdatePerson）

功能介绍

添加人员账号。

相关接口

接口名称

调用说明

获取Token

调用该接口获取到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

否

描述

email

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
}
父主题： 人员管理

相关文档