费用台账查询接口
说明
费用台账查询接口
接口限制
接口地址
/api/openapi/account-book/expense/search
请求类型
POST
请求参数
参数说明
| 参数名称 |
类型 |
是否必填 |
参数说明 |
| startCreateDate |
Long |
是 |
费用创建开始时间 |
| endCreateDate |
Long |
是 |
费用创建结束时间 |
| pageNo |
Integer |
否 |
页码(默认为1) |
| pageSize |
Integer |
否 |
分页大小(默认为50,最大为100) |
| employeeIds |
List<String> |
否 |
费用归属人工号列表 |
| expenseStatuses |
List<String> |
否 |
费用状态列表("OPEN"、"PROCESSING"、"CLOSED"、"FREE") |
参数样例
{
"startCreateDate": 1759161600000,
"endCreateDate": 1767110399999,
"employeeIds": ["XXXX"],
"expenseStatuses": ["PROCESSING"],
"pageNo": 1,
"pageSize": 50
}
响应参数
响应参数说明
| 字段名称 |
字段类型 |
字段说明 |
| hasNextPage |
Boolean |
是否有下一页 |
| list |
List<AccountBookExpense> |
费用台账列表 |
费用台账
| 字段名称 |
字段类型 |
字段说明 |
| code |
String |
费用内码 |
| expenseTypeName |
String |
费用类型名称 |
| expenseTypeCode |
String |
费用类型编码 |
| reimburseStatus |
String |
费用状态(未报销、报销中、已报销、免报销) |
| createdAt |
Long |
创建日期 |
| consumeTime |
DateInput |
消费日期 |
| userName |
String |
费用归属人姓名 |
| employeeId |
String |
费用归属人工号 |
| legalEntityName |
String |
费用归属人所属公司抬头 |
| departmentName |
String |
费用归属人所在部门 |
| receiptAmount |
MonetaryAmount |
费用金额 |
| approvedConsumeAmount |
MonetaryAmount |
付款金额 |
| taxAmount |
MonetaryAmount |
税额(合计) |
| taxDeductionAmount |
MonetaryAmount |
抵扣税额 |
| settleType |
String |
结算方式(个人垫付、企业支付、月结支付、事后统一结算、事后兑换积分) |
| corpType |
String |
业务场景(个人报销、对公全部到票、对公未到票、对公核销) |
| dynaTags |
List<DynaTag> |
标签 |
| sourceType |
String |
费用来源(记费用、第三方平台) |
| reimburseCode |
String |
关联单号 |
| corpExpenseResponsibleUsers |
List<CoverUserDto> |
责任人 |
| budgetFailReason |
String |
预算占有失败原因 |
| comments |
String |
费用备注 |
MonetaryAmount
| 参数名称 |
类型 |
描述 |
| amount |
BigDecimal |
金额 |
| currency |
String |
币种 |
DynaTag
| 参数名称 |
类型 |
描述 |
| bizCode |
String |
标签外码 |
| label |
String |
标签 |
| labelEn |
String |
标签英文名 |
| labelZh |
String |
标签中文名 |
| color |
String |
标签颜色 |
| preDefinedTag |
Boolean |
是否免审标签 |
| tagType |
String |
标签类型(预定义标签:"PRE_DEFINED"、自定义标签:"CUSTOM_DEFINED") |
参数样例
{
"code": "ACK",
"message": null,
"data": {
"total": 49,
"offset": 0,
"pageSize": 0,
"list": [
{
"code": "FD2512291EPSE6FY",
"expenseTypeName": "税额",
"expenseTypeCode": "ET2511161PP950UZ",
"reimburseStatus": "报销中",
"createdAt": 1767057182886,
"consumeTime": {
"currentTime": 1767057181184,
"timeRange": null,
"currentTimeStr": null
},
"userName": "XX",
"employeeId": "XXXX",
"legalEntityName": "每时每刻有限公司3",
"departmentName": "杭州每时每刻有限公司",
"receiptAmount": {
"amount": 1.00,
"currency": "CNY",
"customExchangeRate": 1,
"amountStr": "¥1.00"
},
"approvedConsumeAmount": {
"amount": 1.00,
"currency": "CNY",
"customExchangeRate": 1,
"amountStr": "¥1.00"
},
"taxAmount": {
"amount": 0.00,
"currency": "CNY",
"customExchangeRate": 1,
"amountStr": "¥0.00"
},
"taxDeductionAmount": null,
"settleType": "personal_advance",
"corpType": "个人报销",
"dynaTags": [
{
"bizCode": "BILL_INVOICE_EXPENSE",
"color": "#FFAB00",
"label": "月结发票",
"labelEn": "bill invoice expense",
"labelZh": "月结发票",
"name": "月结发票",
"preDefinedTag": false,
"tagType": "PRE_DEFINED"
}
],
"sourceType": "记费用",
"reimburseCode": "MK25120153",
"corpExpenseResponsibleUsers": null,
"budgetFailReason": null,
"comments": ""
}
],
"hasNextPage": true
},
"requestId": null,
"errorCode": null,
"success": true
}
修改记录
2025-12-30 新增费用台账查询接口文档