新增/更新
- 接口:/org/department/save
- Method:POST
- 数据格式:JSON
- 接口说明:该接口采用单条失败的处理方式,即整批数据中,如果只有其中的几条因为各种原因失败,那么只有那几条数据不会被保存;其它的数据仍然会被正常处理;错误数据的主键(businessCode)会被放在errorData里面;errorData为结构体, 包含出错记录主键(businessCode), 以及与之对应的出错信息; 类似 {"businessCode": "错误信息"}; 具体参见失败示例;如果有错误信息,则返回的code为NACK,然后错误信息会放在errorData里,只有全部成功返回的code为ACK。如果传了externalCode,会默认以externalCode为主键,不传则以businessCode为主键。
请求参数
参数 | 类型 | 必须 | 默认值 | 主键 | 描述 |
---|---|---|---|---|---|
name | string | Y | 部门名称 | ||
nameEn | string | Y | 部门英文名称(name和nameEn至少其中一个要有值) | ||
businessCode | string | Y | Y | 部门编码 | |
externalCode | string | N | 部门外部编码 | ||
costCenterCode | string | N | 成本中心编码 | ||
subsidiaryBizCodes | array | N | 共享部门的业务实体编码 | ||
directSubsidiaryBizCode | string | N | 部门直属的业务实体编码 | ||
active | bool | N | false | 是否启用 | |
principal | string | N | 部门负责人工号 | ||
parentBizCode | string | N | 上级部门编码 | ||
childrenSubsidiaryOperation | string | N | OVERRIDE | 如何处理子部门共享业务实体,可选值OVERRIDE, NO_OVERRIDE | |
asCoverDepartment | bool | N | true | 是否允许作为承担部门 |
返回数据
字段 | 类型 | 描述 |
---|---|---|
code | string | 系统内唯一主键 |
businessCode | string | 部门编码 |
示例:
请求数据
{
"timestamp": 123456,
"data": [{
"name": "部门A",
"businessCode": "BMA",
"costCenterCode": "BMA",
"principal": "10001",
"subsidiaryBizCodes": ["A", "B"],
"active": true
}
]
}
返回数据(成功)
{
"code": "ACK",
"message": "",
"data": [{
"businessCode": "BMA",
"code": "ABCDAAFA1234"
}
]
}
返回数据(失败)
{
"code": "NACK",
"message": "处理错误"
}