河南居民健康卡接口技术规范.DOC

郑卫〔2013〕147号（附件1） 密级 无 版本 2.3 河南省居民健康卡 接口技术规范 （正式版） 河南省卫生厅 二〇一二年十一月 变更记录 版本 日期 变更人 变更描述 V1.0 2011.12.15 高洪涛 创建 V1.1 2011.12.20 刘博 OCX控件文件名、CLSID、ProgID变更，OCX增加属性，接口参数改变；标签表有更新和补充，其它数据说明增加过敏和免役说明。 V1.2 2011.12.21 刘博 函数应用注意事项：增加标志类标签返回值的说明，增加入参分隔符的使用规则说明。 V1.3 2012.01.05 高洪涛 增加设备级接口函数说明 V1.4 2012.02.11 刘博 照片文件最大长度改为：6148； 住院索引长度改为3，记录对应标签改为：1013 – 1015； 业务接口函数应用注意事项部分修改了关于住院信息读写的说明； 增加新标签：101-应用城市代码 102-照片； V1.5 2012.02.15 刘博 第七章末尾新增照片的读取方法 标签表中对102标签的长度做了修改 V1.6 2012.02.17 刘博 DLL增加检索卡片是否就位的方法； 纠正了GetLastOperInfo漏写参数的方法说明； V1.7 2012.02.21 刘博 新增获取个人健康档案信息，对应标签1029； OCX增加了检索卡片是否就位的方法； V1.8 2012.02.24 刘博 在第七章中对业务标签号1029进行了详细的调用说明； V1.9 2012.02.28 李述玉 修正第八章基础代码,让与健康卡采集软件的代码保持一致，增加”联系人关系代码”； V2.0 2012.10.17 刘博 修改文档中错误：发卡时间，卡有效期实际为8字节，接口程序中正常，无变更需要。 V2.1 2012.10.19 刘博 芯片序列号改为发卡序列号 V2.2 2012.10.31 刘博 将标签表中的联系人关系1、2、3改为与持卡人关系1、2、3； 修改照片最大存储长度为：6148字节 V2.3 2012-11-08 刘博 第八章 附件：门诊及住院信息数据表中增加了对代码类国标规范的引用指明了出处； 将原有国标代码表全部移除，以后健康卡内所有国标代码全部引用自《河南省居民健康卡卡内数据元规范V1.0》文档； 其它多个地方也对此部分改动做了相应修改。  目 录 第一章 概述 6 1. 前言 6 2. 规范引用文件 7 3. 接口与业务系统关系示意 7 4. 接口实现方式与调用 8 5. 标准动态链接库（DLL）方式 9 6. ActiveX控件（OCX）方式 9 7. 术语及定义 11 8. 缩略语 13 第二章 接口调用流程概述 15 1. 应用模型 15 2. 读取信息 17 3. 写入信息 17 第三章 数据类型定义 19 1. 基本数据类型定义 19 2. 常量定义 19 3. 复合数据类型定义 20 第四章 设备接口函数说明 22 1. 设备管理 22 2. 用户卡读写 23 3. SAM卡算法服务 30 第五章 DLL方式业务接口使用说明 35 1. 读取信息 35 2. 写入信息 36 3. 获取最近一次卡操作结果信息函数 38 4. 检测读卡器上有无有效的居民健康卡函数 39 第六章 OCX控件业务接口使用说明 40 1. 属性说明 40 2. 读取信息 40 3. 写入信息 41 4. 获取最近一次卡操作结果信息函数 43 5. 检测读卡器上有无有效的居民健康卡函数 44 第七章 业务接口函数应用注意事项 46 第八章 附件 49 1. 业务机构网络及前置服务器配置表 49 2. 标签表 49 3. 居民基本信息记录（对应序号:1000） 51 4. 住院信息数据（对应序号:1013-1015） 52 5. 门诊信息数据(对应序号:1003-1007) 58 6. 过敏基本数据文件 (对应序号:1023-1024) 64 7. 免疫基本数据文件(对应序号:1025-1026) 64 8. 错误代码表 65 9. 国标码对照表 65 10. 国际疾病分类标准编码：ICD10 66 11. 国际手术操作分类标准编码：ICD-9-CM 66 12. 关于国标的其它说明 66 概述 前言 本规范描述了河南省居民健康卡在各类业务终端系统使用的接口技术应用。用以指导业务系统开发商改造业务系统，满足河南省居民健康卡在新农合应用、综合医院应用、基层卫生机构应用、居民个人应用和金融应用领域的流通需求。按照河南省居民健康卡项目建设要求，目前河南省居民健康卡主要面向上述应用领域提供卡片认证、持卡人身份识别、持卡人基本信息调阅三项基本服务。 本规范提供两类接口函数说明。一类是设备级的接口函数，用