《珠海社保系统POS功能接口doc-珠海市人力资源和社会保》由会员分享，可在线阅读，更多相关《珠海社保系统POS功能接口doc-珠海市人力资源和社会保（12页珍藏版）》请在装配图网上搜索。
1、编号：时间：2021年x月x日书山有路勤为径，学海无涯苦作舟页码：第12页 共12页珠海社保系统医院POS功能接口修订记录：版本时间修订人修订内容目 录1 系统目标21.1 背景情况21.2 系统目标21.2.1 功能目标21.2.2 性能目标22 系统结构22.1 概述22.2 网络结构32.3 系统划分32.3.1 PC端动态链接库32.3.2 POS端演示程序33 数据链路层和传输层通讯协议33.1 数据链路层协议33.2 传输层协议34 交易描述54.1 脱机消费54.1.1 交易流程54.1.2 数据流程64.1.3 应用层数据包64.2 黑名单管理（暂未启用）94.2.1 数据流程
2、94.2.2 应用层数据包101 系统目标1.1 背景情况珠海市社会保障卡系统建设目标为五保合一，并作为广东省社保系统的试点系统。个人医疗保障账户要求专款专用，个人医疗保障账户和社会保障卡上的医疗保障电子钱包上的金额专用于支付指定的医疗和购药费用。目前，交易中心的结构未定（单中心或无中心），本子系统要求充分考虑了两种中心的情况。1.2 系统目标本子系统要求采用珠海社保指定的IC卡、PSAM卡，在P70-S POS终端上完成脱机消费以及与医院收费PC之间的数据交换，向珠海社保局及相关部门证明系统结构的可行性和设备的可用性。同时，要求本子系统在结构上允许采用不同的IC卡交易终端设备（包括POS终端
3、和IC卡读卡器），无论采用何种终端设备，通讯接口不变。1.2.1 功能目标l 实现社保卡的脱机消费l 实现黑名单管理l 实现与PC之间的串口通讯l 预留圈存交易接口，但本次不要求实现1.2.2 性能目标l 不计入用户输入密码的时间，脱机消费交易在3秒内完成l 终端至少有160k字节的存储空间，可用于存储约20000条黑名单，该存储空间要求掉电保持l 终端至少有100k字节的存储空间，可用于存储约2000条交易明细，该存储空间要求掉电保持2 系统结构2.1 概述POS终端与PC通过RS232串口连接，每次消费交易由PC触发，POS终端取得PC给出的交易金额和其他有关信息后，完成脱机消费交易，并将
4、交易结果和批上送时需要的数据回传给PC。POS上应同时保留交易信息，根据PC的通知清除。黑名单更新时，由PC发送黑名单更新通知给POS，POS发出更新请求，逐批从PC取得黑名单信息，直至完成，黑名单更新要求在5分钟内完成，不需要支持断点续传。2.2 网络结构LAN动态调用PCDLLRS232POS2.3 系统划分本演示子系统软件分为三个部分：l PC端程序l PC端动态链接库l POS端程序2.3.1 PC端程序使用Power Builder编写。2.3.2 PC端动态链接库C语言编写，由Power Builder程序动态调用，可运行平台包括：Windows 95 / 98 / NT / 20
5、00 / XP。2.3.3 POS端程序C语言编写，在P70-S上运行。3 数据链路层和传输层通讯协议3.1 数据链路层协议通过RS232串口传输数据。缺省参数：9600Bps，8位数据位，1位停止位，无校验位。3.2 传输层协议数据包以STX(0x02)起始，后跟2字节BCD码长度（序号和实际传输内容的长度），1字节seq标示信息包序号，中间为实际传输内容，以ETX(0x03)结束，最后为1字节的LRC校验。实际传输内容要求为ASCII可见字符(0-9, a-z, A-Z)形式的信息。如下：STX（1字节）长度（2字节，BCD码，高位在前）Seq（1字节）实际传输内容（可变长，最大不超过10
6、00字节）ETX（1字节）LRC(1字节，从长度开始至ETX)字符间超时时间为0.5秒。Seq的有效值为0 9，通讯双方必须维护自己的Seq, 每一新的数据包，Seq值循环递增。连续两个数据包，若seq相同，则视为重发的数据包。接收方收到发送方的数据包后，LRC校验成功的，发送一字节ACK(0x06)字符表示确认，否则发送NAK（0x15）表示数据包出错。接收超时的，也发送NAK。如果收到Seq值重复的数据包，也发ACK予以确认。发送方收到接收方的NAK或是发送数据包3秒后未收到ACK，视为本次发送失败，进行重发，重发最多进行两次。三次发送均未成功的，放弃发送，向应用层报告失败。4 交易描述4
7、.1 脱机消费4.1.1 交易流程4.1.2 数据流程4.1.3 应用层数据包l 脱机交易请求包1（查询卡基本信息）为空，传入的长度参数为0l 脱机交易响格式（查询卡基本信息）交易类型（1字节，查询为0x31）(1字节，交易结果标志交易数据（交易成功426定长字节，内容见下，交易失败时，为中文提示信息）交易结果标志：1字节，0x00-成功，后面跟的是107个字节的交易数据 其他值 交易失败，后面以中文字符方式应答了失败原因，不需要处理其响应码交易数据：107字节的交易数据（为了不更改以后接口用）注：BCD码为压缩的十进制数，HEX为16进制数，为不可压缩数值。卡的识别码16字节32位压缩BCD
8、码卡类别 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_id0x10;unsigned char card_type0x01;unsigned char criterion0x04;unsigned char initorgan0x0c;unsigned ch
9、ar issuer_dt0x04;unsigned char expire0x04;unsigned char cardno0x09;unsigned char personid0x12;unsigned char name0x1e;unsigned char sex0x01;unsigned char nation0x01;unsigned char homeplace0x03;unsigned char birthday0x04; T_MEDICARDINFO;l 脱机交易请求包1（查询）为空，传入的长度参数为0l 脱机交易响格式（查询）交易类型（1字节，查询为0x31）(1字节，交易结果
10、标志交易数据（交易成功426定长字节，内容见下，交易失败时，为中文提示信息）交易结果标志：1字节，0x00-成功，后面跟的是426个字节的交易数据 其他值 交易失败，后面以中文字符方式应答了失败原因，不需要处理其响应码交易数据：426字节的交易数据（为了不更改以后接口用）注：BCD码为压缩的十进制数，HEX为16进制数，为不可压缩数值。卡的识别码16字节32位压缩BCD码卡类别 1字节规范版本 4字节HEX码初始化机构编号12字节24位压缩BCD码发卡日期 4字节8位压缩BCD码失效日期 4字节8位压缩BCD码卡号 9字节字符公民身份证号码 18字节字符姓名 30字节字符性别 1字节字符民族
11、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字节高
12、位在前的HEX码年度统筹基金支付累计金额4字节高位在前的HEX码发卡行ID 8字节 16位BCD码（转换后取左三位上传）最近审核日期 4字节 8位压缩BCD码分散因子 8字节 HEX码黑名单版本号 19字节 附上C语言结构typedef struct unsigned char card_id0x10;unsigned char card_type0x01;unsigned char criterion0x04;unsigned char initorgan0x0c;unsigned char issuer_dt0x04;unsigned char expire0x04;unsigned ch
13、ar cardno0x09;unsigned char personid0x12;unsigned char name0x1e;unsigned char sex0x01;unsigned char nation0x01;unsigned char homeplace0x03;unsigned char birthday0x04;unsigned char accreatedt 0x04;unsigned char hospitalname10x3e;unsigned char hospitalnameext10x08;unsigned char hospitalcode10x09;unsig
14、ned char hospitalname20x3e;unsigned char hospitalnameext20x08;unsigned char hospitalcode20x09;unsigned char hospitalname30x3e;unsigned char hospitalnameext30x08;unsigned char hospitalcode30x09;unsigned char medicerti0x0f;unsigned char mediaccount0x0a;unsigned char meditype0x01;unsigned char usecardt
15、ype0x01;unsigned char balance00x04;unsigned char balance10x04;unsigned char balance20x04;unsigned char bankid 0x08;unsigned char latestchktime 0x04;unsigned char diverfactor 0x08; unsigned char blacklistver 0x13; T_MEDICARDINFO;l 脱机交易请求2（消费）金额（12位数值，压缩成6字节BCD码，不足时前补0）商户名称（16字节，即最多8个中文字，不足填空格）商户操作人员姓
16、名（8字节，即最多4个中文字，不足填空格）PC编号（12字节ASCII, 不足时后补二进制0）PC交易序号（12字节ASCII, 不足时后补二进制0）l 脱机交易响应2（消费）交易类型（1字节，消费为0x32）0x02（1字节，交易结果标志)交易数据（交易成功34定长字节，内容见下，交易失败时，为中文提示信息）交易结果标志：1字节，0x00-成功，后面跟的是34个字节的交易数据 其他值 交易失败，后面以中文字符方式应答了失败原因，不需要处理其响应码交易数据：34字节，仅在交易成功时需要，包括以下数据：交易类型标志，1字节，根据医保卡规范交易金额 12位数值 6字节BCD码，高位前，单位为分交易
17、日期， 8位数值， 4字节BCD码，CCYYMMDD交易时间， 6位数值， 3字节BCD码，HHMMSS终端机编号， 12位数值，6字节BCD码PSAM交易号， 4字节 高位在前的HEX 码卡片的交易签名TAC4字节的 HEX码卡片的脱机交易序号 2字节 高位在前的HEX 码卡片交易后余额4字节 高位在前的 HEX 码注意：1 BCD码为压缩的十进制数，HEX为16进制数，为不可压缩数值。 2金额使用压缩的12位BCD码参照ISO8583规范3所有数据使用规范参照现用的医保卡标准，银行清算需要这些数据进行交易有效性检查附上C结构typedef struct /*交易类型标志 */unsigne
18、d char transtype;/*交易金额 */unsigned char transamount6;/*交易日期时间 */unsigned char transdatetime7;/*终端机编号*/unsigned char samid6;/*PSAM卡交易序号 */unsigned char psamptc4;/*用户卡验证码 */unsigned char transtac4;/*用户卡交易序号 */unsigned char transoffctc2;/*用户卡余额 */unsigned char nowbalance4; T_SENDTRANS;l 脱机清算请求为空，传入的长度参
19、数为0l 脱机清算响应交易类型（1字节，为0x34）(1字节，交易结果标志交易数据（交易成功12定长字节，内容见下，交易失败时，为中文提示信息）交易结果标志：1字节，0x00-成功，后面跟的是12个字节的交易数据 其他值 交易失败，后面以中文字符方式应答了失败原因，不需要处理其响应码交易数据：12字节的交易数据注：BCD码为压缩的十进制数终端交易总金额 12位数值 6字节BCD码，高位前，单位为分终端交易总笔数 12位数值 6字节BCD码，高位前4.2 黑名单管理（暂未启用）在本演示系统中，黑名单以文本文件方式在PC上保存，并可手工修改，黑名单以全量方式从PC传给POS。整个黑名单可能分多个数
20、据包发出， 4.2.1 数据流程4.2.2 应用层数据包l 黑名单更新通知0xa0(1字节，黑名单更新通知)0xa0(1字节，通知数据代码)最新黑名单版本号（8位数值，压缩成4字节BCD码）l 黑名单更新请求0xa0(1字节，黑名单更新)0x01(1字节，请求数据代码)黑名单版本号（8位数值，压缩成4字节BCD码）已更新的黑名单纪录数（6位数值，压缩成3字节BCD码）l 黑名单更新响应0xa0(1字节，黑名单更新)0x02(1字节，响应数据代码)黑名单版本号（8位数值，压缩成4字节BCD码）后续数据标志(1字节，0x00-无，更新完成，0x01-有，继续更新)黑名单数据（变长，每8字节为一条纪录）第 12 页 共 12 页
珠海社保系统POS功能接口doc-珠海市人力资源和社会保
