组织人事
  1. 开放平台-组织人事接口
组织人事
  • 开放平台-组织人事接口
    • 开放平台认证步骤
    • 同步人员
      POST
    • 同步部门
      POST
    • 同步分部
      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
  1. 开放平台-组织人事接口

同步外部部门

开发中
POST
/api/hrm/restful/syncExternalDepartment
1.
202501基线支持

请求参数

Cookie 参数
ETEAMSID
string 
可选
默认值:
PCACCOUNT_e59539ab1f9e66971db08e2dc55c77ce-3H4B9AJO05N808
Body 参数application/json
data
array [object {6}] 
必需
name
string 
部门名称
必需
fullname
string 
部门全称
可选
disporder
number 
显示顺序
可选
description
string 
备注
可选
parent
string 
上级部门
可选
上级部门，如果无上级部门，可以空，但是所属企业需要有值
数据内容与数据规则-部门规则有关系
比如部门规则是id，则提供id； 部门规则是名称，则提供名称
subcompanyid
string 
所属企业
必需
所属企业，新增的时候必须提供；
内容与数据规则-企业规则有关
比如企业规则是id，则提供id； 企业规则是名称，则提供名称
dataRule
object 
数据规则
必需
字段校验规则；比如指定人员规则是名称，就按照名称规则检查唯一，如果查询到则更新；否则新增
department
string 
部门规则
可选
id:按照部门id来检查；name:按照部门名称来检查；
subcompany
string 
企业规则
可选
id:按照企业id来检查；name:按照企业名称来检查；
apiTaskId
string 
任务号
可选
任务号，相同任务号防止并发
optId
string 
操作者
必需
会更新到邀请人里面；
extKey
string 
指定需要额外返回内容的key
可选
指定报文中某个列，需要在返回报文中返回；
当指定后，返回内容将提供：extKeyMap；是map对象，并返回指定的key和其内容；
例如 指定 extkey=uuid，且报文提供了uuid=1234;则返回内容有
"extKeyMap": {
"uuid": "1234"
}
virtualId
number 
维度id
必需
外部联系人维度id;
1.
外部互联-维度管理中看到
或者
2.
使用下面sql查询： select * from hrm_company_virtual hcv where tenant_key =租户key and data_type in ('extenal','lower_external','wechat_external','custom_external')
示例
{
    "access_token": "00098fd529fc19d258d4a25087167618",
    "data": [
        {
            "name": "经理室",
            "fullname": "经理室full",
            "parent":"人事部",
            "subcompanyid":"外部泛微",
            "disporder": 5,
            "description": "描述"
        }
    ],
    "dataRule": {
        "subcompany": "name",
        "department": "name"
    },
    "apiTaskId": "task1",
    "optId": "1040027954357846017",
    "extKey": "outkey",
    "virtualId": "900030746512072704"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/hrm/restful/syncExternalDepartment' \
--header 'Cookie: ETEAMSID=PCACCOUNT_e59539ab1f9e66971db08e2dc55c77ce-3H4B9AJO05N808' \
--header 'Content-Type: application/json' \
--data-raw '{
    "access_token": "00098fd529fc19d258d4a25087167618",
    "data": [
        {
            "name": "经理室",
            "fullname": "经理室full",
            "parent":"人事部",
            "subcompanyid":"外部泛微",
            "disporder": 5,
            "description": "描述"
        }
    ],
    "dataRule": {
        "subcompany": "name",
        "department": "name"
    },
    "apiTaskId": "task1",
    "optId": "1040027954357846017",
    "extKey": "outkey",
    "virtualId": "900030746512072704"
}'

返回响应

🟢200成功
application/json
Body
code
integer 
api状态
必需
200 成功
msg
string 
描述
必需
status
boolean 
状态
必需
false 失败；true 成功
data
array [object {5}] 
必需
keyValue
string 
数据唯一字段值
可选
operate
string 
同步操作类型
可选
add 新增、update 修改
status
string 
状态
可选
SUCCESS 成功；ERROR 失败
errcode
string 
失败原因
可选
needRepush
boolean 
可选
示例
{"message":{"errcode":"0","errmsg":"success"},"data":[{"keyValue":"经理室","id":8513466224574465,"operate":"ADD","status":"SUCCESS","errcode":"SUCCESS","needRepush":false}]}
修改于 2025-01-15 07:13:40
上一页
同步外部企业
下一页
同步虚拟维度人员
Built with