【电子回单】建设银行企业现金管理直连版(CCB_CCIP)回单配置
建设银行企业现金管理直连版(CCB_CCIP)的电子回单是发请求银行返回文件流的方式。
一、回单代理程序 - 配置项 - 银行配置
1. 参考银企平台前置机配置
在配置回单时,往往已经在银企平台完成了余额、交易明细、付款等测试,所以[回单代理程序 - 配置项 - 银行配置]页面的一些参数配置可以参考银企平台-系统管理-前置机配置页面中,建设银行企业现金管理直连版(CCB_CCIP)的配置。涉及如下配置项:
银行前置机IP地址
银行前置机端口
企业操作员代码
集团编号(组织机构代码证号,长度10位),客户通过签约唯一确认
客户编号,客户通过签约唯一确认
电子银行合约号(长度30位)
现金客户树编号,客户通过签约唯一确认
现金客户树节点编号,客户通过签约唯一确认
金蝶建设银行前置机文件端口
2. 是否银行主动推送回单
默认请选择否,蒙牛集团请选择是。
3. 实体编号(一般默认CN000即可)
4. 回单下载接口选择
默认请选择P1CCMS006,蒙牛集团请选择P1CCMS008。
二、任务的[创建]->[预处理] ->[下载] ->[扫描]阶段
1. 创建调度
创建建行现金管理直连版的回单任务。
2. 预处理调度
回单代理程序发送查询回单的请求给前置机代理程序,前置机代理程序将请求转发给银行。具体如下:
请求URL:http://前置机代理程序的IP:2333
1. 调用回单索引查询P1CCMS001获取到回单编号信息,如下:
<INNER_NO><![CDATA[43020231018944246991]]></INNER_NO>
2. 调用回单文件下载[同步模式]接口P1CCMS006根据待下载的回单编号(DOWNLOAD_NOS字段)获取到文件名,如下:
<FILE_NAME><![CDATA[20230508/800/20230508080003296678_19990.pdf]]></FILE_NAME>
如果有多个回单编号,就调用多次接口P1CCMS006。
3. 下载调度
向前置机代理程序发起文件下载请求
请求URL:http://前置机代理程序的IP:7777
请求报文类似下面这样:
<?xml version="1.0" encoding="UTF-8"?>
<frontProxyRequst>
<header>
<sequnce>1655384522100834304</sequnce>
<type>download</type>
</header>
<body>
<fileName><![CDATA[20230508/800/20230508080003296678_19990.pdf]]></fileName>
<bankFile><![CDATA[receiptDownload]]></bankFile>
</body>
</frontProxyRequst>
响应报文是回单文件的文件流。电子回单程序将回单文件的文件流转成文件存在回单文件下载保存根目录的tempPath目录下,再转移到scanPath目录下。
4. 扫描调度
回单代理程序将下载到scanPath目录的文件扫描,解析出结构化数据保存到数据库,同时将文件保存到bakPath目录下。
三、常见问题
如果回单服务器和银企服务器不在同一台机器,还需要把回单服务器IP设置到建行前置机代理程序“访问IP地址白名单”中。
另,回单服务器能够访问建行前置机代理程序的服务端口2333和文件业务服务端口7777。
四、附录 - 完整的请求和响应报文
某账号35xxxxxxxxxxxxxxx5在2023.5.4号发生了两笔交易,有两个回单。在回单平台下载这2个回单,调用接口的完整过程如下。
一、回单索引查询 P1CCMS001 建设银行企业现金管理直连版 回单索引查询 P1CCMS001 —— 请求报文<?xml version="1.0" encoding="UTF-8"?> <Transaction> <Transaction_Header> <SYS_TX_CODE><![CDATA[P1CCMS001]]></SYS_TX_CODE> <SYS_REQ_LEN><![CDATA[1021]]></SYS_REQ_LEN> <SYS_REQ_TIME><![CDATA[093503813]]></SYS_REQ_TIME> <SYS_TX_VRSN><![CDATA[01]]></SYS_TX_VRSN> <TXN_DT><![CDATA[20230614]]></TXN_DT> <TXN_TM><![CDATA[093503]]></TXN_TM> <TXN_STFF_ID><![CDATA[xxxxxx]]></TXN_STFF_ID> <MULTI_TENANCY_ID><![CDATA[CN000]]></MULTI_TENANCY_ID> <LNG_ID><![CDATA[zh-cn]]></LNG_ID> <STS_TRACE_ID></STS_TRACE_ID> <CHNL_CUST_NO><![CDATA[XMxxxxxxxxxxxxx1]]></CHNL_CUST_NO> <IttParty_Jrnl_No><![CDATA[1668794146225127424]]></IttParty_Jrnl_No> <Txn_Itt_IP_Adr></Txn_Itt_IP_Adr> </Transaction_Header> <Transaction_Body> <request> <ASPD_ECD><![CDATA[00000886]]></ASPD_ECD> <SChl_No><![CDATA[000000000000000]]></SChl_No> <FwCtl_Node_ID><![CDATA[000000000000000]]></FwCtl_Node_ID> <IttParty_Bsn_Dt><![CDATA[20230614]]></IttParty_Bsn_Dt> <Grp_ID></Grp_ID> <Cst_ID><![CDATA[7xxxxxxxxxxxxxx4]]></Cst_ID> <Prim_AR_No><![CDATA[XMxxxxxxxxxxxxxxx1]]></Prim_AR_No> <Root_Node_PdAr_ID></Root_Node_PdAr_ID> <PdAr_ID></PdAr_ID> <SvM24Hr_Ind><![CDATA[0]]></SvM24Hr_Ind> <Tmzon_ECD><![CDATA[08]]></Tmzon_ECD> <Rqs_Upload_File_Nm></Rqs_Upload_File_Nm> <Cmpt_Ent_ID><![CDATA[0000CN000]]></Cmpt_Ent_ID> <WF_BIZ_ID><![CDATA[1668794146233516032]]></WF_BIZ_ID> <WF_MNPLT_TP><![CDATA[01]]></WF_MNPLT_TP> <WF_FCN_ID></WF_FCN_ID> <CCstTr_ID><![CDATA[CMNxxxxxxxx6]]></CCstTr_ID> <CCstTrNdID><![CDATA[NDxxxxxxxxxxxxxxxxxxxxx1]]></CCstTrNdID> <ACCT_NO><![CDATA[35xxxxxxxxxxxxxxx5]]></ACCT_NO> <BEGIN_DATE><![CDATA[20230504]]></BEGIN_DATE> <END_DATE><![CDATA[20230504]]></END_DATE> <PAGE_NO><![CDATA[1]]></PAGE_NO> <INQUIRE_NUM><![CDATA[20]]></INQUIRE_NUM> </request> </Transaction_Body> </Transaction> 建设银行企业现金管理直连版 回单索引查询 P1CCMS001 —— 响应报文<?xml version="1.0" encoding="UTF-8"?> <Transaction> <Transaction_Header> <SYS_TX_VRSN><![CDATA[01]]></SYS_TX_VRSN> <SYS_MSG_LEN><![CDATA[]]></SYS_MSG_LEN> <SYS_RECV_TIME><![CDATA[20230614093643039]]></SYS_RECV_TIME> <SYS_RESP_TIME><![CDATA[20230614093643189]]></SYS_RESP_TIME> <SYS_PKG_STS_TYPE><![CDATA[01]]></SYS_PKG_STS_TYPE> <SYS_TX_STATUS><![CDATA[00]]></SYS_TX_STATUS> <SYS_RESP_CODE><![CDATA[000000000000]]></SYS_RESP_CODE> <SYS_RESP_DESC_LEN><![CDATA[]]></SYS_RESP_DESC_LEN> <SYS_RESP_DESC><![CDATA[ok]]></SYS_RESP_DESC> <SYS_EVT_TRACE_ID><![CDATA[1010010451686706603452580]]></SYS_EVT_TRACE_ID> <SYS_SND_SERIAL_NO><![CDATA[0000000000]]></SYS_SND_SERIAL_NO> <IttParty_Jrnl_No><![CDATA[1668794146225127424]]></IttParty_Jrnl_No> <SYS_TX_CODE><![CDATA[P1CCMS001]]></SYS_TX_CODE> <CHNL_CUST_NO><![CDATA[XMxxxxxxxxxxxxx1]]></CHNL_CUST_NO> <tran_response> <status><![CDATA[COMPLETE]]></status> </tran_response> </Transaction_Header> <Transaction_Body> <response> <PAGE_NO><![CDATA[1]]></PAGE_NO> <TOT_PAGE_NUM><![CDATA[1]]></TOT_PAGE_NUM> <RESP_CODE><![CDATA[000000]]></RESP_CODE> <RESP_MESG><![CDATA[ok]]></RESP_MESG> <Record p_type="G"> <INNER_NO><![CDATA[35120230019126147287]]></INNER_NO> <TRAN_DATE><![CDATA[20230504]]></TRAN_DATE> <LOG_NO><![CDATA[3510006020NDP9B4HTJ]]></LOG_NO> <CR_COD><![CDATA[贷]]></CR_COD> <TX_AMT>57517.88</TX_AMT> <DOC_TYP><![CDATA[电汇凭证]]></DOC_TYP> <DOC_NO><![CDATA[]]></DOC_NO> <OP_ACCT_NO><![CDATA[0xxxxxxxxxxxxx4]]></OP_ACCT_NO> <OP_ACCT_NAME><![CDATA[xxxxxxxxxx有限公司]]></OP_ACCT_NAME> <CURR_NAME><![CDATA[人民币]]></CURR_NAME> <Acc_Dtl_SN>92296</Acc_Dtl_SN> <Atch_Ind><![CDATA[N]]></Atch_Ind> </Record> <Record p_type="G"> <INNER_NO><![CDATA[35120230019126147358]]></INNER_NO> <TRAN_DATE><![CDATA[20230504]]></TRAN_DATE> <LOG_NO><![CDATA[35100060216FPLGIQ9U]]></LOG_NO> <CR_COD><![CDATA[借]]></CR_COD> <TX_AMT>3773.79</TX_AMT> <DOC_TYP><![CDATA[]]></DOC_TYP> <DOC_NO><![CDATA[]]></DOC_NO> <OP_ACCT_NO><![CDATA[3xxxxxxxxxxxxxxxxxxxxxxxx5]]></OP_ACCT_NO> <OP_ACCT_NAME><![CDATA[xxxxxx户]]></OP_ACCT_NAME> <CURR_NAME><![CDATA[人民币]]></CURR_NAME> <Acc_Dtl_SN>92297</Acc_Dtl_SN> <Atch_Ind><![CDATA[N]]></Atch_Ind> </Record> </response> </Transaction_Body> </Transaction> 获取到回单编号<INNER_NO>:35120230019126147287、35120230019126147358,接下来根据回单编号调用P1CCMS006获取文件名 二、回单文件下载[同步模式](P1CCMS006) 第一个回单编号35120230019126147287: 建设银行企业现金管理直连版 回单文件下载[同步模式](P1CCMS006) —— 请求报文<?xml version="1.0" encoding="UTF-8"?> <Transaction> <Transaction_Header> <SYS_TX_CODE><![CDATA[P1CCMS006]]></SYS_TX_CODE> <SYS_REQ_LEN><![CDATA[1021]]></SYS_REQ_LEN> <SYS_REQ_TIME><![CDATA[093504206]]></SYS_REQ_TIME> <SYS_TX_VRSN><![CDATA[01]]></SYS_TX_VRSN> <TXN_DT><![CDATA[20230614]]></TXN_DT> <TXN_TM><![CDATA[093504]]></TXN_TM> <TXN_STFF_ID><![CDATA[xxxxxx]]></TXN_STFF_ID> <MULTI_TENANCY_ID><![CDATA[CN000]]></MULTI_TENANCY_ID> <LNG_ID><![CDATA[zh-cn]]></LNG_ID> <STS_TRACE_ID></STS_TRACE_ID> <CHNL_CUST_NO><![CDATA[XMxxxxxxxxxxxxx1]]></CHNL_CUST_NO> <IttParty_Jrnl_No><![CDATA[1668794147869294592]]></IttParty_Jrnl_No> <Txn_Itt_IP_Adr></Txn_Itt_IP_Adr> </Transaction_Header> <Transaction_Body> <request> <ASPD_ECD><![CDATA[00000886]]></ASPD_ECD> <SChl_No><![CDATA[000000000000000]]></SChl_No> <FwCtl_Node_ID><![CDATA[000000000000000]]></FwCtl_Node_ID> <IttParty_Bsn_Dt><![CDATA[20230614]]></IttParty_Bsn_Dt> <Grp_ID></Grp_ID> <Cst_ID><![CDATA[7xxxxxxxxxxxxxx4]]></Cst_ID> <Prim_AR_No><![CDATA[XMxxxxxxxxxxxxxxx1]]></Prim_AR_No> <Root_Node_PdAr_ID></Root_Node_PdAr_ID> <PdAr_ID></PdAr_ID> <SvM24Hr_Ind><![CDATA[0]]></SvM24Hr_Ind> <Tmzon_ECD><![CDATA[08]]></Tmzon_ECD> <Rqs_Upload_File_Nm></Rqs_Upload_File_Nm> <Cmpt_Ent_ID><![CDATA[0000CN000]]></Cmpt_Ent_ID> <WF_BIZ_ID><![CDATA[1668794147877683200]]></WF_BIZ_ID> <WF_MNPLT_TP><![CDATA[01]]></WF_MNPLT_TP> <WF_FCN_ID></WF_FCN_ID> <CCstTr_ID><![CDATA[CMNxxxxxxxx6]]></CCstTr_ID> <CCstTrNdID><![CDATA[NDxxxxxxxxxxxxxxxxxxxxx1]]></CCstTrNdID> <ACCT_NO><![CDATA[35xxxxxxxxxxxxxxx5]]></ACCT_NO> <DOWNLOAD_NOS><![CDATA[35120230019126147287]]></DOWNLOAD_NOS> </request> </Transaction_Body> </Transaction> 建设银行企业现金管理直连版 回单文件下载[同步模式](P1CCMS006) —— 响应报文<?xml version="1.0" encoding="UTF-8"?> <Transaction> <Transaction_Header> <SYS_TX_VRSN><![CDATA[01]]></SYS_TX_VRSN> <SYS_MSG_LEN><![CDATA[]]></SYS_MSG_LEN> <SYS_RECV_TIME><![CDATA[20230614093643426]]></SYS_RECV_TIME> <SYS_RESP_TIME><![CDATA[20230614093643592]]></SYS_RESP_TIME> <SYS_PKG_STS_TYPE><![CDATA[01]]></SYS_PKG_STS_TYPE> <SYS_TX_STATUS><![CDATA[00]]></SYS_TX_STATUS> <SYS_RESP_CODE><![CDATA[000000000000]]></SYS_RESP_CODE> <SYS_RESP_DESC_LEN><![CDATA[]]></SYS_RESP_DESC_LEN> <SYS_RESP_DESC><![CDATA[ok]]></SYS_RESP_DESC> <SYS_EVT_TRACE_ID><![CDATA[1010010501686706603087510]]></SYS_EVT_TRACE_ID> <SYS_SND_SERIAL_NO><![CDATA[0000000000]]></SYS_SND_SERIAL_NO> <IttParty_Jrnl_No><![CDATA[1668794147869294592]]></IttParty_Jrnl_No> <SYS_TX_CODE><![CDATA[P1CCMS006]]></SYS_TX_CODE> <CHNL_CUST_NO><![CDATA[XMxxxxxxxxxxxxx1]]></CHNL_CUST_NO> <tran_response> <status><![CDATA[COMPLETE]]></status> </tran_response> </Transaction_Header> <Transaction_Body> <response> <FILE_LIST_PACK p_type="G"> <FILE_NUM><![CDATA[1]]></FILE_NUM> <FILE_INFO p_type="G"> <FILE_NAME><![CDATA[20230614/100/02A420230614093643570725_11798.pdf]]></FILE_NAME> <Msg_Smy><![CDATA[1dd86e1a15833ebf306bcd15009ede37]]></Msg_Smy> </FILE_INFO> </FILE_LIST_PACK> </response> </Transaction_Body> </Transaction> 第二个回单编号35120230019126147358: 建设银行企业现金管理直连版 回单文件下载[同步模式](P1CCMS006) —— 请求报文<?xml version="1.0" encoding="UTF-8"?> <Transaction> <Transaction_Header> <SYS_TX_CODE><![CDATA[P1CCMS006]]></SYS_TX_CODE> <SYS_REQ_LEN><![CDATA[1021]]></SYS_REQ_LEN> <SYS_REQ_TIME><![CDATA[093504546]]></SYS_REQ_TIME> <SYS_TX_VRSN><![CDATA[01]]></SYS_TX_VRSN> <TXN_DT><![CDATA[20230614]]></TXN_DT> <TXN_TM><![CDATA[093504]]></TXN_TM> <TXN_STFF_ID><![CDATA[xxxxxx]]></TXN_STFF_ID> <MULTI_TENANCY_ID><![CDATA[CN000]]></MULTI_TENANCY_ID> <LNG_ID><![CDATA[zh-cn]]></LNG_ID> <STS_TRACE_ID></STS_TRACE_ID> <CHNL_CUST_NO><![CDATA[XMxxxxxxxxxxxxx1]]></CHNL_CUST_NO> <IttParty_Jrnl_No><![CDATA[1668794149303746560]]></IttParty_Jrnl_No> <Txn_Itt_IP_Adr></Txn_Itt_IP_Adr> </Transaction_Header> <Transaction_Body> <request> <ASPD_ECD><![CDATA[00000886]]></ASPD_ECD> <SChl_No><![CDATA[000000000000000]]></SChl_No> <FwCtl_Node_ID><![CDATA[000000000000000]]></FwCtl_Node_ID> <IttParty_Bsn_Dt><![CDATA[20230614]]></IttParty_Bsn_Dt> <Grp_ID></Grp_ID> <Cst_ID><![CDATA[7xxxxxxxxxxxxxx4]]></Cst_ID> <Prim_AR_No><![CDATA[XMxxxxxxxxxxxxxxx1]]></Prim_AR_No> <Root_Node_PdAr_ID></Root_Node_PdAr_ID> <PdAr_ID></PdAr_ID> <SvM24Hr_Ind><![CDATA[0]]></SvM24Hr_Ind> <Tmzon_ECD><![CDATA[08]]></Tmzon_ECD> <Rqs_Upload_File_Nm></Rqs_Upload_File_Nm> <Cmpt_Ent_ID><![CDATA[0000CN000]]></Cmpt_Ent_ID> <WF_BIZ_ID><![CDATA[1668794149307940864]]></WF_BIZ_ID> <WF_MNPLT_TP><![CDATA[01]]></WF_MNPLT_TP> <WF_FCN_ID></WF_FCN_ID> <CCstTr_ID><![CDATA[CMNxxxxxxxx6]]></CCstTr_ID> <CCstTrNdID><![CDATA[NDxxxxxxxxxxxxxxxxxxxxx1]]></CCstTrNdID> <ACCT_NO><![CDATA[35xxxxxxxxxxxxxxx5]]></ACCT_NO> <DOWNLOAD_NOS><![CDATA[35120230019126147358]]></DOWNLOAD_NOS> </request> </Transaction_Body> </Transaction> 建设银行企业现金管理直连版 回单文件下载[同步模式](P1CCMS006) —— 响应报文<?xml version="1.0" encoding="UTF-8"?> <Transaction> <Transaction_Header> <SYS_TX_VRSN><![CDATA[01]]></SYS_TX_VRSN> <SYS_MSG_LEN><![CDATA[]]></SYS_MSG_LEN> <SYS_RECV_TIME><![CDATA[20230614093643766]]></SYS_RECV_TIME> <SYS_RESP_TIME><![CDATA[20230614093643921]]></SYS_RESP_TIME> <SYS_PKG_STS_TYPE><![CDATA[01]]></SYS_PKG_STS_TYPE> <SYS_TX_STATUS><![CDATA[00]]></SYS_TX_STATUS> <SYS_RESP_CODE><![CDATA[000000000000]]></SYS_RESP_CODE> <SYS_RESP_DESC_LEN><![CDATA[]]></SYS_RESP_DESC_LEN> <SYS_RESP_DESC><![CDATA[ok]]></SYS_RESP_DESC> <SYS_EVT_TRACE_ID><![CDATA[1010010401686706603936020]]></SYS_EVT_TRACE_ID> <SYS_SND_SERIAL_NO><![CDATA[0000000000]]></SYS_SND_SERIAL_NO> <IttParty_Jrnl_No><![CDATA[1668794149303746560]]></IttParty_Jrnl_No> <SYS_TX_CODE><![CDATA[P1CCMS006]]></SYS_TX_CODE> <CHNL_CUST_NO><![CDATA[XMxxxxxxxxxxxxx1]]></CHNL_CUST_NO> <tran_response> <status><![CDATA[COMPLETE]]></status> </tran_response> </Transaction_Header> <Transaction_Body> <response> <FILE_LIST_PACK p_type="G"> <FILE_NUM><![CDATA[1]]></FILE_NUM> <FILE_INFO p_type="G"> <FILE_NAME><![CDATA[20230614/200/02A420230614093643565389_29633.pdf]]></FILE_NAME> <Msg_Smy><![CDATA[a9ea36055bada613ed1fac2e42a01388]]></Msg_Smy> </FILE_INFO> </FILE_LIST_PACK> </response> </Transaction_Body> </Transaction> 三、向前置机代理程序发请求下载回单文件 第一个回单文件下载: 建设银行企业现金管理直连版 文件下载 —— 请求报文<?xml version="1.0" encoding="UTF-8"?> <frontProxyRequst> <header> <sequnce>1668794382083424256</sequnce> <type>download</type> </header> <body> <fileName><![CDATA[20230614/100/02A420230614093643570725_11798.pdf]]></fileName> <bankFile><![CDATA[receiptDownload]]></bankFile> </body> </frontProxyRequst> 建设银行企业现金管理直连版 文件下载 —— 收到响应报文 移动文件:d:/receipt\tempPath\CCB_CCIP\35xxxxxxxxxxxxxxx5-20230504-3510006020NDP9B4HTJ-57517.88.pdf到扫描工作路径。d:/receipt\scanPath\CCB_CCIP成功。 第二个回单文件下载: 建设银行企业现金管理直连版 文件下载 —— 请求报文<?xml version="1.0" encoding="UTF-8"?> <frontProxyRequst> <header> <sequnce>1668794383094251520</sequnce> <type>download</type> </header> <body> <fileName><![CDATA[20230614/200/02A420230614093643565389_29633.pdf]]></fileName> <bankFile><![CDATA[receiptDownload]]></bankFile> </body> </frontProxyRequst> 建设银行企业现金管理直连版 文件下载 —— 收到响应报文 移动文件:d:/receipt\tempPath\CCB_CCIP\35xxxxxxxxxxxxxxx5-20230504-35100060216FPLGIQ9U-3773.79.pdf到扫描工作路径。d:/receipt\scanPath\CCB_CCIP成功。
五、其它
当前版本20240801还不支持新接口:回单索引查询P1CCMW001、回单文件下载[同步模式]P1CCMW006。
【电子回单】建设银行企业现金管理直连版(CCB_CCIP)回单配置
本文2024-09-22 20:17:19发表“eas cloud知识”栏目。
本文链接:https://wenku.my7c.com/article/kingdee-eas-112660.html