预算详情查询v2
- 接口：common/budgets/v2/findDetails
- Method：POST
- 数据格式：JSON
- 限流信息：100次每天和50次每小时
- 多语言环境：在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种
- 接口说明：预算根据不同维度查询详情
- 其他补充信息：请求数据(注意：除财年期间以外，必须再传一个查询维度)
参数:
请求参数
| 字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制(字节) |
| page_num |
Integer |
分页页数 (最小1) |
TRUE |
无 |
| page_size |
Integer |
分页条数 (最小1， 最大100) |
TRUE |
无 |
| period_name |
String |
财年期间 |
TRUE |
64 |
| period_type |
String |
财年类型(有效值：’ptd’,’ptd2’,’ptd0’,’total’,’total2’,’total0’) |
FALSE |
64 |
| department_code |
String |
部门编码 |
FALSE |
64 |
| budget_code |
String |
预算科目编码 |
FALSE |
64 |
| project_code |
String |
项目编码 |
FALSE |
64 |
| employee_number |
String |
员工工号 |
FALSE |
64 |
| supplier_code |
String |
供应商编码 |
FALSE |
64 |
| column1 |
String |
自定义字段1 |
FALSE |
64 |
| column2 |
String |
自定义字段2 |
FALSE |
64 |
| column3 |
String |
自定义字段3 |
FALSE |
64 |
| column4 |
String |
自定义字段4 |
FALSE |
64 |
| column5 |
String |
自定义字段5 |
FALSE |
64 |
返回参数
| 字段名称 |
字段类型 |
字段描述 |
| resCode |
Integer |
响应状态码（见附录） |
| resMsg |
String |
返回信息描述 |
| page_num |
Integer |
当前页数 |
| total_page |
Integer |
总页数 |
| page_size |
Integer |
条数 |
| total_count |
Integer |
当前页总条数 |
| page_info |
Array |
预算详情信息 |
| page_info.cid |
Integer |
预算格子唯一编码(只与构成其的预算维度有关,可能对应多个预算计划表) |
| page_info.department_code |
String |
成本中心编码 |
| page_info.budget_code |
String |
预算科目编码 |
| page_info.project_code |
String |
项目编码 |
| page_info.employee_number |
String |
员工工号 |
| page_info.supplier_code |
String |
供应商编码 |
| page_info.budget_amount |
BigDecimal |
预算金额 |
| page_info.request_amount |
BigDecimal |
占用金额 |
| page_info.expense_amount |
BigDecimal |
消耗金额 |
| page_info.balance_amount |
BigDecimal |
余额 |
| page_info.request_date |
Long |
占用日期(13位数字时间戳) |
| page_info.expense_date |
Long |
消耗日期(13位数字时间戳) |
| page_info.plan_names |
Array |
与这个json对象对应的格子相关的所有预算计划表的名称 |
| column1 |
String |
自定义字段1 |
| column2 |
String |
自定义字段2 |
| column3 |
String |
自定义字段3 |
| column4 |
String |
自定义字段4 |
| column5 |
String |
自定义字段5 |
示例：
请求数据
{
"period_name": "2021年3月",
"department_code": "D427",
"page_size": 3,
"page_num": 1,
"period_type": "ptd"
}
返回数据
{
"resCode": 200000,
"resMsg": "SUCCESS",
"data": {
"page_size": 3,
"page_num": 1,
"total_count": 17,
"total_page": 6,
"is_first_page": true,
"is_last_page": false,
"page_info": [
{
"cid": 2,
"plan_names": [
"3月预算",
"3月预算 - 副本",
"4月预算",
"父节点预算PTD"
],
"department_code": "D427",
"budget_amount": 10000,
"request_amount": 1088,
"expense_amount": 78609.23,
"balance_amount": -69697.23,
"request_date": 1626057691000,
"expense_date": 1643187322000
},
{
"cid": 3,
"plan_names": [
null,
"3月预算",
"3月预算 - 副本",
"4月预算",
"父节点预算PTD"
],
"department_code": "D427",
"budget_amount": 10000,
"request_amount": 0,
"expense_amount": 1924,
"balance_amount": 8076,
"request_date": 1611109130000,
"expense_date": 1634205251000
},
{
"cid": 4,
"plan_names": [
"3月预算",
"3月预算 - 副本",
"4月预算",
"父节点预算PTD"
],
"department_code": "D427",
"budget_amount": 10000,
"request_amount": 0,
"expense_amount": 0,
"balance_amount": 10000
}
]
}
}