武汉市民健康卡读写卡器接口规范.docx

资源描述

武汉市民健康卡读写卡器接口规范.docx

《武汉市民健康卡读写卡器接口规范.docx》由会员分享，可在线阅读，更多相关《武汉市民健康卡读写卡器接口规范.docx（18页珍藏版）》请在冰豆网上搜索。

武汉市民健康卡读写卡器接口规范.docx

武汉市民健康卡读写卡器接口规范

武汉市居民健康卡接口规范

版本号

修改时间

修改说明

修改人

V1.0

邓磊

V1.2

☞增加写个人信息时加入结束指令的要求。

☞

李志民

V1.3

2015/6/11

新增DLL封装整体要求。

李志民

V1.4

2005/06/12

按卫生部数据规范，补齐门诊信息相关字段内容。

李志民

V1.5

2015/6/16

对PSAM卡的补充说明。

程序接口本身没有变化。

李志民

V1.6

2015/10/10

增加获取芯片序列号方法

的说明

李志民

1、DLL封装整体要求

☞本接口文档中所要求实现的接口函数统一封装在一个动态库中，名称统一为HealthyCarder.dll。

☞厂商所提供的HealthyCarder.dll如果需要依赖于其它动态库文件支持，则在开发HealthyCarder.dll时，必须通过动态调用（C/C++环境下为LoadLibrary）的方式使用DLL资源。

当HealthyCarder.dll发布实施时，与其相关的DLL要放在同一个目录下。

（说明：

由于最终的用卡环境可能涉及多个厂商的机具，为了避免各个厂商提供的驱动产生命名冲突，以及便于维护管理，集成商将每个厂商的驱动都单独放在一个目录中。

如果厂商的HealthyCarder.dll使用静态编译的方式调用DLL,那么在实际应用时，由于HealthyCarder.dll所在目录不在系统默认搜索范围之内，导致HealthyCarder.dll所依赖的DLL无法找到，上层应用调用HealthyCarder.dll产生失败。

）

2、读卡信息

intstdcallReadCardInfo（char*OutputData,char*ErrMsg）

出参：

0成功非零失败

错误：

ErrMsg

注意：

芯片序列号为卡片出厂时的唯一标识，每个制卡商标识规则不一样。

该信息是由终端发出复位信号以后，IC卡以一串字节作为应答（即复位应答）的信息。

机具厂商在读取复位信息时必须按照ISO7816规范来处理。

下图为握琦居民健康卡复位信息示例：

3、读个人信息

intstdcallReadPeopleInfo（char*OutputData,char*ErrMsg）

出参：

0成功非零失败

错误：

ErrMsg

4、读健康信息

intstdcallReadHealthInfo（char*OutputData,char*ErrMsg）

出参：

0成功非零失败

错误：

ErrMsg

5、提取住院信息

intstdcallReadEEFileInfo（intRecordid,char*OutputData,char*ErrMsg）

入参:

Recordid记录号（有效取值1~3）

出参：

院费用-分类代码5|住院费用-金额5|住院费用-分类6|住院费用-分类代码6|住院费用

0成功非零失败

错误：

ErrMsg

6、写住院信息

intstdcallWriteEEFileInfo（char*InputData,char*ErrMsg）

写入说明：

默认写入第一条，如果第一条记录存在（索引为00），写入下一条，依

次类推。

如果3条记录都存在（写满），则覆盖第一条记录。

入参：

名称|住院患者住院天数|住院患者尸检标志|住院患者随诊标志|住院费用-医疗付款方

0成功非零失败

错误：

ErrMsg

7、提取门诊信息

intstdcallReadEDFileInfo（intRecordid,char*OutputData,char*ErrMsg）

入参:

intRecordid记录号（有效取值1~5）

出参：

0成功非零失败

错误：

ErrMsg

8、写门诊信息

intstdcallWriteEDFileInfo（char*InputData,char*ErrMsg）

写入说明：

默认写入第一条，如果第一条记录存在（索引为00），写入下一条，依

次类推。

如果5条记录都存在（写满），则覆盖第一条记录。

入参：

称10|检查/检验结果代码10|检查/检验定量结果10|检查/检验计量单位10|检查/检

0成功非零失败

错误：

ErrMsg

9、读设备识别码

intstdcallReadDevNum（char*OutputData,char*ErrMsg）

出参：

每个设备的唯一编号：

各机具提供商简称+序列号返回：

0成功非零失败

错误：

ErrMsg

10、读SAM卡号

intstdcallReadSamNum（char*OutputData,char*ErrMsg）出参：

SAM卡卡号。

（SAM卡背后印刷的20位号码，非12位的号码）返回：

0成功非零失败

错误：

ErrMsg

11、读取二代身份证信息

intstdcallReadCertCardInfos（constchar*pBmpFile,char*OutputData,char

*ErrMsg）

入参：

constchar*pBmpFile照片存储路径出参：

0成功非零失败

错误：

ErrMsg

12、持卡人基本信息写入（保留）

写入DDF1-EF06全部数据。

写入DDF1-EF05中的卡号、发卡时间。

发卡时间由参数传入，卡号为身份证号。

由于写个人信息涉及结束指令的执行，而目前由于机具类型及卡类型不明（每个项目、每个医疗机构的用卡环境都

展开阅读全文