新增/更新

  • 接口:/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
}

results matching ""

    No results matching ""