武汉市民健康卡读写卡器接口规范剖析.docxVIP

武汉市居民健康卡接口规范 版本号 修改时间 修改说明 修改人 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、 读卡信息 int stdcall ReadCardInfo(char *OutputData, char *ErrMsg) 出参： 卡的类别|规范版本号|发卡机构名称|发卡机构代码|发卡时间|卡号|安全码|发 卡序列号 |应用城市代码|芯片序列号 返回： 0 成功 非零失败 错误：ErrMsg 注意：芯片序列号为卡片出厂时的唯一标识，每个制卡商标识规则不一样。该信息是 由终端发出复位信号以后，IC 卡以一串字节作为应答（即复位应答）的信息。机具 厂商在读取复位信息时必须按照 ISO 7816 规范来处理。下图为握琦居民健康卡复位 信息示例：  3、 读个人信息 int stdcall ReadPeopleInfo(char *OutputData, char *ErrMsg) 出参： 姓名|性别|民族|出生日期|居民身份证号码|卡有效期|本人电话号码 1|本人电 话 2|医疗费用支付方式 1|医疗费用支付方式 2|医疗费用支付方式 3|地址类别 1|地址 1|地址类别 2|地址 2|联系人姓名 1|联系人关系 1|联系人电话号码 1|联系人姓名 2|联 系人关系 2|联系人电话号码 2|联系人姓名 3|联系人关系 3|联系人电话 3|文化程度代 码|婚姻状况代码|职业代码|证件类别|证件号码|健康档案号|新农合卡号 返回： 0 成功 非零失败 错误：ErrMsg 4、 读健康信息 int stdcall ReadHealthInfo(char *OutputData, char *ErrMsg) 出参： ABO 血型代码|RH 血型代码|哮喘标志|心脏病标志|心脑血管病标志|癫痫病标 志|凝血紊乱标志|糖尿病标志|青光眼标志|透析标志|器官移植标志|器官缺失标志|可 装卸的义肢标志|心脏起搏器标志|其他医学警示名称|精神病标志|过敏物质名称 1|过 敏反应 1|过敏物质名称 2|过敏反应 2|过敏物质名称 3|过敏反应 3|免疫接种名称 1|免 疫接种时间 1|免疫接种名称 2|免疫接种时间 2|免疫接种名称 3|免疫接种时间 3|免疫 接种名称 4|免疫接种时间 4|免疫接种名称 5|免疫接种时间 5|免疫接种名称 6|免疫接 种时间 6|免疫接种名称 7|免疫接种时间 7|免疫接种名称 8|免疫接种时间 8|免疫接种 名称 9|免疫接种时间 9|免疫接种名称 10|免疫接种时间 10 返回： 0 成功 非零失败 错误：ErrMsg 5、 提取住院信息 int stdcall ReadEEFileInfo(int Recordid ,char *OutputData, char *ErrMsg) 入参: Recordid 记录号（有效取值 1~3） 出参：住院机构名称|住院机构组织机构代码|入院日期|住院患者住院次数|病案号|住 院患者入院科室名称|住院患者入院病情|住院患者医院感染名称|住院患者损伤和中 毒外部原因|住院患者血清学检查项目代码 1|住院患者血清学检查结果代码 1|疾病诊 断名称 1