批量组织架构写入/更新接口 - 电子档案开放接口文档

支持的档案版本：4.0.0
异常情况说明
1、新增时,若在同一上级单位下存在相同的部门名称,则新增失败
2、新增/更新时,部门主管字段中,若存在员工已离职,则调用失败
3、新增/更新时,部门主管字段中,若这些员工均不存在,则调用失败
4、新增时,若type为根节点组织,则新增失败
5、新增/更新时,如果上级单位不存在,则调用失败
6、更新时,若type有值且发生改变,则更新失败

请求参数

Header 参数

Authorization

string

可选

默认值:

Content-Type

string

可选

默认值:

application/json

Body 参数application/json

array of:

name

string

部门名称

必需

businessCode

string

必需

部门编码(唯一，仅可新增,无法修改)

pid

string

可选

上级单位编码《orgTag为根结点不能填，非根结点则必填》，新增时必填

remarks

string

部门注释

可选

managerIds

array[string]

主管员工编码

可选

type

enum<string>

必需

部门/公司/根节点标记
BUSINESS_ENTITY, //业务实体(子公司)
DEPARTMENT, //部门
DEFAULT_ROOT //根节点

枚举值:

DEFAULT_ROOTBUSINESS_ENTITYDEPARTMENTUSER

示例

[
    {
        "name": "string",
        "businessCode": "string",
        "pid": "string",
        "remarks": "string",
        "managerIds": [
            "string"
        ],
        "type": "DEFAULT_ROOT"
    }
]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

com.maycur.cm.dto.OpenResultDto<com.maycur.cm.dto.OpenBatchResultDataDto,java.util.List<com.maycur.cm.open.dto.OpenOrgImportResultDTO>>

errData

array[object (OpenOrgImportResultDTO) {6}]

失败结果

可选

name

string

部门名称

可选

businessCode

string

部门编码(唯一)

可选

pid

string

可选

上级单位编码《orgTag为根结点不能填，非根结点则必填》

index

integer

数据在列表中索引

可选

code

integer

结果代码

可选

errorMsg

string

错误信息

可选

code

integer

结果代码

可选

message

string

结果信息

可选

errMsg

string

错误信息

可选

data

object (OpenBatchResultDataDto)

结果数据

可选

successAmount

integer | null

成功条数

可选

timestamp

string

时间戳

可选

示例

{
  "errData": [
    {
      "name": "",
      "businessCode": "",
      "pid": "",
      "index": 0,
      "code": 0,
      "errorMsg": ""
    }
  ],
  "code": 0,
  "message": "",
  "errMsg": "",
  "data": {
    "successAmount": 0
  },
  "timestamp": ""
}