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/syncDepartment
1.
ignoreOrgSaveOrgNameCheck 、ignoreOrgCanceledValidate 在 0701基线后支持
2.
emptyCustomVaueClearable 在2024-1101基线支持后支持

请求参数

Header 参数

Body 参数application/json

示例
{
    "access_token": "实际的access_token",
    "data": [
        {
            "name": "技术中心",
            "fullname": "产品技术中心",
            "code": "RD_PRD_002",
            "parent": "研发部",
            "coadjutant": "李燕",
            "description": "6666",
            "disporder": "001",
            "departmentExtend": {
                "duoryxz1": [
                    "孟玲",
                    "李长昊"
                ],
                "bmzdyzdsz_mxb1": [
                    {
                        "mxwb": "明细字段同步1",
                        "mxry": "扳手001",
                        "mxrq": "2026-10-12",
                        "mxxldxk": "AA"
                    },
                    {
                        "mxwb": "明细字段同步2",
                        "mxry": "李长昊",
                        "mxrq": "2026-10-12",
                        "mxxldxk": "BB"
                    }
                ]
            }
        }
    ],
    "dataRule": {
        "department": "name",
        "employee": "username"
    },
    "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/syncDepartment' \
--header 'tenantKey: tpo43o6r12' \
--header 'Content-Type: application/json' \
--data '{
    "access_token": "实际的access_token",
    "data": [
        {
            "name": "技术中心",
            "fullname": "产品技术中心",
            "code": "RD_PRD_002",
            "parent": "研发部",
            "coadjutant": "李燕",
            "description": "6666",
            "disporder": "001",
            "departmentExtend": {
                "duoryxz1": [
                    "孟玲",
                    "李长昊"
                ],
                "bmzdyzdsz_mxb1": [
                    {
                        "mxwb": "明细字段同步1",
                        "mxry": "扳手001",
                        "mxrq": "2026-10-12",
                        "mxxldxk": "AA"
                    },
                    {
                        "mxwb": "明细字段同步2",
                        "mxry": "李长昊",
                        "mxrq": "2026-10-12",
                        "mxxldxk": "BB"
                    }
                ]
            }
        }
    ],
    "dataRule": {
        "department": "name",
        "employee": "username"
    },
    "optId": 100001234
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "message": {
        "errcode": "0",
        "errmsg": "success"
    },
    "data": [
        {
            "keyValue": "产品部",
            "id": 1313135385506725889,
            "operate": "ADD",
            "status": "SUCCESS",
            "errcode": "SUCCESS",
            "needRepush": false,
            "logUUid": "0225dce57aea42d38cd8cbf3bce23489",
            "extKeyMap": {
                "index": 1
            }
        }
    ]
}
修改于 2026-10-12 06:10:30
上一页
同步人员
下一页
同步分部
Built with