珠海社保系统POS功能接口doc-珠海市人力资源和社会保.doc

珠海社保系统珠海社保系统 医院医院 POS 功能接口功能接口 修订记录 版本时间修订人修订内容 目 录 1 系统目标系统目标 2 1 1 背景情况 2 1 2 系统目标 2 1 2 1 功能目标 2 1 2 2 性能目标 2 2 系统结构系统结构 2 2 1 概述 2 2 2 网络结构 3 2 3 系统划分 3 2 3 1 PC端动态链接库 3 2 3 2 POS端演示程序 3 3 数据链路层和传输层通讯协议数据链路层和传输层通讯协议 3 3 1 数据链路层协议 3 3 2 传输层协议 3 4 交易描述交易描述 5 4 1 脱机消费 5 4 1 1 交易流程 5 4 1 2 数据流程 6 4 1 3 应用层数据包 6 4 2 黑名单管理 暂未启用 9 4 2 1 数据流程 9 4 2 2 应用层数据包 10 1 系统目标系统目标 1 1 背景情况背景情况 珠海市社会保障卡系统建设目标为五保合一 并作为广东省社保系统的试点系统 个人医疗保障账户要求专款专用 个人医疗保障账户和社会保障卡上的医疗保障电子 钱包上的金额专用于支付指定的医疗和购药费用 目前 交易中心的结构未定 单中心或无中心 本子系统要求充分考虑了两种中心的 情况 1 2 系统目标系统目标 本子系统要求采用珠海社保指定的 IC 卡 PSAM 卡 在 P70 S POS 终端上完成脱机消 费以及与医院收费 PC 之间的数据交换 向珠海社保局及相关部门证明系统结构的可行性 和设备的可用性 同时 要求本子系统在结构上允许采用不同的 IC 卡交易终端设备 包括 POS 终端和 IC 卡读卡器 无论采用何种终端设备 通讯接口不变 1 2 1 功能目标功能目标 实现社保卡的脱机消费 实现黑名单管理 实现与 PC 之间的串口通讯 预留圈存交易接口 但本次不要求实现 1 2 2 性能目标性能目标 不计入用户输入密码的时间 脱机消费交易在 3 秒内完成 终端至少有 160k 字节的存储空间 可用于存储约 20000 条黑名单 该存储空间要求掉 电保持 终端至少有 100k 字节的存储空间 可用于存储约 2000 条交易明细 该存储空间要求 掉电保持 2 系统结构系统结构 2 1 概述概述 POS 终端与 PC 通过 RS232 串口连接 每次消费交易由 PC 触发 POS 终端取得 PC 给 出的交易金额和其他有关信息后 完成脱机消费交易 并将交易结果和批上送时需要的数 据回传给 PC POS 上应同时保留交易信息 根据 PC 的通知清除 黑名单更新时 由 PC 发送黑名单更新通知给 POS POS 发出更新请求 逐批从 PC 取得黑名单信息 直至完成 黑名单更新要求在 5 分钟内完成 不需要支持断点续传 2 2 网络结构网络结构 2 3 系统划分系统划分 本演示子系统软件分为三个部分 PC 端程序 PC 端动态链接库 POS 端程序 2 3 1 PC 端程序端程序 使用 Power Builder 编写 2 3 2 PC 端动态链接库端动态链接库 C 语言编写 由 Power Builder 程序动态调用 可运行平台包括 Windows 95 98 NT 2000 XP 2 3 3 POS 端程序端程序 C 语言编写 在 P70 S 上运行 3 数据链路层和传输层通讯协议数据链路层和传输层通讯协议 3 1 数据链路层协议数据链路层协议 通过 RS232 串口传输数据 缺省参数 9600Bps 8 位数据位 1 位停止位 无校验位 3 2 传输层协议传输层协议 数据包以 STX 0 x02 起始 后跟 2 字节 BCD 码长度 序号和实际传输内容的长度 1 字节 seq 标示信息包序号 中间为实际传输内容 以 ETX 0 x03 结束 最后为 1 字节的 LRC 校验 实际传输内容要求为 ASCII 可见字符 0 9 a z A Z 形式的信息 如下 STX 1 字 节 长度 2 字节 BCD 码 高位在前 Seq 1 字 节 实际传输内容 可变长 最大 不超过 1000 字节 ETX 1 字节 LRC 1 字节 从长 度开始至 ETX 字符间超时时间为 0 5 秒 Seq 的有效值为 0 9 通讯双方必须维护自己的 Seq 每一新的数据包 Seq 值循环 PCPOS RS232LAN DLL 动态调用 递增 连续两个数据包 若 seq 相同 则视为重发的数据包 接收方收到发送方的数据包后 LRC 校验成功的 发送一字节 ACK 0 x06 字符表示确 认 否则发送 NAK 0 x15 表示数据包出错 接收超时的 也发送 NAK 如果收到 Seq 值重复的数据包 也发 ACK 予以确认 发送方收到接收方的 NAK 或是发送数据包 3 秒后未收到 ACK 视为本次发送失败 进行重发 重发最多进行两次 三次发送均未成功的 放弃发送 向应用层报告失败 4 交易描述交易描述 4 1 脱机消费脱机消费 4 1 1 交易流程交易流程 接收PC信息 启动脱机 消费交易 获取用户密码 提示插卡并检测 验证IC卡合法性 检查 黑名单 读取卡片余额 进行扣费 消费金额大于卡片 余额 屏幕提示 交易成功 发送交易结果和有关数 据给PC 结束 在POS上保存交易记录 开始 屏幕提示 余额不足 请先圈存 N Y 4 1 2 数据流程数据流程 POS PC 1 脱机消费请求 2 脱机消费结响应 4 1 3 应用层数据包应用层数据包 脱机交易请求包脱机交易请求包 1 查询卡基本信息 查询卡基本信息 为空 传入的长度参数为 0 脱机交易响格式 查询卡基本信息 脱机交易响格式 查询卡基本信息 交易类型 1 字 节 查询为 0 x31 1 字节 交易结 果标志 交易数据 交易成功 426 定长字节 内容见下 交易失败时 为中文提示信息 交易结果标志 交易结果标志 1 字节 0 x00 成功 后面跟的是 107 个字节的交易数据 其他值 交易失败 后面以中文字符方式应答了失败原因 不需要处理其响应码 交易数据 交易数据 107 字节的交易数据 为了不更改以后接口用 注 注 BCD码为压缩的十进制数 码为压缩的十进制数 HEX为为16进制数 为不可压缩数值进制数 为不可压缩数值 卡的识别码16 字节32 位压缩 BCD 码 卡类别 1 字节 规范版本 4 字节HEX 码 初始化机构编号12 字节24 位压缩 BCD 码 发卡日期 4 字节8 位压缩 BCD 码 失效日期 4 字节8 位压缩 BCD 码 卡号 9 字节字符 公民身份证号码 18 字节字符 姓名 30 字节字符 性别 1 字节字符 民族 1 字节2 位压缩 BCD 码 出生地 3 字节6 位压缩 BCD 码 出生日期 4 字节8 位压缩 BCD 码 附上 C 语言结构 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 脱机交易请求包脱机交易请求包 1 查询 查询 为空 传入的长度参数为 0 脱机交易响格式 查询 脱机交易响格式 查询 交易类型 1 字 节 查询为 0 x31 1 字节 交易结 果标志 交易数据 交易成功 426 定长字节 内容见下 交易失败时 为中文提示信息 交易结果标志 交易结果标志 1 字节 0 x00 成功 后面跟的是 426 个字节的交易数据 其他值 交易失败 后面以中文字符方式应答了失败原因 不需要处理其响应码 交易数据 交易数据 426 字节的交易数据 为了不更改以后接口用 注 注 BCD码为压缩的十进制数 码为压缩的十进制数 HEX为为16进制数 为不可压缩数值进制数 为不可压缩数值 卡的识别码16 字节32 位压缩 BCD 码 卡类别 1 字节 规范版本 4 字节HEX 码 初始化机构编号12 字节24 位压缩 BCD 码 发卡日期 4 字节8 位压缩 BCD 码 失效日期 4 字节8 位压缩 BCD 码 卡号 9 字节字符 公民身份证号码 18 字节字符 姓名 30 字节字符 性别 1 字节字符 民族 1 字节2 位压缩 BCD 码 出生地 3 字节6 位压缩 BCD 码 出生日期 4 字节8 位压缩 BCD 码 基本医疗保险个人账户建立日期 4 字节8 位压缩 BCD 码 定点医疗机构名称 1 62 字节字符 定点医疗机构名称扩展 1 8 字节字符 定点医疗机构代码 1 9 字节字符 定点医疗机构名称 2 62 字节字符 定点医疗机构名称扩展 28 字节字符 定点医疗机构代码 2 9 字节字符 定点医疗机构名称 3 62 字节字符 定点医疗机构名称扩展 3 8 字节字符 定点医疗机构代码 3 9 字节字符 医疗证号 15 字节字符 基本医疗保险个人账户 10 字节字符 医疗人员类别 1 字节 医疗保险用卡方式 1 字节 基本医疗保险个人账户余额 4 字节高位在前的 HEX 码 年度个人自付累计金额4 字节高位在前的 HEX 码 年度统筹基金支付累计金额4 字节高位在前的 HEX 码 发卡行 ID 8 字节 16 位 BCD 码 转换后取左三位上 传 最近审核日期 4 字节 8 位压缩 BCD 码 分散因子 8 字节 HEX 码 黑名单版本号 19 字节 附上 C 语言结构 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 脱机交易请求脱机交易请求 2 消费 消费 金额 12 位数值 压 缩成 6 字节 BCD 码 不足时前补 0 商户名称 16 字节 即最多 8 个中文字 不足填空格 商户操作人员 姓名 8 字节 即最多 4 个中 文字 不足填 空格 PC 编号 12 字节 ASCII 不足时 后补二进制 0 PC 交易序号 12 字节 ASCII 不足时 后补二进制 0 脱机交易响应脱机交易响应 2 消费 消费 交易类型 1 字节 消费为 0 x32 0 x02 1 字节 交易结 果标志 交易数据 交易成功 34 定长字节 内容见下 交易失 败时 为中文提示信息 交易结果标志 交易结果标志 1 字节 0 x00 成功 后面跟的是 34 个字节的交易数据 其他值 交易失败 后面以中文字符方式应答了失败原因 不需要处理其响应码 交易数据 交易数据 34 字节 仅在交易成功时需要 包括以下数据 交易类型标志 1 字节 根据医保卡规范 交易金额 12 位数值 6 字节 BCD 码 高位前 单位为分 交易日期 8 位数值 4 字节 BCD 码 CCYYMMDD 交易时间 6 位数值 3 字节 BCD 码 HHMMSS 终端机编号 12 位数值 6 字节 BCD 码 PSAM 交易号 4 字节 高位在前的 HEX 码 卡片的交易签名 TAC 4 字节的 HEX 码 卡片的脱机交易序号 2 字节 高位在前的 HEX 码 卡片交易后余额4 字节 高位在前的 HEX 码 注意 1 BCD 码为压缩的十进制数 HEX 为 16 进制数 为不可压缩数值 2 金额使用压缩的 12 位 BCD 码 参照 ISO8583 规范 3 所有数据使用规范参照现用的医保卡标准 银行清算需要这些数据进行交易 有效性检查 附上 C 结构 typedef struct 交易类型标志 unsigned char transtype 交易金额 unsigned char transamount 6 交易日期时间 unsigned char transdatetime 7 终端机编号 unsigned char samid 6 PSAM 卡交易序号 unsigned char psamptc 4 用户卡验证码 unsigned char transtac 4 用户卡交易序号 unsigned char transoffctc 2 用户卡余额 unsigned char nowbalance 4 T SENDTRANS 脱机清算请求脱机清算请求 为空 传入的长度参数为 0 脱机清算响应脱机清算响应 交易类型 1 字 节 为 0 x34 1 字节 交易结 果标志 交易数据 交易成功 12 定长字节 内容见下 交易失败时 为中文提示信息 交易结果标志 交易结果标志 1