更新员工花名册信息

接口功能介绍

说明

调用本接口可更新员工档案信息。

该接口如果传入的字段是不支持更新的字段（如sys00分組内的字段，部门和直属主管），会返回 參数错误 的报错信息。

以更新员工花名册内的身份证姓名为例，员工小钉在智能人事花名册内的身份证姓名是小钉，如下图所示。

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型

是否支持调用

权限申请方式

API Explorer调试

企业内部应用

是

钉钉HRM数据管理权限

调试

第三方企业应用

是

钉钉HRM数据管理权限

调试

第三方个人应用

否

—

—

基本信息

请求方式：POST

请求地址：https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/v2/update

Query参数

名称

类型

是否必填

示例值

描述

access_token

String

是

af21axxx

调用该API的应用凭证。

企业内部应用，通过获取企业内部应用的access_token接口获取。

第三方企业应用，通过获取第三方企业的access_token接口获取。

Body参数

名称

类型

是否必填

示例值

描述

agentid

Number

是

23470561

应用的AgentId。

企业内部应用，应用详情页获取应用 AgentId。

第三方企业应用，通过获取企业授权信息接口获取agentid传说中。

param

EmpUpdateByCustomParam

是

员工信息。

groups

EmpGroupFieldVo[]

否

花名册分组。

sections

EmpListFieldVo[]

否

分组下明细，非明细分组仅一条明细。

section

EmpFieldVo[]

否

分组下字段列表。

field_code

String

否

sys01-birthTime

更新的字段code，调用获取花名册元数据接口获取field_code参数值。

说明

sys00分组内字段code值为汉字，如姓名，更新时直接传入"姓名"作为该参数值。

sys00分组内的字段，部门和直属主管暂不支持接口更新。

value

String

否

2020-10-10

更新的字段值。

如果field_code对应字段的field_type为TextField，该字段值自定义。

如果field_code对应字段的field_type为DDDateField，该字段值传日期格式为"yyyy-MM-dd"。

如果field_code对应字段的field_type为DDSelectField，该字段值传option_text内的value。结果显示为value对应的label值。

说明

例如“民族”字段获取的元数据信息如截图，此时value传1，该员工的民族会更改为“汉族”。

old_index

Number

否

0

明细下标。

传入该值时，表示当前传入的section为编辑员工花名册现有的第old_index条明细，此时只编辑该条明细中传入的字段。

不传入该值时，表示当前传入的section为新增明细，此时会保存该条明细传入的字段，未传字段会清空。

group_id

String

否

sys01

分组标识，调用获取花名册元数据接口获取group_id参数值。

userid

String

是

123456

被更新字段信息的员工userid。

说明

确保该userId是当前本企业内正确的值，否则接口会报错系统错误。

返回参数

名称

类型

示例值

描述

result

Boolean

true

更新是否成功。

true：成功

false：失败

success

Boolean

true

接口调用是否成功。

true：成功

false：失败

errcode

Number

0

返回码。

errmsg

String

ok

调用失败时返回的错误信息。

request_id

String

8badquf9r90f

请求ID。

示例

请求示例（HTTP）

请求正文

请求示例（JAVA SDK）

返回示例

相关知识

员工花名册应该包含哪些信息？
员工花名册
如何正确理解员工花名册的概念？
员工花名册信息统计表
为什么需要了解员工花名册的意义？
员工花名册 · “i人事”用户手册 · 看云
职工花名册是什么？企业必备的员工管理工具解析
获取员工花名册信息并填充到OA表单
多维度员工信息整合查询——红海云员工信息数字化管理实用指南（中）
公司花名册在员工入职和离职管理中扮演什么角色？

网址: 更新员工花名册信息 https://www.huajiangbk.com/newsview2585746.html