统一征信平台_外围系统接口详细设计说明书_佛山V0..docx

佛山农商行统一征信平台_外围系统接口详细设计说明书 Document number 文档编号 Confidentiality level 密级 内部公开Document version 文档版本 V1.0佛山农商行征信查询管理系统征信平台_外围系统接口详细设计说明书Revision Record 修订记录Date日期Revision Version修订版本Sec No. 修改章节Change Description修改描述Author作者目 录第1章.概述4第2章.设计方案4第3章.接口规范43.1.1.Irb001提交征信批量查询文件43.1.2.征信系统后台处理逻辑说明83.1.3.Irb002 获取征信查询结果文件93.1.4.Irb003单笔征信查询28北京宇信易诚科技有限公司 第 33 页 共 33 页第1章. 概述以下接口都是外围系统通过前置系统发起，征信查询管理系统系统处理结果做出响应：地市前置交易码征信平台交易码描述31150001Irb001提交征信批量查询文件31150002Irb002获取征信查询结果文件31150003Irb003 提交单笔征信查询请求第2章. 设计方案第3章. 接口规范3.1.1. 报文头说明3.1.1.1. 请求报文头字段名说明数据类型备注data_len报文长度long6个字节，用ASCII码表示的数据长度。其值为不包含该数据长度字段，但包括交易码字段的长度。不足6个字节左补“0”，例如：报文体长度为128，则数据长度表示为“000128”。tx_code地市前置交易码char(8)chn_no发起渠道char(6)信贷系统：040300flag预留标志为char(8)3.1.1.1. 应答报文头字段名说明数据类型备注data_len报文长度long6个字节，用ASCII码表示的数据长度。其值为不包含该数据长度字段，但包括交易码字段的长度。不足6个字节左补“0”，例如：报文体长度为128，则数据长度表示为“000128”。tx_code地市前置交易码char(8)chn_no发起渠道char(6)chn_no发起渠道char(6)信贷系统：040300flag预留标志为char(8)3.1.2. Irb001提交征信批量查询文件3.1.2.1. 交易描述外围系统将需要查询人行征信的客户信息组成xml文件，发送文件到文件服务器。然后通过前置系统向征信平台发送征信批量查询请求信息，请求信息记载所上传到文件服务器的征信查询文件路径及名称。征信平台接收到外围系统的请求报文后，根据请求报文的信息从件服务器提取文件，然后返回文件提取成功标志给外围系统。 3.1.2.1. 交互流程图3.1.2.2. 接口交易码Irb001 方法名：3.1.2.3. 请求报文结构字段名 字段属性 字段描述 TxnCd交易码Brch机构号码Oper柜员号码AuthOper授权柜员AuthPwd授权密码BatNo请求批次号(渠道名称+日期+3位流水)FileDesc上传文件目录FileName上传文件名称PrtDt上传文件日期QryEndTm上传文件时间ChanlNo上传渠道3.1.2.4. 批量查询文件结构字段名 字段属性 字段描述 QueryRecordId35外部记录流水号要求外围系统发送过来的记录标识流水号, 用于说明记信息，征信系统不做内部逻辑处理，不能为空。采用queryid+(3位流水)userName30姓名cerType1证件类型(0身份证 ，1户口簿，2护照，3军官证，4士兵证， 5港澳居民来往内地通行证，6台湾同胞来往内地通行证，7临时身份证， 8外国人居留证， 9警官征， A香港身份证，B澳门身份证，C台湾身份证，X其他证件)cerCode18证件号码queryReason2查询原因(01贷后管理，02贷款审批， 03信用卡审批，08担保资格审查，05异议核查，16公积金提取复核，19特约商户实名审查，)verType2信用报告版式(20 2011银行版，22 2011银行异议版，）查询原因为异议核查时信用报告版式为“异议版”，其他情况为银行版idauthFlag1查询类型（0信用报告查询，3信用报告查询含身份信息核查，1身份信息核查，4信用报告查询含身份信息查询，2身份信息查询）证件类型为身份证时查询类型可选身份信息核查，其他情况只能选择信用报告查询occurDate10查询日期input_id8登陆征信平台员工号input_br_id20登陆机构query_way查询方式（1本地库优先2实时查询人行库）local_keep_days本地征信数据有效期（查询方式为1本地库优先，才需要录入）批量查询文件示例 cmis20120101001001张三0440111198803103015032002014031000001000001130 cmis20120101001002李四044011119880310301503200201403100000100000123.1.2.5. 应答报文结构字段名 字段属性 字段描述 TxnCd交易码ReqSeqNo请求流水SvrSeqNo应答响应流水FaultCode信息标识FaultString失败原因SvrDate交易 日期SvrTime交易 时间BatNo请求批次号(渠道名称+日期+3位流水)Status状态（0登记成功，1登记失败，系统已经有相同请求批次号）3.1.2.6. 征信平台系统处理l 解析请求报文，并将解析的请求报文信息保存入表。l 根据外围系统的请求报中给出的xml文件路径和名称，从文件服务器提取文件。l 解析请求文件，将解析的记录登记到征信查询记录表。l 返回接口报文。3.1.3. 征信系统后台处理逻辑说明3.1.3.1. 描述征信查询管理平台接收到外围系统的请求报后，通过三个任务调度完成业务处理。任务调度一：征信报告查询。系统查询征信记录登记表，逐条查询本地库或者人行征信库，获取人行报告。任务调度二：人行征信报告解析，形成结构化数据。系统根据html规范来解析人行报告，将解析结果保存到征信数据库。任务调度三：结构化数据组装成换回文件，上传前置系统服务器。 处理流程图3.1.4. Irb002获取征信查询结果文件3.1.4.1. 交易描述外围系统通过前置系统向征信平台发送报文请求后，轮询向征信平台发送“获取指定批次的征信查询结果文件”请求。征信查询管理平台根据外围系统的“获取指定批次的征信查询结果文件”请后，返回对应批次的处理结果信息。3.1.4.1. 交互流程图3.1.4.1. 接口交易码Irb002 方法名：3.1.4.2. 请求报文结构字段名 字段属性 字段描述 TxnCd交易码Brch机构号码Oper柜员号码AuthOper授权柜员AuthPwd授权密码BatNo请求批次号(渠道名称+日期+3位流水)3.1.4.3. 应答报文结构字段名 字段属性 字段描述 TxnCd交易码ReqSeqNo请求流水SvrSeqNo应答响应流水FaultCode信息标识FaultString失败原因SvrDate交易 日期SvrTime交易 时间BatNo请求批次号(渠道名称+日期+3位流水)Flag处理结果（01无对应请求批次号，从前置系统服务器提取查询文件失败，解析查询文件失败，待查询,查询中,查询成功等）FileDesc查询成功后，上传文件服务器路径FileName查询成功后，上传文件服务器文件名称3.1.4.4. 征信查询结果文件结构字段名称所属表名备注字段说明QueryRecordId信息记录说明外部记录流水号status1. 查询成功2. 查询请求失败mark查询说明REPORT_ID报告编号QUERYDATE查询请求时间QUERIER查询操作员QUERYREASON查询原因QUERYREASON查询原因ID人行查询记录结果信息TBL_PBOC_RESULT_INFOIDBAR_CODEBAR_CODEREPORT_SN报告编号QUERY_TIME查询请求时间REPORT_CREATE_TIME报告时间NAME被查询者姓名CERT_TYPE被查询者证件类型CERT_NO被查询者证件号码QUERY_REASON查询原因QUERY_ORG查询机构USER_CODE查询操作员ID人行个人身份信息TBL_PBOC_PERSIONAL_INFOIDREPORT_ID报告编号GENDER性别BIRTHDAY出生日期MARITAL_STSTE婚姻状况MOBILE手机号码OFFICE_TELEPHONE_NO单位电话HOME_TELEPHONE_NO住宅电话EDU_LEVEL学历EDU_DEGREE学位POST_ADDRESS通讯地址REGISTERED_ADDRESS户籍地址SPOUSE_NAME配偶姓名SPOUSE_CERT_TYPE配偶证件类型SPOUSE_CERT_NO配偶证件号码SPOUSE_EMPLOYER配偶工作单位SPOUSE_TELEPHOME_NO配偶联系电话ID人行个人居住信息TBL_PBOC_RESIDENCE_INFOIDREPORT_ID报告编号ADDRESS居住地址RESIDENCE_TYPE居住状况GET_TIME信息更新日期ID人行个人职业信息TBL_PBOC_PROFESSIONALIDREPORT_ID报告编号EMPLOYER工作单位EMPLOYER_ADDRESS单位地址OCCUPATION职业INDUSTRY行业DUTY职务TITLE职称START_YEAR进入本单位年份GET_TIME信息更新日期ID人行个人信贷汇总TBL_PBOC_INFO_SUMARRYIDREPORT_ID报告编号HOUSE_LOAN_COUNT住房贷款笔数OTHER_LOAN_COUNT其他贷款笔数FIRST_LOAN_OPEN_MONTH首笔贷款发放月份LOAN_CARD_COUNT贷记卡账户数FIRST_LOAN_CARD_OPEN_MONTH首张贷记卡发卡月份STANDARD_LOAN_CARD_COUNT准贷记卡账户数F_STANDARD_LOAN_CARD_OPENMONTH首张准贷记卡发卡卡月份ANNOUNCE_COUNT本人声明数目DISSENT_COUNT异议标注数目SCORE中征信评分SCORE_MONTH评分月份FELL_BACK_COUNT呆账笔数FELL_BACK_BALANCE呆账余额ASSET_DISS_COUNT资产处置笔数ASSET_DISS_BALCNCE资产处置余额ASSURE_REPAY_COUNT保证人呆账笔数ASSURE_REPAY_BALANCE保证人代偿余额LOAN_OVERDUE_COUNT贷款逾期笔数LOAN_OVERDUE_MONTHS贷款逾期月份数LOAN_OVERDUE_HIGEST_AMOUNT_P_M贷款逾期单月最高逾期总额LOAN_OVERDUE_MAX_DURATION贷款逾期最长逾期月数LOAN_CARD_OVERDUE_COUNT贷记卡逾期账户数LOAN_CARD_OVERDUE_MONTHS贷记卡逾期月份数LOAN_CARD_OVERDUE_H_AMOUNT_P_M贷记卡逾期单月最高逾期总额LOAN_CARD_OVERDUE_MAX_DURATION贷记卡逾期最长逾期月数S_LOAN_CARD_ODUE_COUNT准贷记卡60天以上透支账户数S_LOAN_CARD_ODUE_MONTHS准贷记卡60天以上透支月份数S_LOAN_CARD_ODUE_H_AMOUNT_P_M准贷记卡60天以上透支单月最高透支余额S_LOAN_CARD_ODUE_MAX_DURATION准贷记卡60天以上透支最长透支月数UNPAIDLOAN_FINANCE_CORP_COUNT未结清贷款法人机构数UNPAIDLOAN_FINANCE_ORG_COUNT未结清贷款机构数UNPAIDLOAN_ACCOUNT_COUNT未结清贷款笔数UNPAIDLOAN_CREDIT_LIMIT未结清贷款合同总额UNPAIDLOAN_BALANCE未结清贷款余额UNPAIDLOAN_LASTSIX_MONTH_REPAY未结清贷款最近6个月平均还款金额UNDESTYRYLOANCARD_FANC_COUNT发卡法人机构数UNDESTYRYLOANCARD_ORG_COUNT发卡机构数UNDESTYRYLOANCARD_ACCOUNTCOUN账户数UNDESTYRYLOANCARD_CREDIT_LIMIT授信总额UNDESTYRYLOANCARD_MAX_CREDIT单家行最高授信额UNDESTYRYLOANCARD_MIN_CREDIT单家行最低授信额UNDESTYRYLOANCARD_USED_CREDIT已用额度UNDESTYRYLOANCARD_USED_AVG_6最近6个月平均使用额度UNDESTYRYSLOANCARD_FANC_COUNT未销户准记卡发卡法人机构数UNDESTYRYSLOANCARD_ORG_COUNT未销户准记卡发卡机构数UNDESTYRYSLOANCARD_ACCOUNTCOUN未销户准记卡账户数UNDESTYRYSLOANCARD_CREDITLIMIT未销户准记卡授信总额UNDESTYRYSLOANCARD_MAX_CREDIT单家行最高授信额（准记卡）UNDESTYRYSLOANCARD_MIN_CREDIT单家行最低授信额（准记卡）UNDESTYRYSLOANCARD_USED_CREDIT未销户准记卡透支余额UNDESTYRYSLOANCARD_USED_AVG_6未结清贷款最近6个月平均透支金额GUAR_COUNT对外担保笔数GUAR_AMOUNT对外担保金额GUAR_BALANCE对外担保本金余额ID人行贷款汇总信息TBL_PBOC_LOAN_INFOIDREPORT_ID报告编号STATE贷款状态CLASS5STATE五级分类BALANCE本金余额REMAINPAYMENTCYC剩余还款期数SCHEDULEDPAYMENTAMOUNT本月应还款SCHEDULEDPAYMENTDATE应还款日ACTUALPAYMENTAMOUNT本月实还款RECENTPAYDATE最近一次还款日期CURROVERDUECYC当前逾期期数CURROVERDUEAMOUNT当前逾期金额OVERDUE31TO60AMOUNT逾期3160天未还本金OVERDUE61TO90AMOUNT逾期6190天未还本金OVERDUE91TO180AMOUNT逾期91180天未还本金OVERDUEOVER180AMOUNT逾期180天以上未还本金LAST24MONTHBEGINMONTH24月的还款记录起始年月LAST24MONTHENDMONTH24月的还款记录结束年月LATEST24STATE24月的还款记录LOAN_ID贷款标识号CUE信贷交易信息ID人行贷记卡汇总信息TBL_PBOC_LOAN_CARD_INFOIDREPORT_ID报告编号CARD_TYPE卡类型CUE贷记卡信息说明STATE账户状态STATEENDDATE账户有效截止日期STATEENDMONTHSTATEENDMONTHSHARECREDITLIMITAMOUNT共享额度USEDCREDITLIMITAMOUNT已用额度LATEST6MONTHUSEDAVGAMOUNT最近6个月平均使用额度USEDHIGHESTAMOUNT最大使用额度SCHEDULEDPAYMENTDATE账单日SCHEDULEDPAYMENTAMOUNT本月应还款ACTUALPAYMENTAMOUNT本月实还款OVERDUEOVER180AMOUNT透支180天以上未付余额GUANANTEEMONEY保证金额RECENTPAYDATE最近一次还款日期CURROVERDUECYC当前逾期期数CURROVERDUEAMOUNT当前逾期金额BEGINMONTH_24MONTH还款开始月份（还款记录）ENDMONTH_24MONTH还款结束月份（还款记录）LAST_24STATE24月还款记录PRI_BARCODE人行个人住房公积金信息TBL_CRE_PB_RF_INFOPRI_BARCODEPRI_NUM报告编号PRI_ACCOUNT参缴地PRI_EMP缴费单位PRI_OA_DATE参缴日期PRI_FIRST_HOT_DATE初缴月份PRI_LAST_HOT_DATE缴至月份PRI_PAY_DEPOSIT_COM单位缴存比例PRI_PAY_DEPOSIT_PER个人缴存比例PRI_MONTH_PAY_DEPOSIT月缴存额PRI_INFO_DATE信息更新日期PRI_24_MONTH_RETST缴费状态ID人行个人养老保险金信息TBL_PBOC_PUBLICINFOIDREPORT_ID报告编号AREA参保地REGISTERDATE参保日期MONTHDURATION累计缴费月数WORKDATE参加工作月份STATE缴费状态OWNBASICMONEY个人缴费基数MONEY本月缴费金额ORGANNAME缴费单位PAUSEREASON中断或终止缴费原因GETTIME信息更新日期ID人行查询记录历史信息TBL_PBOC_QUERY_HISIDREPORT_NO报告编号BARCODEBARCODEQUERY_RESULT查询原因QUERY_DATE查询日期QUERY_USER查询操作员ID人行个人担保信息TBL_PBOC_GUARANTEEIDREPORT_ID报告编号ORGANNAME担保贷款发放机构CONTRACTMONEY担保贷款合同金额BEGINDATE担保贷款发放日期ENDDATE担保贷款到期日期GUANANTEEMONEY担保金额GUARANTEEBALANCE担保贷款本金余额CLASS5STATE担保贷款五级分类BILLINGDATE结算日期ID人行个人欠税记录信息TBL_PBOC_TAXARREARIDREPORT_ID报告编号ORGANNAME主管税务机关TAXARREAAMOUNT欠税总额REVENUEDATE欠税统计日期ID人行个人民事判决信息TBL_PBOC_CIVILJUDGEMENTIDREPORT_ID报告编号COURT立案法院CASEREASON事由REGISTERDATE立案日期CLOSEDTYPE结案方式CASERESULT判决/调解结果CASEVALIDATEDATE判决/调解生效日期SUITOBJECT诉讼标的SUITOBJECTMONEY诉讼标的金额ID人行个人强制执行记录信息TBL_PBOC_FORCEEXECUTIONIDREPORT_ID报告编号COURT执行法院CASEREASON执行案由REGISTERDATE立案日期CLOSEDTYPE结案方式CASESTATE案件状态CLOSEDDATE结案日期ENFORCEOBJECT申请执行标的ENFORCEOBJECTMONEY申请执行标的价值ALREADYENFORCEOBJECT已执行标的ALREADYENFORCEOBJECTMONEY已执行标的金额ID人行个人行政处罚记录信息TBL_PBOC_ADMINPUNISHMENTIDREPORT_ID报告编号ORGANNAME处罚机构CONTENT处罚内容MONEY处罚金额BEGINDATE生效日期ENDDATE截止日期RESULT行政复议结果ID人行个人养老保险金发放记录信息TBL_PBOC_ENDOWMENTINSURANCEDELIDREPORT_ID报告编号AREA发放地RETIRETYPE离退休类别RETIREDDATE离退休月份WORKDATE参加工作月份MONEY本月实发养老金PAUSEREASON停发原因ORGANNAME原单位名称GETTIME信息更新日期ID人行个人低保救助信息TBL_PBOC_SALVATIONIDREPORT_ID报告编号PERSONNELTYPE人员类别AREA所在地ORGANNAME工作单位MONEY家庭月收入REGISTERDATE申请日期PASSDATE批准日期GETTIME信息更新日期ID人行个人执业资格信息TBL_PBOC_COMPETENCEIDREPORT_ID报告编号COMPETENCYNAME执业资格名称GRADE等级AWARDDATE获得日期ENDDATE到期日期REVOKEDATE吊销日期ORGANNAME颁发机构AREA机构所在地ID人行个人行政奖励信息TBL_PBOC_ADMINAWARDIDREPORT_ID报告编号ORGANNAME奖励机构CONTENT奖励内容BEGINDATE生效日期ENDDATE截止日期日期IDTBL_PBOC_VEHICLEIDREPORT_ID报告编号ENGINECODE发动机号LICENSECODE车牌号码BRAND品牌CARTYPE车辆类型USECHARACTER使用性质STATE车辆状态PLEDGEFLAG抵押标记GETTIME信息更新日期ID人行个人车辆交易和抵押记录信息TBL_PBOC_TELPAYMENTIDREPORT_ID报告编号ORGANNAME电信运营商TYPE业务类型REGISTERDATE业务开通日期STATE当前缴费状态ARREARMONEY当前欠费金额ARREARMONTHS当前欠费月数STATUS24最近24个月缴费记录GETTIME记账年月ID人行贷款逾期记录信息TBL_PBOC_OVERDUERECORDIDLOAN_ID贷款标识号MONTH逾期月份LASTMONTHS逾期持续月数AMOUNT逾期金额IDTBL_PBOC_RECORDSUMMARYNIDREPORT_IDY报告编号LOAN_COUNTY贷款审批查询次数CREDIT_COUNTY信用卡审批查询次数PSP_COUNTY贷后管理查询次数GUAR_COUNTY担保资格审查查询次数SPECIALCUS_COUNTY特约商户实名审查QUERY_CYCLEY查询周期IDTBL_PBOC_RECORDDETAIL_HISNIDQUERY_DATEY查询日期QUERIERY查询操作员QUERY_REASONY查询原因REPORT_IDY报告编号HTML_FILE_PATHHTML_FILE返回的html文件下载Html文件路径HTML_FILE_NAMEHtml文件名征信查询结果文件示例/用区分一条记录 cmis201201010012查询失败、登陆人行失败 cmis201201010021查询本地库成功 /人行个人身份信息，只有一笔记录 女性 1978.09.12 已婚02373222380 73333703 大学本科（简称大学) 其他 佛山市石柱县瑞通路1号佛山农村商业银行股份有限公司石柱支行南 佛山市石柱县南宾镇县委家属院 - - - - /人行个人职业信息，可能有多笔记录,用区别 376 2014021300001582470012 佛山农村商业银行股份有限公司石 佛山市石柱县瑞