银企互连系统企业开发手册.doc

第1章概述银企互联面向大的集团客户，提供与企业ERP系统直连的平台，为工行的现金管理服 务捉供多渠道和客户化支持企业ERP系统通过HTTPS协议与工行系统进行连接并向银企互联前置发送数据，数 据的接口格式使用标准的xml数据格式，但双方通讯的过程中则需要遵守下文描述的规定 银企互联前置接到企业数据后进行一系列的检查后完成交易，并将处理结果以企业便于处 理的形式返回给企业在安全保证方面，通讯层的安全保证是HTTPS协议企业如需使用银企互联系统，要办理有关注册手续，并审领证书企业进行结算类交易时，如果涉及到授权过程，企业盂要在金业网银系统中完成相关 授权动作银企互连系统将企业提交的支付指令或者授权成功后的指令当作最终转账指 令，根据提交指令的证书ID检查收付方帐号等合法性，以保证所提交指令在权限允许范 围内进行操作第2章总体方案介绍2.1总体网络结构图银企“联系统上图企业ERP系统1采用的是非NC方式接入的客户：企业ERP系统2采用的是NC方式 接入的客户；2.2企业端安全服务器简介此服务器只对使用NC方式接入的客户有效企业端安全服务器被称为NetSafe Cliento它有两个可以配置的端口分别用于加密和签名/验签服务，如下图所示（假设1为加密端口,2为签名/验签端口）。

1. http交易请求包•1 （加密）A2「交易结果1.签名/验签请求NetSafe ClientA2 （签名/验签）I签名/验签结果https交易i青求包具体使用时，企业应用向工行提交交易请求时，可以依照http协议向NetSafe Client 的端口 1发送请求接到请求后，NetSafe Client使用金业证书将http请求包转换成https请 求包发往工行端服务器；如來需要对某些交易数据进行签名，则企业应用需要与签名端口建 立Socket连接并将待签名数据发往端口 2,然后接收端口 2的签名结果，之后再将包含签 名信息的交易请求发往端口1而完成整个交易请求过程对签名还是验签名请求的区分则是通过http包头来进行Content-Type: INFOSEC_SIGN/i.O 和 Content-Type: INFOSEC_VERIFY_SIGN/1.0 分别用于标识签名请求 和 验签名 请求，而 Content-Type: INFOSEC_SIGN_RESULT/1.0 和 Content-Type: INFOSEC_VERIFY_SIGN_RESUET/1.0分别用丁标识签名和验签名的返回结果。

为方便起见，可以将NetSafe Client的两个服务端口逻辑地称为两台服务器，NetSafe Client的加密服务器和签名服务器2.3安全控制介绍对于NC方式接入的客户/ 企业向工行提交的交易数据，必须通过企业方的NetSafe Client进行与工行服务器的连接，接口确定需要签名的数据也必须由NetSafe Client的签名服务器签名 后组成规定的数据包格式后，通过NetSafe Client提交工行，这样可以保证企业 数据以及相关信息不被恶意篡改/ 数据全部由NetSafe Client负责转发，使NetSafe Client成为架设在企业现场的工行接入服务器而金业与工行之间安全的连接，由NetSafe Client和工行安全代 理服务器NetSafe保证；/ 工行接收到企业捉交过来的部分关键交易数据后，需要解密并验证企业的数字签名，以防止第三方假冒企业的行为对于非NC方式接入的客户/ 金业向工行提交交易数据时的安全控制企业ERP ■银企互连系统Z间使用HTTPS协议通讯企业可以选择是否对交易数据进行对称加密，冃前系统支持的算法冇DES与3DES进行对称加密可以防止笫三方截获交易的信息。

而加密中需要川到的密 仞由企业与工行共同约定加密功能暂不支持）企业需要对其发送的指令数据进行数字签名，签名中使用的证书可以是企业证 书也可以是工行证书，其中签名使用的算法是SHAlwithRSAo进行数字签名可 以防止笫三方假冒企业的行为/ 工行向企业发送结果信息时的安全控制金业ERP与银金互连系统之间使用HTTPS协议通讯企业可选择是否对返回数据进行对称加密，方法与上文相同工行对部分关键交易返回信息进行数字签名第3章重点说明格式要支持业界公认的标准格式，例如：＜Tag /＞等同于vTag＞＜fTag＞；上送数据格 式尽量简单，避免使用CDData等文木格式》所有的交易请求包中“包序列ID”字段（PnckagcID）由企业产生，产生规则为当前 日期（北京时间，格式为yyyyMMdd） +7位序列号（例如200212230000001,为2002 年12月23 tl发送的一个交易请求包的包序列ID）在一个企业代码下当日包序列ID 必须唯一工行处理完毕Z后将该字段原值返回，即所有的交易返回包小“包序列ID” 字段（PackagelD）》转帐交易请求包中“签名时间”字段（SignTime）,格式为yyyyMMddhhmmssSSS （例 如20021223092710568,表示2002年12刀23 U 9点27分10秒568毫秒）。

签名时 间应为北京吋间签名吋间如果与交易请求到达工行服务器时的北京标准吋问误差过 大（暂定为15分钟），交易将无法进行此措丿施将可以冇效地防止黑客采用重放攻击 进行干扰帐务活动的行为同一•笔交易如果因为网络不正常等因索需要重新提交吋， 要修改转账交易请求包的“签名时间字段”并重新签名A所冇请求包和返回包中备用字段的使用主要是出于对今后扩展的考虑，如果以后需要 增加企业上送的项冃或者返冋给企业的信息，不必再改变交易包格式冃前对企业请 求包来说这些备用字段的值可以送空；企业对银行返回包中的备用字段也不必作处 理请求包中的备用字段标签为“RcqRcscrved*”，返回包中的备用字段标签为 “RepReserved*” （其中*为1、2、3或4,详见接口说明文档）A查询历史明细返回数据包中交易时间（＜Trans_timeX/Trans_time＞）数值如为空, 则说明该笔指令是银行的计息交易明细A支付査询指令接口，方便企业对可疑、有疑问（如网络中断，交易长吋间没有返回等） 或处理完毕的转帐指令进行查询企业提交耍查询的结算请求的包序列ID,工行返回 该笔转帐指令的棊木信息和状态A木接口说明中所有涉及金额的字段都是以分为单位（不带小数点）。

》如企业系统需要代理汇兑功能则金业应用需同步开发网点信息下载交易，以便为代理 汇兑交易中收方为它行情况时提供工行网点名称否则，无需开发网点信息下载交易》在网点信息下载功能中，由于下载数据过大且数据不会经常更新，所以此交易控制了企业每口下载次数冃前暂定次数为每L1 2次A个人联名卡签权指令只支持币种是人民币的账号/卡号》金业端传输数据时，指定xml编码方式为GB2312》银企互联提交包中包含 YSignTime〉签名时间（yyyyMMddhhmmssSSS）〈/SignTime＞”此标签的，说明该交易碍要进行签名处理A企业端的程序需要对银行返冋的数据有可扩展性，以便适应今麻业务的不断发展》银金互连系统支持两种接入方式，客户可以任何选择一种第一种：使用第三方NC 软件方式接入银企互连系统；第二种：使用非NC方式企业岂接接入银企互连系统；》一些接口中，返回包分文件级返回包和指令级返M包两种文件级返M包是作为客户请求的响应信息同步返回的而指令级返回包是银行主动发起的异步返回信息，表示 指令处理的结果，指令级返I叫包首先会返I叫整批指令的处理结果，然后对于其中指令 状态非最终状态（成功和失败）的指令，银行会实时更新每一条指令的状态，然后再 每条分别以指令级返回包的格式返回给客八o》建议客户使用HTTP/1.1协议。

HTTP/1.0及其以下协议版本町能无法正常发送指令到 银行端下面将区分两类客户分别对接入方式等相关信息进行说明第4章 银企互联一NC方式接入客户4.1企业端系统环境要求4丄1软件环境对企业的ERP系统无要求；工行企业端证卩服务器软件NelSafc Client需安装在一台PC机上4.1.2网络环境金业财务系统通过局域网与工商银行提供的NciSafc Client连接；企业端的NetSafe Client可以通过专线或INTERNET与工商银行银企互连系统互 联4.1.3企业开发过程描述4.1.3.1企业提交交易请求数据过程企业提交的交易分为两大类：查询类和结算类（盂要进行签名处理）1、查询类：（1） 金业按照工行提供的xml包格式进行打包，在局域网内通过http协议以POST方式将交易包发送到NetSafe Client的安全http协议服务器 http请求格式：action=,，http://客户端NetSafe Client的地址和加密端口 J /scrvlct/ICBCCMPAPIRcqScrvlct?uscrID= z/F /$ ID&PackagcID二包序 歹QlD &SendTime=请求数据格式（post方式）：Version=）K本号（区分版本时间，暂定0.0.0.1） &TransCode=交易代码（区分交易类型，每个交易固定）&BankCode= 客八的归属单位&GroupCIS=客户的归属编码&ID二客户的证书ID （无 证书客户可空）&PackageID=客户的指令包序列号（由客户ERP系统产 生，不可重复）&Cert=客户的证书公钥信息（进行BASE64编码；NC 客八送空）&reqData=客户的xml诘求数据其中：包序列IR证书ID应根据实际情况进行更改，请求时间为企 业发出该交易请求包的当前系统时间。

post方式最后不允许有回车等 其他乱字符，Trans Code交易名称应与xni包内标签 中的值一致，acti o n 中的证书 ID、 Packagel D与请求数据格式中的证书IR Packagel D. xnli包中的证书 IR Packagel D的值三者相一致2） NetSafe Client将xml包加密后按照https协议，通过互联网/专线发送 到银行端的NetSafe Server0 （本步由NetSafe Client完成，企业无需处 理）；（3） NetSafe Server将交易请求送银企互连系统进行处理2、结算类：（1） 企业按照工行提供的xml包格式进行打包，在局域网内与NetSafeClient的签名端口建立Socket连接，通过此连接向签名端口发送http 数据包http 包头中需包含 “Content-Length” 和 “Content-Type” 两 个属性其小"Content-Length:"后面是需要签名的二进制数据包的 长度，“ Content.Type: ”后而是需要签名的标记，为 INFOSEC_SIGN/1.0o （注意大小写）http请求格式：action="hup:〃客户端NetSafe Client的地址和签名端口 号,，请求数据格式：结算类请求提交的xml包NetSafe Client对xml包进行签名后，通过http协议将签名结果返回给 企业系统。

如签名成功标签A/标签Z间的部分为签名结 果NetSafe Client返回的签名包如下：