2.1.2 融资申请创建
优质
小牛编辑
142浏览
2023-12-01
描述
支持个人、企业融资申请创建。融资申请创建成功后,需要保存响应参数中的“申请ID”,作为后续交易的请求参数。
当借款人已存在一笔新建或审批中的申请时,再次创建新申请会不允许创建(以证件号和证件类型作为条件)。
API代码
loan_app:app:create
请求参数
借款人为个人时,需要提供:
1. 个人借款人信息
- 基本信息
- 职业信息(非个体工商户/私营业主)
- 经营信息(个体工商户/私营业主)
2. 资金需求信息
3. 担保信息(可录入多个,但至少有一个,无实物担保的情况需要填写信用或保证担保)
(个人借款人的联系人信息通过借款人配偶信息和借款人亲朋信息接口提交)
借款人为企业时,需要提供:
1. 企业借款人信息
2. 联系人信息(可录入多个,但至少有一个)
3. 资金需求信息
4. 担保信息(可录入多个,但至少有一个,无实物担保的情况需要填写信用或保证担保)
具体定义如下:
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
cp_cust | JSON | 企业借款人信息,与个人借款人信息同时只能存在一个,见企业借款人信息 | |
cs_cust | JSON | 个人借款人信息,与企业借款人信息同时只能存在一个,见个人借款人信息 | |
contacts | JSON(List) | 是 | 联系人信息(企业专用),见联系人信息 |
fac | JSON | 是 | 资金需求信息 (企业、个人共用), 见资金需求信息 |
col | JSON(List) | 是 | 担保信息 (企业、个人共用), 见担保信息 |
callbackURL | String | 否 | 授信状态变更后通知回调URL( 如:http://api.xxxx.com/ljt/callback ),见授信状态变更通知回调 |
企业借款人信息
名称 | 类型 | 是否必须 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
custId | String | 是 | 50 | 借款人在平台方的客户ID或编号,能够唯一标识某一客户 | 00927284 |
nm | String | 是 | 300 | 企业名称(与营业执照上一致) | 北京某某公司 |
bizRegNo | String | 是 | 50 | 营业执照号码 | |
idNo | String | 是 | 50 | 中征码/贷款卡 | |
isComb | String | 是 | 1 | 是否三证合一 | |
brandNm | String | 是 | 200 | 核心产品及品牌 | |
coreBiz | String | 是 | 255 | 主营业务 | |
isFreeTradeArea | String | 是 | 1 | 是否自贸易区 | |
mtCifCatCd | String | 是 | 20 | 控股经济分类与代码 | |
mtCityCd | String | 是 | 20 | 所在城市 | |
mtCorpSalutationCd | String | 是 | 20 | 公司类型 | |
mtIndDetailCd | String | 是 | 20 | 行业类型 | |
website | String | 是 | 50 | 网址 | |
dtRegistered | Date | 是 | 注册日期 | ||
incomeTaxNo | String | 是 | 20 | 地税登记号 | |
nationalTaxNo | String | 是 | 20 | 国税登记号 | |
registeredAddr | String | 是 | 20 | 注册地址 | |
bizAddr | String | 是 | 50 | 经营地址 | |
dtStart | Date | 是 | 开始营业日期 | ||
noOfBizSite | Number | 是 | 3 | 营业网点数量(单位/个) | |
employeeCnt | Number | 是 | 30 (26,4) | 从业人数(单位/人) | |
mtListedCd | String | 否 | 20 | 是否上市 | |
paidUpCapital | Number | 是 | 30 (26,4) | 实收资本(单位/万元) | |
authCapital | Number | 是 | 30 (26,4) | 注册资本(单位/万元) | |
bizLandArea | Number | 否 | 8 | 经营场地面积(单位/平方米) | |
mtBizLandOwnerCd | String | 是 | 20 | 经营场地所有权 | |
saleAmt | Number | 是 | 30 (26,4) | 近一年销售额(单位/元) | |
assetAmt | Number | 是 | 30 (26,4) | 资产价值(单位/元) | |
ratal | Number | 是 | 14 (12,2) | 近一年纳税额(单位/元) | |
socialSecurity | Number (12,2) | 否 | 14 | 近一年社保缴存额(单位/元) | |
equityLine | Number | 否 | 14 (12,2) | 近一年公积金缴存额(单位/元) | |
waterDosage | Number | 是 | 14 (12,2) | 近一年用水量(单位/吨) | |
electricityDosage | Number | 是 | 14 (12,2) | 近一年用电量(单位/度) | |
salaryTotal | Number | 否 | 14 (12,2) | 近一年发放工资(单位/元) | |
mtSalaryTypCd | String | 否 | 1 | 工资发放方式 | |
principalNo | String | 是 | 20 | 经营电话/负责人电话 | |
mtFinInsttnCd | String | 是 | 20 | 基本开户行 | |
portrait | JSON | 否 | 1000 | 客户画像 | {"行业地位":"市场占有率第一"} |
bizCertificates | JSON(List) | 否 | 见经营许可证信息 |
经营许可证信息
经营许可证信息由三部分组成:经营许可证编号、经营许可证类型、经营许可证到期日
名称 | 类型 | 是否必须 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
no | String | 是 | 50 | 经营许可证编号 | |
mtBizCertificateTypCd | String | 是 | 2 | 经营许可证类型 | |
dtExpiry | Date | 是 | 经营许可证到期日 |
个人借款人信息
个人借款人信息由三部分组成:
名称 | 类型 | 是否必须 | 描述 | 备注 |
---|---|---|---|---|
base | JSON | 是 | 基本信息 | |
employ | JSON | 否 | 职业信息 | 基本信息中“是否为个体工商户/私营业主”为否时必须填写 |
business | JSON | 否 | 经营信息 | 基本信息中“是否为个体工商户/私营业主”为是时必须填写 |
基本信息
名称 | 类型 | 是否必须 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
custId | String | 是 | 50 | 借款人在平台方的客户ID或编号,能够唯一标识某一客户 | 0092728480d24f5d8 |
nm | String | 是 | 300 | 借款人姓名(与身份证上相同) | 张三 |
idNo | String | 是 | 50 | 身份证号码 | |
dtIssued | Date | 否 | 身份证签发日期 | ||
dtExpiry | Date | 否 | 身份证到期日(长期身份证可以为空) | ||
mtGenderCd | String | 是 | 20 | 性别 | |
mtMaritalStsCd | String | 是 | 20 | 婚姻情况 | |
mtEduLvlCd | String | 是 | 20 | 最高学历 | |
mtResidenceStsCd | String | 是 | 20 | 本地居住情况 | |
isFamily | String | 是 | 1 | 是否自有房产 | |
mtJobSectorCd | String | 是 | 20 | 职业 | |
yearIncAmt | String | 否 | 30 (26,4) | 近1年税后收入(单位/元) | |
String | 否 | 30 | 电子邮箱 | ||
mtCityCd | String | 是 | 20 | 所在城市 | |
mobileNo | String | 是 | 20 | 手机号 | |
mtIndvMobileUsageStsCd | String | 否 | 20 | 手机使用年限 | |
Number | 否 | 15 | QQ号 | ||
String | 否 | 50 | 微信号 | ||
bankCard | Number | 是 | 14 (12,2) | 近一年银行卡流水总额 | |
creditCardLines | Number | 否 | 14 (12,2) | 信用卡额度 | |
loanFixedYear | Number | 否 | 20 | 贷款记录年限 | |
isBizEntity | String | 是 | 1 | 是否个体工商户/私营业主 | |
portrait | JSON | 否 | 1000 | 客户画像 | {"芝麻评分":"698"} |
repaymentCard | String | 否 | 30 | 还款银行卡号 | 622649671749152511 |
职业信息
“是否为个体工商户/私营业主”为 "否" 时必须输入:
名称 | 类型 | 是否必须 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
employerNm | String | 是 | 100 | 工作单位 | |
mtPosHeldCd | String | 是 | 20 | 职位 | |
prevServiceYr | Number | 否 | 60 | 工作年限(年) | |
prevServiceMth | Number | 否 | 12 | 工作年限(月) | |
dtWorkInCurrIndustry | Date | 否 | 从事现行业时间 |
经营信息
“是否为个体工商户/私营业主”为“是”时必须输入:
名称 | 类型 | 是否必须 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
isLegalRep | String | 是 | 1 | 是否法定代表人 | |
mtIndDetailCd | String | 是 | 50 | 行业类型 | |
bizRegNo | String | 是 | 50 | 营业执照号 | |
bizAddr | String | 是 | 50 | 经营地址 | |
bizArea | String | 是 | 255 | 经营范围 | |
currentTotal | Number | 是 | 20 (18,2) | 近一年流水总额(单位:元) | |
waterDosage | Number | 是 | 14 (12,2) | 近一年用水量(单位:吨) | |
electricityDosage | Number | 是 | 14 (12,2) | 近一年用电量(单位:度) | |
ratal | Number | 是 | 14 (12,2) | 近一年纳税额(单位:元) | |
socialSecurity | Number | 否 | 14 (12,2) | 近一年社保缴存额 (单位:元) | |
equityLine | Number | 否 | 14 (12,2) | 近一年公积金缴存额 (单位:元) | |
employees | Number | 否 | 14 (12,2) | 员工人数 | |
salaryTotal | Number | 否 | 14 (12,2) | 近一年发放工资 (单位:元) |
联系人信息(企业专用)
名称 | 类型 | 是否必须 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
nm | String | 是 | 100 | 联系人姓名 | |
mobileNo | String | 是 | 20 | 联系人手机号 | |
mtCifContactCd | String | 是 | 20 | 与客户关系,借款人为个人时必需 | |
mtPosHeldCd | String | 是 | 20 | 职位,借款人为企业时必需 | |
String | 否 | 50 | 联系人邮箱 |
资金需求信息
名称 | 类型 | 是否必须 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
mtFacCd | String | 是 | 20 | 业务类型 | |
lmtAppr | Number | 是 | 30 (26,4) | 申请额度 | |
dtMaturity | Date | 否 | 到期日 | ||
tenureAppr | Number | 是 | 6 | 业务期限 | |
mtTimeCd | String | 是 | 1 | 业务期限类型 | D-天、M-月、Y-年 |
mtRepymtTypCd | String | 是 | 20 | 偿还方式 | |
isRevolvingAllowed | String | 是 | 1 | 授信额度是否可循环,默认为否 | Y/N |
mtFacPurCds | JSON | 是 | 100 | 资金用途,可输入多个 | |
intRate | Number | 是 | 9 (5,4) | 年化利率 | |
intRateInSuspense | Number | 否 | 9 (5,4) | 罚息利率 |
担保信息
名称 | 类型 | 是否必须 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
mtCollStyleCd | String | 是 | 20 | 担保方式 | BZ-保证;DY-抵押;ZY-质押;XY-信用 |
mtCollTypCd | String | 是 | 20 | 担保类型 | |
mtCollCatCd | String | 是 | 20 | 担保品种 | |
mtCollCd | String | 是 | 20 | 担保小类 | |
collValue | Number | 是 | 20(18,2) | 担保品价值 | |
isDeposit | String | 是 | 1 | 是否保证金 | Y/N |
collOwner | String | 否 | 50 | 担保品所有者名称 |
- 信用担保品示例
{ "col": [ { "collOwner": "张三",//一般为借款人姓名 "collValue": "30000000", //与申请额度相等 "isDeposit": "N",//固定值 "mtCollCatCd": "OA01",//信用担保品时,固定值 "mtCollCd": "XY0101001",//信用担保品时,固定值 "mtCollStyleCd": "XY",//信用担保品时,固定值 "mtCollTypCd": "OA"//信用担保品时,固定值 } ] }
响应参数
名称 | 类型 | 描述 | 示例值 |
---|---|---|---|
app_id | String | 申请ID | 0092728480d24f5d87bf63639b5cfe1c |
错误码
描述 | HTTP状态码 | 语义 |
---|---|---|
app_id未找到 | 400 | 请输入正确的app_id,或检查申请类型与申请ID是否匹配 |
存在在途申请 | 405 | 客户的前一笔融资请求尚未批准或取消,无法再次发起新融资申请 |
示例
请求示例(企业)
{
"col": [
{
"collOwner": "所有人",
"collValue": "111111",
"mtCollStyleCd": "ZY",
"mtCollTypCd": "DP",
"mtCollCatCd": "DP01",
"mtCollCd": "ZY0101001"
}
],
"contacts": [
{
"email": "1233@qq.com",
"mobileNo": "13333333333",
"mtCifContactCd": "F001",
"mtPosHeldCd": "001",
"nm": "联系人"
}
],
"cp_cust": {
"assetAmt": 55,
"authCapital": 5456,
"bizAddr": "北京",
"bizLandArea": 4576,
"bizRegNo": "58da894a6fc84fb",
"brandNm": "213123412",
"coreBiz": "手机",
"custId": "2f50c12b0d064157bf",
"dtRegistered": "2017-05-03 15:12:24",
"dtStart": "2017-05-03 15:12:24",
"electricityDosage": 879,
"employeeCnt": 12333445,
"equityLine": 879,
"idNo": "a2ebc531112b4fa08d",
"incomeTaxNo": "ds13wqe5",
"isComb": "Y",
"isFreeTradeArea": "Y",
"mtBizLandOwnerCd": "2",
"mtCifCatCd": "112",
"mtCityCd": "110100",
"mtCorpSalutationCd": "2",
"mtFinInsttnCd": "02",
"mtIndDetailCd": "a0111",
"mtListedCd": "Y",
"mtSalaryTypCd": "3",
"nationalTaxNo": "1332",
"nm": "企业",
"noOfBizSite": 333,
"paidUpCapital": 676,
"principalNo": "53453",
"ratal": 3,
"registeredAddr": "北京",
"salaryTotal": 879,
"saleAmt": 33,
"socialSecurity": 879,
"waterDosage": 879,
"website": "baidu.com",
"portrait": "{\"企业实力\":\"世界500强\"}",
"bizCertificateList":[
{
"dtExpiry":"2017-05-16 7:18:12",
"no":"b4812a23a4c14d0ea659",
"mtBizCertificateTypCd":"00"
}
]
},
"fac": {
"dtMaturity": "2017-05-03 15:12:24",
"intRate": 123,
"isRevolvingAllowed": "Y",
"lmtAppr": 123,
"mtFacCd": "P1011",
"mtFacPurCds": [
"1001",
"1002"
],
"mtRepymtTypCd": "001",
"mtTimeCd": "D",
"tenureAppr": "12"
}
}
请求示例(个人)
个人非私营业主
{
"col": [
{
"collOwner": "所有人",
"collValue": "111111",
"mtCollStyleCd": "ZY",
"mtCollTypCd": "DP",
"mtCollCatCd": "DP01",
"mtCollCd": "ZY0101001"
}
],
"cs_cust": {
"base": {
"bankCard": 1234556565,
"creditCardLines": 12345,
"custId": "77f392388c2e410684",
"dtExpiry": "2017-05-03 15:12:27",
"dtIssue": "2017-05-03 15:12:27",
"email": "123@qq.com",
"idNo": "1867fc918fdc4e349e",
"isBizEntity": "N",
"isFamily": "Y",
"loanFixedYear": 11,
"mobileNo": "18888888888",
"yearIncAmt": 100000,
"mtCityCd": "110100",
"mtEduLvlCd": "01",
"mtGenderCd": "M",
"mtIndvMobileUsageStsCd": "01",
"mtJobSectorCd": "10000",
"mtMaritalStsCd": "02",
"mtResidenceStsCd": "01",
"nm": "个人非私营",
"qq": 12345,
"weChat": "1234",
"portrait": "{\"芝麻信用分\":\"750\"}"
},
"employ": {
"dtWorkInCurrIndustry": "2017-05-03 15:12:27",
"employerNm": "单位姓名",
"mtPosHeldCd": "001",
"prevServiceMth": 1,
"prevServiceYr": 2
}
},
"fac": {
"dtMaturity": "2017-05-03 15:12:27",
"intRate": 123,
"isRevolvingAllowed": "Y",
"lmtAppr": 123,
"mtFacCd": "P1011",
"mtFacPurCds": [
"1001",
"1002"
],
"mtRepymtTypCd": "001",
"mtTimeCd": "D",
"tenureAppr": "12"
}
}
个人私营业主
{
"col": [
{
"collOwner": "所有人",
"collValue": "111111",
"mtCollStyleCd": "ZY",
"mtCollTypCd": "DP",
"mtCollCatCd": "DP01",
"mtCollCd": "ZY0101001"
}
],
"cs_cust": {
"base": {
"bankCard": 1234556565,
"creditCardLines": 12345,
"custId": "0bbe35b8858345d19a",
"dtExpiry": "2017-05-03 15:12:25",
"dtIssue": "2017-05-03 15:12:25",
"email": "123@qq.com",
"idNo": "5cb86df87c874f9585",
"isBizEntity": "Y",
"isFamily": "Y",
"loanFixedYear": 11,
"mobileNo": "18888888888",
"yearIncAmt": 100000,
"mtCityCd": "110100",
"mtEduLvlCd": "01",
"mtGenderCd": "M",
"mtIndvMobileUsageStsCd": "01",
"mtJobSectorCd": "10000",
"mtMaritalStsCd": "02",
"mtResidenceStsCd": "01",
"nm": "个人私营",
"qq": 12345,
"weChat": "1234",
"portrait": "{\"芝麻信用分\":\"750\"}"
},
"business": {
"bizAddr": "北京",
"bizArea": "电子商务",
"bizRegNo": "d67402dae31b481",
"currentTotal": 123,
"electricityDosage": 123,
"employees": "22",
"equityLine": 123,
"isLegalRep": "Y",
"mtIndDetailCd": "a0111",
"mtJobSectorCd": "10000",
"ratal": 123,
"salaryTotal": 123,
"socialSecurity": 123,
"waterDosage": 123
}
},
"fac": {
"dtMaturity": "2017-05-03 15:12:25",
"intRate": 123,
"isRevolvingAllowed": "Y",
"lmtAppr": 123,
"mtFacCd": "P1011",
"mtFacPurCds": [
"1001",
"1002"
],
"mtRepymtTypCd": "001",
"mtTimeCd": "D",
"tenureAppr": "12"
}
}
返回示例(正常)
{
"appId":"0092728480d24f5d87bf63639b5cfe1c"
}
返回示例(异常)
{
"error": "500",
"message": "没有获取到用户身份信息",
"timestamp": "2016-12-29 15:10:32"
}