loan-pricing/doc/api/loan-pricing-workflow-api.md

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

请求示例:

{
  "orgCode": "931000",
  "runType": "1",
  "custIsn": "CUST001",
  "custType": "企业",
  "guarType": "抵押",
  "applyAmt": "1000000",
  "loanRate": "4.35",
  "custName": "某某科技有限公司",
  "loanPurpose": "business"
}

响应示例:

{
  "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=科技

响应示例:

{
  "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

响应示例:

{
  "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	服务器内部错误

错误响应示例:

{
  "code": 404,
  "msg": "记录不存在"
}

---

数据字典

客户类型 (custType)

值	说明
个人	个人客户
企业	企业客户

担保方式 (guarType)

值	说明
信用	信用贷款
保证	保证贷款
抵押	抵押贷款
质押	质押贷款

贷款用途 (loanPurpose)

值	说明
consumer	消费贷款
business	经营贷款

抵质押类型 (collType)

值	说明
一线	一线抵押
一类	一类抵押
二类	二类抵押

---

在线文档

访问 Swagger UI 查看交互式 API 文档: http://localhost:8080/swagger-ui.html