首页 分享 更新员工花名册信息

更新员工花名册信息

来源:花匠小妙招 时间:2026-03-29 03:06

接口功能介绍

说明

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

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

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

调用本接口可将员工小钉的身份证姓名更新为小钉1。接口调用成功后,个人信息如下图所示。

权限

服务端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

所属分类:花卉
上一篇: 2026广东粤BA篮球联赛比赛比
下一篇: 2025年广州铭恩园清明拜祭是否

推荐分享