珠海社保系統(tǒng)POS功能接口doc-珠海市人力資源和社會保.doc

珠海社保系統(tǒng)珠海社保系統(tǒng) 醫(yī)院醫(yī)院 POS 功能接口功能接口 修訂記錄 版本時間修訂人修訂內(nèi)容 目 錄 1 系統(tǒng)目標(biāo)系統(tǒng)目標(biāo) 2 1 1 背景情況 2 1 2 系統(tǒng)目標(biāo) 2 1 2 1 功能目標(biāo) 2 1 2 2 性能目標(biāo) 2 2 系統(tǒng)結(jié)構(gòu)系統(tǒng)結(jié)構(gòu) 2 2 1 概述 2 2 2 網(wǎng)絡(luò)結(jié)構(gòu) 3 2 3 系統(tǒng)劃分 3 2 3 1 PC端動態(tài)鏈接庫 3 2 3 2 POS端演示程序 3 3 數(shù)據(jù)鏈路層和傳輸層通訊協(xié)議數(shù)據(jù)鏈路層和傳輸層通訊協(xié)議 3 3 1 數(shù)據(jù)鏈路層協(xié)議 3 3 2 傳輸層協(xié)議 3 4 交易描述交易描述 5 4 1 脫機(jī)消費(fèi) 5 4 1 1 交易流程 5 4 1 2 數(shù)據(jù)流程 6 4 1 3 應(yīng)用層數(shù)據(jù)包 6 4 2 黑名單管理 暫未啟用 9 4 2 1 數(shù)據(jù)流程 9 4 2 2 應(yīng)用層數(shù)據(jù)包 10 1 系統(tǒng)目標(biāo)系統(tǒng)目標(biāo) 1 1 背景情況背景情況 珠海市社會保障卡系統(tǒng)建設(shè)目標(biāo)為五保合一 并作為廣東省社保系統(tǒng)的試點(diǎn)系統(tǒng) 個人醫(yī)療保障賬戶要求?？顚Ｓ?個人醫(yī)療保障賬戶和社會保障卡上的醫(yī)療保障電子 錢包上的金額專用于支付指定的醫(yī)療和購藥費(fèi)用 目前 交易中心的結(jié)構(gòu)未定 單中心或無中心 本子系統(tǒng)要求充分考慮了兩種中心的 情況 1 2 系統(tǒng)目標(biāo)系統(tǒng)目標(biāo) 本子系統(tǒng)要求采用珠海社保指定的 IC 卡 PSAM 卡 在 P70 S POS 終端上完成脫機(jī)消 費(fèi)以及與醫(yī)院收費(fèi) PC 之間的數(shù)據(jù)交換 向珠海社保局及相關(guān)部門證明系統(tǒng)結(jié)構(gòu)的可行性 和設(shè)備的可用性 同時 要求本子系統(tǒng)在結(jié)構(gòu)上允許采用不同的 IC 卡交易終端設(shè)備 包括 POS 終端和 IC 卡讀卡器 無論采用何種終端設(shè)備 通訊接口不變 1 2 1 功能目標(biāo)功能目標(biāo) 實(shí)現(xiàn)社?？ǖ拿摍C(jī)消費(fèi) 實(shí)現(xiàn)黑名單管理 實(shí)現(xiàn)與 PC 之間的串口通訊 預(yù)留圈存交易接口 但本次不要求實(shí)現(xiàn) 1 2 2 性能目標(biāo)性能目標(biāo) 不計入用戶輸入密碼的時間 脫機(jī)消費(fèi)交易在 3 秒內(nèi)完成 終端至少有 160k 字節(jié)的存儲空間 可用于存儲約 20000 條黑名單 該存儲空間要求掉 電保持 終端至少有 100k 字節(jié)的存儲空間 可用于存儲約 2000 條交易明細(xì) 該存儲空間要求 掉電保持 2 系統(tǒng)結(jié)構(gòu)系統(tǒng)結(jié)構(gòu) 2 1 概述概述 POS 終端與 PC 通過 RS232 串口連接 每次消費(fèi)交易由 PC 觸發(fā) POS 終端取得 PC 給 出的交易金額和其他有關(guān)信息后 完成脫機(jī)消費(fèi)交易 并將交易結(jié)果和批上送時需要的數(shù) 據(jù)回傳給 PC POS 上應(yīng)同時保留交易信息 根據(jù) PC 的通知清除 黑名單更新時 由 PC 發(fā)送黑名單更新通知給 POS POS 發(fā)出更新請求 逐批從 PC 取得黑名單信息 直至完成 黑名單更新要求在 5 分鐘內(nèi)完成 不需要支持?jǐn)帱c(diǎn)續(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 端程序 2 3 1 PC 端程序端程序 使用 Power Builder 編寫 2 3 2 PC 端動態(tài)鏈接庫端動態(tài)鏈接庫 C 語言編寫 由 Power Builder 程序動態(tài)調(diào)用 可運(yùn)行平臺包括 Windows 95 98 NT 2000 XP 2 3 3 POS 端程序端程序 C 語言編寫 在 P70 S 上運(yùn)行 3 數(shù)據(jù)鏈路層和傳輸層通訊協(xié)議數(shù)據(jù)鏈路層和傳輸層通訊協(xié)議 3 1 數(shù)據(jù)鏈路層協(xié)議數(shù)據(jù)鏈路層協(xié)議 通過 RS232 串口傳輸數(shù)據(jù) 缺省參數(shù) 9600Bps 8 位數(shù)據(jù)位 1 位停止位 無校驗(yàn)位 3 2 傳輸層協(xié)議傳輸層協(xié)議 數(shù)據(jù)包以 STX 0 x02 起始 后跟 2 字節(jié) BCD 碼長度 序號和實(shí)際傳輸內(nèi)容的長度 1 字節(jié) seq 標(biāo)示信息包序號 中間為實(shí)際傳輸內(nèi)容 以 ETX 0 x03 結(jié)束 最后為 1 字節(jié)的 LRC 校驗(yàn) 實(shí)際傳輸內(nèi)容要求為 ASCII 可見字符 0 9 a z A Z 形式的信息 如下 STX 1 字 節(jié) 長度 2 字節(jié) BCD 碼 高位在前 Seq 1 字 節(jié) 實(shí)際傳輸內(nèi)容 可變長 最大 不超過 1000 字節(jié) ETX 1 字節(jié) LRC 1 字節(jié) 從長 度開始至 ETX 字符間超時時間為 0 5 秒 Seq 的有效值為 0 9 通訊雙方必須維護(hù)自己的 Seq 每一新的數(shù)據(jù)包 Seq 值循環(huán) PCPOS RS232LAN DLL 動態(tài)調(diào)用 遞增 連續(xù)兩個數(shù)據(jù)包 若 seq 相同 則視為重發(fā)的數(shù)據(jù)包 接收方收到發(fā)送方的數(shù)據(jù)包后 LRC 校驗(yàn)成功的 發(fā)送一字節(jié) ACK 0 x06 字符表示確 認(rèn) 否則發(fā)送 NAK 0 x15 表示數(shù)據(jù)包出錯 接收超時的 也發(fā)送 NAK 如果收到 Seq 值重復(fù)的數(shù)據(jù)包 也發(fā) ACK 予以確認(rèn) 發(fā)送方收到接收方的 NAK 或是發(fā)送數(shù)據(jù)包 3 秒后未收到 ACK 視為本次發(fā)送失敗 進(jìn)行重發(fā) 重發(fā)最多進(jìn)行兩次 三次發(fā)送均未成功的 放棄發(fā)送 向應(yīng)用層報告失敗 4 交易描述交易描述 4 1 脫機(jī)消費(fèi)脫機(jī)消費(fèi) 4 1 1 交易流程交易流程 接收PC信息 啟動脫機(jī) 消費(fèi)交易 獲取用戶密碼 提示插卡并檢測 驗(yàn)證IC卡合法性 檢查 黑名單 讀取卡片余額 進(jìn)行扣費(fèi) 消費(fèi)金額大于卡片 余額 屏幕提示 交易成功 發(fā)送交易結(jié)果和有關(guān)數(shù) 據(jù)給PC 結(jié)束 在POS上保存交易記錄 開始 屏幕提示 余額不足 請先圈存 N Y 4 1 2 數(shù)據(jù)流程數(shù)據(jù)流程 POS PC 1 脫機(jī)消費(fèi)請求 2 脫機(jī)消費(fèi)結(jié)響應(yīng) 4 1 3 應(yīng)用層數(shù)據(jù)包應(yīng)用層數(shù)據(jù)包 脫機(jī)交易請求包脫機(jī)交易請求包 1 查詢卡基本信息 查詢卡基本信息 為空 傳入的長度參數(shù)為 0 脫機(jī)交易響格式 查詢卡基本信息 脫機(jī)交易響格式 查詢卡基本信息 交易類型 1 字 節(jié) 查詢?yōu)?0 x31 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碼為壓縮的十進(jìn)制數(shù) 碼為壓縮的十進(jìn)制數(shù) HEX為為16進(jìn)制數(shù) 為不可壓縮數(shù)值進(jìn)制數(shù) 為不可壓縮數(shù)值 卡的識別碼16 字節(jié)32 位壓縮 BCD 碼 卡類別 1 字節(jié) 規(guī)范版本 4 字節(jié)HEX 碼 初始化機(jī)構(gòu)編號12 字節(jié)24 位壓縮 BCD 碼 發(fā)卡日期 4 字節(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 id 0 x10 unsigned char card type 0 x01 unsigned char criterion 0 x04 unsigned char initorgan 0 x0c unsigned char issuer dt 0 x04 unsigned char expire 0 x04 unsigned char cardno 0 x09 unsigned char personid 0 x12 unsigned char name 0 x1e unsigned char sex 0 x01 unsigned char nation 0 x01 unsigned char homeplace 0 x03 unsigned char birthday 0 x04 T MEDICARDINFO 脫機(jī)交易請求包脫機(jī)交易請求包 1 查詢 查詢 為空 傳入的長度參數(shù)為 0 脫機(jī)交易響格式 查詢 脫機(jī)交易響格式 查詢 交易類型 1 字 節(jié) 查詢?yōu)?0 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碼為壓縮的十進(jìn)制數(shù) 碼為壓縮的十進(jìn)制數(shù) HEX為為16進(jìn)制數(shù) 為不可壓縮數(shù)值進(jìn)制數(shù) 為不可壓縮數(shù)值 卡的識別碼16 字節(jié)32 位壓縮 BCD 碼 卡類別 1 字節(jié) 規(guī)范版本 4 字節(jié)HEX 碼 初始化機(jī)構(gòu)編號12 字節(jié)24 位壓縮 BCD 碼 發(fā)卡日期 4 字節(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 碼 定點(diǎn)醫(yī)療機(jī)構(gòu)名稱 1 62 字節(jié)字符 定點(diǎn)醫(yī)療機(jī)構(gòu)名稱擴(kuò)展 1 8 字節(jié)字符 定點(diǎn)醫(yī)療機(jī)構(gòu)代碼 1 9 字節(jié)字符 定點(diǎn)醫(yī)療機(jī)構(gòu)名稱 2 62 字節(jié)字符 定點(diǎn)醫(yī)療機(jī)構(gòu)名稱擴(kuò)展 28 字節(jié)字符 定點(diǎn)醫(yī)療機(jī)構(gòu)代碼 2 9 字節(jié)字符 定點(diǎn)醫(yī)療機(jī)構(gòu)名稱 3 62 字節(jié)字符 定點(diǎn)醫(yī)療機(jī)構(gòu)名稱擴(kuò)展 3 8 字節(jié)字符 定點(diǎn)醫(yī)療機(jī)構(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 id 0 x10 unsigned char card type 0 x01 unsigned char criterion 0 x04 unsigned char initorgan 0 x0c unsigned char issuer dt 0 x04 unsigned char expire 0 x04 unsigned char cardno 0 x09 unsigned char personid 0 x12 unsigned char name 0 x1e unsigned char sex 0 x01 unsigned char nation 0 x01 unsigned char homeplace 0 x03 unsigned char birthday 0 x04 unsigned char accreatedt 0 x04 unsigned char hospitalname1 0 x3e unsigned char hospitalnameext1 0 x08 unsigned char hospitalcode1 0 x09 unsigned char hospitalname2 0 x3e unsigned char hospitalnameext2 0 x08 unsigned char hospitalcode2 0 x09 unsigned char hospitalname3 0 x3e unsigned char hospitalnameext3 0 x08 unsigned char hospitalcode3 0 x09 unsigned char medicerti 0 x0f unsigned char mediaccount 0 x0a unsigned char meditype 0 x01 unsigned char usecardtype 0 x01 unsigned char balance0 0 x04 unsigned char balance1 0 x04 unsigned char balance2 0 x04 unsigned char bankid 0 x08 unsigned char latestchktime 0 x04 unsigned char diverfactor 0 x08 unsigned char blacklistver 0 x13 T MEDICARDINFO 脫機(jī)交易請求脫機(jī)交易請求 2 消費(fèi) 消費(fèi) 金額 12 位數(shù)值 壓 縮成 6 字節(jié) BCD 碼 不足時前補(bǔ) 0 商戶名稱 16 字節(jié) 即最多 8 個中文字 不足填空格 商戶操作人員 姓名 8 字節(jié) 即最多 4 個中 文字 不足填 空格 PC 編號 12 字節(jié) ASCII 不足時 后補(bǔ)二進(jìn)制 0 PC 交易序號 12 字節(jié) ASCII 不足時 后補(bǔ)二進(jìn)制 0 脫機(jī)交易響應(yīng)脫機(jī)交易響應(yīng) 2 消費(fèi) 消費(fèi) 交易類型 1 字節(jié) 消費(fèi)為 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 終端機(jī)編號 12 位數(shù)值 6 字節(jié) BCD 碼 PSAM 交易號 4 字節(jié) 高位在前的 HEX 碼 卡片的交易簽名 TAC 4 字節(jié)的 HEX 碼 卡片的脫機(jī)交易序號 2 字節(jié) 高位在前的 HEX 碼 卡片交易后余額4 字節(jié) 高位在前的 HEX 碼 注意 1 BCD 碼為壓縮的十進(jìn)制數(shù) HEX 為 16 進(jìn)制數(shù) 為不可壓縮數(shù)值 2 金額使用壓縮的 12 位 BCD 碼 參照 ISO8583 規(guī)范 3 所有數(shù)據(jù)使用規(guī)范參照現(xiàn)用的醫(yī)保卡標(biāo)準(zhǔn) 銀行清算需要這些數(shù)據(jù)進(jìn)行交易 有效性檢查 附上 C 結(jié)構(gòu) typedef struct 交易類型標(biāo)志 unsigned char transtype 交易金額 unsigned char transamount 6 交易日期時間 unsigned char transdatetime 7 終端機(jī)編號 unsigned char samid 6 PSAM 卡交易序號 unsigned char psamptc 4 用戶卡驗(yàn)證碼 unsigned char transtac 4 用戶卡交易序號 unsigned char transoffctc 2 用戶卡余額 unsigned char nowbalance 4 T SENDTRANS 脫機(jī)清算請求脫機(jī)清算請求 為空 傳入的長度參數(shù)為 0 脫機(jī)清算響應(yīng)脫機(jī)清算響應(yīng) 交易類型 1 字 節(jié) 為 0 x34 1 字節(jié) 交易結(jié) 果標(biāo)志 交易數(shù)據(jù) 交易成功 12 定長字節(jié) 內(nèi)容見下 交易失敗時 為中文提示信息 交易結(jié)果標(biāo)志 交易結(jié)果標(biāo)志 1