【电子回单】民生银行直连版(CMBC_DC)回单配置指南

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

【电子回单】民生银行直连版(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)回单配置指南

民生银行推送电子回单的方式,是发请求银行返回文件流。具体来讲,是电子回单程序向前置机发送回单下载的请求,银行收到请求后将回单文...
点击下载文档
确认删除?
回到顶部
客服QQ
  • 客服QQ点击这里给我发消息