K3银企互联实施及故障排查手册

1、K3 银企互联实施及故障排查手册 K/3 财务开发部 李佳强 导读 K/312.0 发版以来，出现了许多咨询网上银行设置问题及应用问题，开发人员总结日常支持遇到的各种问题，整理成册，以便后需实施学习。 适用范围 适用于 K/310.2 以后版本。请注意：本文件只作为基础介绍之用，不属于您与金蝶签署的任何协议。本文件仅包括金蝶既定策略、产品及功能方面的信息，不能以本文件作为要求金蝶履行商务条款、产品策略以及开发义务的依据。本文件内容可能随时变更，恕不另行通知。金蝶对本文件可能存在的错误或疏漏不承担任何责任。 目目 录录1K/3 提供的银企互联主要版本提供的银企互联主要版本.31.1K/3V12.

2、0 之前的版本.31.2K/3V12.0 及之后的版本.32使用银企互联的前提条件使用银企互联的前提条件 .33银企互联一般问题分析及处理银企互联一般问题分析及处理 .43.1K/3 目前提供的银企互联功能.43.2K/3 的接入方式.43.2.1K/312.0之前的版本.43.2.2K/312.0之后的版本.43.3K/3 客户端直接接入 BOS 银企平台.53.3.1检查连通.63.3.2查看前置机日志记录。.63.3.3验证.93.3.4其他.94K/3 下载收付款过程问题分析步骤下载收付款过程问题分析步骤.95银企平台配置简要说明银企平台配置简要说明 .105.1银企平台端口设置.10

3、5.2K/312.0 配置及注意事项.115.2.1安装问题.115.2.2注册问题.115.2.3 K/3设置注意事项.121 K/3 提供的银企互联主要版本提供的银企互联主要版本1.1 k/3v12.0 之前的版本之前的版本主要为：工行普通版、中国银行（全国） 、招商银行、建行重客系统、农行设置可参考文档银行接口开发指导手册 V1.01.doc1.2 k/3v12.0 及之后的版本及之后的版本已经与 EAS 共用 BOS 银企平台。提供的银行接口需要查看银企平台提供的手册。2 使用银企互联的前提条件使用银企互联的前提条件由于 K/3 提供的银企互联主要使用银行提供的银行为企业提供的接口，在

4、银行提供的文档一般叫银企直联或引起互联。一般是专为企业 ERP 提供的接口，连接方式可以为专线网络或公网，可以咨询相关银行的技术人员。一般负责这种业务的部门为银行的电子银行业务部（此处没有具体负责过，所以不是很确定，不过银行都有专门的人或部门来处理的） 。大致的流程1.首先咨询银行相关人员，谈费用、签订协议。2.银行为企业开通银企直联服务账户、密码、证书等工作。3.银行一般会有工作人员在企业装一个前置机，功能主要是连接企业与银行服务器的软件，主要负责报文的签名、加密，解密，转发等工作。4.安装 K/3 后，在 K/3 的银企直联银行接口设置中，根据银行提供的资料设置对应银行参数。5.在 K/3

5、 系统中设置企业在该银行开的银行账号信息6.经过上述步骤，即可使用 K/3 的银企互联提供的功能。查交易明细、账户余额、接收收、付款单、转账等业务。3 银企互联一般问题分析及处理银企互联一般问题分析及处理3.1 K/3 目前提供的银企互联功能目前提供的银企互联功能，主要为查账户余额查账户交易明细付款业务（即转账业务）查询付款状态（即同步付款状态）根据银行的交易明细，生成收/付款单,因此此业务，也相当于查交易明细3.2 K/3 的接入方式的接入方式3.2.1 K/312.0 之前的版本之前的版本K/3 客户端银行前置机银行服务器请求应答接入方式：SOCK 或HTTP3.2.2 K/312.0 之

6、后的版本之后的版本BOS 银企平台银行前置机银行服务器请求应答接入方式：SOCK 或 HTTPk/3 客户端请求应答接入方式：webservice 即 http3.3 k/3 客户端直接接入客户端直接接入 BOS 银企平台银企平台K/3 客户端能否连通的第一步是和银企平台有关，与银行没有关系，更与银行的配置没有关系。服务器地址：指的是 BOS 银企网关。在 K/3 安装包 OTHERBOS_EBG 下，参考银企平台安装手册.doc ，最新动态可咨询 BOS 银企平台项目组。也可在 mykingdee 中查找相关资料。补充：银企网关：在安装了银企网关之后，在启动里可看到运行即可启动银企平台。银企

7、平台默认的端口为 5283，查看是否可以连接。在 K3 客户端可使用下列方法在浏览器中输入以下 http:/localhost:5283/ebgateway/services/BankServiceConfig如果出现：BankServiceConfigHi there, this is an AXIS service!Perhaps there will be a form for invoking the service here. 则说明可使用。在 K/3 中只要配置 http:/localhost:5283/ 即可使用中，可把 localhost 替换成平台安装的机子 IP 地址。获取

8、可用银行：配置好服务器地址后，点击此按钮，可获取能够配置的银行列表左边树形为银行各个版本信息。选择一个银行，右边显示需要配置的参数。一边都是与银行配置有关的信息，可以咨询银行工作人员。3.3.1 检查连通检查连通根据上述的接入方式，首先检查各个连接之间网络是否连通，端口是否连通。一般可用telnet 命令来查看网络端口是否连通。银行前置机与银行服务器之间，可咨询银行技术人员。命令来查看网络端口是否连通。银行前置机与银行服务器之间，可咨询银行技术人员。3.3.2 查看前置机日志记录。查看前置机日志记录。一般前置机都会记录连接命令及收发报文，根据日志来判断在那一步出现了问题。 （各个银行都不一致）

9、工行的日志记录在 c:目录下，交易报文都记录在 httpinfo.txt,签名记录在 sign.txt摘录一段工行日志：2008/04/24 11:43:25.043 从客户端 00 收到如下数据POST /servlet/com.icbc.inbs.yhzq.NCAPIReqServlet?userID=Greefinance.d.2002&PackageID=200804249800001&SendTime=20080424114322000 HTTP/1.1Accept: */*Content-Type: application/x-www-for

10、m-urlencodedAccept-Language: zh-cnUA-CPU: x86Accept-Encoding: gzip, deflateUser-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; SV1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)Host: 00:448Content-Length: 443Connection: Keep-AliveCache-Control: no-cachereqData=NCQueryBalanceOp2002020

11、319100093431RMBGreefinance.d.2002200804249800001&userID=Greefinance.d.2002&PackageID=200804249800001&opName=NCQueryBalanceOp2008/04/24 11:43:25.043 向 Server 端 443 发送如下数据:POST /servlet/com.icbc.inbs.yhzq.NCAPIReqServlet?userID=Greefinance.d.2002&PackageID=200804249800001&SendTime=

12、20080424114322000 HTTP/1.1Accept: */*Content-Type: application/x-www-form-urlencodedAccept-Language: zh-cnUA-CPU: x86Accept-Encoding: gzip, deflateUser-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; SV1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)Host: 00:448Content-Length: 443Conn

13、ection: Keep-AliveCache-Control: no-cachereqData=NCQueryBalanceOp2002020319100093431RMBGreefinance.d.2002200804249800001&userID=Greefinance.d.2002&PackageID=200804249800001&opName=NCQueryBalanceOp2008/04/24 11:43:26.043 从 Server 端 收到如下数据:HTTP/1.1 200 OKDate: Thu, 24 Apr 2008 03:43:25 GMT

14、Server: WebSphere Application Server/6.0Content-Length: 564Content-Language: zh-CNreqData=NCQueryBalanceOp2002020319100093431RMB205107717120651003462065100346一般结算户200804249800001Greefinance.d.20022008/04/24 11:43:26.043 向客户端 00 发送如下数据:HTTP/1.1 200 OKDate: Thu, 24 Apr 2008 03:43:25 GMTSer

15、ver: WebSphere Application Server/6.0Content-Length: 564Content-Language: zh-CNreqData=NCQueryBalanceOp2002020319100093431RMB205107717120651003462065100346一般结算户200804249800001Greefinance.d.2002这段主要为，查询帐户余额的指令报文，如果用了 BOS 银企网关，则所有 K/3 的报文都是通过银企网关发送给前置机，然后再把前置机返回的报文发送给 K/3，以下就不区分了第一段：前置机收到 K/3 发出的查询帐户余

16、额的报文第二段：前置机把此报文发送给银行服务器第三段：前置机收到银行服务器返回的报文第四段：前置机向 K/3 发送收到的报文一般的日志都会记录四个步骤，如果出现故障，可通过记录的日志来判断故障在那步发生的。3.3.3 验证验证查看网络连接没有问题后，可进行简单的查询余额、交易明细等指令。由于转账指令一般使用比较严格的加密、签名。因此如果证书等制作过程中出现问题，都可能导致此业务的失败。3.3.4 其他其他基本上错误都可以通过前置机记录的日志来判断是出问题的原因，通过记录的日志中错误信息，咨询银行技术人员就会查明原因。如果银行接口有变动导致交易失败，可向银行索取新的接口资料，发送给 K/3 研发

17、人员分析处理。4 K/3 下载收付款过程问题分析步骤下载收付款过程问题分析步骤K/3 下载收付款单是根据银行提供的交易明细记录自动生成。一般的问题主要为1.下载报错2.下载遗漏交易单据3.下载重复交易单据第一类错误，要排查网络故障，根据上述来查找原因第二类可根据日志中交易明细的记录检查是否真的没有这条交易明细，还是 K/3 处理问题。（1）如果从交易明细日志记录中没有发现，可咨询银行方面。一般而言，用户在查当天的记录，会少一些交易记录，因为有些交易银行还没有处理完成，因此还不能查询到。如在跨行转账中，银行要落地处理，即人工在后台处理，因此交易不能及时处理。 （2）如果从日志记录中可看到，而 K

18、/3 无法生成单据。可跟踪数据库记录来查看原因。K/3 的处理步骤如下的处理步骤如下1. 客户进行获取银行付款单的操作2. K/3 发送获取交易明细的指令给前置机3. K/3 处理前置机返回的交易记录，并记录到数据库 t_bk_bank 中4. K/3 记录需要生成付款单据的交易记录在 t_bk_notice 中5. K/3 生成付款单，并在 t_bk_notice 标记已经生成付款单的交易记录6. K/3 在生成付款单时都要判断此条交易记录是否在 t_bk_notice 中，判断的依据根据银行账号、交易时间、对方账号等信息来判断是否同一条记录。第三类的错误，可参考第二类来处理。5 银企平台配

19、置简要说明银企平台配置简要说明银企平台的配置可参考相关附带文档或咨询银企平台开发或需求人员，在 mykingdee的 BOS 知识库中可搜索到大量相关技术文档，这里只做与 K/3 有关的银企平台的安装可安装在任何机子上，与 K/3 可分开部署。银企平台的技术运用 WEBSERVICE，因此，只要K/3 能访问到此服务即可。5.1 银企平台端口设置银企平台端口设置在银企网关【安装目录】下的/configuration/目录下，有一配置文件 config.ini，在此文件中定义有银企网关的一些配置，其中“org.osgi.service.http.port”定义有网关的 Web Service接口的端口，在此我们将此端口定义为【网关端口】 。设置完成后需要重新启动。BUG 修复问题可安装 PT025906，具体描述可参考补丁发布说明，或咨询补丁开发人员5.2 K/312.0 配置及注意事项配置及注意事项5.2.1安装问题安装问题K/312.0，使用网上银行功能，则必