Skip to content

Latest commit

 

History

History
464 lines (432 loc) · 18 KB

05_app_create.md

File metadata and controls

464 lines (432 loc) · 18 KB

融资申请创建

描述

支持个人、企业融资申请创建。融资申请创建成功后，需要保存响应参数中的“申请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年税后收入(单位/元)
email String 否 30 电子邮箱
mtCityCd String 是 20 所在城市
mobileNo String 是 20 手机号
mtIndvMobileUsageStsCd String 否 20 手机使用年限
qq Number 否 15 QQ号
weChat 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 职位，借款人为企业时必需
email 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"
}

FAQ

关于此文档暂时还没有FAQ