员工借款核销统计接口
说明
- 通过该接口可以查看员工在各个流程状态的借款金额，以及核销情况。具体状态表示和金额见详细参数。
注意事项
- 一次最多传入10个 employeeNo，超过则报错，且不会对重复 No 过滤。
接口地址
/api/openapi/form/loan/employee/detail
请求类型
POST
请求参数
参数说明
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| employeeNos |
List<String> |
是 |
员工工号 |
| needDeductionCompleted |
boolean |
否 |
是否需要查询已核销的借款 |
| pageSize |
int |
否 |
分页大小，默认为 50，最大值为 100 |
| pageNum |
int |
否 |
页码，默认为 1 |
参数样例
{
"employeeNos": [
"user001",
"user002"
],
"needDeductionCompleted":true,
"pageSize":50,
"pageNum":1
}
响应参数
响应参数说明
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| hasNextPage |
boolean |
是 |
是否有下一页 |
| list |
List<Detail> |
是 |
分页查询的结果 |
Details 包含字段说明
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| employeeId |
string |
是 |
员工工号 |
| formCode |
string |
是 |
单据号 |
| formName |
string |
是 |
单据名称 |
| formStatus |
string |
是 |
单据状态 |
| deductions |
List<Deduction> |
是 |
员工借款明细 |
Deduction 包含字段说明
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| deductionStatus |
string |
是 |
核销状态。详细见附录1说明 |
| monetaryInfoList |
List<MonetaryInfo> |
是 |
核销明细 |
MonetaryInfo 包含字段说明
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| amount |
BigDecimal |
|
金额 |
| currency |
string |
|
币种 |
参数样例
{
"hasNextPage": true,
"list": [
{
"employeeId": "emp001",
"formCode": "MK23020120",
"formName": "出差借款",
"formStatus": "COMPLETED",
"deductions": [
{
"deductionStatus": "PENDING",
"monetaryInfoList": [
{
"amount": 67,
"currency": "CNY",
"amountStr": "￥67.00"
}
]
},
{
"deductionStatus": "COMPLETED",
"monetaryInfoList": [
{
"amount": 100,
"currency": "CNY",
"amountStr": "¥100.00"
}
]
},
{
"deductionStatus": "ALL",
"monetaryInfoList": [
{
"amount": 10000,
"currency": "CNY",
"amountStr": "￥10,000.00"
}
]
}
]
}
]
}
附录
1、核销状态
| 字段code |
字段说明 |
| UNSTART |
流程中借款汇总金额（取值逻辑：借款单流程未完成【审批中、审核中、结算中】，借款单批准金额之和）。
taskStatus状态是 PROCESSING 时，则deductionStatus显示此状态。 |
| ALL |
借款汇总金额（取值逻辑：已完成的借款单批准金额之和，包含核销中金额、核销完成金额、人工确认还款金额） |
| PENDING |
核销中金额（取值逻辑：报销单、还款单流程未完成【审批中、审核中、结算中】，核销借款的金额之和） |
| COMPLETED |
核销完成金额（取值逻辑：报销单、还款单流程已完成，核销借款的金额之和） |
| FINANCE |
人工确认还款金额总和 |
修改记录
2024-08-21 新增员工借款核销统计接口文档