组织架构全量同步
PUT
/api-platform/v2/departments处理
Moka 系统中会根据请求的列表对当前系统中的部门进行同步(新增,更新,标记删除)。
可能的错误信息
errorMessage | 描述 |
---|---|
部门 ID 重复 | 请求列表中有重复使用的 department_code |
部门重复 | 请求列表中有相同父级部门,名称的部门 |
父级部门未找到 | 部门的父级部门未在列表中找到 |
部门的父级部门不能直接(间接)为自身 | 部门的父级部门(的父级部门...)不能为自身 |
... |
注意事项
调试请先联系相关负责人开启。 如果请求中曾经有,现在没有了的部门将被标记为已删除状态。位于已删除状态需要手动进入 Moka 系统中将该部门合并到其他部门以完全删除。 如果已删除状态的部门重新同步(departmentCode相同),则回取消原来的已删除状态(不会重新创建新的部门)。
请求参数
Body 参数application/json
departments
array [object {5}]
部门数据
departmentCode
string
部门的唯一 id
name
string
部门名称
parentCode
string | null
必需
部门的上级部门的唯一 id, 如为 null 则为一级部门
type
integer
可选
部门类型: 1 普通部门(默认) 2 门店部门
requiredFieldsValueIsNull
array[string]
可选
上级部门为null时,需要传该参数["parentCode"]
示例
{
"departments": [
{
"departmentCode": "ididid1",
"name": "namenamename1",
"parentCode": "ididid1"
},
{
"departmentCode": "ididid2",
"name": "namenamename2",
"parentCode": "ididid2"
},
{
"departmentCode": "ididid2",
"name": "namenamename2",
"parentCode": "ididid2",
"type": 2
},
{
"departmentCode": "ididid3",
"name": "namenamename3",
"parentCode": null,
"requiredFieldsValueIsNull": [
"parentCode"
]
}
]
}
示例代码
返回响应
成功(200)
操作失败(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
code
integer
必需
200: 成功。其他:错误
msg
string
操作失败的错误原因
data
object
必需
result
object
必需
示例
{
"code": 0,
"msg": "success",
"data": {
"result": {
"new": 0,
"delete": 0,
"update": 0
}
}
}
修改于 3 年前