更新组织架构

POST

/api-platform/v2/departments

PS: 如果同时存在departmentCode和departmentId，则根据departmentId更新部门的departmentCode。

返回json字段

字段	类型	描述
code	boolean	200: 成功。其他：错误
msg	string	操作失败的错误原因

可能的错误信息

errorMessage	描述
当前有未处理完的组织架构更新，请稍后再试
部门名称: XXX, 编号XXX的部门编号重复	请求列表中存在重复部门数据或者请求列表中存在于已同步至系统的部门中存在重复
父级部门未找到	部门的父级部门未在列表中找到
部门的父级部门不能直接(间接)为自身	部门的父级部门（的父级部门...)不能为自身
部门名称XXX，父编号XXX的部门名称已存在	某部门下存在相同名称的部门

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.mokahr.com/api-platform/v2/departments' \
--header 'Content-Type: application/json' \
--data-raw '{
        "departments": [
            {
                "departmentCode": "ididid111123",
                "name": "namenamename1221",
                "parentCode": null
            },
            {
                "departmentCode": "ididid211123",
                "name": "namenamename21_testhema",
                "parentCode": "ididid31112"
            },
            {
                "departmentCode": "ididid311123",
                "name": "namenamename222test_hema",
                "parentCode": "ididid111123",
                "type": 2,
                "departmentId": 387
            },
            {
                "departmentCode": "ididid3",
                "name": "namenamename3",
                "parentCode": null,
                "requiredFieldsValueIsNull": ["parentCode"]
            }
        ]
    }'

响应示例

200 - 成功 - 成功示例

{
  "code": 0,
  "msg": "success"
}

请求参数

Body 参数application/json

departments

array [object {6}]

部门数据

必需

departmentCode

string

部门的唯一 id

必需

name

string

部门名称

必需

parentCode

string | null

必需

部门的上级部门的唯一 id, 如为 null 则为一级部门

type

integer

可选

部门类型: 1 普通部门（默认） 2 门店部门

requiredFieldsValueIsNull

array[string]

可选

上级部门为null时，需要传该参数["parentCode"]

departmentId

integer

可选

部门在Moka系统中的id，此参数存在时，会优先匹配该参数的部门。

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

msg

string

必需

🟢200失败

修改于 2021-12-30 06:25:59

组织架构增量同步

整体流程图/flowchart

更新组织架构

返回json字段#

可能的错误信息#

请求参数

返回响应

返回json字段

可能的错误信息