批量融资申请

接口说明

批量发起融资申请

接口地址

POST /api/loan/create/batch

请求参数 (data 解密后)

{
  "transactionId": "幂等ID",
  "loanCreateRequests": [
    {
      "memberId": 1000001,
      "projectId": 1,
      "loanAmount": 10000000,
      "loanSchedules": 12,
      "loanScheduleDays": 30,
      "repayMethod": 1,
      "dailyRate": 33333,
      "penaltyDailyRate": 50000,
      "repayDay": 25,
      "interestSubsidyDays": 0,
      "outerBusinessId": "LOAN20250111001",
      "trades": [
        {
          "tradeType": 1,
          "tradeVendor": "某某仓库",
          "tradePurchaser": "某某药店",
          "tradeAmount": 10000000,
          "contractSignDate": "2025-01-01",
          "contractStartDate": "2025-01-01",
          "contractEndDate": "2025-12-31",
          "contractNo": "HT20250101001",
          "contractName": "采购合同",
          "resourceIds": [123456, 123457]
        }
      ],
      "payees": [
        {
          "payeeId": 1000002,
          "payeeAmount": 10000000
        }
      ],
      "remark": "采购原材料"
    }
  ]
}

字段说明

字段名	类型	必填	说明
transactionId	String	是	幂等ID
loanCreateRequests	Array	是	融资申请列表(一批最多200条)

loanCreateRequests 字段说明

字段名	类型	必填	说明
memberId	Long	是	融资方成员ID
projectId	Long	是	项目ID
loanAmount	Long	是	融资金额(分)
loanSchedules	Integer	是	分期期数
loanScheduleDays	Integer	是	单期天数
repayMethod	RepayMethod	是	还款方式:1-一次性还本付息,2-先息后本,3-等额本息,4-等额本金
dailyRate	Integer	是	日利率(亿分之级别,例:0.033333%=33333)
penaltyDailyRate	Integer	是	罚息日利率(亿分之级别)
repayDay	Integer	是	还款日(1-31)
interestSubsidyDays	Integer	是	贴息天数
outerBusinessId	String	是	外部流水号(业务标识,唯一性校验)
trades	Array	是	贸易背景信息列表
payees	Array	是	收款账户列表
remark	String	否	备注

特别说明

repayDay(还款日):

• 若大于当月最后一天时,以最后一天作为当月还款日
• 若大于最后一期结清日,以还款日作为结清日
• 理论上应避免出现上面的情况

贸易背景信息 (trades) 字段说明

字段名	类型	必填	说明
tradeType	TradeType	是	贸易背景类型:1-药店和仓库的合同
tradeVendor	String(64)	是	贸易背景收款人名称(仓库)
tradePurchaser	String(64)	是	贸易背景付款人名称(药店)
tradeAmount	Long	是	贸易背景金额(分)
contractSignDate	String	是	合同签署日期(yyyy-MM-dd)
contractStartDate	String	是	合同起始日(yyyy-MM-dd)
contractEndDate	String	是	合同到期日(yyyy-MM-dd)
contractNo	String(64)	是	合同编号
contractName	String(64)	是	贸易背景合同名称
resourceIds	List<Long>	否	调用文件上传接口获取到的资源ID列表

收款账户 (payees) 字段说明

字段名	类型	必填	说明
payeeId	Long	是	收款人成员ID
payeeAmount	Long	是	收款金额(分)

响应参数 (data 解密后)

{
  "code": "0",
  "message": "success",
  "data": [
    {
      "status": 1,
      "message": "申请成功",
      "loanOrderId": 3000001,
      "outerBusinessId": "LOAN20250111001"
    },
    {
      "status": 2,
      "message": "融资金额超过可用额度",
      "loanOrderId": null,
      "outerBusinessId": "LOAN20250111002"
    }
  ]
}

响应字段说明

字段名	类型	说明
code	String	整体响应码:0-成功
message	String	整体响应信息
data	Array	融资申请结果列表
data[].status	Integer	单条状态:1-成功,2-失败
data[].message	String	单条结果信息
data[].loanOrderId	Long	融资订单ID(成功时返回)
data[].outerBusinessId	String	外部流水号

业务规则

1. 接口允许部分成功,即使部分记录失败也会返回成功响应
2. 每条记录都有独立的 status 和 message
3. status=1 表示该条申请成功,会返回 loanOrderId
4. status=2 表示该条申请失败,loanOrderId 为 null,message 说明失败原因
5. 只有全部请求都失败时,外层 code 才会返回错误码