关联申请单可预提费用明细查询接口
说明
按来源普通申请单号查询费用明细及预提金额，供关联申请单预提费用导入接口填写金额。来源单必须是已完成、有效且小类启用的普通申请单；预提申请单不能作为来源。
availableAmount 仅供展示和填写参考，不是导入金额上限。接口返回的 currentAccrualAmount 默认等于 availableAmount，可能为零或负数；实际导入时须填大于零的金额。
接口限制
- 一次最多查询 5 张来源申请单，按请求数组长度校验；列表内单号去重后查询。
- 已预提金额只统计有效且处于审批中及后续状态的目标预提申请单；草稿、删除或作废目标单不计入。
接口地址
/api/openapi/receive/application/expense/accrual/query
请求类型
POST
请求参数
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| sourceFormCodes |
List<String> |
是 |
来源普通申请单的单据号列表，非单据内码；非空、元素非空，最多 5 个 |
请求样例
{
"sourceFormCodes": ["MK26010001", "MK26010002"]
}
响应参数
| 字段名称 |
字段类型 |
字段说明 |
| code |
String |
ACK 表示查询成功 |
| message |
String |
本地化提示信息 |
| data |
List<ApplicationExpenseSummary> |
按请求来源申请单顺序返回；无费用的来源单返回空 expenses |
| success |
boolean |
是否成功 |
ApplicationExpenseSummary
| 字段名称 |
字段类型 |
字段说明 |
| sourceFormCode |
String |
来源普通申请单号 |
| expenses |
List<Expense> |
该来源单的费用列表 |
Expense
| 字段名称 |
字段类型 |
字段说明 |
| sourceApplicationExpenseCode |
String |
来源申请费用编码；导入时需原样传入 |
| expenseTypeCode |
String |
来源费用类型编码 |
| expenseTypeName |
String |
来源费用类型名称 |
| expenseAmount |
Number |
来源费用金额，优先取消费金额 |
| accruedAmount |
Number |
已预提金额；按来源费用编码汇总有效目标单的预提费用 |
| availableAmount |
Number |
可预提金额＝expenseAmount - accruedAmount，可为负数 |
| currentAccrualAmount |
Number |
默认等于 availableAmount，仅供调用方参考 |
| currency |
String |
来源费用的消费币种 |
响应样例
{
"code": "ACK",
"message": "操作成功",
"data": [
{
"sourceFormCode": "MK26010001",
"expenses": [
{
"sourceApplicationExpenseCode": "AE26010001",
"expenseTypeCode": "ET001",
"expenseTypeName": "办公费",
"expenseAmount": 300,
"accruedAmount": 100,
"availableAmount": 200,
"currentAccrualAmount": 200,
"currency": "CNY"
}
]
},
{
"sourceFormCode": "MK26010002",
"expenses": []
}
],
"success": true
}
异常场景
| 场景 |
处理方式 |
sourceFormCodes 为空、含空单号 |
参数错误 |
| 一次传入超过 5 张 |
返回“每次最多查询5张普通申请单” |
| 来源为预提申请单 |
返回“来源申请单不能是预提申请单” |
| 来源不存在、未完成、已删除或小类未启用 |
参数错误 |
修改记录
2026-10-25 DB-61831 新增关联申请单可预提费用明细查询接口文档