创建成本中心项

接口描述

此接口用于使用中间件同步创建成本中心项

接口权限

本接口需要集团权限

旧版本的入口

已经通过老版本接口创建成本中心项经理的客户，可以继续使用老版本的接口进行创建

【Ver1.0 版本】

请求URI

/api/openapi/cost/center/items/V2

请求方式

POST

请求体示例

{
  "costCenterCode": "PROJECT",
  "name": "SpendiaDep",
  "code": "costCenterItemCode",
  "parentCode": "CCI_001",
  "sequenceNumber": "1",
  "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	序号
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}	无
120402	成本中心不存在	无
120504	成本中心项编码已存在	无
120515	成本中心项序号只允许为正整数并且不能超过10位	无
120526	父级成本中心项不允许为空	无
120527	父级成本中心项不属于对应父级成本中心下的成本中心项	无
120528	请先设置对应成本中心的父级成本中心	无
120529	父级成本中心项已禁用	无
120540	部门已失效:{0}	无
121802	当前账套不存在	无
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	无