# 利率定价流程 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`