【电子回单】民生银行直连版(CMBC_DC)回单配置指南
民生银行推送电子回单的方式,是发请求银行返回文件流。具体来讲,是电子回单程序向前置机发送回单下载的请求,银行收到请求后将回单文件的文件流通过前置机返回给回单程序,电子回单程序将回单文件的文件流转成文件存在本地。这种推送回单的方式,配置上往往比较简单。
一、回单代理程序 - 配置项 - 银行配置
1. 银企前置机IP地址、端口、企业客户号、登录用户号、登录密码
银行前置机IP地址
银行前置机端口
民生银行银企直联的'企业客户号'
民生银行银企直联的'登录用户号'
民生银行银企直联的'登录密码'
以上配置信息请参考银企平台 - 系统管理 - 前置机配置页面,选择“民生银行3.0版(CMBC_DC)”的配置,如下图所示:
2. 下载的回单的打印状态
下载的回单的打印状态,默认只下载未打印的回单。默认值(全部)
二、任务的[创建]->[预处理] ->[下载] ->[扫描]阶段
为了快速的看到效果,可以在[配置项 - 银行配置]页面,将“民生银行电子回单调度方式”修改为“测试使用”(测试调度仅需要大约4分钟就可以完成一次调度)。修改并保存后,在[模块管理]页面重启【回单模块】生效。
1. 创建调度
自动创建所有回单账号的前一天的回单任务。
刚部署的情况下是没有任务的,可以点【+添加任务】按钮手动添加一个任务进行测试。
2. 预处理调度
根据任务的账号和日期等信息调用客户回单查询(b2eElectNoteQryNew)接口,返回回单的回单内部编号innerNo、xml文件名称FileName,以及交易流水号svrId(流水号+交易金额 可与交易明细一一对应)。
注意:
1)b2eElectNoteQryNew接口返回的文件名称,b2eElectNoteDownLoad回单下载时原值返回即可,不代表回单文件就是xml格式的,b2eElectNoteDownLoad回单下载返回的是回单PDF数据流;
2)回单查询后需尽快进行回单下载,否则报错“无记录”,目前生产时间间隔为1小时,b2eElectNoteDownLoad回单下载时,回单内部编号和文件名称需最新查询的结果;
3)svrId表示交易流水号,手续费回单的流水号与原转账交易的流水号相同,结息回单的流水号为空;
4)此交易支持T和T-n(n>0)日回单查询,查询T日回单时,BeginDate和EndDate需等于当前日期,否则按照查询T-n日回单处理。(T日回单查询需要单独申请,如有需要请联您的客户经理;但金蝶电子回单平台目前不支持民生银行的当日回单下载)
b2eElectNoteQryNew接口的请求和响应报文如下:
回单查询-请求报文page1: <?xml version="1.0" encoding="GB2312"?> <CMBC header="100" version="100" security="none" trnCode="b2eElectNoteQryNew"> <requestHeader> <dtClient>2023-08-04 09:25:02</dtClient> <clientId>2200218180</clientId> <userId>22xxxxxxxxxx2</userId> <userPswd>xxxxxx</userPswd> <language>chs</language> <appId>nsbdes</appId> <appVer>203</appVer> </requestHeader> <xDataBody> <insId>1687273403469266944</insId> <saAcctNo>6xxxxxxx5</saAcctNo> <BeginDate>2023-07-14</BeginDate> <EndDate>2023-07-14</EndDate> <PrintState>0</PrintState> <pageNo>1</pageNo> <pageSize>10</pageSize> </xDataBody> </CMBC> 回单查询-响应报文page1: <?xml version="1.0" encoding="GB2312"?> <CMBC security="none" trnCode="b2eElectNoteQryNew" header="100" version="100" > <responseHeader> <status> <code>0</code> <severity>info</severity> <message>ok</message> </status> <dtServer>2023-08-04 09:25:02</dtServer> <userKey>N</userKey> <dtDead></dtDead> <language>chs</language> </responseHeader> <xDataBody> <Count>1</Count> <List> <Map> <innerNo>Mjk0MTAwMTI1NDY=</innerNo> <TrsDate>2023-07-14</TrsDate> <BillName>XXXX业务凭证(收款)</BillName> <AcNo>6xxxxxxx5</AcNo> <Currency>人民币</Currency> <LoanFlag>1</LoanFlag> <TrsAmount>1800.00</TrsAmount> <PrintCount>0</PrintCount> <FileName>recp_A1720230804092502220021818000218881.xml</FileName> <svrId>54000202307140000008621</svrId> <insId></insId> </Map> </List> </xDataBody> </CMBC>
预处理调度完成后,任务的状态会变成【预处理完成】,如下图所示。此时点击“详情”,可以看到文件名:
注意:此图为下载完成后的截图。如果预处理调度完成后点“详情”,这个任务明细页面中状态应该是“创建”;下载调度完成后,这里的状态才会变成“下载完成”。
3. 下载调度
遍历预处理阶段b2eElectNoteQryNew接口返回的回单编号、文件名称等,调用b2eElectNoteDownLoad接口(后续版本会支持使用新接口b2eElectNoteDownLoadNew),返回经过Base64加密之后的字符串DownloadFileContent和pdf文件名称DownloadFileName。
对于返回的文件流,经过Base64解码,将其存放在tempPath\CMBC_DC路径下并重命名(文件名规则为:交易日期+账号+借贷标识(0-借 1-贷) 交易金额+交易流水号.pdf),然后移动文件到scanPath\CMBC_DC路径下。至此,下载任务结束。
b2eElectNoteDownLoad接口的请求和响应报文如下:
文件下载-请求报文: <?xml version="1.0" encoding="GBK"?> <CMBC header="100" version="100" security="none" trnCode="b2eElectNoteDownLoad"> <requestHeader> <dtClient>2023-08-04 09:26:00</dtClient> <clientId>2200218180</clientId> <userId>22xxxxxxxxxx2</userId> <userPswd>xxxxxx</userPswd> <language>chs</language> <appId>nsbdes</appId> <appVer>203</appVer> </requestHeader> <xDataBody> <insId>1687273646495629312</insId> <innerNo>Mjk0MTAwMTI1NDY=</innerNo> <xmlFileName>recp_A1720230804092502220021818000218881.xml</xmlFileName> </xDataBody> </CMBC> 文件下载-响应报文: <?xml version="1.0" encoding="GB2312"?> <CMBC security="none" trnCode="b2eElectNoteDownLoad" header="100" version="100" > <responseHeader> <status> <code>0</code> <severity>info</severity> <message>ok</message> </status> <dtServer>2023-08-04 09:26:00</dtServer> <userKey>N</userKey> <dtDead></dtDead> <language>chs</language> </responseHeader> <xDataBody> <trnId></trnId> <DownloadFileContent>JVBERi0xLjQKJeLjz9MKMSAwIG9ia……………………o=</DownloadFileContent> <DownloadFileName>pdf_A20230804092600220021818000289281.pdf</DownloadFileName> </xDataBody> </CMBC>
下载调度结束后,任务的状态会变成“下载完成”。
4. 扫描调度
对下载到scanPath目录的文件进行扫描,解析出结构化数据保存到回单库的表中(主要是这两个表:t_receipt_detail、t_receipt_info ),同时将文件保存到bakPath目录下。扫描调度结束后,可点击回单任务的【结果】查看回单的结构化数据。如下图所示:
【电子回单】民生银行直连版(CMBC_DC)回单配置指南
本文2024-09-22 20:17:44发表“eas cloud知识”栏目。
本文链接:https://wenku.my7c.com/article/kingdee-eas-112706.html