華為客服系統(tǒng)與計費、營帳系統(tǒng)接口協(xié)議說明書

1、華為客服系統(tǒng)與計費、營帳系統(tǒng)接口協(xié)議說明書第一章、背景華為客服系統(tǒng)的話費查詢、業(yè)務(wù)受理、用戶資料、欠費催繳等模塊需要與局方的計費、營帳系統(tǒng)對接。在實際開局過程中，許多地方都提出采用協(xié)議方式對接的要求。華為公司在總結(jié)了與對多方計費、營帳系統(tǒng)的實際對接方案后，提出了一整套協(xié)議方式對接的解決方案。第二章、術(shù)語簡要說明常連接：客服系統(tǒng)向計費、營帳系統(tǒng)建立TCP連接之后，雙方就采用該連接進行數(shù)據(jù)交換，該連接由客服系統(tǒng)來維護，當(dāng)發(fā)生網(wǎng)絡(luò)故障造成斷連后，客服系統(tǒng)會自動重連。短連接：當(dāng)客服系統(tǒng)需要發(fā)送請求報文時，就向計費、營帳系統(tǒng)建立一個連接，然后發(fā)送請求，請求發(fā)送完畢后，客服系統(tǒng)主動切斷連接。當(dāng)計費、營帳系

2、統(tǒng)需要發(fā)送應(yīng)答報文時，向客服系統(tǒng)建立一個連接，發(fā)送應(yīng)答報文，發(fā)送完畢后，主動切斷連接。（這種方式，會在客服以及計費、營帳系統(tǒng)之間頻繁建立、關(guān)閉連接，而連接的建立以及拆除是非常耗時的，而且涉及到系統(tǒng)SOCKET資源的頻繁申請、釋放。在話務(wù)量越大的時候，這個問題就越突出，造成不穩(wěn)定的隱患。強烈建議不要采用這種方式。同步方式： 指客服系統(tǒng)通過某個TCP連接向計費、營帳系統(tǒng)發(fā)送請求報文后，阻塞在該TCP連接上等待應(yīng)答，直到應(yīng)答結(jié)束或者等待應(yīng)答超時才能再次使用該TCP連接來發(fā)送新的請求。這種方式一般要建立一條以上的TCP連接。不推薦使用這種方式，這種方式浪費了TCP資源的使用率。異步方式：指客服系統(tǒng)通過

3、某個TCP連接向計費、營帳系統(tǒng)發(fā)送請求報文后，只要有新的請求報文，都可以使用該TCP連接發(fā)送出去。這種方式可以充分利用TCP連接資源，一般建立一個TCP連接即可。采用異步方式必須有請求ID，這樣才能將請求和應(yīng)答對應(yīng)起來。請求ID的詳細(xì)說明見后?？蛻暨M程：指客服通訊接口進程。有兩種含義：從業(yè)務(wù)邏輯上來說，客服系統(tǒng)發(fā)送請求，計費、營帳系統(tǒng)應(yīng)答。從連接方式上來說，客服系統(tǒng)發(fā)起連接請求，計費、營帳系統(tǒng)監(jiān)聽連接請求。服務(wù)進程：指計費、營帳通訊接口進程。請求報文：從客服系統(tǒng)發(fā)出的報文都統(tǒng)稱為請求報文。應(yīng)答報文：從計費、營帳系統(tǒng)發(fā)出的報文都統(tǒng)稱為應(yīng)答報文。請求、應(yīng)答方式：指客服系統(tǒng)發(fā)送請求報文，計費、營帳系

4、統(tǒng)針對該請求報文發(fā)送一條或者多條應(yīng)答報文。這是最常用的方式。請求、無應(yīng)答方式：指客服系統(tǒng)發(fā)送請求報文，計費、營帳系統(tǒng)針對該請求報文進行處理，但是不需要將結(jié)果返回給客服系統(tǒng)。這種方式只適用于某些特定的報文。如催繳結(jié)果回寫計費、營帳系統(tǒng)，計費，營帳系統(tǒng)對該請求報文進行處理后，不需要再回應(yīng)答報文給客服系統(tǒng)。無請求、應(yīng)答方式。指計費、營帳系統(tǒng)主動發(fā)送報文給客服系統(tǒng)。此種方式一般不推薦采用。變長包：指請求報文或者應(yīng)答報文的長度是變化的，不是固定包長固定包長不靈活且浪費傳輸帶寬，不推薦采用。由于TCP協(xié)議本身是面向字節(jié)流的，和UDP協(xié)議不同，所以不能認(rèn)為一次接收到的就是一條報文。所以在報文中必須有長度字段

5、或者其它標(biāo)志，接收進程根據(jù)該長度從接收到的字節(jié)流切割出一個個報文。命令字：命令字用來區(qū)分請求報文，應(yīng)答報文的命令字必須和請求報文的命令字一致。請求ID：客服系統(tǒng)發(fā)送請求報文時，攜帶有請求ID，該請求ID由客服系統(tǒng)產(chǎn)生，并且可以在較長一段時間內(nèi)保證唯一性。計費、營帳系統(tǒng)進行應(yīng)答時必須將請求ID返回，且不能修改，若有多個應(yīng)答包，則每個應(yīng)答包都必須帶有該請求ID。MorePkt字段：當(dāng)對應(yīng)一個請求有多個應(yīng)答報文時，必須通過該字段來說明還有后續(xù)包，還是應(yīng)答結(jié)束。網(wǎng)絡(luò)字節(jié)順序：由于在數(shù)據(jù)交換時，會涉及到不同主機硬件，而字節(jié)順序的處理可能不一致。所以對于通訊報文采用統(tǒng)一的字節(jié)順序即網(wǎng)絡(luò)字節(jié)順序。注意字節(jié)順

6、序只對存儲空間超過一個字節(jié)的類型有意義，對于字符串以及單字節(jié)整型數(shù)是無所謂的。字節(jié)對齊方式：由于不同的編譯器其默認(rèn)的字節(jié)對齊方式是不同的，為保證統(tǒng)一，要求都按照單字節(jié)對齊的方式設(shè)定編譯開關(guān)。最大包長：客服系統(tǒng)只能支持一個包最大20K的長度，所以所有的協(xié)議報文不能超過30K。第三章、網(wǎng)絡(luò)通訊協(xié)議客服系統(tǒng)和計費、營帳系統(tǒng)之間交換數(shù)據(jù)需要通過網(wǎng)絡(luò)來傳輸，網(wǎng)絡(luò)傳輸協(xié)議采用TCP/IP協(xié)議，雙方的通訊進程在TCP協(xié)議之上采用SOCKET方式建立一條或者多條TCP連接。根據(jù)業(yè)務(wù)邏輯來劃分，客服系統(tǒng)的接口進程是客戶端，計費、營帳系統(tǒng)的接口進程是服務(wù)端。計費、營帳系統(tǒng)的接口進程提供一個或多個監(jiān)聽端口?？头到y(tǒng)

7、主動發(fā)起連接請求，并負(fù)責(zé)斷連后的重連。當(dāng)計費、營帳系統(tǒng)應(yīng)答時，必須按照請求報文的路由原路返回。如果沒有原始請求報文，則按照預(yù)先商定好的路由傳輸?？头ㄓ嵔涌谶M程可以向計費、營帳接口進程的一個或者多個監(jiān)聽端口建立一條或者多條連接，這些連接可以采用負(fù)荷分擔(dān)的方式，也可以根據(jù)不同的業(yè)務(wù)報文走不同的連接。而且客服系統(tǒng)可以支持向多個計費，營帳系統(tǒng)的通訊接口進程建立連接?？头到y(tǒng)的接口通訊進程既可以采用負(fù)荷分擔(dān)的方式和多個計費、營帳接口進程通訊，也可以根據(jù)不同的業(yè)務(wù)報文走不同的計費、營帳接口進程。（這些實現(xiàn)必須計費、營帳系統(tǒng)的接口進程要支持。在實際應(yīng)用中，計費，營帳系統(tǒng)的接口進程可以采用上面所述方式中的一

8、種。譬如：在實際應(yīng)用中，自動業(yè)務(wù)的請求報文，對于應(yīng)答時間要求比較嚴(yán)格，但是查詢的結(jié)果數(shù)據(jù)集不多，一條應(yīng)答報文就可以實現(xiàn)。而人工業(yè)務(wù)的某些查詢請求，可能有許多的應(yīng)答包，這些應(yīng)答包在傳輸時會占用連接資源。所以一般將較短的的請求，應(yīng)答報文和較大的請求，應(yīng)答報文分別走不同的連接，可以提高系統(tǒng)的響應(yīng)速度。第四章、系統(tǒng)框圖建議計費、營帳系統(tǒng)的接口進程至少起兩個。第五章、報文協(xié)議詳述§1 通用報文結(jié)構(gòu)通用報文結(jié)構(gòu)分為兩部分，包頭和包體：1包頭控制信息：struct PktCtlMsg unsigned long len; / 包的總長度，為包控制信息和實際傳送內(nèi)容長度之和 unsigned cha

9、r factorycode;/ 廠商編碼, 華為168 unsigned char progid;/ 進程號 unsigned char morepkt; / 是否還有后續(xù)包，1有，0無 char cmd_id10; / 命令字，最大長度為9，以null結(jié)束 long start_num;/ 起始記錄號(從0開始) long end_num;/ 終止記錄號(為0時表示其余全部數(shù)據(jù)) long request_id; / 請求ID long answer_id; / 應(yīng)答ID(保留) long sequence;/ 包序號 char rec_seperator5;/ 記錄分隔符，最大長度為4，以

10、null結(jié)束 char field_seperator5;/ 字段分隔符，最大長度為4，以null結(jié)束 long dataflag;/ DataTrans 的結(jié)構(gòu)標(biāo)志，0 - 有標(biāo)題段和列寬段/ 1 - 無標(biāo)題段和列寬段 long reserved;/ 保留;2) 協(xié)議包結(jié)構(gòu)struct PktMsg struct PktCtlMsg CtlMsg;/ 包控制信息 short errorcode;/ 返回碼 char datatrans1;/ 傳送內(nèi)容，從datatrans開始依次為數(shù)據(jù)內(nèi)容，/ 實際使用時取其地址作為指針使用;3) 協(xié)議說明：1 包為變長，總長度由len域指定。2 發(fā)送包和接

11、受包都使用此結(jié)構(gòu)。3 進程號由客服系統(tǒng)產(chǎn)生，計費系統(tǒng)不可更改。計費系統(tǒng)前置機根據(jù)連接的IP地址和進程號唯一識別一個客戶端，判斷將哪些數(shù)據(jù)包回送給哪個客戶端連接。4 請求ID為客服系統(tǒng)生成，計費系統(tǒng)回送數(shù)據(jù)時將相應(yīng)的請求ID傳回來。應(yīng)答ID用于計費系統(tǒng)使用，也可不用。5 包序號為計費系統(tǒng)生成，對于每個請求，相應(yīng)的一個或多個應(yīng)答包都從1開始編號，逐次連續(xù)加一。如果有多個應(yīng)答包，則只有最后一個應(yīng)答包的morePkt 為0,其它包的morePkt 都為1。6 記錄分隔符和字段分隔符由客服系統(tǒng)指定，用于控制傳送內(nèi)容。計費系統(tǒng)回送報文時，rec_seperator和field_seperator原樣傳回，

12、并按照rec_seperator和field_seperator 組織回送內(nèi)容，詳見datatrans論述部分。7 datatrans 為實際發(fā)送或接收的數(shù)據(jù)內(nèi)容，實際上為一個變長數(shù)組，數(shù)據(jù)內(nèi)容依次向后放。8 人工和自動業(yè)務(wù)因為業(yè)務(wù)種類不同，需要的數(shù)據(jù)及格式也不同，因此cmd_id 分別定義，比如人工和自動都有業(yè)務(wù)受理的功能，要定義為兩個不同的cmd_id, 同時輸入的參數(shù)也有所不同。9 errorcode 為返回碼，表示請求是否被成功地處理，與具體的業(yè)務(wù)無關(guān)。0為成功，其它值為失敗。當(dāng)網(wǎng)絡(luò)、應(yīng)用通訊、數(shù)據(jù)庫訪問正常時，errorcode 應(yīng)該為0。請求包不填errorcode。10 客服系統(tǒng)

13、發(fā)送數(shù)據(jù)包datatrans內(nèi)容： 參數(shù)1參數(shù)2參數(shù)3.參數(shù)n;11 計費系統(tǒng)回送數(shù)據(jù)包 datatrans 內(nèi)容：第一包：標(biāo)題段;列寬段;數(shù)據(jù)段1;數(shù)據(jù)段2;.數(shù)據(jù)段n;標(biāo)題段內(nèi)容為：標(biāo)題1標(biāo)題2.標(biāo)題n。列寬段內(nèi)容為：列寬1列寬2.列寬n。列寬的數(shù)據(jù)類型為字符串，表示實際傳送數(shù)據(jù)列的最大實際寬度，用于控制在界面上顯示的寬度。實際傳送時可根據(jù)實際情況，取值小于等于數(shù)據(jù)庫的字段寬度。如'20101540'。每一數(shù)據(jù)段包括：數(shù)據(jù)1數(shù)據(jù)2.數(shù)據(jù)m。每一個字段的實際傳送都以字符串方式傳送。標(biāo)題段、列寬段、數(shù)據(jù)段之間，以及各數(shù)據(jù)段之間，都用記錄分隔符進行分隔，記錄分隔符由客服發(fā)送報文的

14、rec_seperator 指定，記錄分隔符一般采用分號(;)。各標(biāo)題之間、各列寬之間、各數(shù)據(jù)字段之間用字段分隔符進行分隔，字段分隔符由客服發(fā)送報文的field_seperator 指定。字段分隔符一般采用波浪號()。當(dāng)返回碼errorcode不為0，即失敗時，回送數(shù)據(jù)包datatrans 內(nèi)容為：標(biāo)題;列寬;錯誤碼錯誤信息描述;當(dāng)dataflag 為0時，datatrans 中含有標(biāo)題段和列寬段，這種報文用于人工業(yè)務(wù)和人工自動都可進行的業(yè)務(wù)。 當(dāng)dataflag 為1時，datatrans 中不含標(biāo)題段和列寬段，這種報文只用于自動業(yè)務(wù)。在多包情況下，不可出現(xiàn)一條記錄被截斷而出現(xiàn)在兩個包中的情

15、況。4業(yè)務(wù)處理方式提供兩種方式進行業(yè)務(wù)處理。第一種：一次查詢?nèi)拷Y(jié)果，將起始位置和終止位置都設(shè)為0。結(jié)果可分為一個或多個包發(fā)回給客服系統(tǒng)。第二種：分段查詢。用于查詢詳單，查詢催繳數(shù)據(jù)等海量數(shù)據(jù)。在發(fā)起的報頭中指定每次查詢的起始位置和終止位置.即可進行分段的查詢，如起始位置為0，結(jié)束位置為30，則查詢前30條記錄。系統(tǒng)每次要求傳輸?shù)臄?shù)據(jù)量可以由程序指定. 分段查詢過程中，后續(xù)查詢的結(jié)果格式與第一次查詢的結(jié)果格式完全相同(標(biāo)題段，列寬段，數(shù)據(jù)段)。§2. 業(yè)務(wù)報文1. 語音播報欠費信息(xf_GetDebtFee)功能詳述：查詢用戶欠費信息，提供語音播報。報文詳述：發(fā)送報文：命令字：10

16、004datatrans：sIDnOption;回送報文：datatrans：retoutNoteItem1outNoteItem2outNoteItem3outNoteItem4outNoteItem5outNoteItem6outNoteItem7outNoteItem8outNoteItem9outNoteItem10;參數(shù)說明：sID: 用戶號碼nOption: 號碼類別, 1-合同號 2-固定號碼 3-移動號碼 4-托收號碼ret: ret=0表示欠費，ret=111不欠費outNoteItem1.outNoteItem10：要播報的各項欠費數(shù)據(jù)。播報的欠費數(shù)據(jù)格式可有兩種，可根據(jù)局

17、方的實際情況選擇一種，下面詳述如下： 方式一：格式為：其中NN為帳目的索引值， 由計費系統(tǒng)指定MMMMMM為帳目的中文描述XXXXX為具體的帳目金額，單位是人民幣分注意三個字段都是不定長的，用"."做分割此種方式適用于局方數(shù)據(jù)庫為豎表方式實現(xiàn)帳目計費的，比如帳目表只有三列：帳目索引，帳目名稱，帳目金額。方式二、格式為 “XXXX”，其中XXXX為各帳目金額，單位為人民幣分。此種方式適用于局方數(shù)據(jù)庫為橫表方式實現(xiàn)帳目計費的，使用此種方式回送數(shù)據(jù)要求順序嚴(yán)格固定。2. 號碼驗證(NumberExistJudg)功能詳述：有線客服系統(tǒng)號碼驗證。報文詳述：發(fā)送報文：命令字：1000

18、8datatrans：sIDnOption;回送報文：datatrans： ret;參數(shù)說明：sID-輸入號碼 nOption-調(diào)用類別 1：合同號嗎，2：固定號碼，4：托收號碼 ret：ret=0成功，ret=111、此用戶不存在，或輸入nOption參數(shù)錯誤3. 語音報總帳(xf_GetTotalFee)功能詳述：查詢用戶的某月話費，提供語音播報。報文詳述：發(fā)送報文：命令字：10009datatrans：inIDinIDTypeinYearMonth;回送報文：datatrans：retoutFeeMonthnoteoutDateTimeoutTotalAmountoutFee1.outF

19、eeN;參數(shù)說明： inID：合同號碼、固定號碼、移動號碼、托收號碼 inIDType：1: 合同號，2: 固定，3: 移動，4: 托收號碼 inYearMonth：查詢年月，格式：YYYYMM或MMret：ret= 0, 成功，ret= 111, 數(shù)據(jù)不存在，時間輸入不正確或inIDType輸入錯outFeeMonth：返回的話費月份，格式為YYYYMM，其值必須給出note：通知語音編號譬如 note = 1 代表語音 “您的話費已經(jīng)托收”，此時系統(tǒng)會播放“您XXXX年XX月份的話費為XXX，您的話費已托收”。又比如note = 2 代表語音“您的話費已交”此時系統(tǒng)會播放“您XXXX年XX月份的話費為XXX，您的話費已交”。該語音編號可