# 一. 接口适用场景
1. 查询固定资产-折旧预测数据
2. 跨业务模块数据汇集
# 二. 接口定义
## 服务定义
所属领域cloudId：`fi
`
所属应用appId：`fa
`
服务接口：`
FaCardListService
`
方法名：`
queryCardDepreForecast
`
## 请求参数定义
参数类型：`java.util.Map`
参数内容：
| 字段key | 字段类型 | 必填参数 | 字段描述 |
| ----------------- | ------------ | -------- | ------------------------------------------ |
| orgNumber | String | 是 | 组织编码 |
| depreUseNumber | String | 是 | 折旧用途编码 |
| startPeriodNumber | String | 是 | 预测开始期间编码 |
| endPeriodNumber | String | 是 | 期间编码(与ID参数2选1) |
| containsDetail | boolean | 是 | 是否包含每一期的折旧额 |
| extBaseField | List<String> | 否 | 其它资产信息字段，财务卡片和实物卡片的字段 |
| otherFilters | String | 否 | 其它过滤条件(如：number = 'xxxxx') |
## 返回结果定义
参数类型：
```
List<Map<String, Object>>
```
数据内容：
| 字段key | 字段类型 | 字段描述 |
| ------------------ | ---------- | ------------------------------------------ |
| number | String | 资产编码 |
| assetname | String | 资产名称 |
| currency | Long | 币别ID |
| currencynumber | String | 币别编码 |
| currencyname | String | 币别名称 |
| assetcatnumber | String | 资产类别编码 |
| assetcatname | String | 资产类别名称 |
| periodid | Long | 期间ID |
| predictdepre | BigDecimal | 预测折旧额 |
| monthdepre | BigDecimal | 期折旧额 |
| predictoriginalval | BigDecimal | 资产原值 |
| predictaccumdepre | BigDecimal | 累计折旧 |
| predictnetworth | BigDecimal | 净值 |
| predictdecval | BigDecimal | 减值准备 |
| predictnetamount | BigDecimal | 净额 |
| preusingamount | BigDecimal | 预计使用期间数 |
| predepredamount | BigDecimal | 已折旧期间数 |
| preresidualval | BigDecimal | 预计净残值 |
| preremainderamount | BigDecimal | 剩余使用期间数 |
| preaddupyeardepre | BigDecimal | 预测本年累计折旧 |
| extBaseFieldMap | Map | 其它资产信息字段，财务卡片和实物卡片的字段 |
# 三. 调用示例
```
// 调用参数
Map<String, Object> param = new HashMap<>(8);
// 查询组织id
param.put("orgNumber", "Org1001");
// 折旧用途
param.put("depreUseNumber", "01");
// 期间
param.put("startPeriodNumber", "202301");
param.put("endPeriodNumber", "202312");
// 是否包含每一期的折旧额
param.put("containsDetail", false);
// 其它过滤条件：如查询资产类别编码为F01
param.put("otherFilters", "assetcat.number='F01'");
// 其它卡片信息
param.put("extBaseField", Arrays.asList("realcard.assetname", "assetcat.number"));
// 发起接口调用
List<Map> result = DispatchServiceHelper.invokeBizService("fi", "fa","FaCardListService", "queryCardDepreForecast", param);
// TODO 按需解析返回结果
```
