招商銀行銀企直連開發(fā)指南210

1、招商銀行直聯(lián)系統(tǒng)開發(fā)指南version 2.1修訂記錄日期修訂版本修訂人修訂內(nèi)容2010-10-18楊成海新建2011-9-271.0.1徐蓓FBSDK3.3發(fā)布，修改版本信息，更新5.1版本信息和6.1接口文檔2011-11-21徐蓓FBSDK3.4發(fā)布，修改版本信息，更新5.1版本信息和6.1接口文檔2012-02-231.0.3徐蓓FBSDK3.5發(fā)布，修改版本信息，更新5.1版本信息和6.1接口文檔2012-04-13徐蓓FBSDK3.6發(fā)布，修改版本信息，更新5.1版本信息和6.1接口文檔2013-4-2楊成海FBSDK3.8發(fā)布，更新5.1版本信息和6.1接口文檔2013-4-18

2、楊成海FBSDK5.0發(fā)布，更新3.1.3菜單功能說明、5.1版本信息和6.1接口文檔.刪除原4.3.6國內(nèi)信用證接口2013-4-19楊成海FBSDK5.1發(fā)布，增加二代KEY支持。2013-7-9徐蓓增加供應(yīng)鏈金融功能（增加附錄6.6）。修改了票據(jù)通的業(yè)務(wù)接口（附錄6.3的接口文檔）；修改5.1版本信息；2013-8-15楊成海增加公司理財業(yè)務(wù)接口（附錄6.1）；更新供應(yīng)鏈接口文檔V1.1（附錄6.6）；修改5.1版本信息; 2013-9-3徐蓓修改人民幣現(xiàn)金池業(yè)務(wù)接口（附錄6.1）；更新供應(yīng)鏈接口文檔V1.2（附錄6.6）；修改5.1版本信息; 2013-9-12楊成海增加記賬寶接口（附

3、錄6.1）；修改5.1版本信息; 2013-10-10徐蓓FBSDK5.2發(fā)布；增加對跨境賬戶視圖功能的支持（附錄6.1）；修改5.1版本信息; 修改5.3的版本查看方式。2013-10-29楊成海更新6.1接口文檔2013-10-30徐蓓更新供應(yīng)鏈接口文檔V1.3（附錄6.6）；修改5.1版本信息2013-11-20楊成海(1) 代發(fā)代扣業(yè)務(wù)增加“代發(fā)工資額度查詢接口”(2) 修改公司理財業(yè)務(wù)接口詳情見附錄6.1。2014-1-82.1徐蓓更新6.1接口文檔，增加新的支付和內(nèi)轉(zhuǎn)接口；把第4部分移入6.7嵌入式開發(fā)指南；修改5.1版本信息招商銀行直聯(lián)系統(tǒng)開發(fā)指南11系統(tǒng)簡介31.1概述31.2

4、背景3前置機(jī)式直聯(lián)（推薦）：3嵌入式直聯(lián)：41.3閱讀對象41.4術(shù)語定義42解決方案52.1概述52.2功能62.3整體要求7系統(tǒng)要求7技術(shù)要求7企業(yè)要求72.4開發(fā)流程7準(zhǔn)備7開發(fā)8使用83前置機(jī)式93.1前置程序說明9概述9程序主界面說明9菜單功能說明10注意事項(xiàng)153.2通訊協(xié)議說明16概述16HTTP/HTTPS協(xié)議16SOCKET協(xié)議163.3XML報文格式16概述16格式三17格式一18格式二18說明193.4調(diào)用頻率20說明203.5并發(fā)性能20說明204嵌入式215版本說明215.1版本信息215.2升級建議235.3查看版本信息246資源下載246.1招商銀行銀企直連接口說

5、明書(XML格式三說明文檔)246.2人行電子票據(jù)銀企直連接口說明書(XML格式三)246.3招商銀行票據(jù)通銀企直連接口說明書(XML格式三)256.4XML格式一和格式二報文說明文檔256.5開發(fā)范例源碼256.6供應(yīng)鏈金融銀企直連接口說明書266.7招商銀行嵌入式銀企直聯(lián)開發(fā)指南261 系統(tǒng)簡介1.1 概述本開發(fā)指南對招商銀行企業(yè)銀行直聯(lián)系統(tǒng)（以下簡稱本系統(tǒng)）進(jìn)行詳細(xì)地描述，通過該指南可以對本系統(tǒng)有個全面地了解，并可用于指導(dǎo)如何在該系統(tǒng)上進(jìn)行二次開發(fā)，實(shí)現(xiàn)與企業(yè)財務(wù)/ERP/電子商務(wù)交易平臺等系統(tǒng)（以下簡稱企業(yè)財務(wù)系統(tǒng)）平滑對接和有機(jī)融合。 1.2 背景招商銀行網(wǎng)上企業(yè)銀行本身有一套完整的

6、經(jīng)辦、審批機(jī)制，幫助企業(yè)規(guī)范財務(wù)制度、安全地做網(wǎng)上業(yè)務(wù)，但是它有一定的限制，就是必須在企業(yè)銀行系統(tǒng)內(nèi)封閉的完成。 很多企業(yè)都有一套自己的財務(wù)系統(tǒng)，企業(yè)使用財務(wù)系統(tǒng)生成一些經(jīng)辦業(yè)務(wù)需要的數(shù)據(jù)，如支付脫機(jī)制單數(shù)據(jù)、工資表和收方信息等，然后將生成的數(shù)據(jù)交由企業(yè)銀行系統(tǒng)經(jīng)辦和審批，再將銀行返回的數(shù)據(jù)導(dǎo)入到財務(wù)系統(tǒng)中。目前企業(yè)財務(wù)系統(tǒng)與企業(yè)銀行系統(tǒng)間只能以文件形式進(jìn)行數(shù)據(jù)交換，而企業(yè)希望能在自己的系統(tǒng)內(nèi)和企業(yè)銀行間進(jìn)行直接的數(shù)據(jù)交換。 基于以上情況，招商銀行開發(fā)了本系統(tǒng)。本系統(tǒng)提供兩種方式與企業(yè)財務(wù)系統(tǒng)對接。一種是前置機(jī)式；一種是嵌入式。 1.2.1 前置機(jī)式直聯(lián)（推薦）：即通過在企業(yè)內(nèi)部網(wǎng)絡(luò)內(nèi)安裝一臺

7、前置機(jī)（即安裝了本系統(tǒng)并啟動了直連服務(wù)的PC機(jī)），企業(yè)財務(wù)系統(tǒng)通過報文交互的方式與前置機(jī)通訊，以實(shí)現(xiàn)向企業(yè)銀行系統(tǒng)發(fā)送指令，并接收銀行返回的數(shù)據(jù)。 1.2.2 嵌入式直聯(lián)：即通過在企業(yè)財務(wù)系統(tǒng)內(nèi)部調(diào)用本系統(tǒng)提供的接口，實(shí)現(xiàn)財務(wù)系統(tǒng)和企業(yè)銀行間的直接交互。本系統(tǒng)作為財務(wù)系統(tǒng)的一個組成部分嵌入到財務(wù)系統(tǒng)，在財務(wù)系統(tǒng)和企業(yè)銀行間采用不落地方式交換數(shù)據(jù)，財務(wù)系統(tǒng)通過本系統(tǒng)提供的接口直接向企業(yè)銀行系統(tǒng)發(fā)送指令，并接收銀行返回的數(shù)據(jù)。 嵌入式直聯(lián)方式僅作向下兼容支持，新增客戶請使用前置機(jī)式直聯(lián)。1.3 閱讀對象預(yù)期讀者為利用本系統(tǒng)進(jìn)行二次開發(fā)的相關(guān)人員，以及其他需要了解本系統(tǒng)的人員。 1.4 術(shù)語定義招行

8、銀企直聯(lián)：招商銀行提供的一種網(wǎng)上“企業(yè)銀行”系統(tǒng)與企業(yè)的財務(wù)軟件系統(tǒng)的直接聯(lián)接的接入方式。招行企業(yè)網(wǎng)銀：招商銀行企業(yè)網(wǎng)銀是使用本地客戶端軟件，通過Internet網(wǎng)絡(luò)或其它信息網(wǎng)絡(luò)，將用戶電腦終端連接至銀行，實(shí)現(xiàn)將銀行服務(wù)直接送到用戶辦公室和家中。它改變了銀行傳統(tǒng)的服務(wù)方式，是銀行業(yè)務(wù)系統(tǒng)的擴(kuò)充和延伸。用戶管理：企業(yè)銀行系統(tǒng)的用戶分為系統(tǒng)管理員和一般用戶。企業(yè)到銀行申請開辦“企業(yè)銀行”業(yè)務(wù)時，由銀行為企業(yè)生成兩個系統(tǒng)管理員，兩個系統(tǒng)管理員的權(quán)限完全平等，共同負(fù)責(zé)企業(yè)銀行管理的工作。通常系統(tǒng)的設(shè)置必須由一個系統(tǒng)管理員進(jìn)行經(jīng)辦而由另一個系統(tǒng)管理員進(jìn)行授權(quán)，必須兩個系統(tǒng)管理員同時認(rèn)可后設(shè)置方才有效；

9、系統(tǒng)管理員不能為自己設(shè)置業(yè)務(wù)權(quán)限，也不能對自己經(jīng)辦的系統(tǒng)設(shè)置進(jìn)行授權(quán)。建議由公司財務(wù)經(jīng)理擔(dān)任系統(tǒng)管理員之一。一般用戶由系統(tǒng)管理員使用“用戶管理”功能增加到系統(tǒng)中，由系統(tǒng)管理員設(shè)置其權(quán)限。負(fù)責(zé)在權(quán)限內(nèi)經(jīng)辦和授權(quán)各項(xiàng)企業(yè)銀行業(yè)務(wù)。另外，系統(tǒng)管理員也可具有業(yè)務(wù)權(quán)限，處理企業(yè)銀行業(yè)務(wù)。業(yè)務(wù)管理：業(yè)務(wù)管理用于在網(wǎng)上企業(yè)銀行上建立適應(yīng)企業(yè)內(nèi)部財務(wù)管理要求的業(yè)務(wù)操作規(guī)范。網(wǎng)上企業(yè)銀行采用靈活的預(yù)設(shè)模式方式，實(shí)行“操作鏈”式管理，系統(tǒng)性地固化企業(yè)財務(wù)管理制度。客戶可以自由定制企業(yè)內(nèi)部財務(wù)授權(quán)管理模式，適應(yīng)多種個性化財務(wù)管理需求?！安僮麈湣毙蜗蟮孛枋隽似髽I(yè)內(nèi)部財務(wù)管理的崗位設(shè)置、業(yè)務(wù)分工和業(yè)務(wù)流程，同時規(guī)定了崗

10、位上不同身份的人員的操作權(quán)限和關(guān)系?！安僮麈湣鄙显O(shè)經(jīng)辦崗位一個，設(shè)審批崗位一級或多級。經(jīng)辦崗位可以設(shè)置多人，人數(shù)不限制。經(jīng)辦人員負(fù)責(zé)所有其有權(quán)處理的業(yè)務(wù)的制單發(fā)起操作，經(jīng)辦人員之間是同一級別的并列關(guān)系。每一級審批崗位只可以設(shè)一名審批人員，審批人員負(fù)責(zé)其有權(quán)處理的業(yè)務(wù)的復(fù)核審批操作，不同級別審批崗位之間是上下級的關(guān)系，審批的權(quán)限依次增大，但是審批的流程必須依次進(jìn)行，不得越級。備注：招行銀企直聯(lián)與招行企業(yè)網(wǎng)銀共用一套用戶管理、業(yè)務(wù)管理系統(tǒng)，后臺業(yè)務(wù)處理系統(tǒng)也相同，是招行網(wǎng)上企業(yè)銀行系統(tǒng)的兩個不同接入渠道。用戶、業(yè)務(wù)管理只能在企業(yè)網(wǎng)銀上管理。CA（認(rèn)證中心）：（Certification Autho

11、rity 認(rèn)證中心）是用來頒發(fā)數(shù)字證書的權(quán)威機(jī)構(gòu)，它具有權(quán)威性、公正性和可靠性。其主要任務(wù)是受理數(shù)字證書的申請、簽發(fā)及對數(shù)字證書的管理。在受理申請的同時，一般還會核對申請者的身份，以確保正確。數(shù)字證書：數(shù)字證書是用電子手段來證實(shí)一個用戶的身份和對網(wǎng)絡(luò)資源的訪問權(quán)限。數(shù)字證書是由權(quán)威機(jī)構(gòu)(CA)采用數(shù)字簽名技術(shù)，頒發(fā)給用戶，用以在數(shù)字領(lǐng)域中證實(shí)用戶其本身的一種數(shù)字憑證。本系統(tǒng)的證書由招商銀行CA簽發(fā)，用于確認(rèn)用戶在招行企業(yè)銀行系統(tǒng)中的身份。2 解決方案2.1 概述本系統(tǒng)支持兩種直連方式：· 前置機(jī)式：向本系統(tǒng)發(fā)送HTTP請求，實(shí)現(xiàn)和銀行的直聯(lián)。（具體請參考目錄"前置機(jī)式&qu

12、ot;） · 嵌入式：以Win32動態(tài)鏈接庫（DLL）和JAVA開發(fā)包(jar)的方式提供編程調(diào)用接口，企業(yè)可利用這些接口進(jìn)行相應(yīng)的二次開發(fā)。該方式支持VC、VB、C#、DELPHI、CB、PB、JAVA等開發(fā)工具。（具體請參考目錄"嵌入式"） 結(jié)構(gòu)示意圖如上圖所示，企業(yè)可以有自己完善的財務(wù)管理系統(tǒng)，公司內(nèi)部資金調(diào)撥及對外支付先經(jīng)過其內(nèi)在的財務(wù)管理流程，再通過招行提供的編程接口把生成的指令直接提交到招行，招行根據(jù)該指令進(jìn)行處理；企業(yè)的帳戶信息、交易信息等也可以通過直聯(lián)接口從招行獲得。 2.2 功能 本系統(tǒng)目前提供的業(yè)務(wù)功能包括：· 賬戶管理·

13、支付結(jié)算 · 代發(fā)代扣 · 商務(wù)支付 · 委托貸款· 定期業(yè)務(wù)· 信用管理· 人民幣現(xiàn)金池· 代理清算· 外匯匯款· 支付限額協(xié)議管理· 資金余額管理大額劃撥· 外幣現(xiàn)金池· 人行電子票據(jù)· 招商網(wǎng)上電子票據(jù)· 供應(yīng)鏈金融后續(xù)將根據(jù)市場需求，逐步添加其他業(yè)務(wù)。2.3 整體要求2.3.1 系統(tǒng)要求· 硬件：建議Pentium133以上CPU，32MB RAM，至少256色（建議16位以上真彩）顯示，100M以上的空閑硬盤空間。對數(shù)字證書卡用戶，需要

14、一個串口或USB口，用于安裝數(shù)字證書卡驅(qū)動器； · 操作系統(tǒng)：建議中文/英文WINDOWS 98/NT/2000/XP/2003，對英文WINDOWS，需要外掛中文平臺； · 瀏覽器：必須安裝Microsoft Internet Explorer 4.0以上的瀏覽器。本系統(tǒng)不支持Netscape的瀏覽器； · 系統(tǒng)環(huán)境：建議使用一臺電腦專門運(yùn)行財務(wù)系統(tǒng)和直聯(lián)系統(tǒng)，應(yīng)確保系統(tǒng)中沒有病毒、木馬等有害程序。 2.3.2 技術(shù)要求· 在正式使用直聯(lián)系統(tǒng)前，請確認(rèn)您所使用的財務(wù)系統(tǒng)和本系統(tǒng)的直聯(lián)已在招行的測試環(huán)境下經(jīng)過嚴(yán)格測試，并得到招行技術(shù)部門的認(rèn)證； 

15、3; 請確認(rèn)所使用的本系統(tǒng)的動態(tài)庫均有招行的數(shù)字簽名。 2.3.3 企業(yè)要求· 開通招行網(wǎng)上企業(yè)銀行； · 與招行簽訂直聯(lián)協(xié)議； · 開通帳戶查詢、直接支付等所需業(yè)務(wù)，經(jīng)辦用戶需要擁有招行簽發(fā)的數(shù)字證書卡。 2.4 開發(fā)流程2.4.1 準(zhǔn)備· 到所在地招行的分/支行開通招行企業(yè)銀行； · 到所在地招行的分/支行申請調(diào)試直聯(lián)系統(tǒng)，銀行分配用于測試的用戶ID、密碼等； · 到招行網(wǎng)站下載本系統(tǒng)的開發(fā)工具包（包括開發(fā)包安裝程序、本開發(fā)指南等）； · 運(yùn)行開發(fā)包安裝程序完成本系統(tǒng)的安裝； · 修改system32drive

16、rsetchosts文件，增加兩行數(shù)據(jù)： · 使用FBSdkManager.exe或者FBSdkTest.exe修改通訊方式的服務(wù)器為測試機(jī)，如下圖所示：· 通過提供的測試程序驗(yàn)證測試環(huán)境是否正確。（注：在測試環(huán)境，允許經(jīng)辦用戶采用非證書卡方式登錄） 2.4.2 開發(fā)· 根據(jù)提供的編程接口，在自己的財務(wù)系統(tǒng)上進(jìn)行開發(fā)，實(shí)現(xiàn)所需要的業(yè)務(wù)功能（接口調(diào)用可參考提供的測試程序源代碼）； · 對自己財務(wù)系統(tǒng)的業(yè)務(wù)功能進(jìn)行測試（可根據(jù)提供的測試程序進(jìn)行驗(yàn)證）。 2.4.3 使用· 到所在地招行的分/支行簽訂直聯(lián)協(xié)議； · 到所在地招行的分/支行開

17、通直接支付/賬戶查詢等所需業(yè)務(wù)； · 到招行網(wǎng)站下載本系統(tǒng)的正式發(fā)布包； · 運(yùn)行正式發(fā)布包安裝程序完成本系統(tǒng)的安裝； · 在企業(yè)銀行客戶端，由企業(yè)系統(tǒng)管理員對業(yè)務(wù)模式進(jìn)行設(shè)置； · 可在自己財務(wù)系統(tǒng)上進(jìn)行相應(yīng)的直聯(lián)操作，完成相關(guān)業(yè)務(wù)。（注：在真實(shí)環(huán)境，經(jīng)辦用戶必須采用證書卡方式登錄） · 專線用戶，且無DNS服務(wù)器時需要在系統(tǒng)HOST文件中增加如下域名的映射：， 3 前置機(jī)式3.1 前置程序說明3.1.1 概述本系統(tǒng)支持HTTP/HTTPS/SOCKET請求，企業(yè)通過HTTP/HTTPS（POST方式）或SOCKET協(xié)議發(fā)送請求到前置程序FB

18、SdkManager，并處理接收到的應(yīng)答報文來實(shí)現(xiàn)和銀行系統(tǒng)的交互。3.1.2 程序主界面說明1、系統(tǒng)菜單：詳情見菜單功能說明。2、菜單工具欄：從左至右依次為：啟動服務(wù)、停止服務(wù)、登陸銀行、退出銀行、系統(tǒng)設(shè)置、銀行通訊設(shè)置、查看系統(tǒng)日志、系統(tǒng)開發(fā)指南。3、登錄信息：顯示目前登錄的用戶信息。4、系統(tǒng)日志：顯示系統(tǒng)操作日志等信息。5、提示欄：從左到右依次為：服務(wù)啟動信息、用戶登陸信息、系統(tǒng)啟動時間信息。3.1.3 菜單功能說明1、系統(tǒng)>系統(tǒng)設(shè)置：設(shè)置服務(wù)類型以及監(jiān)聽端口、設(shè)置是否記錄業(yè)務(wù)報文日志、設(shè)置是否過濾企業(yè)端IP地址、設(shè)置程序是否自動鎖定。設(shè)置服務(wù)類型以及監(jiān)聽端口記錄業(yè)務(wù)報文日志：記錄

19、直聯(lián)系統(tǒng)接收到的XML報文以及發(fā)送給企業(yè)財務(wù)軟件系統(tǒng)的XML報文；記錄系統(tǒng)通訊日志：啟用后，系統(tǒng)碰到自動登錄失敗時會檢測系統(tǒng)通訊情況并記錄檢測結(jié)果。設(shè)置是否過濾企業(yè)端IP地址：當(dāng)啟用IP過濾時，系統(tǒng)如發(fā)現(xiàn)請求報文來自允許訪問列表之外的地址，將拒絕訪問。設(shè)置程序是否自動鎖定2、系統(tǒng)>鎖定程序：隱藏直聯(lián)前置程序窗口，恢復(fù)窗口需要輸入鎖定密碼。3、服務(wù)>啟動服務(wù)：啟動服務(wù)前必須先設(shè)置服務(wù)類型以及監(jiān)聽端口。4、服務(wù)>停止服務(wù)：必須在所有登陸用戶退出銀行系統(tǒng)后才能停止服務(wù)。5、登陸>登陸銀行：必須啟動服務(wù)后才能登陸銀行系統(tǒng)。6、登陸>退出銀行：退出銀行系統(tǒng)，選中登陸用戶后該

20、菜單才可操作。7、登陸>銀行通訊設(shè)置：設(shè)置登陸銀行通訊參數(shù)，該參數(shù)必須在用戶登錄前設(shè)置。8、登錄>系統(tǒng)通訊檢測：檢測系統(tǒng)及系統(tǒng)與銀行服務(wù)器之間通訊情況。9、查看>查看日志：業(yè)務(wù)報文日志，密文保存(可保存為明文）；系統(tǒng)日志，明文保存；系統(tǒng)通訊日志：明文保存。10、查看>查看業(yè)務(wù)模式：選中登陸用戶后，可查看該用戶下的業(yè)務(wù)模式信息（包括業(yè)務(wù)名稱以及編號），雙擊選中的業(yè)務(wù)模式可查看詳細(xì)信息。11、查看>查看證書：查看及更新證書看信息，須先脫機(jī)登錄。12、幫助>開發(fā)指南：顯示招商銀行銀企直聯(lián)系統(tǒng)對接開發(fā)指南。13、幫助>關(guān)于銀企直聯(lián)：顯示招商銀行銀企直聯(lián)系統(tǒng)版本

21、等信息。3.1.4 注意事項(xiàng)1、該系統(tǒng)實(shí)現(xiàn)了和銀行自動重連的功能（當(dāng)收到HTTP/HTTPS/SOCKET請求時，如果和銀行的連接已經(jīng)斷開，會自動進(jìn)行重連）。2、請求和應(yīng)答的報文都采用XML格式（請參考XML報文格式）。3、請求的報文需要在<INFO>中增加<LGNNAM>，內(nèi)容為登錄的用戶名。4、不支持下列接口的請求：登陸(Login)簽退(Logout)，系統(tǒng)參數(shù)設(shè)置(SetConfig),保持連接(SetAlive)釋放緩沖區(qū)(FreeBuffer)，XML 接口調(diào)用(XmlComm)。5、注意：只要能向運(yùn)行前置程序FBSdkManager的機(jī)器發(fā)送HTTP/SO

22、CKET請求就能和銀行進(jìn)行直聯(lián)，因此必須保證該機(jī)器網(wǎng)絡(luò)的安全性，和其它無關(guān)的機(jī)器在網(wǎng)絡(luò)上做到安全隔離。3.2 通訊協(xié)議說明3.2.1 概述企業(yè)財務(wù)系統(tǒng)與直聯(lián)前置程序間通訊協(xié)議支持HTTP、HTTPS、SOCKET三種協(xié)議。3.2.2 HTTP/HTTPS協(xié)議企業(yè)端使用HTTP/HTTPS協(xié)議，通過POST方式提交XML報文數(shù)據(jù)到直聯(lián)前置程序，并接收返回XML報文數(shù)據(jù)，完成報文數(shù)據(jù)交換。3.2.3 SOCKET協(xié)議· 企業(yè)端使用SOCKET協(xié)議，通過以下數(shù)據(jù)包格式提交XML報文數(shù)據(jù)到直聯(lián)前置程序，完成報文數(shù)據(jù)交換。通訊數(shù)據(jù)包格式為：8位字節(jié)報頭（XML報文長度，左對齊，長度不夠右補(bǔ)空格

23、) + XML報文。范例：假如XML報文長度為1300個字節(jié)，通訊數(shù)據(jù)包格式為：“1300    ”（右邊4個空格） + XML報文。3.3 XML報文格式3.3.1 概述本系統(tǒng)共提供了三種XML報文格式，主要用于前置機(jī)與企業(yè)端數(shù)據(jù)交換以及嵌入式開發(fā)中的XML請求(XmlComm)函數(shù)。格式三在V1.7版本推出，新直連用戶請使用格式三的標(biāo)準(zhǔn)進(jìn)行開發(fā)，將來新功能都只支持格式三的報文格式。3.3.2 格式三請求報文：<?xml version="1.0" encoding="GBK"?> / encodin

24、g如果設(shè)置成BIG5表示繁體報文<CMBSDKPGK>  <INFO>    <FUNNAM></FUNNAM>  / 函數(shù)名    <DATTYP>2</DATTYP> / 數(shù)據(jù)格式（固定為2）    <LGNNAM></LGNNAM> / 前置機(jī)登錄用戶名   / 用戶自定義數(shù)據(jù)，應(yīng)答報文會原樣返回，建議字段名不要用6位的字母  </INFO>&

25、#160; <Interface-Name>  /業(yè)務(wù)接口名稱    </Field-Name>Field-Value</Field-Name>  /業(yè)務(wù)接口字段名稱，字段值                     /多個字段，同接口下不能重復(fù)  </Interface-Name> 

26、;                      /多個業(yè)務(wù)接口</CMBSDKPGK> 應(yīng)答報文：<?xml version="1.0" encoding="GBK"?> / encoding和請求一致<CMBSDKPGK>  <INFO>    <FUNNAM><

27、/FUNNAM>  / 函數(shù)名    <DATTYP>2</DATTYP> / 數(shù)據(jù)格式（固定為2）    <RETCOD></RETCOD>  / 調(diào)用結(jié)果    <ERRMSG></ERRMSG>  / 錯誤消息                &#

28、160;    / 用戶自定義數(shù)據(jù)  </INFO>  <Interface-Name>  / 自定義接口名稱    </Field-Name>Field-Value</Field-Name>  /自定義字段名稱，字段值                   &#

29、160; /可以定義多個字段  </Interface-Name>                       / 可以定義多個接口</CMBSDKPGK>  備注：不同的交易接口名稱不一樣，一個請求報文中可以有多個不同的接口，接口名也可以重名。3.3.3 格式一請求報文：<?xml version="1.0" encoding

30、="GBK"?> / encoding如果設(shè)置成BIG5表示繁體報文<REQUEST>  <INFO>    <FUNNAM></FUNNAM>  / 函數(shù)名    <DATTYP>0</DATTYP> / 數(shù)據(jù)格式（固定為0）                 

31、    / 用戶自定義數(shù)據(jù)，應(yīng)答報文會原樣返回，建議字段名不要用6位的字母  </INFO>  <SUMMARY></SUMMARY>  / 概要信息  <DETAIL></DETAIL>    / 詳細(xì)信息</REQUEST> 應(yīng)答報文：<?xml version="1.0" encoding="GBK"?> / encoding和請求一致<RESPONSE>

32、  <INFO>    <FUNNAM></FUNNAM>  / 函數(shù)名    <DATTYP>0</DATTYP> / 數(shù)據(jù)格式（固定為0）    <RETCOD></RETCOD>  / 調(diào)用結(jié)果    <ERRMSG></ERRMSG>  / 錯誤消息       

33、              / 用戶自定義數(shù)據(jù)  </INFO>  <SUMMARY></SUMMARY>  / 概要信息  <DETAIL></DETAIL>    / 詳細(xì)信息</RESPONSE>備注：1、概要信息為單條記錄，明細(xì)信息支持多條記錄，每條記錄由多個字段組成，字段間用" ;"(空格加分號)

34、分開，各個字段格式為：字段名=數(shù)值。2、對于明細(xì)信息，如果是多條記錄，每條記錄用"rn"分開（"rn"是指回車符和換行符）。3.3.4 格式二請求報文：<?xml version="1.0" encoding="GBK"?> / encoding如果設(shè)置成BIG5表示繁體報文<REQUEST>  <INFO>    <FUNNAM></FUNNAM>  / 函數(shù)名    <

35、;DATTYP>1</DATTYP> / 數(shù)據(jù)格式（固定為1）                     / 用戶自定義數(shù)據(jù)，應(yīng)答報文會原樣返回，建議字段名不要用6位的字母  </INFO>  <SUMMARY></SUMMARY>  / 概要信息  <DETAIL>   &

36、#160;         / 詳細(xì)信息    <RECORD></RECORD>  / 詳細(xì)信息數(shù)據(jù)  </DETAIL> </REQUEST> 應(yīng)答報文：<?xml version="1.0" encoding="GBK"?> / encoding和請求一致<RESPONSE>  <INFO>   

37、<FUNNAM></FUNNAM>  / 函數(shù)名    <DATTYP>1</DATTYP> / 數(shù)據(jù)格式（固定為1）    <RETCOD></RETCOD>  / 調(diào)用結(jié)果    <ERRMSG></ERRMSG>  / 錯誤消息             &#

38、160;       / 用戶自定義數(shù)據(jù)  </INFO>  <SUMMARY></SUMMARY>  / 概要信息  <DETAIL> / 詳細(xì)信息    <RECORD></RECORD>  / 詳細(xì)信息數(shù)據(jù)  </DETAIL></RESPONSE>  備注：概要信息和詳細(xì)信息的數(shù)據(jù)由多個字段組成，格式為<字段名>數(shù)值<

39、;/字段名>。3.3.5 說明1、對于函數(shù)名(<FUNNAM>)，除了用"GetAccInfo"表示"GetAccInfoA"，"GetTransInfo"表示"GetTransInfoA"，"Payment"代替"DirectPayment"和"DirectGroupPayment"，其他和編程接口的函數(shù)名保持一致。2、對于調(diào)用結(jié)果(<RETCOD>)錯誤消息(<ERRMSG>)，和調(diào)用指定函數(shù)后的返回值和錯誤信

40、息相同。3、概要和明細(xì)的具體信息請參考各個函數(shù)的說明。4、請求報文字段值中的&和<要做格式轉(zhuǎn)換，"&"->"&amp;"，"<"->"&lt;"，應(yīng)答報文要做相反的格式轉(zhuǎn)換。格式三說明文檔：見招商銀行銀企直連接口說明書(XML格式三說明文檔)格式一和格式二說明文檔：見XML格式一和格式二報文說明文檔3.4 調(diào)用頻率3.4.1 說明請求調(diào)用間隔：本次請求調(diào)用與上次請求調(diào)用之間的時間差；調(diào)用頻率控制按接口種類區(qū)別控制：· 經(jīng)辦類請求：兩次經(jīng)辦類請求最小調(diào)

41、用間隔為1秒；· 查詢類請求：兩次查詢類請求最小調(diào)用間隔為2秒；· 通知類請求：兩次通知類請求最小調(diào)用間隔為5秒。1 當(dāng)調(diào)用頻率沒有滿足以上條件時（實(shí)際調(diào)用間隔小于最小調(diào)用間隔），系統(tǒng)默認(rèn)會內(nèi)部等待，等待時間為：最小調(diào)用間隔 實(shí)際調(diào)用間隔，等待完成后再處理該請求。2 當(dāng)調(diào)用頻率滿足以上條件時（實(shí)際調(diào)用間隔大于或等于最小調(diào)用間隔），系統(tǒng)立即處理該請求并轉(zhuǎn)發(fā)到銀行后臺系統(tǒng)。· 調(diào)用頻率控制以登陸用戶為單位，不同登陸用戶之間不受影響。3.5 并發(fā)性能3.5.1 說明本系統(tǒng)支持多用戶并發(fā)請求，同一用戶的多個請求按照優(yōu)先隊(duì)列排隊(duì)處理，為了避免請求等待時間過長，建議同一用戶并

42、發(fā)請求不要超過50個，登陸用戶數(shù)沒有限制。備注：一臺電腦只能安裝一個招行前置機(jī)，多臺電腦允許安裝多個招行前置機(jī)。4 嵌入式見附錄6.75 版本說明5.1 版本信息· .0 實(shí)現(xiàn)賬戶查詢、交易查詢、直接支付(直接集團(tuán)支付)等業(yè)務(wù)· .0 增加代發(fā)代扣等業(yè)務(wù)· .0 不需要調(diào)用SetAlive，系統(tǒng)實(shí)現(xiàn)自動和銀行端保持連接功能· .0 增加國內(nèi)信用證、商務(wù)支付等業(yè)務(wù)，提供多種登錄方式· .0 不需要調(diào)用SetAlive，系統(tǒng)實(shí)現(xiàn)自動和銀行端保持長連接功能（沒有該功能）· 1.4 增加內(nèi)部轉(zhuǎn)賬、查詢支付結(jié)果信息等業(yè)務(wù)，對一些接

43、口進(jìn)行改進(jìn)· 1.5 增加帶審批的支付、集團(tuán)支付等業(yè)務(wù)，支持XML報文格式和HTTP請求、支持繁· 1.6 增加對usbkey證書的支持· 1.7 增加XML報文格式三，在以后版本的新功能上都將全面支持格式三的xml報文； 支持簡體、繁體、英文操作系統(tǒng)。· 1.8 增加自動支付功能； 增加委托貸款功能； 增加定活互轉(zhuǎn)、通知存款功能； 增加信用查詢功能； 增加歷史通知查詢功能。· 1.9 增加人民幣現(xiàn)金池功能； 增加賬戶歷史余額查詢功能；增加收方限制列表查詢功能。· 2.0 增加跨行代發(fā)功能；增加查詢批量支付經(jīng)辦結(jié)果的功能。·

44、 2.1 增加代理清算功能。· 2.2 增加人民銀行電子票據(jù)功能。· 2.3 增加外匯匯款功能。· 2.4 增加招商銀行網(wǎng)上電子票據(jù)功能。· 增加查詢分行號功能。· 增加支付限額協(xié)議管理功能、資金余額管理大額劃撥功能。· 增加批量查詢賬戶詳細(xì)信息功能。· 直聯(lián)新版前置機(jī)上線。· 招行票據(jù)通：票據(jù)號長度改成20位。· 代理清算支持自動支付。· 國際結(jié)算系統(tǒng)收到電文存儲改造。· 增加外幣現(xiàn)金池直聯(lián)功能。· 人行電子票據(jù)二期功能（非同業(yè)）。增加生成簽名接口；修改訂單狀態(tài)查詢接口，增加票據(jù)信息的返回。· 3.3.0支付接口優(yōu)化。· 增加自助打印回單查詢接口。· 3.5.0支持人行二代支付接口。修改支付和代理清算相關(guān)接口。· 3.6.0調(diào)整境內(nèi)銀行涉外收付憑證及相關(guān)信息。修改外匯匯款和來單承付的相關(guān)接口。&#