中間業(yè)務(wù)聯(lián)通新接口

1、綜合營帳代收接口方案 3.5最后更新日期 2002-8-8山東版本說明：該版本是對以前的接口方案 3.X和補(bǔ)充說明匯總，本版本中的接口形式無新的變化，但補(bǔ)充，各代收機(jī)構(gòu)需嚴(yán)格執(zhí)行。補(bǔ)充規(guī)定：1、明確包頭中 A9 位置的定義，必須嚴(yán)格按照下述描述指收方的形式?；镜拇招问揭话阌袑?shí)時(shí)柜臺(tái)交費(fèi)、自助交費(fèi)、協(xié)議批量代扣、網(wǎng)上交費(fèi)、ATM 自助交費(fèi)等形式，它們的代碼分別為MAN、BAT、WEB、ATM，代收機(jī)構(gòu)每增加新的代收形式，都需要事先以形式通知方；2、打印時(shí)，通過接口方返回給代收機(jī)構(gòu)的項(xiàng)目，代收方必須嚴(yán)格按照返回內(nèi)容、完全打印到上，包括的繳費(fèi)流水號、第幾/幾張、時(shí)間、部門等；對在上定義的接口中不

2、需返回的代收方的項(xiàng)目，也要嚴(yán)格打印，包括代收網(wǎng)點(diǎn)、網(wǎng)點(diǎn)流水號、操作員、操作部門等。3、在以前版本的交費(fèi)交易（交易碼 010102）的請求包的最后有是否生成的標(biāo)志，現(xiàn)改為忽略該值，不論其值為多少，都生成，但該標(biāo)志的位置仍保留。4、部分代收機(jī)構(gòu)通過本接口實(shí)現(xiàn)的批量或自助等業(yè)務(wù)，由于該種業(yè)務(wù)具有客戶不需親自到現(xiàn)場的特點(diǎn)，在開通該類業(yè)務(wù)時(shí)系統(tǒng)必須能實(shí)現(xiàn)客戶對票據(jù)的需求。為了使業(yè)務(wù)處理清晰簡潔，代收機(jī)構(gòu)應(yīng)取回發(fā)票內(nèi)容入庫保留，以便在以后查詢打印或采取其它通知和送達(dá)方式。在保留內(nèi)容時(shí)要注意到能處理中項(xiàng)目的靈活、不固定的特點(diǎn)。5、其它改動(dòng)或補(bǔ)充在下一版本中。山東自 96 年開業(yè)以來，、郵政代系統(tǒng)在對用戶服務(wù)

3、方面發(fā)揮了巨大的作用。但隨著用戶數(shù)量的增長、業(yè)務(wù)的發(fā)展，老的代系統(tǒng)已經(jīng)無法適應(yīng)業(yè)務(wù)需要。首先，在 97 年初代系統(tǒng)啟用初期，山東只存在后用戶，即用戶打完并在月結(jié)出帳后才需要交費(fèi)，但是為了方便用戶，不論是否欠費(fèi)和欠費(fèi)多少，用戶都可以隨意交任意金額的作法是在一開始就堅(jiān)持的一條原則，因而在那時(shí)，用戶的票據(jù)由兩種情況，欠費(fèi)但未交足和足額交清。后來，隨著業(yè)務(wù)的發(fā)展，增加了預(yù)業(yè)務(wù)，因而又增加了一種在用戶不欠費(fèi)情況下交費(fèi)產(chǎn)生的預(yù)格式；鑒于內(nèi)容和格式有所區(qū)別，在上增加了備注內(nèi)容，相應(yīng)地在接口上也擴(kuò)充了備注列，用于標(biāo)注“本月話費(fèi)未結(jié)清(收據(jù))”、“預(yù)交款(收據(jù))”等。從增加該備注列后新開通的或作過系統(tǒng)升級的部分

4、老，都是按照這種接口執(zhí)行的。隨著山東一期期工程的進(jìn)展，至今已經(jīng)是五期、六期工程了，但接口方面一直未有進(jìn)一步的變化。的下一步系統(tǒng)規(guī)劃中，為了塑造“世界關(guān)注的中國綜合電信運(yùn)營商”的形象，對運(yùn)營支撐系統(tǒng)的要求也越來越高。為了實(shí)現(xiàn)的 GSM、CDMA 移動(dòng)業(yè)務(wù)互聯(lián)網(wǎng)業(yè)務(wù)、長途業(yè)務(wù)、IP 業(yè)務(wù)等綜合業(yè)務(wù)的“一張單據(jù)”等新要求，以及改變原有接口已存在的與現(xiàn)有業(yè)務(wù)也不能很好適應(yīng)的缺陷，特在老接口的基礎(chǔ)上，根據(jù)山東的情況，結(jié)合的實(shí)現(xiàn)方法，提出新的綜合代收接口。新接口的目標(biāo)是，首先從技術(shù)上保證接口更加穩(wěn)定可靠；其次，要在的接口上完成綜合業(yè)務(wù)的代功能， 實(shí)現(xiàn)“一臺(tái)清”和“一單清”；再次，新的接口要在適應(yīng)當(dāng)前業(yè)務(wù)需

5、求的基礎(chǔ)上，適當(dāng)考慮將來業(yè)務(wù)的擴(kuò)展。新接口的特點(diǎn)、與老接口的明顯變化：1、實(shí)現(xiàn)綜合業(yè)務(wù)。在老接口中，是用在同一個(gè)位置上機(jī)號和帳號指定用戶的；在新接口中，參照中國總部 H2 接口規(guī)范，凡需要指定用戶的場合，都包含以下三項(xiàng)內(nèi)容：業(yè)務(wù)類型（代表 GSM、CDMA、165、193等各種業(yè)務(wù)）、號碼類型（代表在同一種業(yè)務(wù)中后面的值是號碼還是帳號等）、號碼具體值（該值的具體內(nèi)容）。在和交費(fèi)方式的處理上，該接口對所有綜合業(yè)務(wù)的處理也是的。2、在接口中著重考慮易用性和易理解性，適當(dāng)增加說明文字的位置，讓受理員清楚、讓顧客明白。該處的信息還可用作在出現(xiàn)錯(cuò)誤時(shí)，直接返回提示信息。3、豐富查詢內(nèi)容，在用戶查詢應(yīng)交話

6、費(fèi)時(shí)，適當(dāng)將與交費(fèi)相關(guān)的一些用戶屬性返回。如：性質(zhì)（是預(yù)還是后），用戶的當(dāng)前欠費(fèi)額及建議交費(fèi)額等。在用戶欠多月的情況下，除了返回欠費(fèi)總額外，還返回每個(gè)月的欠費(fèi)情況。4、欠費(fèi)額及建議交費(fèi)額的含義及計(jì)算方法。用戶的欠費(fèi)額是用戶截至到當(dāng)前的欠費(fèi)金額（后用戶不包括當(dāng)月實(shí)時(shí)話費(fèi)），若小于零，則表明用戶不欠費(fèi)，其絕對值代表用戶的預(yù)付款余額。建議交費(fèi)額的計(jì)算方法：若為預(yù)用戶，在欠費(fèi)額的基礎(chǔ)上（不論正負(fù)）增加 50，若該值0,則向上取成 5 的倍數(shù)；若該值0,則向上取 5 的倍數(shù)；若該值0，則為 0。說明60可以增加說明性文字返回月數(shù)2表明本次返回幾個(gè)月的數(shù)據(jù)10 x0A分割符序號2代表欠費(fèi)的第幾個(gè)月份，排序

7、后字段字段長度說明預(yù)留20為請求方提供的字段，服務(wù)應(yīng)答時(shí)原樣返回。帳期6格式：YYYYMM。若 atol(該值)=0,則含義為查詢欠費(fèi)情況；否則，含義為查詢指定月份的費(fèi)用情況。（注：指定月份查詢的功能尚未完善）0 x1A包結(jié)束標(biāo)志2. 繳費(fèi)（交易代碼 010102）(包頭 A7 為 01，A6 為號碼)請求包格式：字段字段長度說明預(yù)留20合同號20繳費(fèi)金額12(允許為零，此時(shí)代表交零打票)繳費(fèi)日期14格式：YYYYMMDDHHMISS。為請求方時(shí)間，作為對帳依據(jù)是否生成1（Ver3.5 后忽略該標(biāo)志，即不論該值如何，都認(rèn)為是生成）帳期6可能存在多個(gè)帳期是否交清11（是）；0（否）。是否打印過1

8、1（是）；0（否）。上期余額10本月合計(jì)10本月用戶產(chǎn)生的費(fèi)用本月已繳10在本次交費(fèi)前用戶已交的本月費(fèi)用本月欠費(fèi)10本月到當(dāng)前的欠費(fèi)到當(dāng)前的滯納金10本月欠費(fèi)到當(dāng)前產(chǎn)生的滯納金本月總應(yīng)交10本月到當(dāng)前總應(yīng)交備注20可增加注釋10 x0A分割符序號2帳期6可能存在多個(gè)帳期.備注2010 x1A包結(jié)束標(biāo)志應(yīng)答包格式：3. 打（交易代碼 010103）(包頭 A7 為 01，A6 為號碼)請求包格式：應(yīng)答包格式：字段字段長度說明預(yù)留20繳費(fèi)流水號20服務(wù)方交易流水號。說明60210 x0A分割符序號2日期10格式：YYYY.MM.DD 為服務(wù)方日期時(shí)間8格式：HH:MI:SS 為服務(wù)方時(shí)間字段字段長

9、度說明預(yù)留20繳費(fèi)流水號20服務(wù)方交易流水號。(若打印失敗，同一個(gè)流水號可再次申請)序號2代表要打印該流水的第幾張(0 或非法值代表取該筆流水的所有)10 x1A包結(jié)束標(biāo)志字段字段長度說明預(yù)留20繳費(fèi)流水號20服務(wù)方交易流水號。說明6010 x1A包結(jié)束標(biāo)志10 x1A包結(jié)束標(biāo)志合同號20用戶名稱60代表號20用字符方式處理，原樣打印類型20為字符，標(biāo)明的類型帳期6為字符項(xiàng)目總數(shù)最大值 2410 x0D單元分割符費(fèi)用項(xiàng)目名 120字符費(fèi)用金額 110字符(為了打印方便，已填空對齊)費(fèi)用項(xiàng)目名 220字符費(fèi)用金額 210字符(為了打印方便，已填空對齊).10 x0D單元分割符上次余額10字符(為

10、了打印方便，已填空對齊)本次實(shí)交10字符(為了打印方便，已填空對齊)本次余額10字符(為了打印方便，已填空對齊)金額大寫40字符金額小寫10字符(為了打印方便，已填空對齊)部門20字符，在代打時(shí)可以不同于部門備注敬告、通知等備注敬告、通知等備注敬告、通知等x0A分割符序號2下一張.4.退款（交易代碼 010104）、沖正（交易代碼 010105）(包頭 A7 為 01，A6 為號碼) (如果是退款包頭 A7 為 02，A6 為帳號)請求包格式：應(yīng)答包格式：5.交費(fèi)情況查詢（交易代碼 010106）(包頭 A7 為 01，A6 為號碼)通過接口能夠查詢指定用戶的當(dāng)天的交費(fèi)和退款情況。請求包格式：

11、應(yīng)答包格式：字段字段長度說明預(yù)留20字段字段長度說明預(yù)留20日期8格式：YYYYMMDD10 x1A包結(jié)束標(biāo)志字段字段長度說明預(yù)留20說明6010 x1A包結(jié)束標(biāo)志字段字段長度說明預(yù)留20繳費(fèi)請求流水號20沖正時(shí)忽略此值繳費(fèi)金額12退款日期14格式：YYYYMMDDHHMISS。為請求方時(shí)間，作為對帳依據(jù)10 x1A包結(jié)束標(biāo)志備注 3800 x1A 包結(jié)束符6. 查詢月費(fèi)用（交易碼 010107）(包頭 A7 為 01，A6 為號碼)根據(jù)指定用戶和指定月份，查詢用戶的明細(xì)項(xiàng)目和金額。請求包格式：應(yīng)答包格式：字段字段長度說明預(yù)留20帳務(wù)月份6格式：YYYYMM10 x1A包結(jié)束標(biāo)志說明60業(yè)務(wù)筆

12、數(shù)210 x0A分割符序號2流水號20服務(wù)方交易流水號。交費(fèi)部門20交費(fèi)機(jī)構(gòu)業(yè)務(wù)種類12交費(fèi)或退款等發(fā)生金額10業(yè)務(wù)狀態(tài)10是否有效發(fā)生時(shí)間14格式：YYYYMMDDHHMISS。為請求方時(shí)間，作為對帳依據(jù)2若未打印則為零備注2010 x0A分割符序號2下一筆.備注2010 x1A包結(jié)束標(biāo)志7. 取服務(wù)方文件(交易代碼 010108)取服務(wù)方文件，文件名必須登記在服務(wù)方的配置文件內(nèi)，配置文件內(nèi)可以登記文件名的匹配規(guī)則。請求包格式：(無包體)字段字段長度說明字段字段長度說明預(yù)留20合同號20代表號20用戶名60說明60210 x0A分割符序號2項(xiàng)目總數(shù)最大值 24費(fèi)用項(xiàng)目名 120字符費(fèi)用金額

13、110字符(為了顯示方便，已填空對齊)費(fèi)用項(xiàng)目名 220字符費(fèi)用金額 210字符(為了顯示方便，已填空對齊).10 x0A分割符序號2下一張.10 x1A包結(jié)束標(biāo)志應(yīng)答包格式：8.對帳文件傳輸（交易代碼 010109）（注：沒有包結(jié)束符。對帳文件格式說明見后）送對帳文件（或其它文件），用于將代收方的文件傳送到方。請求包格式：應(yīng)答包格式：五 對帳文件規(guī)范：1.文件命名方式：LT+A8 營業(yè)點(diǎn)(最大 6 位，6 位取實(shí)際位數(shù)) 序號（2 位，00）日期（8 位）2.時(shí)間:約定一天對一次。每天晚上 24:00 之前；每月最后一天 19:00 前3.傳送過程中若失敗，sleep 若干秒后重試,重試 5

14、 次仍不成功則失敗退出。4.文件格式字段行數(shù)說明字段字段長度說明文件名40文件大小10寫到磁盤上的文件的尺寸10 x1A包結(jié)束標(biāo)志字段字段長度說明文件名40文件內(nèi)容4k整個(gè)包的總長度4K字段字段長度說明文件大小10磁盤文件尺寸文件內(nèi)容4K整個(gè)包的總長度4K文件名4010 x1A包結(jié)束標(biāo)志統(tǒng)計(jì)時(shí) 間段1 行YYYYMMDDHHMMSS:YYYYMMDDHHMMSS-YYYYMMDDHHMMSS統(tǒng)計(jì)數(shù)據(jù)生成時(shí)間:統(tǒng)計(jì)起始點(diǎn)-統(tǒng)計(jì)結(jié)束點(diǎn)總數(shù)1 行總金額|總筆數(shù)明細(xì)業(yè) 務(wù)N 行繳費(fèi)請求包頭流水號|繳費(fèi)返回包體流水號|繳費(fèi)請求合同號|繳費(fèi)請求金額|預(yù)留文件尾1(在無后續(xù)文字時(shí)也要存在)區(qū)任意的文字六 幾

15、個(gè)典型業(yè)務(wù)的數(shù)據(jù)包結(jié)構(gòu)圖：1、 查詢請求包(簡單格式)TE包 頭包 體應(yīng)答包ATTAE包 頭用戶信息月份帳務(wù)信息2、 繳費(fèi)請求包：簡單格式應(yīng)答包：簡單格式3、打印請求包TE應(yīng)答包ATTTTADDE包頭總情況頭體尾4、 退款、沖正請求包：簡單格式應(yīng)答包：簡單格式七打印規(guī)范：下面是空白的示意圖在系統(tǒng)中打印票據(jù)時(shí)共有三種情況，分別是已出帳月的完整、已出帳月的交票據(jù)、尚未出帳月的預(yù)交款票據(jù)，情況分別如下：1、正常2、未交清中國山東發(fā)票聯(lián)網(wǎng)點(diǎn)流水號：1234567890地稅 No.交費(fèi)流水號：123456789012第 1/2 張時(shí)間：2002.01.28 12:34:56操作員: JNCZY操作部門:

16、 JNYYT1網(wǎng)點(diǎn):部門: JNYYT1敬 1.2.告 3.客戶帳號1234567890客戶名稱碼類型1出 帳 月2001.12項(xiàng)目金額項(xiàng)目金額項(xiàng)目金額月租費(fèi)市話費(fèi)長途費(fèi)特服費(fèi)漫游費(fèi)其它費(fèi)1.002.003.004.005.006.00 7.00 上次余額1.00本次實(shí)交15.00本次余額2.00合計(jì)金額大寫壹拾肆元整合計(jì)金額14.00中國山東發(fā)票聯(lián)網(wǎng)點(diǎn)流水號：地稅 No.交費(fèi)流水號：第 / 張時(shí)間：客戶帳號客戶名稱碼類型出 帳 月項(xiàng)目金額項(xiàng)目金額項(xiàng)目金額上次余額本次實(shí)交本次余額合計(jì)金額大寫合計(jì)金額操作員:操作部門:網(wǎng)點(diǎn):部門:敬 1.2.告 3.3、 預(yù)交款中國山東發(fā)票聯(lián)網(wǎng)點(diǎn)流水號：1234

17、567890地稅 No.交費(fèi)流水號：123456789012第 1/1 張時(shí)間：2002.01.28 12:34:56操作員: ABCD操作部門: JNZSYH網(wǎng)點(diǎn): 955551234部門: JNZSYH敬 1.2.告 3.客戶帳號1234567890客戶名稱碼類型2出 帳 月2002.01項(xiàng)目金額項(xiàng)目金額項(xiàng)目金額預(yù)交款本月實(shí)時(shí)話費(fèi)預(yù)交款累計(jì)(收據(jù)) 16.0050.00上次余額20.00本次實(shí)交30.00本次余額34.00合計(jì)金額大寫合計(jì)金額30.00中國山東發(fā)票聯(lián)網(wǎng)點(diǎn)流水號：1234567890地稅 No.交費(fèi)流水號：123456789012第 1/1 張時(shí)間：2002.01.28 12

18、:34:56操作員: ABC操作部門: JNNH網(wǎng)點(diǎn): 370001234部門: JNNH敬 1.2.告 3.客戶帳號1234567890客戶名稱碼類型2出 帳 月2001.10項(xiàng)目金額項(xiàng)目金額項(xiàng)目金額本月話費(fèi)未結(jié)清本月話費(fèi)合計(jì)本次交滯納金(收據(jù)) 14.001.00上次余額-1.00本次實(shí)交10.00本次余額-6.00合計(jì)金額大寫合計(jì)金額10.004、 說明：5、上面分三個(gè)區(qū)，從上往下分別為 H 區(qū)、D 區(qū)和 F 區(qū)；6、H 區(qū)和 F 區(qū)項(xiàng)目內(nèi)容較固定；網(wǎng)點(diǎn)流水號、操作員、操作部門、網(wǎng)點(diǎn)等信息由代收方自己提供，接口中不再傳輸；包括部門在內(nèi)的其余項(xiàng)目內(nèi)容全部從接口中獲得；7、D 區(qū)按照接口中的內(nèi)容和順序依次打印；8、原則上在接口中用來在上打印的數(shù)據(jù)都是用字符格式，代收方不必轉(zhuǎn)化；若某些值為空，則打印空格或不必打??；八 附注：1. 應(yīng)答結(jié)果代碼約定如下：（詳細(xì)代碼另行定義，或以文件形式通過接口取得）服務(wù)類型返回碼說明任何00000操作成功查詢