中国工商银行银企互连系统企业开发手册

中国工商银行银企互连系统企业开发手册银企互联面向大的集团客户，提供与企业ERP 系统直连的平台，银企互联面向大的集团客户，提供与企业ERP 系统直连的平台，为工行的现金治理服务提供多渠道和客户化支持。

企业ERP 系统通过HTTPS 协议与工行系统进行连接并向银企互联前置发送数据，数据的接口格式使用标准的xml 数据格式，但双方通讯的过程中则需要遵守下文描述的规定。

银企互联前置接到企业数据后进行一系列的检查后完成交易，并将处理结果以企业便于处理的形式返回给企业。

在安全保证方面，通讯层的安全保证是HTTPS 协议。

企业如需使用银企互联系统，要办理有关注册手续，并审领证书。

企业进行结算类交易时，如果涉及到授权过程，企业需要在企业网银系统中完成有关授权动作。

银企互连系统将企业提交的支付指令或者授权成功后的指令当作最终转账指令，按照提交指令的证书ID 检查收付方帐号等合法性，以保证所提交指令在权限承诺范畴内进行操作。

总体方案介绍总体网络结构图Internet/Intranet Internet/Intranet企业ERP 系统2银企互联系统NetSafe 服务器企业ERP 系统1https NetSafe Client http https上图企业ERP 系统1采纳的是非NC 方式接入的客户；企业ERP 系统2采纳的是NC 方式接入的客户；企业端安全服务器简介此服务器只对使用NC 方式接入的客户有效。

企业端安全服务器被称为NetSafe Client 。

它有两个能够配置的端口分不用于加密和签名／验签服务，如下图所示（假设１为加密端口，２为签名／验签端口）。

1（加密）NetSafeClient2（签名／验签）1. http 交易要求包https 交易要求包1.签名／验签要求2.签名／验签结果2. 交易结果具体使用时，企业应用向工行提交交易要求时，能够按照http协议向NetSafe Client的端口１发送要求。

接到要求后，NetSafe Client使用企业证书将http要求包转换成https要求包发往工行端服务器；如果需要对某些交易数据进行签名，则企业应用需要与签名端口建立Socket 连接并将待签名数据发往端口２，然后接收端口２的签名结果，之后再将包含签名信息的交易要求发往端口１而完成整个交易要求过程。

对签名依旧验签名要求的区分则是通过http包头来进行。

Content-Type: INFOSEC_SIGN/1.0和Content-Type: INFOSEC_VERIFY_SIGN/1.0分不用于标识签名要求和验签名要求，而Content-Type: INFOSEC_SIGN_RESUL T/1.0和Content-Type: INFOSEC_VERIFY_SIGN_RESULT/1.0分不用于标识签名和验签名的返回结果。

为方便起见，能够将NetSafe Client的两个服务端口逻辑地称为两台服务器，NetSafe Client的加密服务器和签名服务器。

安全操纵介绍关于NC方式接入的客户企业向工行提交的交易数据，必须通过企业方的NetSafe Client进行与工行服务器的连接，接口确定需要签名的数据也必须由NetSafe Client的签名服务器签名后组成规定的数据包格式后，通过NetSafe Client提交工行，如此能够保证企业数据以及有关信息不被恶意篡改。

数据全部由NetSafe Client负责转发，使NetSafe Client成为架设在企业现场的工行接入服务器。

而企业与工行之间安全的连接，由NetSafe Cli ent和工行安全代理服务器NetSafe保证；工行接收到企业提交过来的部分关键交易数据后，需要解密并验证企业的数字签名，以防止第三方假冒企业的行为。

关于非NC方式接入的客户企业向工行提交交易数据时的安全操纵企业ERP与银企互连系统之间使用HTTPS协议通讯。

企业能够选择是否对交易数据进行对称加密，目前系统支持的算法有D ES与3DES。

进行对称加密能够防止第三方截获交易的信息。

而加密中需要用到的密钥由企业与工行共同约定。

（加密功能暂不支持）企业需要对其发送的指令数据进行数字签名，签名中使用的证书能够是企业证书也能够是工行证书，其中签名使用的算法是SHA1withRSA。

进行数字签名能够防止第三方假冒企业的行为。

工行向企业发送结果信息时的安全操纵企业ERP与银企互连系统之间使用HTTPS协议通讯。

企业可选择是否对返回数据进行对称加密，方法与上文相同。

工行对部分关键交易返回信息进行数字签名。

重点讲明所有的交易要求包中“包序列ID”字段（PackageID）由企业产生，产生规则为当前日期（北京时刻，格式为yyyyMMdd）＋7位序列号（例如2 00212230000001，为2002年12月23日发送的一个交易要求包的包序列I D）。

在一个企业代码下当日包序列ID必须唯独。

工行处理完毕之后将该字段原值返回，即所有的交易返回包中“包序列ID”字段（PackageID）。

转帐交易要求包中“签名时刻”字段（SignTime），格式为yyyyMMdd hhmmssSSS（例如20021223092710568，表示2002年12月23日9点27分10秒568毫秒）。

签名时刻应为北京时刻。

签名时刻如果与交易要求到达工行服务器时的北京标准时刻误差过大（暂定为15分钟），交易将无法进行。

此措施将能够有效地防止黑客采纳重放攻击进行干扰帐务活动的行为。

同一笔交易如果因为网络不正常等因素需要重新提交时，要修改转账交易要求包的“签名时刻字段”并重新签名。

所有要求包和返回包中备用字段的使用要紧是出于对今后扩展的考虑，如果以后需要增加企业上送的项目或者返回给企业的信息，不必再改变交易包格式。

目前对企业要求包来讲这些备用字段的值能够送空；企业对银行返回包中的备用字段也不必作处理。

要求包中的备用字段标签为“R eqReserved*”，返回包中的备用字段标签为“RepReserved*”（其中*为1、2、3或4，详见接口讲明文档）。

查询历史明细返回数据包中交易时刻（<Trans_time></Trans_time>）数值如为空，则讲明该笔指令是银行的计息交易明细。

支付查询指令接口，方便企业对可疑、有疑咨询（如网络中断，交易长时刻没有返回等）或处理完毕的转帐指令进行查询。

企业提交要查询的结算要求的包序列ID，工行返回该笔转帐指令的差不多信息和状态。

本接口讲明中所有涉及金额的字段差不多上以分为单位（不带小数点）。

如企业系统需要代理汇兑功能则企业应用需同步开发网点信息下载交易，以便为代理汇兑交易中收方为它行情形时提供工行网点名称。

否则，无需开发网点信息下载交易。

在网点信息下载功能中，由于下载数据过大且数据可不能经常更新，因此此交易操纵了企业每日下载次数。

目前暂定次数为每日2次。

个人联名卡签权指令只支持币种是人民币的账号/卡号。

企业端传输数据时，指定xml编码方式为GB2312。

银企互联提交包中包含“<SignTime>签名时刻（yyyyMMddhhmmssSS S）</SignTime>”此标签的，讲明该交易需要进行签名处理。

企业端的程序需要对银行返回的数据有可扩展性，以便适应今后业务的持续进展。

银企互连系统支持两种接入方式，客户能够任何选择一种。

第一种：使用第三方NC软件方式接入银企互连系统；第二种：使用非NC方式企业直截了当接入银企互连系统；下面将区分两类客户分不对接入方式等有关信息进行讲明。

银企互联——NC方式接入客户企业端系统环境要求软件环境对企业的ERP系统无要求；工行企业端证书服务器软件NetSafe Client需安装在一台PC机上。

网络环境企业财务系统通过局域网与工商银行提供的NetSafe Client连接；企业端的NetSafe Client 能够通过专线或INTERNET 与中国工商银行银企互连系统互联。

企业开发过程描述企业提交交易要求数据过程企业提交的交易分为两大类：查询类和结算类（需要进行签名处理）。

查询类：企业按照工行提供的xml 包格式进行打包，在局域网内通过http 协议以POST 方式将交易包发送到NetSafe Client 的安全http 协议服务器。

http 要求格式：action=”http://客户端NetSafe Client 的地址和加密端口号/servlet/ICBCCMPAPIReqServlet?userID=证书ID&PackageID=包序列ID &SendTime=要求时刻”要求数据格式（post 方式）：Version=版本号（区分版本时刻，暂定0.0.0.1) &TransCode=交易代码（区分交易类型，每个交易固定)&BankCode=客户的归属单位&GroupCIS=客户的归属编码&ID=客户的证书ID （无证书客户可空)&PackageID=客户的指令包序列号（由客户ERP 系统产生，不可重复)&Cert=客户的证书公钥信息（进行BASE64编码；NC 客户送空) &re qData=客户的xml 要求数据其中：包序列ID 、证书ID 应按照实际情形进行更换，要求时刻为企业发出该交易要求包的当前系统时刻。

post 方式最后不承诺有回车等其他乱字符，TransCode 交易名称应与xml 包内标签<TransCode></TransCode>中的值一致，action 中的证书ID 、PackageID 与要求数据格式中的证书ID 、PackageID 、xml 包中的证书ID 、PackageID 的值三者相一致。

NetSafe Client 将xml 包加密后按照https 协议，通过互联网/专线发送到银行端的NetSafe Server 。

（本步由NetSafe Client 完成，企业无需处理）；NetSafe Server 将交易要求送银企互连系统进行处理。

结算类：企业NetSafe Client NetSafe Server （1）（2）工行（3）企业按照工行提供的xml包格式进行打包，在局域网内与NetSafe Cli ent的签名端口建立Socket连接，通过此连接向签名端口发送http数据包。

http包头中需包含“Content-Length”和“Content-Type”两个属性。

其中“C ontent-Length:”后面是需要签名的二进制数据包的长度，“Content-Type:”后面是需要签名的标记，为INFOSEC_SIGN/1.0。