1. 开放平台-组织人事接口
组织人事
  • 开放平台-组织人事接口
    • 开放平台认证步骤
    • 同步人员
      POST
    • 同步部门
      POST
    • 同步分部
      POST
    • 同步岗位
      POST
    • 同步条件矩阵数据
      POST
    • 同步兼职信息
      POST
    • 封存部门
      POST
    • 解封部门
      POST
    • 人员返聘
      POST
    • 基本信息自定义字段信息
      POST
    • 部门自定义字段信息
      POST
    • 分部自定义字段信息
      POST
    • 人员查询
      POST
    • 组织查询
      POST
    • 岗位查询
      POST
    • 条件矩阵-条件查询取值
      POST
    • 条件矩阵-生产视图创建语句(兼容E9)
      POST
    • 批量新增职务
      POST
    • 同步职称
      POST
    • 同步职务类别
      POST
    • 同步职务
      POST
    • 群组列表查询
      POST
    • 批量删除群组
      POST
    • 新增或修改群组
      POST
    • 批量封存/解封群组
      POST
    • 群组成员查询接口
      POST
    • 新增群组成员
      POST
    • 删除群组成员
      POST
    • 添加群组可见范围
      POST
    • 更新群组可见范围项
      POST
    • 删除群组可见范围项
      POST
    • 根据组织或者人员查询全路径数据
      POST
    • 同步人力共享权限数据
      POST
    • 同步职级
      POST
    • 同步外部联系人
      POST
    • 同步外部企业
      POST
    • 同步外部部门
      POST
    • 同步虚拟维度人员
      POST
    • 查询虚拟维度人员
      POST
    • 清理组织人事缓存
      POST
    • 清理矩阵中无效数据
      POST
    • 查询职务
      POST
    • 查询职务类别
      POST
  1. 开放平台-组织人事接口

同步人员

POST
/api/hrm/restful/syncEmployee
1.
emptyCustomVaueClearable 在2024-1101基线支持后支持
2.
文档中【数据内容】必填仅对新增有效;修改的时候无需考虑必填,
只需要提供:数据规则字段的数据和想要更新字段的数据即可;例如 人员规则指定工号,且仅需更新名称,则内容提供job_num和username即可

请求参数

Body 参数application/json

示例
{
    "access_token": "实际的access_token",
    "data": [
        {
            "username": "张敏",
            "department": "产品部",
            "email": "zhangmin@weaver.com.cn",
            "mobile": "138001380XX",
            "job_num": "EMP20260101",
            "position": "高级产品经理",
            "superior": "孟玲",
            "other_superior": [
                "李妍",
                "杨文元"
            ],
            "sex": "female",
            "personnel_status": "3",
            "hiredate": "2024-03-15",
            "id_no": "110101199003078624",
            "birthday": "1990-03-07",
            "education": "本科",
            "degree": "学士",
            "marital_status": "married",
            "loginid": "zhangmin",
            "loginEmail": "zhangmin@weaver.com.cn",
            "password": "1",
            "accounttype": "0",
            "login_status": "normal",
            "sec_level": 1,
            "disporder": 100,
            "location": "1195512857120940033",
            "grade": "1195512569397510144",
            "job_call": "1098287918817517571",
            "jobsetid": "P_ENG_001",
            "native_place": "安徽省",
            "nation": "汉族",
            "household_type": "本市农村",
            "politics_status": "团员",
            "residence_place": "上海市",
            "family_contact": "021",
            "first_work_date": "2022-01-01",
            "work_year": 3,
            "child_status": "1个",
            "employeeExtend": {
                "dxwb_68wl": "内部员工",
                "rq_1bbm": "2026-09-09",
                "hrm_form_t_hrmmxb1": [
                    {
                        "mxxldxk": "你好",
                        "mxryxz": "扳手001",
                        "mxdxwb": "家庭来那些人1"
                    },
                    {
                        "mxxldxk": "你好AA",
                        "mxryxz": "陆佳豪",
                        "mxdxwb": "家庭联系人2"
                    }
                ]
            },
            "multiObj": {
                "username": {
                    "8": "dailishangd",
                    "9": "代理商-繁体"
                }
            }
        }
    ],
    "dataRule": {
        "employee": "username",
        "department": "name",
        "position": "name"
    },
    "optId": 100001234
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/api/hrm/restful/syncEmployee' \
--header 'Content-Type: application/json' \
--data-raw '{
    "access_token": "实际的access_token",
    "data": [
        {
            "username": "张敏",
            "department": "产品部",
            "email": "zhangmin@weaver.com.cn",
            "mobile": "138001380XX",
            "job_num": "EMP20260101",
            "position": "高级产品经理",
            "superior": "孟玲",
            "other_superior": [
                "李妍",
                "杨文元"
            ],
            "sex": "female",
            "personnel_status": "3",
            "hiredate": "2024-03-15",
            "id_no": "110101199003078624",
            "birthday": "1990-03-07",
            "education": "本科",
            "degree": "学士",
            "marital_status": "married",
            "loginid": "zhangmin",
            "loginEmail": "zhangmin@weaver.com.cn",
            "password": "1",
            "accounttype": "0",
            "login_status": "normal",
            "sec_level": 1,
            "disporder": 100,
            "location": "1195512857120940033",
            "grade": "1195512569397510144",
            "job_call": "1098287918817517571",
            "jobsetid": "P_ENG_001",
            "native_place": "安徽省",
            "nation": "汉族",
            "household_type": "本市农村",
            "politics_status": "团员",
            "residence_place": "上海市",
            "family_contact": "021",
            "first_work_date": "2022-01-01",
            "work_year": 3,
            "child_status": "1个",
            "employeeExtend": {
                "dxwb_68wl": "内部员工",
                "rq_1bbm": "2026-09-09",
                "hrm_form_t_hrmmxb1": [
                    {
                        "mxxldxk": "你好",
                        "mxryxz": "扳手001",
                        "mxdxwb": "家庭来那些人1"
                    },
                    {
                        "mxxldxk": "你好AA",
                        "mxryxz": "陆佳豪",
                        "mxdxwb": "家庭联系人2"
                    }
                ]
            },
            "multiObj": {
                "username": {
                    "8": "dailishangd",
                    "9": "代理商-繁体"
                }
            }
        }
    ],
    "dataRule": {
        "employee": "username",
        "department": "name",
        "position": "name"
    },
    "optId": 100001234
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "message": {
        "errcode": "0",
        "errmsg": "success"
    },
    "data": [
        {
            "keyValue": "张敏",
            "id": 1313196898058256391,
            "operate": "ADD",
            "status": "SUCCESS",
            "errcode": "SUCCESS",
            "needRepush": false,
            "logUUid": "2038f82b805b41d6b2364c11e2037aba",
            "extKeyMap": {
                "index": 1
            }
        }
    ]
}
修改于 2026-09-22 09:41:37
上一页
开放平台认证步骤
下一页
同步部门
Built with