【电子回单】中国银行(BOC_NET)回单配置指南

栏目:eas cloud知识作者:金蝶来源:金蝶云社区发布:2024-09-22浏览:1

【电子回单】中国银行(BOC_NET)回单配置指南

一、中行下载回单的流程

1. 回单代理程序通过银企平台发送查询及下载回单的请求给中国银行前置机,银行前置机将请求转发给银行

    回单代理程序访问银企平台,银企平台发起逐笔电子回单下载(b2e0500接口)请求到中行前置机,中行前置机将请求转发给银行服务器。


2. 银行收到请求后,返回文件名称给银企平台,然后再返回给回单代理程序

    获取到的文件名称为“客户号_生成日期YYYYMMD_交易类型_下载序号.zip",内容包含这个账号在这个交易日期的所有回单文件,回单文件的名称为“交易日期YYYYMMDD+交易账号+交易流水号.pdf”。

    说明:这三个要素(交易日期,交易账号,交易流水号),也能够在交易明细报文中返回,实现电子回单和交易明细的精确匹配。


3. 银行推送zip文件到中国银行的SFTP服务器上

    中国银行的电子回单文件生成与文件名返回是不同步的;操作时若处于业务高峰,耗时可能会较长(超过200分钟),其他情况下正常十分钟左右可返回回单到中行sftp服务器上。

    中国银行的sftp服务器信息如下(具体可以咨询银行技术。一般联系银行开通回单功能后,银行会发邮件给到客户的,邮件内容会有说明):


    注意,银行提供了登录用户名和初始密码之后,首次登录要求修改密码,一般可以使用winscp进行登录后修改密码;修改初始密码之后,再回单电子回答系统-以后配置页面配置sftp信息的时候,“登录SFTP服务器使用的密码”就输入这个修改后的密码。

    需要说明的是,目前遇到的大多数客户都是发请求后银行推送回单到中行的SFTP服务器上;但可能也有个别客户,是客户自己搭建了SFTP服务器,银行推送回单到客户自己搭建的SFTP服务器上;或者其它的形式;具体是何种形式,请在开通回单功个后,看下银行方发送的文档说明,或咨询银行方技术人员。如果不是中行提供的SFTP服务,配置上会有些差异,具体问题再具体沟通。

    中行推送的回单zip包如下:

    zip文件解压后内容如下:


4. 回单代理程序从中行SFTP服务上下载回单文件到回单代理程序服务器,然后进行扫描。


二、回单代理程序 - 配置项 - 银行配置

1. 配置中行SFTP信息

    回单获取方式选择“远程sftp获取”,然后配置中行的SFTP服务器的信息,包括IP地址、端口、用户名、密码。“银行SFTP文件保存子路径”默认为空即可,一般是推送到SFTP的根目录下(但是也遇到过推送到了/Inbox 子目录下;所以一般可以先通过winscp连上中行sftp,看下以后推送的文件是放在根目录下还是子目录 /Inbox 下)。

2. 是否获取当日回单

    中国银行支持获取当日回单。如果选择"是",请对下方【[当日回单创建]任务调度配置】进行设置。

3. 配置中行电子回单调度方式

    因为中国银行的电子回单文件生成与文件名返回是不同步的,如果调度方式配置为【测试使用】,那任务较少的情况下发请求后1分钟内可能就会去连中行SFTP服务器下载zip文件,此时可能银行还没推送回单文件过来;那么任务状态就会变成失败,原因往往显示为“ 中行回单下载异常,使用SFTP下载回单文件发生异常:/xxxxxxxxx_20230425_7802_187b664e876.zip is not a valid file path”。

    所以,正式上线后,电子回单调度方式请修改为【正式使用】或者【自定义】模式,不要用【测试使用】。


三、任务的[创建]->[预处理] ->[下载] ->[扫描]阶段]

创建调度:创建中国银行的回单任务。

预处理调度:通过银企平台发送b2e0500请求到银行,获取到文件名称(zip)。

下载调度:回单代理程序访问中行SFTP服务,下载zip文件根目录下的tempPath目录,再转移到scanPath目录

扫描调度:回单代理程序将下载到scanPath目录的文件扫描,解析出结构化数据保存到数据库,同时将文件保存到bakPath目录下。


四、常见问题

1、 中国银行下载不到回单,提示:银行返回报文的回单文件名为空

2、 中行任务失败,提示 xxx.zip is not a valid file path

3、 银企平台 - 业务管理 - 业务系统配置 - 电子回单格式选择

    中国银行支持两种格式的回单:报文、文件。如果客户要下载的是文件格式的回单,那在部署回单代理程序、配置并下载中国银行的回单之后,还要在银企平台 - 业务管理 - 银行业务配置页面把“电子回单格式选择”设置为“文件”,重启银企服务生效。

4、 中行任务下载完成,结果为空


【电子回单】中国银行(BOC_NET)回单配置指南

一、中行下载回单的流程1. 回单代理程序通过银企平台发送查询及下载回单的请求给中国银行前置机,银行前置机将请求转发给银行 回单代理...
点击下载文档
确认删除?
回到顶部
客服QQ
  • 客服QQ点击这里给我发消息