新增/更新
- 接口:/costtracking/item/save
- Method:POST
- 数据格式:JSON
- 接口说明:每批次最多处理50条记录
请求参数
参数 | 类型 | 必须 | 默认值 | 主键 | 描述 |
---|---|---|---|---|---|
costTrackingName | string | Y | 选项属于的辅助核算名称 | ||
name | string | N | 辅助核算选项名称(name和nameEn至少其中一个要有值) | ||
nameEn | string | N | 辅助核算选项英文名称(name和nameEn至少其中一个要有值) | ||
businessCode | string | Y | Y | 辅助核算选项编码 | |
visibilityAuthLevel | string | Y | 可见性授权,默认值及历史数据为 不可授权;可选值:NONE, RESP_USER,RESP_AND_AUTH_USER; RESP_USER表示负责人可授权, RESP_AND_AUTH_USER表示 负责人与可见人可授权, NONE:不可授权 |
||
category | string | N | 辅助核算选项上级名称路径,以/分隔层次,类似A/B/C | ||
principal | string | N | 负责人工号 | ||
departmentBizCodes | array | N | 可见部门编码列表 | ||
employeeIds | array | N | 可见员工工号列表 | ||
feeTypeBizCodes | array | N | 可见费用类型编码 | ||
active | bool | N | false | 是否启用 | |
downOption | bool | N | true | 是否可选择 | |
visibility | enum | N | WHITE_LIST | 辅助核算选项可见性,可选值: OPEN, WHITE_LIST; OPEN表示所有部门 可见, WHITE_LIST表示仅给定 的员工列表或部门列表可见; 默认为WHITE_LIST |
|
tag | string | N | 选项属性 | ||
subsidiaryBizCodes | array | N | 关联业务实体编码列表,如果不提供, 则可用于所有业务实体 |
||
coverDepartmentBizCodes | array | N | 关联承担部门编码 | ||
source | string | N | 来源,不同来源的辅助核算授权, 不会相互影响 | ||
dependencyBizCode | string | N | 依赖的辅助核算选项编码,支持多选,以逗号隔开;只有当辅助核算设置了依赖, 并且这里被依赖的选项正确时,才能设置上去 |
备注
该接口采用单条失败的处理方式,即整批数据中,如果只有其中的几条因为各种原因失败,那么只有那几条数据不会被保存;其它的数据仍然会被正常处理;错误数据的主键(name)会被放在errorData里面;
errorData为结构体, 包含出错记录主键(name), 以及与之对应的出错信息; 类似 {"项目": "部门不存在"}; 具体参见失败实例;
为保持向后兼容, data也会包含有和errorData相同的记录,但后续可能会改变;
示例:
请求数据
{
"timestamp": 123456,
"data": [{
"costTrackingName": "项目",
"name": "2016年3月投标A",
"nameEn": "nameEn",
"businessCode": "2016_3_A",
"visibilityAuthLevel": "NONE",
"category": "2016/3",
"principal": "10001",
"departmentBizCodes": ["A", "B"],
"employeeIds": ["10001"],
"feeTypeBizCodes":["FEE_TYPE_1","FEE_TYPE_2"],
"coverDepartmentBizCodes":["C","D"],
"active": true,
"downOption": true
}]
}
返回数据(成功)
{
"code": "ACK",
"message": "",
"data": {},
"args": null,
"linkDetail": false,
"nonBizError": false
}
返回数据(失败)
{
"code": "NACK",
"message": null,
"data": {
"4003": "辅助核算填写不正确"
},
"args": null,
"linkDetail": false,
"errorData": {
"4003": "辅助核算填写不正确"
},
"nonBizError": false
}