2.1.2 融资申请创建

优质
小牛编辑
124浏览
2023-12-01

描述

支持个人、企业融资申请创建。融资申请创建成功后,需要保存响应参数中的“申请ID”,作为后续交易的请求参数。

当借款人已存在一笔新建或审批中的申请时,再次创建新申请会不允许创建(以证件号和证件类型作为条件)。

API代码

loan_app:app:create

请求参数

借款人为个人时,需要提供:

1. 个人借款人信息
    - 基本信息
    - 职业信息(非个体工商户/私营业主)
    - 经营信息(个体工商户/私营业主)
2. 资金需求信息
3. 担保信息(可录入多个,但至少有一个,无实物担保的情况需要填写信用或保证担保)

(个人借款人的联系人信息通过借款人配偶信息借款人亲朋信息接口提交)

借款人为企业时,需要提供:

1. 企业借款人信息
2. 联系人信息(可录入多个,但至少有一个)
3. 资金需求信息
4. 担保信息(可录入多个,但至少有一个,无实物担保的情况需要填写信用或保证担保)

具体定义如下:

名称类型是否必须描述
cp_custJSON企业借款人信息,与个人借款人信息同时只能存在一个,见企业借款人信息
cs_custJSON个人借款人信息,与企业借款人信息同时只能存在一个,见个人借款人信息
contactsJSON(List)联系人信息(企业专用),见联系人信息
facJSON资金需求信息 (企业、个人共用), 见资金需求信息
colJSON(List)担保信息 (企业、个人共用), 见担保信息
callbackURLString授信状态变更后通知回调URL( 如:http://api.xxxx.com/ljt/callback ),见授信状态变更通知回调

企业借款人信息

名称类型是否必须最大长度描述示例值
custIdString50借款人在平台方的客户ID或编号,能够唯一标识某一客户00927284
nmString300企业名称(与营业执照上一致)北京某某公司
bizRegNoString50营业执照号码
idNoString50中征码/贷款卡
isCombString1是否三证合一
brandNmString200核心产品及品牌
coreBizString255主营业务
isFreeTradeAreaString1是否自贸易区
mtCifCatCdString20控股经济分类与代码
mtCityCdString20所在城市
mtCorpSalutationCdString20公司类型
mtIndDetailCdString20行业类型
websiteString50网址
dtRegisteredDate注册日期
incomeTaxNoString20地税登记号
nationalTaxNoString20国税登记号
registeredAddrString20注册地址
bizAddrString50经营地址
dtStartDate开始营业日期
noOfBizSiteNumber3营业网点数量(单位/个)
employeeCntNumber30 (26,4)从业人数(单位/人)
mtListedCdString20是否上市
paidUpCapitalNumber30 (26,4)实收资本(单位/万元)
authCapitalNumber30 (26,4)注册资本(单位/万元)
bizLandAreaNumber8经营场地面积(单位/平方米)
mtBizLandOwnerCdString20经营场地所有权
saleAmtNumber30 (26,4)近一年销售额(单位/元)
assetAmtNumber30 (26,4)资产价值(单位/元)
ratalNumber14 (12,2)近一年纳税额(单位/元)
socialSecurityNumber (12,2)14近一年社保缴存额(单位/元)
equityLineNumber14 (12,2)近一年公积金缴存额(单位/元)
waterDosageNumber14 (12,2)近一年用水量(单位/吨)
electricityDosageNumber14 (12,2)近一年用电量(单位/度)
salaryTotalNumber14 (12,2)近一年发放工资(单位/元)
mtSalaryTypCdString1工资发放方式
principalNoString20经营电话/负责人电话
mtFinInsttnCdString20基本开户行
portraitJSON1000客户画像{"行业地位":"市场占有率第一"}
bizCertificatesJSON(List)经营许可证信息

经营许可证信息

经营许可证信息由三部分组成:经营许可证编号、经营许可证类型、经营许可证到期日

名称类型是否必须最大长度描述示例值
noString50经营许可证编号
mtBizCertificateTypCdString2经营许可证类型
dtExpiryDate经营许可证到期日

个人借款人信息

个人借款人信息由三部分组成:

名称类型是否必须描述备注
baseJSON基本信息
employJSON职业信息基本信息中“是否为个体工商户/私营业主”为否时必须填写
businessJSON经营信息基本信息中“是否为个体工商户/私营业主”为是时必须填写

基本信息

名称类型是否必须最大长度描述示例值
custIdString50借款人在平台方的客户ID或编号,能够唯一标识某一客户0092728480d24f5d8
nmString300借款人姓名(与身份证上相同)张三
idNoString50身份证号码
dtIssuedDate身份证签发日期
dtExpiryDate身份证到期日(长期身份证可以为空)
mtGenderCdString20性别
mtMaritalStsCdString20婚姻情况
mtEduLvlCdString20最高学历
mtResidenceStsCdString20本地居住情况
isFamilyString1是否自有房产
mtJobSectorCdString20职业
yearIncAmtString30 (26,4)近1年税后收入(单位/元)
emailString30电子邮箱
mtCityCdString20所在城市
mobileNoString20手机号
mtIndvMobileUsageStsCdString20手机使用年限
qqNumber15QQ号
weChatString50微信号
bankCardNumber14 (12,2)近一年银行卡流水总额
creditCardLinesNumber14 (12,2)信用卡额度
loanFixedYearNumber20贷款记录年限
isBizEntityString1是否个体工商户/私营业主
portraitJSON1000客户画像{"芝麻评分":"698"}
repaymentCardString30还款银行卡号622649671749152511

职业信息

“是否为个体工商户/私营业主”为 "否" 时必须输入:

名称类型是否必须最大长度描述示例值
employerNmString100工作单位
mtPosHeldCdString20职位
prevServiceYrNumber60工作年限(年)
prevServiceMthNumber12工作年限(月)
dtWorkInCurrIndustryDate从事现行业时间

经营信息

“是否为个体工商户/私营业主”为“是”时必须输入:

名称类型是否必须最大长度描述示例值
isLegalRepString1是否法定代表人
mtIndDetailCdString50行业类型
bizRegNoString50营业执照号
bizAddrString50经营地址
bizAreaString255经营范围
currentTotalNumber20 (18,2)近一年流水总额(单位:元)
waterDosageNumber14 (12,2)近一年用水量(单位:吨)
electricityDosageNumber14 (12,2)近一年用电量(单位:度)
ratalNumber14 (12,2)近一年纳税额(单位:元)
socialSecurityNumber14 (12,2)近一年社保缴存额 (单位:元)
equityLineNumber14 (12,2)近一年公积金缴存额 (单位:元)
employeesNumber14 (12,2)员工人数
salaryTotalNumber14 (12,2)近一年发放工资 (单位:元)

联系人信息(企业专用)

名称类型是否必须最大长度描述示例值
nmString100联系人姓名
mobileNoString20联系人手机号
mtCifContactCdString20与客户关系,借款人为个人时必需
mtPosHeldCdString20职位,借款人为企业时必需
emailString50联系人邮箱

资金需求信息

名称类型是否必须最大长度描述示例值
mtFacCdString20业务类型
lmtApprNumber30 (26,4)申请额度
dtMaturityDate到期日
tenureApprNumber6业务期限
mtTimeCdString1业务期限类型D-天、M-月、Y-年
mtRepymtTypCdString20偿还方式
isRevolvingAllowedString1授信额度是否可循环,默认为否Y/N
mtFacPurCdsJSON100资金用途,可输入多个
intRateNumber9 (5,4)年化利率
intRateInSuspenseNumber9 (5,4)罚息利率

担保信息

名称类型是否必须最大长度描述示例值
mtCollStyleCdString20担保方式BZ-保证;DY-抵押;ZY-质押;XY-信用
mtCollTypCdString20担保类型
mtCollCatCdString20担保品种
mtCollCdString20担保小类
collValueNumber20(18,2)担保品价值
isDepositString1是否保证金Y/N
collOwnerString50担保品所有者名称
  • 信用担保品示例
    {
      "col": [
          {
              "collOwner": "张三",//一般为借款人姓名
              "collValue": "30000000", //与申请额度相等
              "isDeposit": "N",//固定值
              "mtCollCatCd": "OA01",//信用担保品时,固定值
              "mtCollCd": "XY0101001",//信用担保品时,固定值
              "mtCollStyleCd": "XY",//信用担保品时,固定值
              "mtCollTypCd": "OA"//信用担保品时,固定值
          }
      ]
    }
    

响应参数

名称类型描述示例值
app_idString申请ID0092728480d24f5d87bf63639b5cfe1c

错误码

描述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"
}