268 lines
6.3 KiB
Markdown
268 lines
6.3 KiB
Markdown
# 利率定价流程 API 接口文档
|
|
|
|
## 概述
|
|
|
|
本文档描述利率定价流程管理相关的后端 API 接口。
|
|
|
|
**基础路径:** `/loanPricing/workflow`
|
|
|
|
**认证方式:** Bearer Token (JWT)
|
|
|
|
**Content-Type:** `application/json`
|
|
|
|
---
|
|
|
|
## 接口列表
|
|
|
|
### 1. 发起利率定价流程
|
|
|
|
创建新的利率定价申请。
|
|
|
|
**接口地址:** `POST /loanPricing/workflow/create`
|
|
|
|
**权限要求:** `loanPricing:workflow:create`
|
|
|
|
**请求参数:**
|
|
|
|
| 参数名 | 类型 | 必填 | 说明 |
|
|
|--------|------|------|------|
|
|
| orgCode | String | 是 | 机构编码,固定值: 931000 |
|
|
| runType | String | 是 | 运行模式,固定值: 1(同步) |
|
|
| custIsn | String | 是 | 客户内码 |
|
|
| custType | String | 是 | 客户类型,可选值: 个人/企业 |
|
|
| guarType | String | 是 | 担保方式,可选值: 信用/保证/抵押/质押 |
|
|
| midPerQuickPay | String | 否 | 中间业务_个人_快捷支付,值: true/false |
|
|
| midPerEleDdc | String | 否 | 中间业务_个人_电费代扣,值: true/false |
|
|
| midEntEleDdc | String | 否 | 中间业务_企业_电费代扣,值: true/false |
|
|
| midEntWaterDdc | String | 否 | 中间业务_企业_水费代扣,值: true/false |
|
|
| applyAmt | String | 是 | 申请金额,单位: 元 |
|
|
| isCleanEnt | String | 否 | 净身企业,值: true/false |
|
|
| hasSettleAcct | String | 否 | 开立基本结算账户,值: true/false |
|
|
| isManufacturing | String | 否 | 制造业企业,值: true/false |
|
|
| isAgriGuar | String | 否 | 省农担担保贷款,值: true/false |
|
|
| isTaxA | String | 否 | 是否纳税信用等级A级,值: true/false |
|
|
| isAgriLeading | String | 否 | 是否县级及以上农业龙头企业,值: true/false |
|
|
| loanPurpose | String | 否 | 贷款用途,可选值: consumer/business |
|
|
| bizProof | String | 否 | 是否有经营佐证,值: true/false |
|
|
| collType | String | 否 | 抵质押类型,可选值: 一线/一类/二类 |
|
|
| collThirdParty | String | 否 | 抵质押物是否三方所有,值: true/false |
|
|
| loanRate | String | 是 | 贷款利率 |
|
|
| custName | String | 否 | 客户名称 |
|
|
| idType | String | 否 | 证件类型 |
|
|
| isInclusiveFinance | String | 否 | 是否普惠小微借款人,值: true/false |
|
|
|
|
**请求示例:**
|
|
|
|
```json
|
|
{
|
|
"orgCode": "931000",
|
|
"runType": "1",
|
|
"custIsn": "CUST001",
|
|
"custType": "企业",
|
|
"guarType": "抵押",
|
|
"applyAmt": "1000000",
|
|
"loanRate": "4.35",
|
|
"custName": "某某科技有限公司",
|
|
"loanPurpose": "business"
|
|
}
|
|
```
|
|
|
|
**响应示例:**
|
|
|
|
```json
|
|
{
|
|
"code": 200,
|
|
"msg": "操作成功",
|
|
"data": {
|
|
"serialNum": "20250119143025123",
|
|
"orgCode": "931000",
|
|
"runType": "1",
|
|
"custIsn": "CUST001",
|
|
"custType": "企业",
|
|
"guarType": "抵押",
|
|
"applyAmt": "1000000",
|
|
"loanRate": "4.35",
|
|
"custName": "某某科技有限公司",
|
|
"createTime": "2025-01-19 14:30:25",
|
|
"createBy": "admin"
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
### 2. 查询利率定价流程列表
|
|
|
|
分页查询利率定价流程记录,支持多条件筛选。
|
|
|
|
**接口地址:** `GET /loanPricing/workflow/list`
|
|
|
|
**权限要求:** `loanPricing:workflow:list`
|
|
|
|
**请求参数:**
|
|
|
|
| 参数名 | 类型 | 必填 | 说明 |
|
|
|--------|------|------|------|
|
|
| pageNum | Integer | 否 | 页码,默认 1 |
|
|
| pageSize | Integer | 否 | 每页数量,默认 10 |
|
|
| createBy | String | 否 | 创建者(筛选条件) |
|
|
| custName | String | 否 | 客户名称(模糊查询) |
|
|
| orgCode | String | 否 | 机构号(筛选条件) |
|
|
|
|
**请求示例:**
|
|
|
|
```
|
|
GET /loanPricing/workflow/list?pageNum=1&pageSize=10&custName=科技
|
|
```
|
|
|
|
**响应示例:**
|
|
|
|
```json
|
|
{
|
|
"code": 200,
|
|
"msg": "查询成功",
|
|
"rows": [
|
|
{
|
|
"serialNum": "20250119143025123",
|
|
"orgCode": "931000",
|
|
"custIsn": "CUST001",
|
|
"custType": "企业",
|
|
"guarType": "抵押",
|
|
"applyAmt": "1000000",
|
|
"loanRate": "4.35",
|
|
"custName": "某某科技有限公司",
|
|
"createTime": "2025-01-19 14:30:25",
|
|
"updateTime": "2025-01-19 15:20:10",
|
|
"createBy": "admin"
|
|
}
|
|
],
|
|
"total": 1
|
|
}
|
|
```
|
|
|
|
**说明:** 结果按更新时间(update_time)倒序排列。
|
|
|
|
---
|
|
|
|
### 3. 查看利率定价流程详情
|
|
|
|
根据业务方流水号查询流程的完整信息。
|
|
|
|
**接口地址:** `GET /loanPricing/workflow/{serialNum}`
|
|
|
|
**权限要求:** `loanPricing:workflow:query`
|
|
|
|
**路径参数:**
|
|
|
|
| 参数名 | 类型 | 必填 | 说明 |
|
|
|--------|------|------|------|
|
|
| serialNum | String | 是 | 业务方流水号 |
|
|
|
|
**请求示例:**
|
|
|
|
```
|
|
GET /loanPricing/workflow/20250119143025123
|
|
```
|
|
|
|
**响应示例:**
|
|
|
|
```json
|
|
{
|
|
"code": 200,
|
|
"msg": "查询成功",
|
|
"data": {
|
|
"serialNum": "20250119143025123",
|
|
"orgCode": "931000",
|
|
"runType": "1",
|
|
"custIsn": "CUST001",
|
|
"custType": "企业",
|
|
"guarType": "抵押",
|
|
"midPerQuickPay": "false",
|
|
"midPerEleDdc": "false",
|
|
"midEntEleDdc": "false",
|
|
"midEntWaterDdc": "false",
|
|
"applyAmt": "1000000",
|
|
"isCleanEnt": "false",
|
|
"hasSettleAcct": "false",
|
|
"isManufacturing": "true",
|
|
"isAgriGuar": "false",
|
|
"isTaxA": "false",
|
|
"isAgriLeading": "false",
|
|
"loanPurpose": "business",
|
|
"bizProof": "true",
|
|
"collType": "一类",
|
|
"collThirdParty": "false",
|
|
"loanRate": "4.35",
|
|
"custName": "某某科技有限公司",
|
|
"idType": "统一社会信用代码",
|
|
"isInclusiveFinance": "true",
|
|
"createTime": "2025-01-19 14:30:25",
|
|
"createBy": "admin",
|
|
"updateTime": "2025-01-19 15:20:10",
|
|
"updateBy": "admin"
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## 错误码说明
|
|
|
|
| 错误码 | 说明 |
|
|
|--------|------|
|
|
| 200 | 请求成功 |
|
|
| 401 | 未授权,请先登录 |
|
|
| 403 | 无权限访问 |
|
|
| 404 | 资源不存在 |
|
|
| 500 | 服务器内部错误 |
|
|
|
|
**错误响应示例:**
|
|
|
|
```json
|
|
{
|
|
"code": 404,
|
|
"msg": "记录不存在"
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## 数据字典
|
|
|
|
### 客户类型 (custType)
|
|
|
|
| 值 | 说明 |
|
|
|----|------|
|
|
| 个人 | 个人客户 |
|
|
| 企业 | 企业客户 |
|
|
|
|
### 担保方式 (guarType)
|
|
|
|
| 值 | 说明 |
|
|
|----|------|
|
|
| 信用 | 信用贷款 |
|
|
| 保证 | 保证贷款 |
|
|
| 抵押 | 抵押贷款 |
|
|
| 质押 | 质押贷款 |
|
|
|
|
### 贷款用途 (loanPurpose)
|
|
|
|
| 值 | 说明 |
|
|
|----|------|
|
|
| consumer | 消费贷款 |
|
|
| business | 经营贷款 |
|
|
|
|
### 抵质押类型 (collType)
|
|
|
|
| 值 | 说明 |
|
|
|----|------|
|
|
| 一线 | 一线抵押 |
|
|
| 一类 | 一类抵押 |
|
|
| 二类 | 二类抵押 |
|
|
|
|
---
|
|
|
|
## 在线文档
|
|
|
|
访问 Swagger UI 查看交互式 API 文档: `http://localhost:8080/swagger-ui.html`
|