珠海社保系統(tǒng)

1、珠海社保系統(tǒng)珠海社保系統(tǒng)醫(yī)院醫(yī)院 POS 功能接口功能接口修訂記錄：版本時間修訂人修訂內(nèi)容目 錄1 系統(tǒng)目標(biāo)系統(tǒng)目標(biāo).21.1 背景情況.21.2 系統(tǒng)目標(biāo).2功能目標(biāo).2性能目標(biāo).22 系統(tǒng)結(jié)構(gòu)系統(tǒng)結(jié)構(gòu).22.1 概述.22.2 網(wǎng)絡(luò)結(jié)構(gòu).32.3 系統(tǒng)劃分.3端動態(tài)鏈接庫.3端演示程序.33 數(shù)據(jù)鏈路層和傳輸層通訊協(xié)議數(shù)據(jù)鏈路層和傳輸層通訊協(xié)議.33.1 數(shù)據(jù)鏈路層協(xié)議.33.2 傳輸層協(xié)議.34 交易描述交易描述.54.1 脫機消費.5交易流程.5數(shù)據(jù)流程.6應(yīng)用層數(shù)據(jù)包.64.2 黑名單管理（暫未啟用）.9數(shù)據(jù)流程.9應(yīng)用層數(shù)據(jù)包.101 系統(tǒng)目標(biāo)系統(tǒng)目標(biāo)1.1 背景情況背景情況珠海市

2、社會保障卡系統(tǒng)建設(shè)目標(biāo)為五保合一，并作為廣東省社保系統(tǒng)的試點系統(tǒng)。個人醫(yī)療保障賬戶要求專款專用，個人醫(yī)療保障賬戶和社會保障卡上的醫(yī)療保障電子錢包上的金額專用于支付指定的醫(yī)療和購藥費用。目前，交易中心的結(jié)構(gòu)未定（單中心或無中心） ，本子系統(tǒng)要求充分考慮了兩種中心的情況。1.2 系統(tǒng)目標(biāo)系統(tǒng)目標(biāo)本子系統(tǒng)要求采用珠海社保指定的 IC 卡、PSAM 卡，在 P70-S POS 終端上完成脫機消費以及與醫(yī)院收費 PC 之間的數(shù)據(jù)交換，向珠海社保局及相關(guān)部門證明系統(tǒng)結(jié)構(gòu)的可行性和設(shè)備的可用性。同時，要求本子系統(tǒng)在結(jié)構(gòu)上允許采用不同的 IC 卡交易終端設(shè)備（包括 POS 終端和IC 卡讀卡器） ，無論采用何

3、種終端設(shè)備，通訊接口不變。實現(xiàn)社保卡的脫機消費實現(xiàn)黑名單管理實現(xiàn)與 PC 之間的串口通訊預(yù)留圈存交易接口，但本次不要求實現(xiàn)不計入用戶輸入密碼的時間，脫機消費交易在 3 秒內(nèi)完成終端至少有 160k 字節(jié)的存儲空間，可用于存儲約 20000 條黑名單，該存儲空間要求掉電保持終端至少有 100k 字節(jié)的存儲空間，可用于存儲約 2000 條交易明細，該存儲空間要求掉電保持2 系統(tǒng)結(jié)構(gòu)系統(tǒng)結(jié)構(gòu)2.1 概述概述POS 終端與 PC 通過 RS232 串口連接，每次消費交易由 PC 觸發(fā)，POS 終端取得 PC 給出的交易金額和其他有關(guān)信息后，完成脫機消費交易，并將交易結(jié)果和批上送時需要的數(shù)據(jù)回傳給 PC

4、。POS 上應(yīng)同時保留交易信息，根據(jù) PC 的通知清除。黑名單更新時，由 PC 發(fā)送黑名單更新通知給 POS，POS 發(fā)出更新請求，逐批從 PC取得黑名單信息，直至完成，黑名單更新要求在 5 分鐘內(nèi)完成，不需要支持斷點續(xù)傳。2.2 網(wǎng)絡(luò)結(jié)構(gòu)網(wǎng)絡(luò)結(jié)構(gòu)2.3 系統(tǒng)劃分系統(tǒng)劃分本演示子系統(tǒng)軟件分為三個部分：PC 端程序PC 端動態(tài)鏈接庫POS 端程序端程序端程序使用 Power Builder 編寫。C 語言編寫，由 Power Builder 程序動態(tài)調(diào)用，可運行平臺包括：Windows 95 / 98 / NT / 2000 / XP。C 語言編寫，在 P70-S 上運行。3 數(shù)據(jù)鏈路層和傳輸層

5、通訊協(xié)議數(shù)據(jù)鏈路層和傳輸層通訊協(xié)議3.1 數(shù)據(jù)鏈路層協(xié)議數(shù)據(jù)鏈路層協(xié)議通過 RS232 串口傳輸數(shù)據(jù)。缺省參數(shù)：9600Bps，8 位數(shù)據(jù)位，1 位停止位，無校驗位。3.2 傳輸層協(xié)議傳輸層協(xié)議數(shù)據(jù)包以 STX(0 x02)起始，后跟 2 字節(jié) BCD 碼長度（序號和實際傳輸內(nèi)容的長度） ，1 字節(jié) seq 標(biāo)示信息包序號，中間為實際傳輸內(nèi)容，以 ETX(0 x03)結(jié)束，最后為 1 字節(jié)的LRC 校驗。實際傳輸內(nèi)容要求為 ASCII 可見字符(0-9, a-z, A-Z)形式的信息。如下：STX（1 字節(jié)）長度（2 字節(jié)，BCD碼，高位在前）Seq（1 字節(jié)）實際傳輸內(nèi)容（可變長，最大不超過

6、 1000 字節(jié)）ETX（1 字節(jié)）LRC(1 字節(jié)，從長度開始至 ETX)字符間超時時間為 0.5 秒。Seq 的有效值為0 9，通訊雙方必須維護自己的 Seq, 每一新的數(shù)據(jù)包，Seq 值循環(huán)PCPOSRS232LANDLL動態(tài)調(diào)用遞增。連續(xù)兩個數(shù)據(jù)包，若 seq 相同，則視為重發(fā)的數(shù)據(jù)包。接收方收到發(fā)送方的數(shù)據(jù)包后，LRC 校驗成功的，發(fā)送一字節(jié) ACK(0 x06)字符表示確認，否則發(fā)送 NAK（0 x15）表示數(shù)據(jù)包出錯。接收超時的，也發(fā)送 NAK。如果收到 Seq值重復(fù)的數(shù)據(jù)包，也發(fā) ACK 予以確認。發(fā)送方收到接收方的 NAK 或是發(fā)送數(shù)據(jù)包 3 秒后未收到 ACK，視為本次發(fā)送

7、失敗，進行重發(fā)，重發(fā)最多進行兩次。三次發(fā)送均未成功的，放棄發(fā)送，向應(yīng)用層報告失敗。4 交易描述交易描述4.1 脫機消費脫機消費接收PC信息，啟動脫機消費交易獲取用戶密碼提示插卡并檢測驗證IC卡合法性,檢查黑名單讀取卡片余額進行扣費消費金額大于卡片余額？屏幕提示：交易成功發(fā)送交易結(jié)果和有關(guān)數(shù)據(jù)給PC結(jié)束在POS上保存交易記錄開始屏幕提示：余額不足，請先圈存NYPOSPC(1)脫機消費請求(2)脫機消費結(jié)響應(yīng)脫機交易請求包脫機交易請求包 1（查詢卡基本信息）（查詢卡基本信息）為空，傳入的長度參數(shù)為 0脫機交易響格式（查詢卡基本信息）脫機交易響格式（查詢卡基本信息）交易類型（1 字節(jié)，查詢?yōu)? x3

8、1）(1 字節(jié)，交易結(jié)果標(biāo)志交易數(shù)據(jù)（交易成功 426 定長字節(jié)，內(nèi)容見下，交易失敗時，為中文提示信息）交易結(jié)果標(biāo)志：交易結(jié)果標(biāo)志：1 字節(jié)，0 x00-成功，后面跟的是 107 個字節(jié)的交易數(shù)據(jù) 其他值 交易失敗，后面以中文字符方式應(yīng)答了失敗原因，不需要處理其響應(yīng)碼交易數(shù)據(jù)：交易數(shù)據(jù)：107 字節(jié)的交易數(shù)據(jù)（為了不更改以后接口用）注：注：BCD碼為壓縮的十進制數(shù)，碼為壓縮的十進制數(shù)，HEX為為16進制數(shù)，為不可壓縮數(shù)值進制數(shù)，為不可壓縮數(shù)值?？ǖ淖R別碼16 字節(jié)32 位壓縮 BCD 碼卡類別 1 字節(jié)規(guī)范版本 4 字節(jié)HEX 碼初始化機構(gòu)編號12 字節(jié)24 位壓縮 BCD 碼發(fā)卡日期 4 字

9、節(jié)8 位壓縮 BCD 碼失效日期 4 字節(jié)8 位壓縮 BCD 碼卡號 9 字節(jié)字符公民身份證號碼 18 字節(jié)字符姓名 30 字節(jié)字符性別 1 字節(jié)字符民族 1 字節(jié)2 位壓縮 BCD 碼出生地 3 字節(jié)6 位壓縮 BCD 碼出生日期 4 字節(jié)8 位壓縮 BCD 碼 附上 C 語言結(jié)構(gòu)typedef struct unsigned char card_id0 x10;unsigned char card_type0 x01;unsigned char criterion0 x04;unsigned char initorgan0 x0c;unsigned char issuer_dt0 x04;

10、unsigned char expire0 x04;unsigned char cardno0 x09;unsigned char personid0 x12;unsigned char name0 x1e;unsigned char sex0 x01;unsigned char nation0 x01;unsigned char homeplace0 x03;unsigned char birthday0 x04; T_MEDICARDINFO;脫機交易請求包脫機交易請求包 1（查詢）（查詢）為空，傳入的長度參數(shù)為 0脫機交易響格式（查詢）脫機交易響格式（查詢）交易類型（1 字節(jié)，查詢?yōu)?

11、x31）(1 字節(jié)，交易結(jié)果標(biāo)志交易數(shù)據(jù)（交易成功 426 定長字節(jié)，內(nèi)容見下，交易失敗時，為中文提示信息）交易結(jié)果標(biāo)志：交易結(jié)果標(biāo)志：1 字節(jié)，0 x00-成功，后面跟的是 426 個字節(jié)的交易數(shù)據(jù) 其他值 交易失敗，后面以中文字符方式應(yīng)答了失敗原因，不需要處理其響應(yīng)碼交易數(shù)據(jù)：交易數(shù)據(jù)：426 字節(jié)的交易數(shù)據(jù)（為了不更改以后接口用）注：注：BCD碼為壓縮的十進制數(shù)，碼為壓縮的十進制數(shù)，HEX為為16進制數(shù)，為不可壓縮數(shù)值進制數(shù)，為不可壓縮數(shù)值?？ǖ淖R別碼16 字節(jié)32 位壓縮 BCD 碼卡類別 1 字節(jié)規(guī)范版本 4 字節(jié)HEX 碼初始化機構(gòu)編號12 字節(jié)24 位壓縮 BCD 碼發(fā)卡日期 4

12、 字節(jié)8 位壓縮 BCD 碼失效日期 4 字節(jié)8 位壓縮 BCD 碼卡號 9 字節(jié)字符公民身份證號碼 18 字節(jié)字符姓名 30 字節(jié)字符性別 1 字節(jié)字符民族 1 字節(jié)2 位壓縮 BCD 碼出生地 3 字節(jié)6 位壓縮 BCD 碼出生日期 4 字節(jié)8 位壓縮 BCD 碼基本醫(yī)療保險個人賬戶建立日期 4 字節(jié)8 位壓縮 BCD 碼定點醫(yī)療機構(gòu)名稱 1 62 字節(jié)字符定點醫(yī)療機構(gòu)名稱擴展 1 8 字節(jié)字符定點醫(yī)療機構(gòu)代碼 1 9 字節(jié)字符定點醫(yī)療機構(gòu)名稱 2 62 字節(jié)字符定點醫(yī)療機構(gòu)名稱擴展 28 字節(jié)字符定點醫(yī)療機構(gòu)代碼 2 9 字節(jié)字符定點醫(yī)療機構(gòu)名稱 3 62 字節(jié)字符定點醫(yī)療機構(gòu)名稱擴展

13、3 8 字節(jié)字符定點醫(yī)療機構(gòu)代碼 3 9 字節(jié)字符醫(yī)療證號 15 字節(jié)字符基本醫(yī)療保險個人賬戶 10 字節(jié)字符醫(yī)療人員類別 1 字節(jié)醫(yī)療保險用卡方式 1 字節(jié)基本醫(yī)療保險個人賬戶余額 4 字節(jié)高位在前的 HEX 碼年度個人自付累計金額4 字節(jié)高位在前的 HEX 碼年度統(tǒng)籌基金支付累計金額4 字節(jié)高位在前的 HEX 碼發(fā)卡行 ID 8 字節(jié) 16 位 BCD 碼（轉(zhuǎn)換后取左三位上傳）最近審核日期 4 字節(jié) 8 位壓縮 BCD 碼分散因子 8 字節(jié) HEX 碼黑名單版本號 19 字節(jié) 附上 C 語言結(jié)構(gòu)typedef struct unsigned char card_id0 x10;unsign

14、ed char card_type0 x01;unsigned char criterion0 x04;unsigned char initorgan0 x0c;unsigned char issuer_dt0 x04;unsigned char expire0 x04;unsigned char cardno0 x09;unsigned char personid0 x12;unsigned char name0 x1e;unsigned char sex0 x01;unsigned char nation0 x01;unsigned char homeplace0 x03;unsigned

15、 char birthday0 x04;unsigned char accreatedt 0 x04;unsigned char hospitalname10 x3e;unsigned char hospitalnameext10 x08;unsigned char hospitalcode10 x09;unsigned char hospitalname20 x3e;unsigned char hospitalnameext20 x08;unsigned char hospitalcode20 x09;unsigned char hospitalname30 x3e;unsigned cha

16、r hospitalnameext30 x08;unsigned char hospitalcode30 x09;unsigned char medicerti0 x0f;unsigned char mediaccount0 x0a;unsigned char meditype0 x01;unsigned char usecardtype0 x01;unsigned char balance00 x04;unsigned char balance10 x04;unsigned char balance20 x04;unsigned char bankid 0 x08;unsigned char

17、 latestchktime 0 x04;unsigned char diverfactor 0 x08; unsigned char blacklistver 0 x13; T_MEDICARDINFO;脫機交易請求脫機交易請求 2（消費）（消費）金額（12 位數(shù)值，壓縮成 6 字節(jié) BCD碼，不足時前補0）商戶名稱（16字節(jié)，即最多8 個中文字，不足填空格）商戶操作人員姓名（8 字節(jié)，即最多 4 個中文字，不足填空格）PC 編號（12 字節(jié)ASCII, 不足時后補二進制 0）PC 交易序號（12 字節(jié)ASCII, 不足時后補二進制 0）脫機交易響應(yīng)脫機交易響應(yīng) 2（消費）（消費）交易類型（

18、1 字節(jié)，消費為 0 x32）0 x02（1 字節(jié)，交易結(jié)果標(biāo)志)交易數(shù)據(jù)（交易成功 34 定長字節(jié)，內(nèi)容見下，交易失敗時，為中文提示信息）交易結(jié)果標(biāo)志：交易結(jié)果標(biāo)志：1 字節(jié)，0 x00-成功，后面跟的是 34 個字節(jié)的交易數(shù)據(jù) 其他值 交易失敗，后面以中文字符方式應(yīng)答了失敗原因，不需要處理其響應(yīng)碼交易數(shù)據(jù)：交易數(shù)據(jù)：34 字節(jié)，僅在交易成功時需要，包括以下數(shù)據(jù)：交易類型標(biāo)志，1 字節(jié)，根據(jù)醫(yī)保卡規(guī)范交易金額 12 位數(shù)值 6 字節(jié) BCD 碼，高位前，單位為分交易日期， 8 位數(shù)值， 4 字節(jié) BCD 碼，CCYYMMDD交易時間， 6 位數(shù)值， 3 字節(jié) BCD 碼，HHMMSS終端機編

19、號， 12 位數(shù)值，6 字節(jié) BCD 碼PSAM 交易號， 4 字節(jié) 高位在前的 HEX 碼卡片的交易簽名 TAC 4 字節(jié)的 HEX 碼卡片的脫機交易序號 2 字節(jié) 高位在前的 HEX 碼卡片交易后余額4 字節(jié) 高位在前的 HEX 碼注意：1 BCD 碼為壓縮的十進制數(shù)，HEX 為 16 進制數(shù)，為不可壓縮數(shù)值。 2金額使用壓縮的 12 位 BCD 碼 參照 ISO8583 規(guī)范3所有數(shù)據(jù)使用規(guī)范參照現(xiàn)用的醫(yī)保卡標(biāo)準(zhǔn)，銀行清算需要這些數(shù)據(jù)進行交易有效性檢查附上 C 結(jié)構(gòu)typedef struct /*交易類型標(biāo)志 */unsigned char transtype;/*交易金額 */uns

20、igned char transamount6;/*交易日期時間 */unsigned char transdatetime7;/*終端機編號*/unsigned char samid6;/*PSAM 卡交易序號 */unsigned char psamptc4;/*用戶卡驗證碼 */unsigned char transtac4;/*用戶卡交易序號 */unsigned char transoffctc2;/*用戶卡余額 */unsigned char nowbalance4; T_SENDTRANS;脫機清算請求脫機清算請求為空，傳入的長度參數(shù)為 0脫機清算響應(yīng)脫機清算響應(yīng)交易類型（1 字節(jié)，為 0 x34）(1 字節(jié)，交易結(jié)果標(biāo)志交易數(shù)據(jù)（交易成功 12 定長字節(jié)，內(nèi)容見下，交易失敗時，為中文提示信息）