个人接口格式对外发布的接口格式.docx

个人接口格式对外发布的接口格式.docx

《个人接口格式对外发布的接口格式.docx》由会员分享，可在线阅读，更多相关《个人接口格式对外发布的接口格式.docx（49页珍藏版）》请在冰豆网上搜索。

个人接口格式对外发布的接口格式

1接口说明

1.1概述

本文档主要说明接口填写要求及接口的格式要求,供商业银行业务系统开发人员或系统实施人员查看。

1.2填写说明

接口抽取程序须将每月的全量数据写入接口表中，报数系统在读取完接口中的数据后会自动清空接口表。

2接口格式

2.1交易信息（tiu_trade）

名称

字段

必填/选填

类型/长度

备注

姓名

NAME

必填

String（30）

在提取姓名字段时，要注意去除客户真实姓名前后可能存在的空格、姓名中含有的空格（英文名除外）、姓名后跟着的数字或英文字母等。

对于联合贷款，可能存在多个姓名连在一起但只有一个证件号码的情况，这时要设法从这几个姓名中选择那个与证件号码对应的姓名报送。

证件类型

CERTTYPE

String

（1）

代码表：

0-身份证；

1-户口簿；

2-护照；

3-军官证；

4-士兵证；

5-港澳居民来往内地通行证；

6-台湾同胞来往内地通行证；

7-临时身份证；

8-外国人居留证；

9-警官证；

X-其他证件。

按公安部规定，18位身份证号码的最后一位只能为0-9和“X”，商业银行在提取证件号码时，如果发现身份证的最后一位为小写字母“x”，应该统一用大写字母“X”替代。

证件号码

CERTNO

String（18）

数据发生机构代码

DEPTCODE

String（14）

征信中心下发的14位金融机构代码

业务种类

GENERALTYPE

String

（1）

代码表：

1-贷款；

2-信用卡。

业务种类细分

TYPE

String

（2）

代码表：

11-个人住房贷款；

12-个人商用房（包括商住两用）贷款；

13-个人住房公积金贷款；

21-个人汽车贷款；

31-个人助学贷款；

41-个人经营性贷款；

51-农户贷款；

71-准贷记卡；

81-贷记卡；

99-其他。

业务号

ACCOUNT

String（40）

商业银行自己定义和使用的，用来唯一标识本行内一笔贷款、准贷记卡账户或贷记卡账户的标识符。

业务种类为贷款时，此数据项为贷款业务号码，业务种类为信用卡且业务种类细分为准贷记卡时，此数据项为准贷记卡账号，业务种类为信用卡且业务种类细分为贷记卡时，此数据项为贷记卡账号。

发生地点

AREACODE

String（6）

申请地点的行政区划代码。

对于全国集中发卡或者网上发卡等无法判断其申请地点的，则填写受理申请机构所在地的行政区划代码。

要求地点填写到地市级。

编码采用GB/T2260-2002《中华人民共和国行政区划代码》的数字型代码，详见附录B。

开户日期

DATEOPENED

Date

格式为YYYYMMDD。

业务种类为贷款时，此数据项是指首次放款日期。

到期日期

DATECLOSED

Date

格式为YYYYMMDD。

业务种类为贷款时，此数据项为到期日期；业务种类为信用卡时，用20991231填充。

币种

CURRENCY

String（3）

此处填报的是账户开立时所使用的币种。

采用根据GB/T12406-1996《表示货币和资金的代码》和ISO/FDIS4217:

2000《货币和资金的代码》编制的三位字母型代码，详见附录B。

授信额度

CREDITLIMIT

Long（10）

业务种类为贷款时，此数据项是指贷款合同金额；业务种类为信用卡时，此数据项是指信用额度。

共享额度

SHAREACCOUNT

Long（10）

当业务种类为贷款时，‘共享授信额度’填写‘贷款合同金额’；当业务种类为信用卡时，对于存在额度共享的情况，在共享同一授信额度的账户记录中选择一条记录，填写‘共享授信额度’，在其他共享同一授信额度的账户记录中‘共享授信额度’填写0。

对于不存在额度共享的情况，必须将‘共享授信额度’填写为与‘1101-授信额度’相同的值。

最大负债额

MAXDEBT

Long（10）

业务种类为贷款时，此数据项表示在该项借款协议下的最高贷款余额，不含利息；业务种类为信用卡时，此数据项表示此卡的实际使用额度（透支）最高值，包括利息甚至罚息。

如果该数据项无法从业务系统中直接提取，那么在报送第一个月数据时，可以使用当月余额作为最大负债额，以后月在生成数据记录时，使用上个月的最大负债额与当前月的余额进行比较，取大的作为最大负债额。

担保方式

GUARANTEEWAY

Integer

（1）

代码表：

1-质押（含保证金）；

2-抵押；

3-自然人保证；

4-信用/免担保；

5-组合（含自然人保证）；

6-组合（不含自然人保证）；

7-农户联保；

9-其他。

法人担保暂不考虑，填“9-其他”，法人担保信息不需要出现在担保信息段内。

还款频率

TERMSFREQ

String

（2）

业务种类为贷款时，此数据项有意义，为该笔贷款连续两次还款时间的间隔。

代码表：

01-日；

02-周；

03-月；

04-季；

05-半年；

06-年；

07-一次性；

08-不定期（贷款期限内任意时间还款）；

99-其他。

业务种类为信用卡时，用C填充。

“一次性还款利随本清”的还款频率为一次性。

“分次付息一次还本”还款频率为按利息的还款频率填，本月应还款金额填还款计划表的每月应还利息。

还款月数

MONTHDURATION

Long（3）

业务种类为贷款时，此数据项为借款人的该笔贷款总期数折合的月数。

业务种类为信用卡时，用C填充。

对于业务种类为贷款的各种还款频率，填报说明如下：

定期还款

●还款频率为天：

除以30.42

●还款频率为周：

除以4.33

●还款频率为月：

实际总还款期数

●还款频率为季：

乘以3

●还款频率为半年：

乘以6

●还款频率为年：

乘以12

数值向上取整。

不定期还款-用U填充；

一次性还款-用O填充；

其他类型还款-用X填充。

剩余还款月数

MONTHUNPAID

Long（3）

业务种类为贷款时，此数据项为借款人的该笔贷款剩余还款期数折合的月数。

业务种类为信用卡时用C填充。

对于业务种类为贷款的各种还款频率，填报说明如下：

定期还款

●还款频率为天：

除以30.42

●还款频率为周：

除以4.33

●还款频率为月：

实际剩余还款期数

●还款频率为季：

乘以3

●还款频率为半年：

乘以6

●还款频率为年：

乘以12

数值向上取整。

不定期还款-用U填充；

一次性还款-用O填充；

其他类型还款-用X填充。

对于非定期贷款，无论是否结清，其“剩余还款月数”都与“还款月数”相同。

在计算定期贷款的“剩余还款月数”时，所使用的期数不包括至今仍拖欠未还的那些期数，专指按照还款计划表应该在当前结算/应还款日到到期日期之间偿还的贷款期数。

结算_应还款日期

BILLINGDATE

Date

格式为YYYYMMDD。

业务种类为贷款：

此数据项为应还款日期。

若当月需要还款，则为当月最后一次应还款日期。

若当月不需还款，如按季、半年、年或不定期等非还款月时，则为当月最后一天。

例如，当月新开户且不需要还款时，“结算/应还款日期”填当月最后一天。

对于已经到期但尚未结清（包括核销）的贷款，每个月的“结算/应还款日期”按照到期之前的“结算/应还款日期”逐月顺推。

业务种类为信用卡：

对于准贷记卡，“结算/应还款日”就是商业银行每月的出单日（结算日）。

对于贷记卡，“结算/应还款日”严格说来应该是每月的到期还款日（持卡人应该在这一天之前还清他这个月的最低还款额）。

但是，考虑到每月的到期还款日和出单日比较接近，为了商业银行生成报文的方便，就把这个日子规定为商业银行的出单日。

需要强调的是，为了如实反映每一个账户每一期的还款情况，应该在每个账户当月的“结算/应还款日期”结束后立即生成该账户的当月报送记录。

即，该账户的当月报送记录所反映的账户状态信息应该截止到当月的“结算/应还款日期”结束。

最近一次实际还款日期

RECENTPAYDATE

Date

格式为YYYYMMDD。

自账户开立以来无还款历史的账户，其最近一次实际还款日期填报开户日期。

如果业务系统中没有记录最近一次实际还款日期，就要开发补丁程序去保存该数据项。

对于以前的存量数据，确实无法推算最近一次实际还款日期的，根据当月是否逾期来填写该数据项。

当月的还款状态正常，如果当月需要还款则“最近一次实际还款日期”取当月的“结算/应还款日期”；如果当月不需要还款则“最近一次实际还款日期”与上个月报送记录中的该数据项取相同值。

当月的还款状态逾期，“最近一次实际还款日期”取上个月报送记录中该数据项的值。

本月应还款金额

SCHEDULEDAMOUNT

Long（10）

到期前：

业务种类为贷款：

根据还款计划表，借款人应在连续两个结算/应还款日期间的归还的累计金额不包括该结算周期之外的未归还欠款）。

按年、按季、按月、一次性还款，如果本月不需还款，用0填充。

业务种类为信用卡：

业务种类细分为准贷记卡时，此数据项是指累计透支额与利息之和，等于上月透支余额＋本月透支总额＋相应利息额；业务种类细分为贷记卡时，此数据项为上一结算周期计算出的最低还款额。

到期后：

为所欠全部金额。

在计算过程中，出现本月应还款金额、余额、当前逾期总额等小于1元的小数时，如果银行认为该账户逾期，那么对相应的金额字段进行向上取整，反之，则向下取零。

实际还款金额

ACTUALPAYAMOUNT

Long（10）

业务种类为贷款：

此数据项是指借款人在连续两个结算/应还款日期间的实际还款金额总和。

实际还款金额反映的是该账户实际接收到的还款总额，在出现担保人代还和以资抵债情况时，“实际还款金额”包含担保人代还部分和以资抵债部分。

业务种类为信用卡：

业务种类细分为准贷记卡时，此数据项是指累计还款额，即借款人在连续两个结算/应还款日期间偿还透支部分的金额合计；业务种类细分为贷记卡时，此数据项是指借款人在连续两个结算/应还款日期间的实际还款金额总和，不包括存款部分。

余额

BALANCE

Long（10）

业务种类为贷款：

此数据项是指贷款余额，此处余额指本金。

业务种类为信用卡：

业务种类细分为准贷记卡时，此数据项是指透支余额；业务种类细分为贷记卡时，此数据项是指已使用额度。

贷记卡和准贷记卡的余额包含利息。

当前逾期期数

CURTERMSPASTDUE

Long

（2）

业务种类为贷款：

此数据项为当前应还未还的贷款期数。

如果以资抵债且资不抵债，此数据项继续累计。

业务种类为信用卡：

业务种类细分为贷记卡时，此数据项为当前连续未还最低还款额次数；业务种类细分为准贷记卡时，用0填充。

当前逾期总额

AMOUNTPASTDUE

Long（10）

业务种类为贷款：

此数据项为当前应还未还的贷款本息之和。

如果以资抵债且资不抵债，此数据项继续累计。

业务种类为信用卡：

业务种类细分为贷记卡时，此数据项为当前连续未还最低还款额总额，包括利息（含罚息）和费用（包括超限费和滞纳金）；业务种类细分为准贷记卡时，用0填充。

逾期31－60天未归还贷款本金

AMOUNTPASTDUE30

Long（10）

业务种类为贷款时，此数据项有意义；业务种类为信用卡时，用0填充。

计算时按月。

如果以资抵债且资不抵债，此数据项继续累计。

逾期61－90天未归还贷款本金

AMOUNTPASTDUE60

Long（10）

业务种类为贷款时，此数据项有意义；业务种类为信用卡时，用0填充。

计算时按月。

如果以资抵债且资不抵债，此数据项继续累计。

逾期91－180天未归还贷款本金

AMOUNTPASTDUE90

Long（10）

业务种类为贷款时，此数据项有意义；业务种类为信用卡时，用0填充。

计算时按月。

如果以资抵债且资不抵债，此数据项继续累计。

逾期180天以上未归还贷款本金

APASTDUE180

Long（10）

业务种类为贷款时，此数据项有意义；业务种类为信用卡时，用0填充。

计算时按月。

如果以资抵债且资不抵债，此数据项继续累计。

违约次数

TERMSPASTDUE

Long（3）

业务种类为贷款：

为自贷款开立以来，违约次数的总和，逾期一期算作违约一次。

业务种类为信用卡：

业务种类细分为贷记卡时，为12个月内未还最低还款额次数；业务种类细分为准贷记卡时，用0填充。

如果该数据项无法直接从业务系统中提取，可以从当前月开始计算，初始值填“当前逾期期数”。

最高逾期期数

MAXTERMSPASTDUE

Long

（2）

业务种类为贷款：

表示当前逾期期数的历史最大值。

如果以资抵债且资不抵债，此数据项继续累计。

业务种类为信用卡：

业务种类细分为贷记卡时，此数据项为12个月内连续未还最低还款额次数的最大值；业务种类细分为准贷记卡时，用0填充。

如果无法直接从业务系统中提取该数据项，可以从数据报送第一个月开始计算，初始值统一填“当前逾期期数”，以后与每个月的当前逾期期数进行比较，取大的那个。

五级分类状态

CLASS5STAT

Integer

（1）

代码表：

1-正常；

2-关注；

3-次级；

4-可疑；

5-损失；

9-未知。

帐户状态

ACCOUNTSTAT

Integer

（1）

反映金融机构对该贷款或信用风险程度的评估。

一个账户只要有应还未还的情况，账户状态就算逾期，而不是整个账户到期后未还清才算逾期。

一次还本，按期还息。

利息未还，也算逾期。

代码表：

业务种类为贷款：

1-正常；

2-逾期；

3-结清；

4-呆账。

业务种类为信用卡：

1-正常；

2-冻结；

3-止付；

4-销户；

5-呆账。

当月还款状态

PAYSTAT24MONTH

String

（1）

业务种类为贷款：

代码表：

/-未开立账户；

*-当月不需还款，且账户状态为正常。

即：

按照还款计划表，当月不需要还款；而且也没有以前拖欠的贷款需要还。

对于贷款，当还款周期大于月时，在该账户当前没有逾期的情况下，该笔贷款还款计划中的非还款月皆用“*”填写（按照还款计划表，当月不需还款，就填“*”）；当该账户逾期的情况下，该笔贷款还款计划中的非还款月继续按照实际逾期期数填写。

N-正常（借款人已经按时归还该月应还款金额的全部，且该账户没有逾期）；

提前归还该月应还款金额的全部（但尚未结清），也归入“N-正常”。

1-表示逾期1-30天；

2-表示逾期31-60天；

3-表示逾期61-90天；

4-表示逾期91-120天；

5-表示逾期121-150天；

6-表示逾期151-180天；

7-表示逾期180天以上；

D-担保人代还（表示借款人的该笔贷款已由担保人代还，包括担保人按期代还与担保人代还部分贷款）；

Z-以资抵债（表示借款人的该笔贷款已通过以资抵债的方式进行还款。

仅指以资抵债部分）；

C-结清（借款人的该笔贷款全部还清，贷款余额为0。

包括正常结清、提前结清、以资抵债结清、担保人代还结清等情况）；

G-结束（除结清外的，其他任何形态的终止账户，如核销）。

业务种类为信用卡：

业务种类细分为准贷记卡：

代码表：

/-未开立账户；

*-本月没有透支行为且上月该账户没有透支余额；

N-正常，是指准贷记卡透支后还清；

1-表示透支1-30天；

2-表示透支31-60天；

3-表示透支61-90天；

4-表示透支91-120天；

5-表示透支121-150天；

6-表示透支151-180天；

7-表示透支180天以上；

如果存在多笔透支且各笔透支天数不同，“24个月还款状态”中当月透支天数取透支最长天数。

对存在多笔透支的准贷记卡还部分款时，该笔还款按各商行规定确定还款归属（一般是还最前透支，也有挑着还款的），而部分还款后的透支天数取剩余透支天数中最大值。

C-结清的销户；

G-结束（除结清外的，其他任何形态的终止账户）。

业务种类细分为贷记卡：

代码表：

/-未开立账户；

*-本月未使用额度且不需要还款；

N-正常，是指当月的最低还款额已被全部还清或透支后处于免息期内；

1-表示未还最低还款额1次；

2-表示连续未还最低还款额2次；

3-表示连续未还最低还款额3次；

4-表示连续未还最低还款额4次；

5-表示连续未还最低还款额5次；

6-表示连续未还最低还款额6次；

7-表示连续未还最低还款额7次及以上；

C-结清的销户；

G-结束（除结清外的，其他任何形态的终止账户）。

附：

“24个月（账户）还款状态”的填写是以该账户当月的实际状态来填写。

对于贷款来讲，本月如果是担保人代还，就填‘D’，如果以后发生应还未还的行为，就按逾期多少天的实际状态填写，如果是按周还款，就以当月最后一次还款状态填写。

考虑到各行业务系统的现状，在系统运行初期，增加一项“#-账户已开立，但当月状态未知”。

但随着时间的推移，各行报送的数据中最终不应该出现“#”。

2.2人员自然信息（tiu_person）

名称

字段

必填/选填

类型/长度

备注

姓名

NAME

必填

String（30）

在提取姓名字段时，要注意去除客户真实姓名前后可能存在的空格、姓名中含有的空格（英文名除外）、姓名后跟着的数字或英文字母等。

对于联合贷款，可能存在多个姓名连在一起但只有一个证件号码的情况，这时要设法从这几个姓名中选择那个与证件号码对应的姓名报送。

对于姓名，规定中文名字只能含有汉字和特殊字符“·”。

证件类型

CERTTYPE

必填

String

（1）

代码表：

0-身份证；

1-户口簿；

2-护照；

3-军官证；

4-士兵证；

5-港澳居民来往内地通行证；

6-台湾同胞来往内地通行证；

7-临时身份证；

8-外国人居留证；

9-警官证；

X-其他证件。

按公安部规定，18位身份证号码的最后一位只能为0-9和“X”，商业银行在提取证件号码时，如果发现身份证的最后一位为小写字母“x”，应该统一用大写字母“X”替代。

证件号码

CERTNO

必填

String（18）

数据发生机构代码

DEPTCODE

必填

String（14）

性别

Gender

必填

Integer

（1）

代码表：

0-未知的性别；

1-男性；

2-女性；

9-未说明性别。

出生日期

BIRTHDAY

必填

Date

格式为

YYYYMMDD。

无法填报时，统一填“19010101”。

婚姻状况

MARRIAGE

必填

Integer

（2）

代码表：

10-未婚；

20-已婚；

21-初婚；

22-再婚；

23-复婚；

30-丧偶；

40-离婚；

90-未说明的婚姻状况。

最高学历

EDULEVEL

必填

Integer

（2）

代码表：

10-研究生；

20-大学本科（简称“大学”）；

30-大学专科和专科学校（简称“大专”）；

40-中等专业学校或中等技术学校；

50-技术学校；

60-高中；

70-初中；

80-小学；

90-文盲或半文盲；

99-未知。

最高学位

EDUDEGREE

必填

Integer

（1）

代码表：

0-其他；

1-名誉博士；

2-博士；

3-硕士；

4-学士；

9-未知。

配偶姓名

SPOUSE_NAME

选填

String（30）

配偶证件号码

SPOUSE_CERTNO

选填

String

（1）

代码表：

0-身份证；

1-户口簿；

2-护照；

3-军官证；

4-士兵证；

5-港澳居民来往内地通行证；

6-台湾同胞来往内地通行证；

7-临时身份证；

8-外国人居留证；

9-警官证；

X-其他证件。

配偶证件类型

SPOUSE_CERTTYPE

选填

String（18）

配偶工作单位

SPOUSE_OFFICE

选填

String（60）

配偶联系电话

SPOUSE_TEL

选填

String（25）

住宅电话

HOMETEL

选填

String（25）

手机号码

MOBILETEL

选填

String（16）

单位电话

OFFICETEL

选填

String（25）

电子邮件地址

EMAIL

选填

String（30）

通讯地址

ADDRESS

必填

String（60）

包含省市县（区）等详细信息。

此处填报的是月结单地址。

通讯邮政编码

ZIP

必填

String（6）

无法填报时，统一填“999999”。

户籍地址

RESIDENCE

选填

String（60）

包含省市县（区）等详细信息。

2.3就业信息（tiu_emp）

名称

对应接口系统的字段

必填/选填

类型/长度

备注

姓名

NAME

同身份信息

证件类型

CERTTYPE

证件号码

CERTNO

数据发生机构代码

DEPTCODE

职业

OCCUPATION

必填

String

（1）

代码表：

0-国家机关、党群组织、企业、事业单位负责人；

1-专业技术人员；

3-办事人员和有关人员；

4-商业、服务业人员；

5-农、林、牧、渔、水利业生产人员；

6-生产、运输设备操作人员及有关人员；

X-军人；

Y-不便分类的其他从业人员；

Z-未知。

单位名称

COMPANY

必填

String（60）

无法填报时，暂时填“暂缺”。

单位所属行业

INDUSTRY

必填

String

（1）

代码表：

A-农、林、牧、渔业；

B-采掘业；

C-制造业；

D-电力、燃气及水的生产和供应业；

E-建筑业；

F-交通运输、仓储和邮政业；

G-信息传输、计算机服务和软件业；

H-批发和零售业；

I-住宿和餐饮业；

J-金融业；

K-房地产业；

L-租赁和商务服务业；

M-科学研究、技术服务业和地质勘察业；N-水利、环境和公共设施管理业；

O-居民服务和其他服务业；

P-教育；

Q-卫生、社会保障和社会福利业；

R-文化、体育和娱乐业；

S-公共管理和社会组织；

T-国际组织；

Z-未知。

单位地址

OCCADDRESS

选填

String（60）

包含省市县（区）等详细信息。

单位邮政编码

OCCZIP

选填

String（6）

本单位工作起始年份

STARTYEAR

选填

Integer（4）

格式为YYYY。

在本单位工作的起始年份

本人职务

DUTY

必填

Integer

（1）

代码表：

1-高级领导（行政级别局级及局级以上领导或大公司高级管理人员）；

2-中级领导（行政级别局级以下领导或大公司中级管理人员）；

3-一般员工；

4-其他；

9-未知。

本人职称

CASTE

必填

Integer

（1）

专业技术职务的称谓。

代码表：

0-无；

1-高级；

2-中级；

3-初级；

9-未知。

年收入

ANNUALINCOME

选填

Integer（10）

账户拥有者在申请表中填报的年收入。

2.4居住信息（tiu_address）