《统一征信平台_外围系统接口详细设计说明书_佛山v0.2》由会员分享，可在线阅读，更多相关《统一征信平台_外围系统接口详细设计说明书_佛山v0.2（31页珍藏版）》请在金锄头文库上搜索。
1、 佛山农商行统一征信平台_外围系统接口详细设计说明书 北京宇信易诚科技有限公司 第 1 页 共 31 页Document number 文档编号 Confidentiality level 密级 内部公开Document version 文档版本 V1.0佛山农商行征信查询管理系统征信佛山农商行征信查询管理系统征信平台平台_外围系统接口详细设计说明书外围系统接口详细设计说明书佛山农商行统一征信平台_外围系统接口详细设计说明书 北京宇信易诚科技有限公司 第 2 页 共 31 页Revision Record 修订记录Date日期Revision Version修订版本Sec No. 修改章节Ch
2、ange Description修改描述Author作者佛山农商行统一征信平台_外围系统接口详细设计说明书 北京宇信易诚科技有限公司 第 3 页 共 31 页目目 录录第第 1 章章.概述概述.4第第 2 章章.设计方案设计方案.4第第 3 章章.接口规范接口规范.43.1.1.Irb001 提交征信批量查询文件.4 3.1.2.征信系统后台处理逻辑说明.8 3.1.3.Irb002 获取征信查询结果文件.9 3.1.4.Irb003 单笔征信查询.28佛山农商行统一征信平台_外围系统接口详细设计说明书 北京宇信易诚科技有限公司 第 4 页 共 31 页第第 1 章章. 概述概述以下接口都是外
3、围系统通过前置系统发起，征信查询管理系统系统处理结果做出响应：第第 2 章章. 设计方案设计方案第第 3 章章. 接口规范接口规范3.1.1. Irb001 提交征信批量查询文件提交征信批量查询文件3.1.1.1.交易描述交易描述外围系统将需要查询人行征信的客户信息组成 xml 文件，发送文件到文件服务器。然后通过前置系统向征信平台发送征信批量查询请求信息，请求信息记载所上传到文件服务器的征信查询文件路径及名称。征信平台接收到外围系统的请求报文后，根据请求报文的信息从件服务器提取文件，然后返回文件提取成功标志给外围系统。 3.1.1.1.交互流程图交互流程图小企 系统文件 服务1.上传征信查询
4、文件Irb001提交征信批量查询文件Irb002获取征信查询结果文件Irb003 提交单笔征信查询请求佛山农商行统一征信平台_外围系统接口详细设计说明书 北京宇信易诚科技有限公司 第 5 页 共 31 页小企 系统文件 服务征信 查询 系统前置 系统1.发送征信批量查询请求2.转发发送征信批量查询请求3.文件服务器提取文件4.返回文件提取成功标志5.转发返回文件提取成功标志3.1.1.2.接口交易码接口交易码Irb001 方法名：3.1.1.3.请求报文结构请求报文结构字段名 字段属性 字段描述 TxnCd交易码Brch机构号码Oper柜员号码AuthOper授权柜员AuthPwd授权密码Ba
5、tNo请求批次号(渠道名称+日期+3 位 流水)FileDesc上传文件目录FileName上传文件名称PrtDt上传文件日期QryEndTm上传文件时间ChanlNo上传渠道3.1.1.4.批量查询文件结构批量查询文件结构字段名 字段属性 字段描述 QueryRecordId35外部记录流水号要求外围系统发送过来的记录标识流水号, 用于说明记信息，征信系统不做内部逻辑处理，不能为空。采用 queryid+(3 位流水)userName30姓名佛山农商行统一征信平台_外围系统接口详细设计说明书 北京宇信易诚科技有限公司 第 6 页 共 31 页cerType1证件类型(0 身份证 ，1 户口簿
6、，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 信用报告查询，
7、3 信用报告查询含身份信息核查，1 身份信息核查，4 信用报告查询含身份信息查询，2 身份信息查询）证件类型为身份证时查询类型可选身份信息核查，其他情况只能选择信用报告查询佛山农商行统一征信平台_外围系统接口详细设计说明书 北京宇信易诚科技有限公司 第 7 页 共 31 页occurDate10查询日期input_id8登陆征信平台员工号input_br_id20登陆机构query_way查询方式（1 本地库优先 2 实时查询人行库）local_keep_days本地征信数据有效期（查询方式为1 本地库优先，才需要录入）批量查询文件示例cmis20120101001001张三 04401111
8、98803103015032002014031000001000001130cmis20120101001002李四 04401111988031030150320020140310000010000012佛山农商行统一征信平台_外围系统接口详细设计说明书 北京宇信易诚科技有限公司 第 8 页 共 31 页3.1.1.5.应答报文结构应答报文结构字段名 字段属性 字段描述 TxnCd交易码ReqSeqNo请求流水SvrSeqNo应答响应流水FaultCode信息标识FaultString失败原因SvrDate交易 日期SvrTime交易 时间BatNo请求批次号(渠道名称+日期+3 位 流水)
9、Status状态（0 登记成功，1 登记失败， 系统已经有相同请求批次号）3.1.1.6.征信平台系统处理征信平台系统处理解析请求报文，并将解析的请求报文信息保存入表。 根据外围系统的请求报中给出的 xml 文件路径和名称，从文件服务器提取文件。 解析请求文件，将解析的记录登记到征信查询记录表。 返回接口报文。3.1.2. 征信系统后台处理逻辑说明征信系统后台处理逻辑说明3.1.2.1.描述描述征信查询管理平台接收到外围系统的请求报后，通过三个任务调度完成业务处理。任务调度一：征信报告查询。系统查询征信记录登记表，逐条查询本地库或者人行征信库，获取人行报告。任务调度二：人行征信报告解析，形成结
10、构化数据。系统根据 html 规范来解析人行报告，将解析结果保存到征信数据库。任务调度三：结构化数据组装成换回文件，上传前置系统服务器。佛山农商行统一征信平台_外围系统接口详细设计说明书 北京宇信易诚科技有限公司 第 9 页 共 31 页文件 服务征信 查询 系统 2.文件服务器提取文件人行 征信 系统1.逐笔查询人行征信处理流程图3.1.3. Irb002获取征信查询结果文件获取征信查询结果文件3.1.3.1.交易描述交易描述外围系统通过前置系统向征信平台发送报文请求后，轮询向征信平台发送“获取指定批次的征信查询结果文件”请求。征信查询管理平台根据外围系统的“获取指定批次的征信查询结果文件”
11、请后，返回对应批次的处理结果信息。3.1.3.1.交互流程图交互流程图小企 系统文件 服务征信 查询 系统前置 系统1.发送获取征信查询结果文件请求5.提取结果文件2.转发获取征信查询结果文件请求3.返回处理结果信息4.转发处理结果信息3.1.3.1.接口交易码接口交易码Irb002 方法名：佛山农商行统一征信平台_外围系统接口详细设计说明书 北京宇信易诚科技有限公司 第 10 页 共 31 页3.1.3.2.请求报文结构请求报文结构字段名 字段属性 字段描述 TxnCd交易码Brch机构号码Oper柜员号码AuthOper授权柜员AuthPwd授权密码BatNo请求批次号(渠道名称+日期+3
12、 位 流水)3.1.3.3.应答报文结构应答报文结构字段名 字段属性 字段描述 TxnCd交易码ReqSeqNo请求流水SvrSeqNo应答响应流水FaultCode信息标识FaultString失败原因SvrDate交易 日期SvrTime交易 时间BatNo请求批次号(渠道名称+日期+3 位 流水)Flag处理结果（01 无对应请求批次号， 从前置系统服务器提取查询文件 失败，解析查询文件失败，待查 询,查询中,查询成功等）FileDesc查询成功后，上传文件服务器路 径FileName查询成功后，上传文件服务器文 件名称3.1.3.4.征信查询结果文件结构征信查询结果文件结构字段名称所属表名备 注字段说明QueryRecordId 外部记录流水号status信息记录说明1.查询成功2.查询请求失败mark查询说明佛山农商行统一征信平台_外围系统接口详细设计说明书 北京宇信易诚科技有限公司 第 11 页 共 31 页REPORT_ID 报告编号QUERYDATE 查询请求时间QUERIER 查询操作员QUERY
