1、.SOP通訊格式規(guī)則1. 概述通訊數(shù)據(jù)包由公共信息部分、交易數(shù)據(jù)部分公共信息部分包括系統(tǒng)信息頭和交易公共信息頭。交易數(shù)據(jù)部分包括交易數(shù)據(jù)頭（可選）、業(yè)務數(shù)據(jù)和系統(tǒng)控制命令。業(yè)務數(shù)據(jù)部分又包括數(shù)據(jù)單元、表格和對象。業(yè)務數(shù)據(jù)部分可以插入系統(tǒng)控制命令。1.1 系統(tǒng)信息頭部分是與系統(tǒng)相關的，包括目標服務代碼、數(shù)據(jù)源代碼、長度等系統(tǒng)信息，由系統(tǒng)配置文件（數(shù)據(jù)庫表，下同）指定，每字段的個數(shù)、順序、長度固定。1.2 交易公共信息頭部分是跟同一數(shù)據(jù)包中所包含的所有交易相關的信息，包括交易的終端，交易柜員，機構等信息，組織方式同系統(tǒng)信息頭的格式。1.3 交易數(shù)據(jù)頭部分包括交易代碼，交易模式，前臺流水號,授權柜員

2、等信息，組織方式同系統(tǒng)信息頭的格式。1.4 業(yè)務數(shù)據(jù)部分 由長度+數(shù)據(jù)組成，長度用一個字節(jié)的二進制數(shù)表示，數(shù)據(jù)全部轉換成字符串傳送，字符串的最大長度由系統(tǒng)的BYTE_MAX_LEN宏定義指定（在本系統(tǒng)里，我們定義BYTE_MAX_LEN 為250（0xFA），大于該長度的部分系統(tǒng)保留作為控制命令用。如果數(shù)據(jù)單元的長度超過BYTE_MAX_LEN，則分段發(fā)送，0xFF作為超長數(shù)據(jù)的標志。例如要傳768字節(jié)數(shù)據(jù)，由于系統(tǒng)定義BYTE_MAX_LEN為250，則該數(shù)據(jù)段為0xFF+250字符+0xFF+250字符+0xFF+250字符+0x12+18字符；如要傳250字節(jié)數(shù)據(jù)時，則該數(shù)據(jù)段為0xFA

3、+250字符?？刂泼畈糠?。在業(yè)務數(shù)據(jù)中，可以穿插控制命令，其格式為：控制字符標志+控制字符串長度+控制字符串?？刂谱址麡酥居上到y(tǒng)保留的BYTE_MAX_LEN0xFF之間的字符標識，在本系統(tǒng)中系統(tǒng)保留字符為0xFB，0xFC，0xFD，0xFE，目前僅使用0XFE作為打印相關的控制命令標識符。整個通訊數(shù)據(jù)包的組成示意圖如下：公共信息交易數(shù)據(jù)交易頭業(yè)務數(shù)據(jù)系統(tǒng)信息頭交易公共信息頭交易數(shù)據(jù)頭數(shù)據(jù)單元數(shù)據(jù)單元數(shù)據(jù)單元表格單元對象單元?？刂泼畲a可以穿插在業(yè)務數(shù)據(jù)之間，如單元與單元之間，表格內部數(shù)據(jù)項之間，以及對象內數(shù)據(jù)項之間下面將分幾個部分詳細描述整個系統(tǒng)的通訊格式。2. 單元定義2.1 數(shù)據(jù)單元

4、（TRANFLD）數(shù)據(jù)單元TRANFLD是COP和SOP中代表特定內容的基本數(shù)據(jù)項，一般對應一個應用數(shù)據(jù)定義，在SOP平臺中采用可自解包的通訊格式。數(shù)據(jù)單元通訊格式如下：可選機構名可選金額可選266字節(jié)數(shù)據(jù)。屬性0X5“A網點”屬性0X“123.45”屬性0xFF250字節(jié)0X1016字節(jié)每一個數(shù)據(jù)單元在通訊格式中用兩個部分表示長度+內容。內容部分都以字符串方式傳輸，截掉前導和后續(xù)的空格，以減少冗余數(shù)據(jù)的傳輸。長度以一個字節(jié)的16進制數(shù)表示，可表示的最大長度為250（0XFA）字節(jié)，若數(shù)據(jù)單元長度超過250字節(jié)，則采用分解傳送的方式，以0XFF表示數(shù)據(jù)單元超長，如上圖中266字節(jié)數(shù)據(jù)單元。長度

5、定義中0XFB0xFE保留，作為控制命令使用，見控制命令描述。屬性是可選項，可以包括多種屬性，目前僅支持打印屬性。對于一般數(shù)據(jù)單元不需要定義，對于其它對象一般需要定義相應屬性。打印屬性定義格式如下：打印行打印列打印模式0，本系統(tǒng)中，要求Y=250 & X=250。打印模式的具體含義見打印模式定義。2.2 表格單元（FORM）表格單元FORM是指COP和SOP平臺中由格式相同的多條記錄組成的復合數(shù)據(jù)單元，其中每一條記錄的數(shù)據(jù)又由多個數(shù)據(jù)單元組成。表格在通訊格式中以表格名+記錄條數(shù)+多條記錄數(shù)據(jù)組成，每一條記錄又由多個數(shù)據(jù)單元（表示方法同數(shù)據(jù)單元）表示。表格單元的通訊格式如下：表格名記錄條數(shù)欄位個

6、數(shù)可選項記錄01記錄020X3“F01”0X20X3打印屬性或其它0X3“ABC”0X2借0x“1234.99”0X4“李明”0X2貸0x5“20.00”表格名長度表格名稱見下表姓名項借貸標志項金額項姓名項借貸標志項金額項屬性是可選項，在一般數(shù)據(jù)單元的定義中不使用。在本系統(tǒng)中，記錄條數(shù)不得大于250個。如果記錄條數(shù)可能大于250條，必須采用文件傳輸?shù)姆绞浇鉀Q這一問題。表格的打印屬性定義如下：起始行號打印列模式打印列模式。打印列n模式nYX1M1X2M2XnMn模式M1Mn為數(shù)字代碼，含義同數(shù)據(jù)單元中的說明。其它屬性定義可以根據(jù)擴展對象的屬性進行定義。2.3 對象單元COP/SOP的對象代表一個

7、具有特定屬性的復合數(shù)據(jù)單元，是COP/SOP系統(tǒng)實現(xiàn)后臺驅動前臺的基礎。對象描述中必須包括對象名，其它屬性如字段排列順序等可在外部靜態(tài)定義。對象的組成元素可以包括數(shù)據(jù)單元和表格單元等系統(tǒng)支持的各類單元。在COP/SOP系統(tǒng)中，對象的類型可以根據(jù)需求進行擴展和定義，目前支持的對象類型包括窗口對象、打印對象等。對象一般由對象名+數(shù)據(jù)單元(可選項)+表格單元(可選項)組成。一個包含數(shù)據(jù)單元和表格單元的窗口對象的通訊格式如下：對象名對象內容0X5“OBJ01”數(shù)據(jù)單元數(shù)據(jù)單元。表格單元01數(shù)據(jù)單元。窗口對象的對象內容中不包含數(shù)據(jù)單元和表格單元的可選屬性，如行、列、模式等信息。打印對象由對象名+打印屬性

8、數(shù)據(jù)單元(可選項)+表格名稱記錄條數(shù)欄位數(shù)打印屬性格數(shù)據(jù)(可選項)打印控制命令碼（可選項）組成。打印控制命令碼見打印控制命令碼介紹。2.4 控制命令碼控制命令碼可以穿插在數(shù)據(jù)單元之間，也可以穿插在表格單元的數(shù)據(jù)項之間。COP/SOP系統(tǒng)中保留了XFB0XFE之間的取值作為控制命令標志用。目前僅使用控制命令標志0XFE，作為打印控制命令碼傳輸標志。控制命令標志控制命令長度N位控制序列0XFE0xN0x14。在這里有一個換頁打印的問題，本系統(tǒng)定義了0xFE為系統(tǒng)控制命令標志，換頁符為0x0c換行0x0a。因此，如果需要換頁打印，該換頁控制命令串為0xFE+0x01+0x14；該串可以置于打印對象的

9、數(shù)據(jù)單元或表格單元之前（如0xFE+0x01+0x14+TRANFLD或FORM），也可以置于FORM數(shù)據(jù)中某一條記錄之前（如FORM的第n-1條記錄+0xFE+0x01+0x14+FORM的第n條記錄），其它地方一概予以忽略。3. 輸入信息格式輸入輸出是相對后臺主機而言的。輸入信息是指客戶端發(fā)向后臺主機的信息。輸入信息包由系統(tǒng)信息頭、交易公共頭、交易數(shù)據(jù)頭、業(yè)務數(shù)據(jù)組成。其中系統(tǒng)信息頭、交易公共頭和交易數(shù)據(jù)頭采用結構化的數(shù)據(jù)格式；業(yè)務數(shù)據(jù)采用長度加字符串的傳輸方式，在本系統(tǒng)中，除二進制數(shù)據(jù)外，其他數(shù)據(jù)都轉換成字符串類型進行傳輸。輸入信息包的格式如下：公共信息交易數(shù)據(jù)1交易數(shù)據(jù)2。系統(tǒng)信息頭交

10、易公共頭交易數(shù)據(jù)頭數(shù)據(jù)單元數(shù)據(jù)單元表格單元。交易數(shù)據(jù)頭數(shù)據(jù)單元數(shù)據(jù)單元。輸入信息格式中不允許存在對象單元和控制命令碼，業(yè)務數(shù)據(jù)由數(shù)據(jù)單元和表格單元組成。數(shù)據(jù)單元和表格單元的傳輸格式見單元定義。下面將介紹系統(tǒng)信息頭、交易公共頭、交易數(shù)據(jù)頭三個部分的數(shù)據(jù)格式。3.1 系統(tǒng)信息頭系統(tǒng)信息頭的格式如下：（55bytes） 報文頭總長140B 數(shù)據(jù)包長度 （SHJBCD）unsigned short 2B/轉換成網絡格式報文MAC(BAWMAC)char(16)MAC機構號MACJGH char(4) /表示報文中MAC的對方機構號PIN種子PINZHZ char(16) /表示報文中PIN的種子(隨機

11、數(shù)參與加密)目標地址 (YNDIZH)unsigned char(4) /二進制方式存儲源地址 (MBIODZ)unsigned char(4) /二進制方式存儲系統(tǒng)保留位 (BOLIUW)unsigned char(1) /二進制方式存儲信息結束標志(XXJSBZ)unsigned char(1) /二進制方式存儲報文序號(SJBSXH)unsigned short 2B /轉換成網絡格式校驗標志 (JIOYBZ)unsigned char(1) /二進制方式存儲密鑰版本號 (MIYBBH)integer 4B字段說明信息長度：表示整個數(shù)據(jù)包的長度，包括本數(shù)據(jù)項所占用的字節(jié)數(shù)。目標地址：目標

12、服務器的地址，以代碼表示，包含目標服務器，服務端口等信息。具體表示方法見附錄。源地址：交易發(fā)起端地址，以代碼表示，包含源設備，服務端口等信息。具體表示方法見附錄。系統(tǒng)保留位：暫不使用。默認設置為信息結束標志：為適應多包數(shù)據(jù)通訊保留，默認設置為報文序號：為了防止報文惡意重發(fā)設置，暫不使用，默認值為校驗標志：是否需要MAC或其它校驗, 暫不使用;報文MAC：校驗算法生成的數(shù)據(jù)項3.2 交易公共頭公共交易頭格式如下：(21bytes)終端號ZHNGDHchar(5)String/字符串方式存儲城市代碼CHSHDMchar(4)String機構代碼YNGYJGchar(4)String交易柜員JIO1

13、GYchar(8)String字段說明終端號：交易發(fā)起端終端號，省略TTY，如21a表示終端tty21a。城市代碼：暫不使用，設置為空格機構代碼：銀行機構代碼。交易柜員：交易柜員代碼。3.3 交易數(shù)據(jù)頭交易數(shù)據(jù)頭格式如下：( 64bytes)交易代碼JIAOYMchar(4)/String交易子碼JIOYZMchar(2)/String交易模式JIOYMSchar(1)/String交易序號JIOYXHint4B/int (pjyjk: N 4)本交易包長度COMMLNunsigned short2B(pjyjk:n 2)/系統(tǒng)偏移1PNYIL1unsigned short2B /0xFFFF

14、為無效系統(tǒng)偏移2PNYIL2unsigned short2B /0xFFFF為無效前臺流水號QANTLSchar(12)前臺日期QANTRQchar(8)授權柜員SHOQGYchar(8)/String授權密碼SHOQMMchar(16)/String授權柜員有無卡標志YWKABZchar(1)授權柜員卡序號CZYNXHchar(2)字段說明交易子碼：判斷某個復合交易中的子交易碼交易序號：主要為組合交易使用，是前臺帶到后臺的組合交易序號。系統(tǒng)偏移：記錄加密字段的偏移位置授權柜員有無卡標志：0-無卡1-有卡；4. 輸出信息格式輸出信息是指后臺交易完成后返回給前臺的通訊數(shù)據(jù)，由系統(tǒng)信息頭、交易公共

15、頭、返回業(yè)務數(shù)據(jù)組成。輸出信息包的格式如下：公共信息業(yè)務數(shù)據(jù)系統(tǒng)信息頭交易公共頭對象1對象2。對象n4.1 系統(tǒng)信息頭系統(tǒng)信息頭同輸入信息格式。4.2 交易公共頭交易公共頭的數(shù)據(jù)格式如下：(41bytes)交易代碼JIAOYM unsigned char(4)聯(lián)動交易碼LDJYDM unsigned char(4) /*-前臺讀取前臺再聯(lián)動-*/交易日期JIOYRQchar(8)交易時間JIOYSJint4B (PJYJK : L 4) 柜員流水號GUIYLSchar(12)出錯交易序號CWJYXHshort2B錯誤代號PTCWDHchar(7) /成功返回AAAAAAA，其他返回錯誤代碼字段

16、描述交易代碼：輸入數(shù)據(jù)中的第一個交易代碼。柜員流水號：財務交易產生，包含四位柜員號及六位順序號信息。出錯交易序號：出錯交易的交易序號，是由前臺生成并傳輸?shù)胶笈_的。交易狀態(tài)：前三位為錯誤類型，后4位為錯誤代碼。見附錄錯誤代碼分類表。4.3 業(yè)務數(shù)據(jù)部分對于業(yè)務數(shù)據(jù)部分，采用對象傳輸方式，不允許直接傳輸單獨的數(shù)據(jù)單元或表格單元。4.3.1 錯誤信息對象在錯誤情況下，此處為錯誤描述對象，其格式如下例：錯誤信息對象名錯誤信息0X6“ERRMSG”0X02-1 0x “此帳號不存在”4.3.2 正常交易對象交易狀態(tài)正常情況下，數(shù)據(jù)格式如下：業(yè)務數(shù)據(jù)對象對象。對象N5. 附錄：5.1 打印模式定義打印模式

17、字符代碼含義0（默認）S4c1宋體，正常字，15CPI，6LPI1S4c1宋體，正常字，15CPI，6LPI2S4C1宋體，正常字，10CPI，6LPI3S4c2宋體，正常字，15CPI，8LPI4S4C2宋體，正常字，10CPI，8LPI5S4c3宋體，正常字，15CPI，10LPI6S4C3宋體，正常字，10CPI，10LPI7S4c4宋體，正常字，15CPI，12LPI8S4C4宋體，正常字，10CPI，12LPI9S4c5宋體，正常字，15CPI，4LPI10S4C5宋體，正常字，10CPI，4LPI11S3c1宋體，倍高字，15CPI，6LPI12S3C1宋體，倍高字，10CPI，6

18、LPI13S3c2宋體，倍高字，15CPI，8LPI14S3C2宋體，倍高字，10CPI，8LPI15S3c3宋體，倍高字，15CPI，10LPI16S3C3宋體，倍高字，10CPI，10LPI17S3c4宋體，倍高字，15CPI，12LPI18S3C4宋體，倍高字，10CPI，12LPI19S3c5宋體，倍高字，15CPI，4LPI20S3C5宋體，倍高字，10CPI，4LPI21S2c1宋體，倍寬字，15CPI，6LPI22S2C1宋體，倍寬字，10CPI，6LPI23S2c2宋體，倍寬字，15CPI，8LPI24S2C2宋體，倍寬字，10CPI，8LPI25S2c3宋體，倍寬字，15CPI，10LPI26S2C3宋體，倍寬字，10CPI，10LPI27S2c4宋體，倍寬字，15CPI，12LPI28S2C4宋體，倍寬字，10CPI，12LPI29S2c5宋體，倍寬字