鐵通銀行代收代辦系統(tǒng)V3[1]5接口規(guī)范.doc

鐵通話費銀行代收系統(tǒng)接口規(guī)范說明書編寫單位：華泰貝通計費事業(yè)部定稿時間：2003年7月16日【版權(quán)聲明】本文檔版權(quán)歸北京華泰貝通公司所有，任何人不得以任何方式將本文檔傳遞給其他與本項目無關(guān)的個人或機構(gòu)，我公司對違反此聲明者保留依法追究法律責任的權(quán)利。版本歷史版 本作者/修改者日 期備 注1.0高佩忠2002-4-25一稿1.1高佩忠2002-8-19修改了一些表達不準確的地方2.0何武軍2002-10-24增加發(fā)票打印及發(fā)票補打交易2.1高佩忠2002-11-13加目錄；備注移到文件尾3.0高佩忠2003-4-16將批扣和托收部分單獨形成一個文檔3.1高佩忠2003-4-16修改第8頁關(guān)于交易包填充的說明3.2高佩忠2003-4-16將與批量代扣相關(guān)的FTP說明移至鐵通話費銀行批量代扣規(guī)范3.3武豪2003-5-28細化了關(guān)于時間的說明3.4高佩忠2003-7-16增加遼寧各地市金融機構(gòu)代碼定義3.5李洪濤2005-3-1取消“繳費申請”、“繳費確認”兩種交易目 錄1接口規(guī)范說明51.1參數(shù)定義51.2關(guān)于對帳61.3實現(xiàn)方式61.4關(guān)于銀行柜臺繳費61.5關(guān)于其它繳費模式61.6響應(yīng)碼定義61.7關(guān)于安全問題61.8通訊方式72鐵通話費銀行現(xiàn)金代繳規(guī)范82.1通信報文格式82.1.1話費查詢（銀行鐵通）82.1.2話費繳納（銀行鐵通）92.1.3發(fā)票打?。ㄣy行鐵通）112.1.4發(fā)票補打（銀行鐵通）122.1.5用戶退費（銀行鐵通）142.1.6繳費沖正（銀行鐵通）142.1.7退費沖正（銀行鐵通）152.1.8總額對帳（銀行鐵通）162.1.9明細對帳（銀行鐵通）172.2交易返回碼定義（鐵通銀行、銀行鐵通）183銀行-鐵通FTP文件傳輸規(guī)范193.1登錄用戶及密碼193.1.1用戶名193.1.2密碼193.2路徑說明203.2.1銀行上傳明細對帳文件路徑203.3其它說明203.3.1FTP用戶瀏覽權(quán)限203.3.2關(guān)于上傳、下載路徑204備注211 接口規(guī)范說明1.1 參數(shù)定義1) 代理金融機構(gòu)代碼：3位，用于識別代金融機構(gòu)110 建行、210 交行、310 農(nóng)行、410 中行、510 工行、610 招行、710 郵儲、810 城市商業(yè)銀行、910 廣發(fā)行、A10 福建興業(yè)銀行、B10 華夏銀行、C10 中信實業(yè)銀行、D10 光大銀行、E10 農(nóng)聯(lián)社F10Z10其它銀行依次定義?！具|寧金融機構(gòu)代碼定義】仍用三位表示：ABC “A”代表金融機構(gòu)，其余兩位“BC”代表地市；“A”的定義為：0銀聯(lián)、1 建行、2 交行、3 農(nóng)行、4中行、5 工行、6 招行、7 郵儲、8 城市商業(yè)銀行、9 廣發(fā)行；“BC”的定義為：沈陽 24鐵嶺 10大連 11鞍山 12撫順 13本溪 14丹東 15錦州 16營口 17阜新 18遼陽 19朝陽 21盤錦 27葫蘆島 29通遼 75赤峰 762) 電信運營商代碼：鐵通0110。3) 應(yīng)用種類定義：代繳話費：0101/0001；代扣話費：0102；代辦業(yè)務(wù)：0103，如需增加業(yè)務(wù)種類，雙方協(xié)商決定。1.2 關(guān)于對帳1) 對帳標準：通過銀行代收代繳發(fā)生的帳務(wù)，以銀行端交易記錄為準。2) 異常處理：經(jīng)核對，雙方不一致的交易，進行人工干預(yù)處理。3) 對帳時間：由銀行系統(tǒng)發(fā)起對帳交易請求，時間可以考慮在每天營業(yè)結(jié)束后進行，具體時間由雙方協(xié)商確定。1.3 實現(xiàn)方式目前不僅考慮實時聯(lián)網(wǎng)的現(xiàn)金或支票繳費方式，也包括批量代扣方式等繳費方式。1.4 關(guān)于銀行柜臺繳費1) 目前允許的繳費方式：可支持用戶現(xiàn)金繳費，同時系統(tǒng)也要支持個人或單位的支票繳費方式，以方便用戶，具體的支票繳費流程需要由銀行完成。2) 業(yè)務(wù)流程：向鐵通計費系統(tǒng)查詢話費用戶身份核對用戶繳費打印發(fā)票完畢。1.5 關(guān)于其它繳費模式電話銀行繳費、網(wǎng)上銀行支付、銀行查詢終端繳費等交易處理模式可參照銀行柜臺交易的模式進行處理，計費系統(tǒng)只負責按照統(tǒng)一的格式傳送交易包請求回復(fù)資料，具體的處理流程由銀行完成。1.6 響應(yīng)碼定義采用自定義響應(yīng)碼，見后。 1.7 關(guān)于安全問題交易傳輸過程中涉及的資料加密問題，由銀行方提供相應(yīng)標準及接口函數(shù)。1.8 通訊方式雙方前置機通訊采用TCP/IP socket編程方式，連接方式為短連接，即每有交易時由客戶端（銀行端）發(fā)起通訊請求，建立TCP/IP連接，交易結(jié)束后雙方斷開連接。2 鐵通話費銀行現(xiàn)金代繳規(guī)范2.1 通信報文格式2.1.1 話費查詢（銀行鐵通）請求響應(yīng)屬性備注MMChar(4)包長度，傳遞ASC碼字符（長度不足左補零）01000110MMChar(4)單位編號（鐵通4位、0110）MChar(10)銀行應(yīng)收金額（取整后），以分為單位，（長度不足左補零）；MChar(10)用戶實際費用金額，以分為單位，（長度不足左補零） MMChar(14)交易流水號（響應(yīng)時的交易流水號與請求相同）MChar(14)交易時間（YYYYMMDDHHMMSS）MMChar(4)應(yīng)用種類（代繳話費：0101）MMChar(30)銀行柜臺代碼（響應(yīng)時與請求時代碼一致）MMChar(3)銀行代碼MChar(14)應(yīng)答流水號（YYYYMMDDnnnnnn）MChar(2)交易返回碼MChar(40)說明信息MMChar(7)區(qū)號MMChar(16)電話號碼MChar(30)用戶名稱MChar(20)營業(yè)合同號（企業(yè)用戶在營業(yè)合同號末位加#號）MChar(8)費用起始時間（YYYYMMDD）MChar(8)費用終止時間（YYYYMMDD）MChar(2)話費明細個數(shù)（長度不足左補零）MLLVAR話費明細，不定長字符。先是費用項名稱20個字符，后跟10位以分為單位的費用，費用名稱不足20位右補空格，費用不足10位左補0。注：1) 本報文用于銀行方查詢用戶費用情況。2) “M”的意義為：該域在請求或應(yīng)答交易包中必須存在；無“M”標志的域在交易包中可做填充，也可不填充；若在交易包中填充，則必須以空格填充，但最好不填充。此規(guī)則適用于所有交易包。3) “交易返回碼”：參見“交易返回碼定義”。此規(guī)則適用于所有交易包。4) “說明信息”域是對“交易返回碼”的輔助說明。5) “話費明細”域第一項為上期余額，其它為話費明細，沒有合計項；話費明細有些項目有可能為負值。例如：上期余額*0000000000月租費用*0000005000長話費用*0000050000市話費用*0000080000時段優(yōu)惠*-000002000 ，*表示空格。6) 交易包各域的填充規(guī)則：用于數(shù)值運算的域，長度不足左補零，如果為負值，負號在首位；其它域右補空格。此規(guī)則適用于所有交易包。7) 交易包總長度包括“包長度”域的四個字節(jié)。此規(guī)則適用于所有交易包。8) 關(guān)于“銀行應(yīng)收金額”和“用戶實際費用金額”銀行應(yīng)收金額 = 取整（用戶實際費用金額 上期余額）；取整規(guī)則由雙方協(xié)議；如果用戶實際費用金額小于上期余額，銀行應(yīng)收金額不進行取整，為精確到分的一個負值；用戶實際費用金額 = 話費明細中除去上期余額項之外的所有項之和。2.1.2 話費繳納（銀行鐵通）請求響應(yīng)屬性備注MMChar(4)包長度，傳遞ASC碼字符。02000210MMChar(4)單位編號（鐵通4位、0110）MChar(10)實交金額，以分為單位（長度不足左補零）MMChar(10)用戶實際費用金額，以分為單位（長度不足左補零）MMChar(14)交易流水號（響應(yīng)時的交易流水號與請求相同）MChar(14)交易時間（YYYYMMDDHHMMSS）MMChar(4)應(yīng)用種類（代繳話費：0101 / 0001）MMChar(30)銀行柜臺代碼MMChar(3)銀行代碼MChar(14)應(yīng)答流水號（YYYYMMDDnnnnnn）MChar(2)交易返回碼MChar(40)說明信息MMChar(7)區(qū)號MMChar(16)電話號碼 注：1) 該報文用于銀行代繳話費。2) 用戶繳費前必須做話費查詢交易。3) “實交金額”即銀行實際收取的金額4) “用戶實際費用金額”域必須與話費查詢交易中返回的“用戶實際費用金額”完全一致，否則繳費會失敗。5) 發(fā)票信息可以從話費查詢交易中獲取，也可以通過發(fā)票打印交易獲取。6) 如果從話費查詢交易中獲取，無法分帳期打印發(fā)票，同時在繳費請求包中應(yīng)將應(yīng)用種類置為0101，銀行方應(yīng)將“實交金額”“用戶實際費用金額” “上期余額”打印在用戶發(fā)票的“本期余額”項目中（該項目不包含在查詢應(yīng)答包的名細項目中，要由銀行端程序產(chǎn)生）。通過此方式打印發(fā)票后，鐵通將該張發(fā)票置為已打印，銀行不能再通過發(fā)票打印或發(fā)票補打交易打印該張發(fā)票。7) 如果銀行不利用話費查詢交易信息打印發(fā)票，在繳費請求包中應(yīng)將應(yīng)用種類置為0001，鐵通將該次繳費的發(fā)票置為未打印，銀行能通過發(fā)票打印或發(fā)票補打交易打印該次繳費的發(fā)票。2.1.3 發(fā)票打?。ㄣy行鐵通）請求響應(yīng)屬性備注MMChar(4)包長度，傳遞ASC碼字符。17001710MMChar(4)單位編號（鐵通4位、0110）MMChar(14)交易流水號（響應(yīng)時的交易流水號與請求相同）MMChar(14)交易時間（YYYYMMDDHHMMSS）MMChar(30)銀行柜臺代碼MMChar(3)銀行代碼MMChar(14)對應(yīng)的話費繳納交易流水號MMChar(7)區(qū)號MMChar(16)電話號碼 MChar(1)上張發(fā)票打印結(jié)果（0：打印成功，1：打印失敗，2： 申請第一張發(fā)票）MChar(1)發(fā)票申請標志。0：繼續(xù)申請上張發(fā)票（上張發(fā)票打印失敗），1：申請下一張發(fā)票，2：停止申請（不想繼續(xù)申請或發(fā)票已經(jīng)申請完）。如果申請第一張發(fā)票該字段置1。MChar(2)剩余未打印發(fā)票張數(shù)（包括當前張）MChar(2)交易返回碼MChar(40)說明信息MChar(8)發(fā)票起日期MChar(8)發(fā)票止日期MChar(30)用戶名稱MChar(20)營業(yè)合同號（企業(yè)用戶在營業(yè)合同號末位加#號）MChar(10)上期余額（長度不足左補零）MChar(10)本次存入金額（長度不足左補零）MChar(10)支付話費（該帳期內(nèi)用戶實際費用金額，長度不足左補零）MChar(10)當前余額（長度不足左補零）MChar(2)話費明細個數(shù)（長度不足左補零）MLLVAR話費明細，不定長字符。先是費用項名稱20個字符，后跟10位以分為單位的費用，費用名稱不足20位右補空格，費用不足10位左補0。注：1) 該報文用于用戶繳納話費之后，分帳期打印發(fā)票。2) 該交易只返回本次繳費的發(fā)票信息，如果該次繳費跨幾帳期，發(fā)票將會有多張，每次只返回某一帳期的發(fā)票信息，該次繳費由“對應(yīng)的話費繳納交易流水號”域唯一決定。3) 如果銀行申請的為第一張發(fā)票，應(yīng)將“上張發(fā)票打印結(jié)果”域置為2（表示申請第一張發(fā)票），其它情況按照上張發(fā)票的實際打印結(jié)果置該域為相應(yīng)的值。4) 如果銀行申請的為第一張發(fā)票，將“發(fā)票申請標志”域置為1。5) 銀行在打印發(fā)票過程中，可以選擇繼續(xù)申請上一張發(fā)票（在上一張發(fā)票打印失敗的情況下），或者申請下一張未打印發(fā)票，或者停止申請；如果銀行停止申請，鐵通將不返回信息給銀行。6) 正常情況下，如果有n張發(fā)票需要打印，銀行需要發(fā)n+1次請求，其中最后一次請求為第n張發(fā)票的打印確認信息。7) 銀行在申請每一張發(fā)票時，都需要重新連接，即通訊采用短連接方式。2.1.4 發(fā)票補打（銀行鐵通）請求響應(yīng)屬性備注MMChar(4)包長度，傳遞ASC碼字符。18001810MMChar(4)單位編號（鐵通4位、0110）MMChar(14)交易流水號（響應(yīng)時的交易流水號與請求相同）MMChar(14)交易時間（YYYYMMDDHHMMSS）MMChar(30)銀行柜臺代碼MMChar(3)銀行代碼MMChar(7)區(qū)號MMChar(16)電話號碼 MChar(1)上張發(fā)票打印結(jié)果（0：打印成功，1：打印失敗，2： 申請第一張發(fā)票）MChar(1)發(fā)票申請標志。0：繼續(xù)申請上張發(fā)票（上張發(fā)票打印失?。?：申請下一張發(fā)票，2：停止申請（不想繼續(xù)申請或發(fā)票已經(jīng)申請完）MChar(2)剩余未打印發(fā)票張數(shù)（包括當前張）MChar(2)交易返回碼MChar(40)說明信息MChar(8)發(fā)票起日期MChar(8)發(fā)票止日期MChar(30)用戶名稱MChar(20)營業(yè)合同號（企業(yè)用戶在營業(yè)合同號末位加#號）MChar(10)上期余額（長度不足左補零）MChar(10)本次存入金額（長度不足左補零）MChar(10)支付話費（長度不足左補零）MChar(10)當前余額（長度不足左補零）MChar(2)話費明細個數(shù)（長度不足左補零）MLLVAR話費明細，不定長字符。先是費用項名稱20個字符，后跟10位以分為單位的費用，費用名稱不足20位右補空格，費用不足10位左補0。注：1) 該報文用于用戶所有未打印發(fā)票的打?。ɡ纾弘娫掋y行繳費、網(wǎng)上銀行繳費等）。2) 每次只返回一張發(fā)票的信息，如果有多張發(fā)票，需要發(fā)多次申請。3) 如果銀行申請的為第一張發(fā)票，應(yīng)將“上張發(fā)票打印結(jié)果”域置為2（表示申請第一張發(fā)票），其它情況按照上張發(fā)票的實際打印結(jié)果置該域為相應(yīng)的值。4) 如果銀行申請的為第一張發(fā)票，將“發(fā)票申請標志”域置為1。5) 銀行在打印發(fā)票過程中，可以選擇繼續(xù)申請上一張發(fā)票（在上一張發(fā)票打印失敗的情況下），或者申請下一張未打印發(fā)票，或者停止申請，如果銀行停止申請，鐵通將不返回信息給銀行。6) 正常情況下，如果有n張發(fā)票需要打印，銀行需要發(fā)n+1次請求，其中最后一次請求為第n張發(fā)票的打印確認信息。7) 銀行在申請每一張發(fā)票時，都需要重新連接，即通訊采用短連接方式。2.1.5 用戶退費（銀行鐵通）請求響應(yīng)屬性備注MMChar(4)包長度，傳遞ASC碼字符。03000310MMChar(4)單位編碼（鐵通4位、0110）MMChar(10)退費金額MMChar(14)交易流水號（請求時與響應(yīng)時相同）MChar(14)交易時間（YYYYMMDDHHMMSS）MChar(4)應(yīng)用種類（代繳話費：0101）MMChar(30)銀行柜臺代碼MMChar(3)銀行代碼MMChar(14)銀行原繳費交易流水號/應(yīng)答流水號MChar(2)返回碼MChar(40)說明信息MMChar(7)區(qū)號MMChar(16)電話號碼 注：1) 該交易主要是用于對某筆成功的繳費交易進行退費處理。2) 該交易只能做當日繳費交易的退費。2.1.6 繳費沖正（銀行鐵通）請求響應(yīng)屬性備注MMChar(4)包長度，傳遞ASC碼字符。04000410MMChar(4)單位編號（鐵通4位、0110）MMChar(10)沖正金額（長度不足左補零）MMChar(14)交易流水號（響應(yīng)流水號與請求流水號一致）MChar(14)交易時間（YYYYMMDDHHMMSS）MChar(4)應(yīng)用種類（代繳話費：0101）MMChar(30)銀行柜臺代碼MMChar(3)銀行代碼MMChar(14)銀行原繳費交易流水號MChar(2)返回碼MChar(40)說明信息MMChar(7)區(qū)號MMChar(16)電話號碼 注：1) 主要用于由于網(wǎng)絡(luò)或其它原因引起的銀行發(fā)出的繳費請求沒有收到響應(yīng)的處理，也可用于因操作員誤操作所引起錯誤的處理。2) 該交易只能做當日繳費交易的沖正。2.1.7 退費沖正（銀行鐵通）請求響應(yīng)屬性備注MMChar(4)包長度，傳遞ASC碼字符。13001310MMChar(4)單位編號（鐵通4位、0110）MMChar(10)沖正金額（長度不足左補零）MMChar(14)交易流水號（響應(yīng)流水號與請求流水號一致）MChar(14)交易時間（YYYYMMDDHHMMSS）MChar(4)應(yīng)用種類（代繳話費：0101）MMChar(30)銀行柜臺代碼MMChar(3)銀行代碼MMChar(14)銀行原退費交易流水號MChar(2)返回碼MChar(40)說明信息MMChar(7)區(qū)號MMChar(16)電話號碼 注：1) 該交易主要用于由于網(wǎng)絡(luò)或其它原因引起的銀行發(fā)出的退費請求沒有收到響應(yīng)的處理，也可用于因操作員誤操作所引起錯誤的處理。2) 該交易只能做當日退費交易的沖正。2.1.8 總額對帳（銀行鐵通）請求響應(yīng)屬性備注MMChar(4)包長度，傳遞ASC碼字符。05000510MMChar(4)單位編號(鐵通)MMChar(14)交易流水號（請求與響應(yīng)一致）MChar(14)交易時間（YYYYMMDDHHMMSS）MChar(4)應(yīng)用種類（代繳話費：0101）MMChar(3)銀行代碼MChar(2)返回碼MChar(40)說明信息MMChar(6)代收總筆數(shù)（長度不足左補零）MMChar(14)代收總金額（長度不足左補零）MMChar(14)對帳起始時間（YYYYMMDDHHMMSS）MMChar(14)對帳終止時間（YYYYMMDDHHMMSS）注：1) “代收總筆數(shù)”： 請求包為銀行在對帳時間內(nèi)發(fā)生的所有成功的繳費與退費交易的總筆數(shù)，不包括已沖正的記錄數(shù)；響應(yīng)包為鐵通在對帳時間內(nèi)發(fā)生的所有成功的繳費與退費交易的總筆數(shù)，不包括已沖正的記錄數(shù)。2) “代收總金額”： 請求包為銀行在對帳時間內(nèi)發(fā)生的所有成功的繳費與退費交易的總金額，不包括已沖正的記錄；響應(yīng)包為鐵通在對帳時間內(nèi)發(fā)生的所有成功的繳費與退費交易的總金額，不包括已沖正的記錄。3) 對于對帳業(yè)務(wù)，由銀行發(fā)出對帳請求，具體處理情況可參照前面所述。不論總額對帳是否正確，都要進行明細對帳。2.1.9 明細對帳（銀行鐵通）請求響應(yīng)屬性備注MMChar(4)包長度，傳遞ASC碼字符。06000610MChar(14)交易時間（YYYYMMDDHHMMSS）MChar(4)應(yīng)用種類（代繳話費：0101）MMChar(3)銀行代碼MMChar(14)交易流水號（請求與響應(yīng)一致）MMChar(80)對帳明細文件名，不足位右補空格。MMChar(10)對帳明細文件長度（長度不足左補零）MMChar(14)對帳起始時間（YYYYMMDDHHMMSS）MMChar(14)對帳終止時間（YYYYMMDDHHMMSS）MChar(2)返回碼MChar(40)說明信息注：1) 銀行方先將文件傳送到鐵通前置機再發(fā)對帳請求。2) 對帳文件所對應(yīng)的存放目錄，見銀行 - 鐵通FTP文件傳輸規(guī)范。3) 因以銀行方帳務(wù)為準，故不向銀行方傳遞對帳差錯文件。4) 對帳明細文件長度以文件系統(tǒng)給出的文件大小為準。（王旭）明細對帳文件格式（文件取名為B+銀行代碼_CRC_LIST_YYYYMMDD.TXT）類別屬性備注區(qū)號Char(7)區(qū)號（不足右補空）電話號碼Char(16)電話號碼（不足右補空）交易金額Char(10)交易金額，以分為單位（09，不足左補0）銀行交易流水號Char(14)銀行交易時所產(chǎn)生的流水號鐵通交易流水號Char(14)鐵通交易時所產(chǎn)生的流水號注：1) 明細對帳文件包括該銀行對帳時間范圍內(nèi)所有成功的繳費與退費交易記錄，不包括已沖正的記錄。2) 如果為退費交易記錄，金額為負值，負號位于最左邊。2.2 交易返回碼定義（鐵通銀行、銀行鐵通）交易返回碼說明00交易成功01此電話號碼或帳戶不存在02此電話號碼或帳戶無費用03此用戶不可以在銀行窗口交費04數(shù)據(jù)庫中無此用戶數(shù)10交易碼非法11訪問數(shù)據(jù)庫失敗12修改數(shù)據(jù)庫失敗13系統(tǒng)或網(wǎng)絡(luò)故障14打開文件錯20沖正日期非當天21已經(jīng)沖正，不可再沖正22沖正和交款機構(gòu)不一致23沖正系統(tǒng)錯24此沖正記錄不存在25已過退費時間26已經(jīng)退費30對帳文件長度不符31對帳筆數(shù)不符32對帳總額不符33銀行方無此筆交易記錄34鐵通方無此筆交易記錄35雙方交易記錄內(nèi)容不一致36電話號碼錯誤或不存在37用戶帳號錯誤38帳戶金額不足39扣款成功40已經(jīng)是代扣用戶,不