创建成本中心项
接口描述
此接口用于使用中间件同步创建成本中心项
接口权限
本接口需要集团权限
新版本的入口
返回最新版本
【最新的版本】
请求URI
/api/openapi/cost/center/items
请求方式
POST
请求体示例
{
"costCenterCode": "PROJECT",
"name": "SpendiaDep",
"code": "costCenterItemCode",
"parentCode": "CCI_001",
"sequenceNumber": "1",
"managerEmployeeId": "LA10001",
"setOfBooksCode": "DEFAULT_SOB",
"isEnabled": true,
"isPublic": false,
"startDate": "2021-01-01",
"endDate": "2021-01-02",
"isApplyAllCompanies": true,
"primaryDepartmentCode":"dept001",
"secondaryDepartmentCodes":"dept002",
"remarkForInquiry":"自定义字段信息",
"customFields":[
{
"fieldCode":"Test",
"value":"1"
}
]
}
请求体字段
| 字段名 | 类型 | 必填 | 主键 | 约束 | 说明 |
|---|---|---|---|---|---|
| costCenterCode | String | 是 | ○ | 最大长度 36 | 成本中心编码 |
| name | String | 是 | 最大长度 150 | 成本中心项名称 | |
| code | String | 是 | ○ | 最大长度 36 | 成本中心项编码 |
| parentCode | String | 否 | 最大长度 36 | 父成本中心项编码。如果已经关联父成本中心项,则不能为空 | |
| sequenceNumber | Long | 否 | 正整数,最大长度10 | 序号 | |
| managerEmployeeId | String | 否 | 管理员员工工号。 | ||
| setOfBooksCode | String | 是 | ○ | 最大长度 36 | 所属账套编码 |
| isEnabled | Boolean | 否 | 是否启用。默认true | ||
| startDate | Date | 否 | 日期格式:yyyy-MM-dd | 有效开始时间 | |
| endDate | Date | 否 | 日期格式:yyyy-MM-dd | 有效结束时间 | |
| isPublic | Boolean | 否 | 是否为公共项目。默认false | ||
| isApplyAllCompanies | Boolean | 否 | 是否为适用全部公司。默认true | ||
| primaryDepartmentCode | String | 否 | 主部门编码 | ||
| secondaryDepartmentCodes | String | 否 | 从属部门编码。 多个用逗号隔开 | ||
| remarkForInquiry | String | 最大长度 50 | 备注(查询用) | ||
| customFields | List <FormField> | 否 | 扩展字段 |
CustomField
| 参数名 | 类型 | 必填 | 主键 | 约束 | 说明 |
|---|---|---|---|---|---|
| fieldCode | String | ○ | ○ | 最大长度 50 | 自定义字段编码 |
| value | String | 最大长度 200 | 自定义字段值,如果自定义字段设定为必填,则该值不可为空 |
接口返回示例
成功
{
"message": "success",
"oid": "6e060119-c09e-4d6d-b226-b490e229346b",
"key": "costCenterItemCode"
}
失败示例
{
"message": "成本中心不存在",
"errorCode": "120402"
}
字段说明
| 字段名称 | 类型 | 说明 |
|---|---|---|
| message | String | 返回信息说明 |
| oid | UUID | 成本中心项OID |
| key | String | 成本中心项编码 |
| errorCode | String | 返回错误码 |
错误代码
| errorCode | message | 说明 |
|---|---|---|
| 0013 | 参数:{0},最大长度{1} | 字段长度超出限制 |
| 120003 | 缺少必填项:{0} | 无 |
| 120004 | 参数长度非法:{0}长度必须在{1}到{2}个字符之间 | 无 |
| 120112 | 部门不存在:{0} | 无 |
| 120207 | 员工不存在 | 无 |
| 120402 | 成本中心不存在 | 无 |
| 120504 | 成本中心项编码已存在 | 无 |
| 120515 | 成本中心项序号只允许为正整数并且不能超过10位 | 无 |
| 120526 | 父级成本中心项不允许为空 | 无 |
| 120527 | 父级成本中心项不属于对应父级成本中心下的成本中心项 | 无 |
| 120528 | 请先设置对应成本中心的父级成本中心 | 无 |
| 120529 | 父级成本中心项已禁用 | 无 |
| 120540 | 部门已失效:{0} | 无 |
| 121802 | 当前账套不存在 | 无 |
| 6049004 | 成本中心项经理必填 | 无 |
| 120007 | 编码不合法,包含非法字符 | 无 |
| 6061006 | 自定义字段:{0} 的值填写不正确 | 无 |
| 60390022 | 未找到员工的主岗(工号{0},姓名{1},基准日期{2}) | 无 |
| 120237 | 成本中心扩展字段编码不存在:{0} | 无 |
| 120238 | 成本中心最多有10个扩展字段 | 无 |
| 120239 | 成本中心扩展字段编码不能为空 | 无 |
| 120240 | 成本中心扩展字段值不能为空 | 无 |
| 120241 | 成本中心扩展字段编码不能重复 | 无 |
| 120007 | 编码不合法,包含非法字符 | 无 |
| 6013009 | 日期格式为:yyyy-MM-dd | 无 |
| 6049010 | 有效日期至不能小于有效日期从 | 无 |
| 6061008 | 自定义字段:{0} 的值整数位数请输入{1}位以内 | 无 |
| 6061009 | 自定义字段:{0} 的值浮点数位数请输入{1}位以内 | 无 |
| 6061011 | 自定义字段:{0} 的值日期格式为YYYY-MM-dd | 无 |