《统一征信平台_外围系统接口详细设计说明书_佛山V0.4.docx》由会员分享，可在线阅读，更多相关《统一征信平台_外围系统接口详细设计说明书_佛山V0.4.docx（34页珍藏版）》请在金锄头文库上搜索。
1、 佛山农商行统一征信平台_外围系统接口详细设计说明书 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.Ir
2、b002 获取征信查询结果文件93.1.4.Irb003单笔征信查询28北京宇信易诚科技有限公司 第 4 页 共 33 页第1章. 概述以下接口都是外围系统通过前置系统发起，征信查询管理系统系统处理结果做出响应：地市前置交易码征信平台交易码描述31150001Irb001提交征信批量查询文件31150002Irb002获取征信查询结果文件31150003Irb003 提交单笔征信查询请求第2章. 设计方案第3章. 接口规范3.1.1. 报文头说明3.1.1.1. 请求报文头字段名说明数据类型备注data_len报文长度long6个字节，用ASCII码表示的数据长度。其值为不包含该数据长度字段，
3、但包括交易码字段的长度。不足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
4、(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机构号码Ope
5、r柜员号码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台湾同胞
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身份信息查询）证件类型为身份证时查
7、询类型可选身份信息核查，其他情况只能选择信用报告查询occurDate10查询日期input_id8登陆征信平台员工号input_br_id20登陆机构query_way查询方式（1本地库优先2实时查询人行库）local_keep_days本地征信数据有效期（查询方式为1本地库优先，才需要录入）批量查询文件示例 cmis20120101001001张三0440111198803103015032002014031000001000001130 cmis20120101001002李四044011119880310301503200201403100000100000123.1.2.5. 应答报
8、文结构字段名 字段属性 字段描述 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
9、.1. 描述征信查询管理平台接收到外围系统的请求报后，通过三个任务调度完成业务处理。任务调度一：征信报告查询。系统查询征信记录登记表，逐条查询本地库或者人行征信库，获取人行报告。任务调度二：人行征信报告解析，形成结构化数据。系统根据html规范来解析人行报告，将解析结果保存到征信数据库。任务调度三：结构化数据组装成换回文件，上传前置系统服务器。 处理流程图3.1.4. Irb002获取征信查询结果文件3.1.4.1. 交易描述外围系统通过前置系统向征信平台发送报文请求后，轮询向征信平台发送“获取指定批次的征信查询结果文件”请求。征信查询管理平台根据外围系统的“获取指定批次的征信查询结果文件”请
10、后，返回对应批次的处理结果信息。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查询请求时间
