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

K3 银企互联实施及故障排查手册 K 3 财务开发部 李佳强 导读 K 312 0 发版以来 出现了许多咨询网上银行设置问题及应用问题 开发人员总结日常 支持遇到的各种问题 整理成册 以便后需实施学习 适用范围 适用于 K 310 2 以后版本 请注意 本文件只作为基础介绍之用 不属于您与金蝶签署的任何协议 本文件仅包括金蝶既定策略 产 品及功能方面的信息 不能以本文件作为要求金蝶履行商务条款 产品策略以及开发义务的依据 本文件 内容可能随时变更 恕不另行通知 金蝶对本文件可能存在的错误或疏漏不承担任何责任 目目 录录 1K 3 提供的银企互联主要版本提供的银企互联主要版本 3 1 1K 3V12 0 之前的版本 3 1 2K 3V12 0 及之后的版本 3 2使用银企互联的前提条件使用银企互联的前提条件 3 3银企互联一般问题分析及处理银企互联一般问题分析及处理 4 3 1K 3 目前提供的银企互联功能 4 3 2K 3 的接入方式 4 3 2 1K 312 0之前的版本 4 3 2 2K 312 0之后的版本 4 3 3K 3 客户端直接接入 BOS 银企平台 5 3 3 1检查连通 6 3 3 2查看前置机日志记录 6 3 3 3验证 9 3 3 4其他 9 4K 3 下载收付款过程问题分析步骤下载收付款过程问题分析步骤 9 5银企平台配置简要说明银企平台配置简要说明 10 5 1银企平台端口设置 10 5 2K 312 0 配置及注意事项 11 5 2 1安装问题 11 5 2 2注册问题 11 5 2 3 K 3设置注意事项 12 1 K 3 提供的银企互联主要版本提供的银企互联主要版本 1 1 k 3v12 0 之前的版本之前的版本 主要为 工行普通版 中国银行 全国 招商银行 建行重客系统 农行 设置可参考文档 银行接口开发指导 手册 V1 01 doc 1 2 k 3v12 0 及之后的版本及之后的版本 已经与 EAS 共用 BOS 银企平台 提供的银行接口需要查看银企平台提供的手册 2 使用银企互联的前提条件使用银企互联的前提条件 由于 K 3 提供的银企互联主要使用银行提供的银行为企业提供的接口 在银行提供的 文档一般叫银企直联或引起互联 一般是专为企业 ERP 提供的接口 连接方式可以为专线 网络或公网 可以咨询相关银行的技术人员 一般负责这种业务的部门为银行的电子银行 业务部 此处没有具体负责过 所以不是很确定 不过银行都有专门的人或部门来处理的 大致的流程 1 首先咨询银行相关人员 谈费用 签订协议 2 银行为企业开通银企直联服务账户 密码 证书等工作 3 银行一般会有工作人员在企业装一个前置机 功能主要是连接企业与银行服务器 的软件 主要负责报文的签名 加密 解密 转发等工作 4 安装 K 3 后 在 K 3 的银企直联 银行接口设置中 根据银行提供的资料设置对 应银行参数 5 在 K 3 系统中设置企业在该银行开的银行账号信息 6 经过上述步骤 即可使用 K 3 的银企互联提供的功能 查交易明细 账户余额 接收收 付款单 转账等业务 3 银企互联一般问题分析及处理银企互联一般问题分析及处理 3 1 K 3 目前提供的银企互联功能目前提供的银企互联功能 主要为 查账户余额 查账户交易明细 付款业务 即转账业务 查询付款状态 即同步付款状态 根据银行的交易明细 生成收 付款单 因此此业务 也相当于查交易明细 3 2 K 3 的接入方式的接入方式 3 2 1 K 312 0 之前的版本之前的版本 K 3 客户端银行前置机 银行服务器 请求 应答 接入方式 SOCK 或 HTTP 3 2 2 K 312 0 之后的版本之后的版本 BOS 银企平台 银行前置机银行服务器 请求 应答 接入方式 SOCK 或 HTTP k 3 客户端 请求 应答 接入方式 webservice 即 http 3 3 k 3 客户端直接接入客户端直接接入 BOS 银企平台银企平台 K 3 客户端能否连通的第一步是和银企平台有关 与银行没有关系 更与银行的配置没有 关系 服务器地址 指的是 BOS 银企网关 在 K 3 安装包 OTHER BOS EBG 下 参考 银企平 台安装手册 doc 最新动态可咨询 BOS 银企平台项目组 也可在 mykingdee 中查找相关 资料 补充 银企网关 在安装了银企网关之后 在启动里可看到 运行即可启动银企平台 银企平台默认的端口为 5283 查看是否可以连接 在 K3 客户端可使用下列方法 在浏览器中输入以下 http localhost 5283 ebgateway services BankServiceConfig 如果出现 BankServiceConfig Hi there this is an AXIS service Perhaps there will be a form for invoking the service here 则说明可使用 在 K 3 中只要配置 http localhost 5283 即可 使用中 可把 localhost 替换成平台安装的机子 IP 地址 获取可用银行 配置好服务器地址后 点击此按钮 可获取能够配置的银行列表 左边树形为银行各个版本信息 选择一个银行 右边显示需要配置的参数 一边都是与银 行配置有关的信息 可以咨询银行工作人员 3 3 1 检查连通检查连通 根据上述的接入方式 首先检查各个连接之间网络是否连通 端口是否连通 一般可用 telnet 命令来查看网络端口是否连通 银行前置机与银行服务器之间 可咨询银行技术人员 命令来查看网络端口是否连通 银行前置机与银行服务器之间 可咨询银行技术人员 3 3 2 查看前置机日志记录 查看前置机日志记录 一般前置机都会记录连接命令及收发报文 根据日志来判断在那一步出现了问题 各个银 行都不一致 工行的日志记录在 c 目录下 交易报文都记录在 httpinfo txt 签名记录在 sign txt 摘录一段工行日志 2008 04 24 11 43 25 043 从客户端 192 168 10 100 收到如下数据 POST servlet com icbc inbs yhzq NCAPIReqServlet userID Greefinance d 2002 MSIE 6 0 Windows NT 5 2 SV1 NET CLR 1 1 4322 NET CLR 2 0 50727 Host 192 168 10 100 448 Content Length 443 Connection Keep Alive Cache Control no cache reqData NCQueryBalanceOpRMBGreefin ance d 20020001 MSIE 6 0 Windows NT 5 2 SV1 NET CLR 1 1 4322 NET CLR 2 0 50727 Host 192 168 10 100 448 Content Length 443 Connection Keep Alive Cache Control no cache reqData NCQueryBalanceOpRMBGreefin ance d 20020001 userID Greefinance d 2002 PackageID 0001 opName NCQueryBalanceOp 2008 04 24 11 43 26 043 从 Server 端 收到如下数据 HTTP 1 1 200 OK Date Thu 24 Apr 2008 03 43 25 GMT Server WebSphere Application Server 6 0 Content Length 564 Content Language zh CN reqData NCQueryBalanceOp RMB 一般结算户 0001 Greefinance d 2002 2008 04 24 11 43 26 043 向客户端 192 168 10 100 发送如下数据 HTTP 1 1 200 OK Date Thu 24 Apr 2008 03 43 25 GMT Server WebSphere Application Server 6 0 Content Length 564 Content Language zh CN reqData NCQueryBalanceOp RMB 一般结算户 0001 Greefinance d 2002 这段主要为 查询帐户余额的指令报文 如果用了 BOS 银企网关 则所有 K 3 的报文都是 通过银企网关发送给前置机 然后再把前置机返回的报文发送给 K 3 以下就不区分了 第一段 前置机收到 K 3 发出的查询帐户余额的报文 第二段 前置机把此报文发送给银行服务器 第三段 前置机收到银行服务器返回的报文 第四段 前置机向 K 3 发送收到的报文 一般的日志都会记录四个步骤 如果出现故障 可通过记录的日志来判断故障在那步发生 的 3 3 3 验证验证 查看网络连接没有问题后 可进行简单的查询余额 交易明细等指令 由于转账指令一般使用比较严格的加密 签名 因此如果证书等制作过程中出现问题 都 可能导致此业务的失败 3 3 4 其他其他 基本上错误都可以通过前置机记录的日志来判断是出问题的原因 通过记录的日志中错误 信息 咨询银行技术人员就会查明原因 如果银行接口有变动导致交易失败 可向银行索 取新的接口资料 发送给 K 3 研发人员分析处理 4 K 3 下载收付款过程问题分析步骤下载收付款过程问题分析步骤 K 3 下载收付款单是根据银行提供的交易明细记录自动生成 一般的问题主要为 1 下载报错 2 下载遗漏交易单据 3 下载重复交易单据 第一类错误 要排查网络故障 根据上述来查找原因 第二类可根据日志中交易明细的记录检查是否真的没有这条交易明细 还是 K 3 处理问题 1 如果从交易明细日志记录中没有发现 可咨询银行方面 一般而言 用户在查当天的 记录 会少一些交易记录 因为有些交易银行还没有处理完成 因此还不能查询到 如在 跨行转账中 银行要落地处理 即人工在后台处理 因此交易不能及时处理 2 如果从日志记录中可看到 而 K 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 银企平台配置简要说明银企平台配置简要说明 银企平台的配置可参考相关附带文档或咨询银企平台开发或需求人员 在 mykingdee 的 BOS 知识库中可搜索到大量相关技术文档 这里只做与 K 3 有关的银企平台的安装可安 装在任何机子上 与 K 3 可分开部署 银企平台的技术运用 WEBSERVICE 因此 只要 K 3 能访问到此服务即可 5 1 银企平台端口设置银企平台端口设置 在银企网关 安装目录 下的 configuration 目录下 有一配置文件 config ini 在此文件 中定义有银企网关的一些配置 其中 org osgi service http port 定义有网关的 Web Service 接口的端口 在此我们将此端口定义为 网关端口 设置完成后需要重新启动 BUG 修复问题 可安装 PT 具体描述可参考补丁发布说明 或咨询补丁开发人员 5 2 K 312 0 配置及注意事项配置及注意事项 5 2 1安装问题安装问题 K 312 0 使用网上银行功能 则必须安装 NET2 0 通过环境监测可安装此包 5 2 2注册问题注册问题 如果安装了 NET2 0 后 在调用 K 3 相关配置配置功能是 还报对象创建失败的提示 是 由于注册组件失败 可能的原因是没有先安装 net2 0 然后再安装 K 3 可通过手工注册客 户端安装目录下 K3ERP 下的 EBankinterface dll 通过 cmd 运行控制台 进入 K3ERP 目录下 运行以下命令 windir Microsoft NET Framework v2 0 50727 regasm EBankInterface dll codebase 提示注册成功 则说明环境已经没有问题 5 2 3 K 3 设置注意事项设置注意事项 K 3 中银行账号基础资料主要设置付款方银行账号 特