分页查询成本中心项
接口描述
此接口为根据成本中心查询成本中心项
旧版本的入口
已经通过老版本接口创建成本中心项经理的客户,可以继续使用老版本的接口进行创建
请求URI
/api/openapi/cost/center/items/V2
请求方式
GET
请求参数示例
/api/openapi/cost/center/items?page=1&size=20&costCenterCode=CC_001&setOfBooksCode=TestSOB
请求参数说明
参数名 | 类型 | 是否必填 | 说明 |
---|---|---|---|
page | int | 是 | 页码, 第一页的page为1 |
size | int | 是 | 每页结果数。最大50 |
costCenterCode | String | 是 | 成本中心名称。 |
setOfBooksCode | String | 否 | 账套编码。 公司登录可以不传账套代码,租户登录要传账套代码 |
接口返回示例
{
"total": 1,
"current": 1,
"pageSize": 20,
"pages": 1,
"hasPrevious": false,
"hasNext": false,
"data": [
{
"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"
}
]
}
]
}
接口返回字段
PageResposne
参数名 | 类型 | 说明 |
---|---|---|
total | int | 查询结果总个数 |
current | int | 当前页数 |
pageSize | int | 每页结果计 |
pages | int | 查询结果总分页数 |
hasPrevious | boolean | 是否有上一页 |
hasNext | boolean | 是否有下一页 |
data | CostCenterItem[] | 成本中心项列表 |
CostCenterItem
字段名 | 类型 | 约束 | 说明 |
---|---|---|---|
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 | 最大长度 100 | 自定义字段编码 |
value | String | 最大长度 2000 | 自定义字段值 |
错误代码
errorCode | message | 说明 |
---|---|---|
120003 | 缺少必填项:{0} | 无 |
120004 | 参数长度非法:{0}长度必须在{1}到{2}个字符之间 | 无 |
120402 | 成本中心不存在 | 无 |
121801 | 账套代码不能为空 | 无 |
121802 | 当前账套不存在 | 无 |