【电子回单】中国农业银行公网版（ABC_DC）回单配置指南 - 【CMRA25、CMRA76】

    中国农业银行公网版（ABC_DC）的回单推送方式支持三种：主动推送、CMRA25接口、CMRA76接口。

    其中，“主动推送”方式，回单代理程序不需要跟银企通交互，其配置请参考文档：中国农业银行公网版（ABC_DC）回单配置指南 - 【主动推送】

    本文主要介绍发请求银行推送回单文件（CMRA25接口、CMRA76接口）的回单配置流程。

一、接口说明

1. CMRA25接口

    使用CMRA25接口自行主动下载的方式适用场景：客户回单数据量小，每日数据包大小在50M以下

1）需要与总行对接，通过CMRA25接口可根据银企通编号（CorpNo）、查询标志（AlterFlag，默认为1）、查询文件包日期（StartDate）等联机下载PDF电子回单文件包。

文件包名示例：11050153100000930_20181213_CommonSingle_1.zip

文件包的内容等可参考 中国农业银行公网版（ABC_DC）回单配置指南 - 【主动推送】 文中总行推送的文件包说明。

    接口的请求和响应报文如下：

请求：

<?xml version="1.0" encoding="GBK"?>

<ap>

    <CCTransCode>CMRA25</CCTransCode>

    <ProductID>ICC</ProductID>

    <ChannelType>ERP</ChannelType>

    <CorpNo>11050153100000930</CorpNo>

    <OpNo>0002</OpNo>

    <AuthNo></AuthNo>

    <ReqSeqNo>1651785814717235200</ReqSeqNo>

    <ReqDate>20181214</ReqDate>

    <ReqTime>111001</ReqTime>

    <Sign></Sign>

    <Corp>

        <StartDate>20181213</StartDate>

        <AlterFlag>1</AlterFlag>

    </Corp>

</ap>

响应：

<ap>

    <Cmp>

        <BatchFileName>11050153100000930_20181213_CommonSingle_1.zip</BatchFileName>

    </Cmp>

    <RespSource>0</RespSource>

    <RespCode>0000</RespCode>

    <RespInfo>交易成功</RespInfo>

    <RxtInfo>交易成功</RxtInfo>

    <Cme>

        <RecordNum>0</RecordNum>

        <FieldNum>0</FieldNum>

    </Cme>

    <FileFlag>1</FileFlag>

</ap>

2）该联机下载交易对文件包大小有严格要求，目前限定不得大于50M，否则不允许下载。

3）文件包保留日期目前默认为7天，即客户可以自行下载7天之内的文件包。

    调用CMRA25接口，交易成功后，银行服务器会推送文件包到银企通安装目录的detail目录下。

     另，使用CMRA25接口的时候，回单系统首先会访问SFTP检查是否存在xxxxxxxxxxxxxxxx_yyyymmdd_CommonSingle_1.zip包，如果存在，就会直接下载这个zip包，不再调用CMRA25接口发请求给银行。

2. CMRA76接口

1）首先调用查询结算账户明细交易接口CQRA10，根据银行账号、交易日期等信息获取到回单日志号、回单对方账号、回单交易金额、以及交易明细概要文件等信息。

    报文如下：

农行查询交易明细请求：CQRA10 

<?xml version="1.0" encoding="GBK"?>

<ap>

    <CCTransCode>CQRA10</CCTransCode>

    <ProductID>ICC</ProductID>

    <ChannelType>ERP</ChannelType>

    <CorpNo>15397053200000036</CorpNo>

    <OpNo>0005</OpNo>

    <AuthNo></AuthNo>

    <ReqSeqNo>1630116283351564288</ReqSeqNo>

    <ReqDate>20230303</ReqDate>

    <ReqTime>160302</ReqTime>

    <Sign></Sign>

    <Corp>

        <StartDate>20230302</StartDate>

        <EndDate>20230302</EndDate>

    </Corp>

    <Channel>

        <LastJrnNo>0</LastJrnNo>

    </Channel>

    <Cmp>

        <DbAccNo>15394101040030298</DbAccNo>

        <DbProv>26</DbProv>

        <DbCur>01</DbCur>

        <StartTime></StartTime>

    </Cmp>

</ap>

农行查询交易明细响应：CQRA10 

<ap>

    <RespSource>0</RespSource>

    <RespCode>0000</RespCode>

    <RespInfo>交易成功</RespInfo>

    <RxtInfo></RxtInfo>

    <RespSeqNo>170370891801</RespSeqNo>

    <Cmp>

        <BatchFileName>TBANK.7505.26320153100003944.17037089180190638080-D-032</BatchFileName>

        <RespPrvData></RespPrvData>

        <ContFlg></ContFlg>

    </Cmp>

    <Cme>

        <RecordNum>11</RecordNum>

        <FieldNum>33</FieldNum>

    </Cme>

    <FileFlag>1</FileFlag>

    <RespDate>20230303</RespDate>

    <RespTime>000003</RespTime>

    <CCTransCode>CQRA10</CCTransCode>

</ap>

2）CQRA10响应报文返回交易成功时，回单程序会连上SFTP去银企通服务器下载概要文件，并读取概要文件信息；然后以其中一笔明细的详细信息作为请求条件，上送至CMRA76的请求报文中，获取到回单文件名称，PDF文件名规则：帐号_日期_日志号_回单编号.pdf。当返回/ap/FileFlag节点值为0时，表示无文件，无记录。

    下面所示，为根据银行账号、省市代码、币别、对方账号、交易日期、日志号、交易金额等信息调用CMRA76 接口的请求和响应报文：

农行回单下载请求：CMRA76 

<?xml version="1.0" encoding="GBK"?>

<ap>

    <CCTransCode>CMRA76</CCTransCode>

    <ProductID>ICC</ProductID>

    <ChannelType>ERP</ChannelType>

    <CorpNo>15157153200000035</CorpNo>

    <OpNo>0011</OpNo>

    <AuthNo></AuthNo>

    <ReqSeqNo>1655513078864805888</ReqSeqNo>

    <ReqDate>20230508</ReqDate>

    <ReqTime>180050</ReqTime>

    <Sign></Sign>

    <Cmp>

        <DbProv>15</DbProv>

        <DbAccNo>155101040013566</DbAccNo>

        <DbCur>01</DbCur>

        <CrProv>15</CrProv>

        <CrAccNo>155101040027863</CrAccNo>