# 一. 接口适用场景
1. 查询固定资产-资产清单数据
2. 跨业务模块数据汇集
# 二. 接口定义
## 服务定义
所属领域cloudId：`fi
`
所属应用appId：`fa
`
服务接口：`
FaCardListService
`
方法名：`
queryAssetCard
`
## 请求参数定义
参数类型：`java.util.Map`
参数内容：
| 字段key | 字段类型 | 必填参数 | 字段描述 |
| ---------------- | ------------ | -------- | ---------------------------------- |
| orgNumber | String | 是 | 组织编码 |
| depreUseNumber | String | 是 | 折旧用途编码 |
| periodId | Long | 否 | 期间ID |
| periodNumber | String | 否 | 期间编码(与ID参数2选1) |
| includeClearCard | boolean | 否 | 是否包含已清理卡片 |
| fields | List<String> | 否 | 其它需查询字段(财务卡片上的字段) |
| otherFilters | String | 否 | 其它过滤条件(如：number = 'xxxxx') |
## 返回结果定义
参数类型：
```
List<Map<String, Object>>
```
数据内容：
| 字段key | 字段类型 | 字段描述 |
| -------------- | -------- | -------------------------- |
| number | String | 资产编码 |
| currency | Long | 币别ID |
| currencyNumber | String | 币别编码 |
| currencyName | String | 币别名称 |
| ...... | | 其它加入fields参数中的字段 |
# 三. 调用示例
```
// 调用参数
Map<String, Object> param = new HashMap<>(8);
// 查询组织id
param.put("orgNumber", "Org1001");
// 折旧用途
param.put("depreUseNumber", "01");
// 期间
param.put("periodId", 120210010L);
// 是否包含已清理卡片
param.put("includeClearCard", true);
// 其它过滤条件：如查询资产类别编码为F01
param.put("otherFilters", "assetcat.number='F01'");
// 其它卡片信息
param.put("fields", Arrays.asList("realcard.assetname", "assetcat.number"));
// 发起接口调用
List<Map> result = DispatchServiceHelper.invokeBizService("fi", "fa","FaCardListService", "queryAssetCard", param);
// TODO 按需解析返回结果
```
