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

1、个人接口格式对外发布的接口格式1 接口说明1.1 概述本文档主要说明接口填写要求及接口的格式要求,供商业银行业务系统开发人员或系统实施人员查看。1.2 填写说明接口抽取程序须将每月的全量数据写入接口表中，报数系统在读取完接口中的数据后会自动清空接口表。2 接口格式2.1 交易信息(tiu_trade)名称字段必填/选填类型/长度备注姓名NAME必填String(30)在提取姓名字段时，要注意去除客户真实姓名前后可能存在的空格、姓名中含有的空格（英文名除外）、姓名后跟着的数字或英文字母等。对于联合贷款，可能存在多个姓名连在一起但只有一个证件号码的情况，这时要设法从这几个姓名中选择那个与证件号码对

2、应的姓名报送。证件类型CERTTYPEString(1)代码表：0-身份证；1-户口簿；2-护照；3-军官证；4-士兵证；5-港澳居民来往内地通行证；6-台湾同胞来往内地通行证；7-临时身份证；8-外国人居留证；9-警官证；X-其他证件。按公安部规定，18位身份证号码的最后一位只能为0-9和“X”，商业银行在提取证件号码时，如果发现身份证的最后一位为小写字母“x”，应该统一用大写字母“X”替代。证件号码CERTNOString(18)数据发生机构代码DEPTCODEString(14)征信中心下发的14位金融机构代码业务种类GENERALTYPEString(1)代码表：1-贷款；2-信用卡。

3、业务种类细分TYPEString(2)代码表：11-个人住房贷款；12-个人商用房（包括商住两用）贷款；13-个人住房公积金贷款；21-个人汽车贷款；31-个人助学贷款；41-个人经营性贷款；51-农户贷款；71-准贷记卡；81-贷记卡；99-其他。业务号ACCOUNTString(40)商业银行自己定义和使用的，用来唯一标识本行内一笔贷款、准贷记卡账户或贷记卡账户的标识符。业务种类为贷款时，此数据项为贷款业务号码，业务种类为信用卡且业务种类细分为准贷记卡时，此数据项为准贷记卡账号，业务种类为信用卡且业务种类细分为贷记卡时，此数据项为贷记卡账号。发生地点 AREACODEString(6)申请

4、地点的行政区划代码。对于全国集中发卡或者网上发卡等无法判断其申请地点的，则填写受理申请机构所在地的行政区划代码。要求地点填写到地市级。编码采用GB/T 2260-2002中华人民共和国行政区划代码的数字型代码，详见附录B。开户日期DATEOPENEDDate格式为YYYYMMDD。业务种类为贷款时，此数据项是指首次放款日期。到期日期DATECLOSEDDate格式为YYYYMMDD。业务种类为贷款时，此数据项为到期日期；业务种类为信用卡时，用20991231填充。币种 CURRENCYString(3)此处填报的是账户开立时所使用的币种。采用根据GB/T 12406-1996表示货币和资金的代

5、码和ISO/FDIS 4217:2000货币和资金的代码编制的三位字母型代码，详见附录B。授信额度 CREDITLIMITLong(10)业务种类为贷款时，此数据项是指贷款合同金额；业务种类为信用卡时，此数据项是指信用额度。共享额度 SHAREACCOUNTLong(10)当业务种类为贷款时，共享授信额度填写贷款合同金额；当业务种类为信用卡时，对于存在额度共享的情况，在共享同一授信额度的账户记录中选择一条记录，填写共享授信额度，在其他共享同一授信额度的账户记录中共享授信额度填写0。对于不存在额度共享的情况，必须将共享授信额度填写为与1101-授信额度相同的值。最大负债额MAXDEBTLong(

6、10)业务种类为贷款时，此数据项表示在该项借款协议下的最高贷款余额，不含利息；业务种类为信用卡时，此数据项表示此卡的实际使用额度（透支）最高值，包括利息甚至罚息。如果该数据项无法从业务系统中直接提取，那么在报送第一个月数据时，可以使用当月余额作为最大负债额，以后月在生成数据记录时，使用上个月的最大负债额与当前月的余额进行比较，取大的作为最大负债额。担保方式GUARANTEEWAYInteger(1)代码表： 1-质押（含保证金）；2-抵押；3-自然人保证；4-信用/免担保；5-组合（含自然人保证）；6-组合（不含自然人保证）；7-农户联保；9-其他。法人担保暂不考虑，填“9-其他”，法人担保信

7、息不需要出现在担保信息段内。还款频率TERMSFREQString(2)业务种类为贷款时，此数据项有意义，为该笔贷款连续两次还款时间的间隔。代码表：01-日；02-周；03-月；04-季；05-半年；06-年；07-一次性；08-不定期（贷款期限内任意时间还款）；99-其他。业务种类为信用卡时，用C填充。“一次性还款利随本清”的还款频率为一次性。“分次付息一次还本”还款频率为按利息的还款频率填，本月应还款金额填还款计划表的每月应还利息。还款月数MONTHDURATIONLong(3)业务种类为贷款时，此数据项为借款人的该笔贷款总期数折合的月数。业务种类为信用卡时，用C填充。对于业务种类为贷款的

8、各种还款频率，填报说明如下：定期还款 还款频率为天：除以30.42 还款频率为周：除以4.33 还款频率为月：实际总还款期数 还款频率为季：乘以3 还款频率为半年：乘以6 还款频率为年：乘以12数值向上取整。不定期还款-用U填充；一次性还款-用O填充；其他类型还款-用X填充。剩余还款月数MONTHUNPAIDLong(3)业务种类为贷款时，此数据项为借款人的该笔贷款剩余还款期数折合的月数。业务种类为信用卡时用C填充。对于业务种类为贷款的各种还款频率，填报说明如下：定期还款 还款频率为天：除以30.42 还款频率为周：除以4.33 还款频率为月：实际剩余还款期数 还款频率为季：乘以3 还款频率为

9、半年：乘以6 还款频率为年：乘以12数值向上取整。不定期还款-用U填充；一次性还款-用O填充；其他类型还款-用X填充。对于非定期贷款，无论是否结清，其“剩余还款月数”都与“还款月数”相同。在计算定期贷款的“剩余还款月数”时，所使用的期数不包括至今仍拖欠未还的那些期数，专指按照还款计划表应该在当前结算/应还款日到到期日期之间偿还的贷款期数。结算_应还款日期BILLINGDATEDate格式为YYYYMMDD。业务种类为贷款：此数据项为应还款日期。若当月需要还款，则为当月最后一次应还款日期。若当月不需还款，如按季、半年、年或不定期等非还款月时，则为当月最后一天。例如，当月新开户且不需要还款时，“结

10、算/应还款日期”填当月最后一天。对于已经到期但尚未结清（包括核销）的贷款，每个月的“结算/应还款日期”按照到期之前的“结算/应还款日期”逐月顺推。业务种类为信用卡：对于准贷记卡，“结算/应还款日”就是商业银行每月的出单日（结算日）。对于贷记卡，“结算/应还款日”严格说来应该是每月的到期还款日（持卡人应该在这一天之前还清他这个月的最低还款额）。但是，考虑到每月的到期还款日和出单日比较接近，为了商业银行生成报文的方便，就把这个日子规定为商业银行的出单日。需要强调的是，为了如实反映每一个账户每一期的还款情况，应该在每个账户当月的“结算/应还款日期”结束后立即生成该账户的当月报送记录。即，该账户的当月

11、报送记录所反映的账户状态信息应该截止到当月的“结算/应还款日期”结束。最近一次实际还款日期RECENTPAYDATEDate格式为YYYYMMDD。自账户开立以来无还款历史的账户，其最近一次实际还款日期填报开户日期。如果业务系统中没有记录最近一次实际还款日期，就要开发补丁程序去保存该数据项。对于以前的存量数据，确实无法推算最近一次实际还款日期的，根据当月是否逾期来填写该数据项。当月的还款状态正常，如果当月需要还款则“最近一次实际还款日期”取当月的“结算/应还款日期”；如果当月不需要还款则“最近一次实际还款日期”与上个月报送记录中的该数据项取相同值。当月的还款状态逾期，“最近一次实际还款日期”取

12、上个月报送记录中该数据项的值。本月应还款金额SCHEDULEDAMOUNTLong(10)到期前： 业务种类为贷款：根据还款计划表，借款人应在连续两个结算/应还款日期间的归还的累计金额不包括该结算周期之外的未归还欠款）。按年、按季、按月、一次性还款，如果本月不需还款，用0填充。业务种类为信用卡： 业务种类细分为准贷记卡时，此数据项是指累计透支额与利息之和，等于上月透支余额本月透支总额相应利息额；业务种类细分为贷记卡时，此数据项为上一结算周期计算出的最低还款额。到期后：为所欠全部金额。在计算过程中，出现本月应还款金额、余额、当前逾期总额等小于1元的小数时，如果银行认为该账户逾期，那么对相应的金额

13、字段进行向上取整，反之，则向下取零。实际还款金额 ACTUALPAYAMOUNTLong(10)业务种类为贷款：此数据项是指借款人在连续两个结算/应还款日期间的实际还款金额总和。实际还款金额反映的是该账户实际接收到的还款总额，在出现担保人代还和以资抵债情况时，“实际还款金额”包含担保人代还部分和以资抵债部分。业务种类为信用卡： 业务种类细分为准贷记卡时，此数据项是指累计还款额，即借款人在连续两个结算/应还款日期间偿还透支部分的金额合计；业务种类细分为贷记卡时，此数据项是指借款人在连续两个结算/应还款日期间的实际还款金额总和，不包括存款部分。余额BALANCELong(10)业务种类为贷款：此数

14、据项是指贷款余额，此处余额指本金。业务种类为信用卡：业务种类细分为准贷记卡时，此数据项是指透支余额；业务种类细分为贷记卡时，此数据项是指已使用额度。贷记卡和准贷记卡的余额包含利息。当前逾期期数 CURTERMSPASTDUELong(2)业务种类为贷款：此数据项为当前应还未还的贷款期数。如果以资抵债且资不抵债，此数据项继续累计。业务种类为信用卡：业务种类细分为贷记卡时，此数据项为当前连续未还最低还款额次数；业务种类细分为准贷记卡时，用0填充。当前逾期总额AMOUNTPASTDUELong(10)业务种类为贷款：此数据项为当前应还未还的贷款本息之和。如果以资抵债且资不抵债，此数据项继续累计。业务

15、种类为信用卡：业务种类细分为贷记卡时，此数据项为当前连续未还最低还款额总额，包括利息（含罚息）和费用（包括超限费和滞纳金）；业务种类细分为准贷记卡时，用0填充。逾期3160天未归还贷款本金AMOUNTPASTDUE30Long(10)业务种类为贷款时，此数据项有意义；业务种类为信用卡时，用0填充。计算时按月。如果以资抵债且资不抵债，此数据项继续累计。逾期6190天未归还贷款本金AMOUNTPASTDUE60Long(10)业务种类为贷款时，此数据项有意义；业务种类为信用卡时，用0填充。计算时按月。如果以资抵债且资不抵债，此数据项继续累计。逾期91180天未归还贷款本金AMOUNTPASTDUE

16、90Long(10)业务种类为贷款时，此数据项有意义；业务种类为信用卡时，用0填充。计算时按月。如果以资抵债且资不抵债，此数据项继续累计。逾期180天以上未归还贷款本金APASTDUE180Long(10)业务种类为贷款时，此数据项有意义；业务种类为信用卡时，用0填充。计算时按月。如果以资抵债且资不抵债，此数据项继续累计。违约次数 TERMSPASTDUELong(3)业务种类为贷款：为自贷款开立以来，违约次数的总和，逾期一期算作违约一次。业务种类为信用卡：业务种类细分为贷记卡时，为12个月内未还最低还款额次数；业务种类细分为准贷记卡时，用0填充。如果该数据项无法直接从业务系统中提取，可以从当

17、前月开始计算，初始值填“当前逾期期数”。最高逾期期数 MAXTERMSPASTDUELong(2)业务种类为贷款：表示当前逾期期数的历史最大值。如果以资抵债且资不抵债，此数据项继续累计。业务种类为信用卡：业务种类细分为贷记卡时，此数据项为12个月内连续未还最低还款额次数的最大值；业务种类细分为准贷记卡时，用0填充。如果无法直接从业务系统中提取该数据项，可以从数据报送第一个月开始计算，初始值统一填“当前逾期期数”，以后与每个月的当前逾期期数进行比较，取大的那个。五级分类状态CLASS5STAT Integer(1)代码表：1-正常；2-关注；3-次级；4-可疑；5-损失；9-未知。帐户状态 AC

18、COUNTSTATInteger(1)反映金融机构对该贷款或信用风险程度的评估。一个账户只要有应还未还的情况，账户状态就算逾期，而不是整个账户到期后未还清才算逾期。一次还本，按期还息。利息未还，也算逾期。代码表：业务种类为贷款：1-正常； 2-逾期； 3-结清；4-呆账。业务种类为信用卡：1-正常； 2-冻结；3-止付；4-销户；5-呆账。当月还款状态PAYSTAT24MONTHString(1)业务种类为贷款： 代码表：/-未开立账户；*-当月不需还款，且账户状态为正常。即：按照还款计划表，当月不需要还款；而且也没有以前拖欠的贷款需要还。对于贷款，当还款周期大于月时，在该账户当前没有逾期的情

19、况下，该笔贷款还款计划中的非还款月皆用“*”填写（按照还款计划表，当月不需还款，就填“*”）；当该账户逾期的情况下，该笔贷款还款计划中的非还款月继续按照实际逾期期数填写。N-正常（借款人已经按时归还该月应还款金额的全部，且该账户没有逾期）；提前归还该月应还款金额的全部（但尚未结清），也归入“N-正常”。1-表示逾期1-30天；2-表示逾期31-60天；3-表示逾期61-90天；4-表示逾期91-120天；5-表示逾期121-150天；6-表示逾期151-180天；7-表示逾期180天以上；D-担保人代还（表示借款人的该笔贷款已由担保人代还，包括担保人按期代还与担保人代还部分贷款）；Z-以资抵债

20、（表示借款人的该笔贷款已通过以资抵债的方式进行还款。仅指以资抵债部分）；C-结清（借款人的该笔贷款全部还清，贷款余额为0。包括正常结清、提前结清、以资抵债结清、担保人代还结清等情况）；G-结束（除结清外的，其他任何形态的终止账户，如核销）。业务种类为信用卡：业务种类细分为准贷记卡：代码表：/-未开立账户；*-本月没有透支行为且上月该账户没有透支余额；N-正常，是指准贷记卡透支后还清；1-表示透支1-30天；2-表示透支31-60天；3-表示透支61-90天；4-表示透支91-120天；5-表示透支121-150天；6-表示透支151-180天；7-表示透支180天以上；如果存在多笔透支且各笔透

21、支天数不同，“24个月还款状态”中当月透支天数取透支最长天数。对存在多笔透支的准贷记卡还部分款时，该笔还款按各商行规定确定还款归属（一般是还最前透支，也有挑着还款的），而部分还款后的透支天数取剩余透支天数中最大值。C-结清的销户；G-结束（除结清外的，其他任何形态的终止账户）。业务种类细分为贷记卡：代码表：/-未开立账户；*-本月未使用额度且不需要还款；N-正常，是指当月的最低还款额已被全部还清或透支后处于免息期内； 1-表示未还最低还款额1次；2-表示连续未还最低还款额2次；3-表示连续未还最低还款额3次；4-表示连续未还最低还款额4次；5-表示连续未还最低还款额5次；6-表示连续未还最低还

22、款额6次；7-表示连续未还最低还款额7次及以上；C-结清的销户；G-结束（除结清外的，其他任何形态的终止账户）。附：“24个月（账户）还款状态”的填写是以该账户当月的实际状态来填写。对于贷款来讲，本月如果是担保人代还，就填D，如果以后发生应还未还的行为，就按逾期多少天的实际状态填写，如果是按周还款，就以当月最后一次还款状态填写。考虑到各行业务系统的现状，在系统运行初期，增加一项“ #-账户已开立，但当月状态未知”。但随着时间的推移，各行报送的数据中最终不应该出现“#”。2.2 人员自然信息(tiu_person)名称字段必填/选填类型/长度备注姓名NAME必填String(30)在提取姓名字段

23、时，要注意去除客户真实姓名前后可能存在的空格、姓名中含有的空格（英文名除外）、姓名后跟着的数字或英文字母等。对于联合贷款，可能存在多个姓名连在一起但只有一个证件号码的情况，这时要设法从这几个姓名中选择那个与证件号码对应的姓名报送。对于姓名，规定中文名字只能含有汉字和特殊字符“”。证件类型CERTTYPE必填String(1)代码表：0-身份证；1-户口簿；2-护照；3-军官证；4-士兵证；5-港澳居民来往内地通行证；6-台湾同胞来往内地通行证；7-临时身份证；8-外国人居留证；9-警官证；X-其他证件。按公安部规定，18位身份证号码的最后一位只能为0-9和“X”，商业银行在提取证件号码时，如果

24、发现身份证的最后一位为小写字母“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)代

25、码表：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-临

26、时身份证；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

27、”。户籍地址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)无法填报

28、时，暂时填“暂缺”。单位所属行业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选填Stri

29、ng(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)