南京民卡一卡通接口方案-南京卫生12320网.doc

文件编号：WSXX2012001 文件版次：WSXX2012001-001 文档编号：SMK2012-001 版本号：1.0 发布日期：2012-5-16 南京市医疗一卡通 接口方案技术支持：东软医疗系统有限公司南京市市民卡有限公司目 录 1 引言 1 1.1文档编制目的 1 1.2背景 1 2 医疗一卡通解决方案 2 2.1综述 2 2.2医院流程方案 2 2.2.1医院开卡 2 2.2.2黑名单的获取 5 2.2.3开卡文件的上传 6 2.2.4患者基本信息的修改 7 2.2.5断网处理 9 2.3 黑民单文件解析 10 2.3.1传输模式 10 2.3.2接口及说明 10 2.3.3 C#解析样例 11 2.4开卡文件上传 13 2.4.1传输模式 13 2.4.2接口及说明 14 2.4.3开发方案 15 2.4.4 C#解析样例 16 3 数据中心交互接口 20 3.1综述 20 3.2配置说明 20 3.3方法说明及样例 21 3.4数据交互接口 24 3.4.1上传患者基本信息 24 3.4.2根据身份证号查询患者基本信息 29 3.4.3根据卡号查询患者基本信息 33 3.4.4根据姓名查询患者基本信息 33 3.4.5修改患者基本信息 34 3.4.6卡片信息绑定 37 4 市民卡设备连接方法 39 4.1概述 39 4.2接口说明 39 4.2.1公用函数说明 39 4.2.2 M1卡专用函数 40 4.2.3 Desfire卡专用函数 41 4.3读卡号和卡类型流程图 45 4.4读取卡信息流程图 46 4.5写卡信息流程图 47 4.6卡消费流程图 48 4.7公共返回值说明 48 4.8 C#调用样例 48 4.8.1函数定义 48 4.8.2参数结构体定义 51 4.8.3返回值 53 4.9 封装函数使用说明 56 4.9.1连接读卡器 56 4.9.2读卡号和卡类型（不分Desfire卡和M1卡） 56 4.9.3读卡信息（不分Desfire卡和M1卡） 57 4.9.4写卡信息（不分Desfire卡和M1卡） 57 4.9.5卡消费 57 4.9.6释放读卡器 57 5 附录 57 5.1附录1 医院编码表 57 5.2附录2 市民卡文件数据类型说明 59 5.3附录3 网络PING方法 60  1 引言 1.1文档编制目的 本报告主要表述了南京市市民卡医疗一卡通接口设计方案，内容包含医疗一卡通解决方案、数据中心交互接口、市民卡设备连接方法等。 本方案将根据国家居民健康卡管理方法进行及时修订，并适时发布新版本。 1.2背景 南京市市民卡由市政府授权发放，主要是通过整合目前我市广大市民在用的社保卡、金陵通卡和银行卡等相关卡证，以便民、惠民为宗旨，实现个人身份识别、个人相关社会事务办理、享受公共服务、进行电子支付等功能。 市民卡内分配给医疗行业使用的空间为64字节，用来存储市民的姓名、身份证号、电子健康档案号（新农合号）等。市民的年龄、性别可以从其身份证号中转义出来。市民的其余信息，如血型、家庭住址、联系电话、过敏史、既往病史、家族病史等可以通过区域医疗卫生信息平台查询中心数据库来获得。 市民卡作为南京市市民就诊时唯一的身份标识凭证，积极探索并尝试银医合作，对提高医院服务质量，缓解“看病难、看病贵”等问题，特别是对建设中的居民电子健康档案，区域电子病历系统、区域PACS系统乃至整个南京市的区域卫生信息平台都有着重要的意义。 市民卡密钥管理体系将参照卫生部《居民健康卡密钥管理办法执行》。 2 医疗一卡通解决方案 2.1综述 市民卡分为三种类型A（Desfire）卡、B（Desfire）卡、C（M1）卡。其中C卡为专门为医疗行业制作的市民卡，C卡由各医院向卫生局申请购买。C卡与A、B卡有很大不同，由各医院窗口进行发放，全市共享使用。为了能够达到患者信息各医院共享使用的目的，南京卫生局架设中心端卡服务，供医院进行调用，以实现患者基本信息共享。 由于A卡、B卡发放是南京市政府行为，其信息是可靠的，用卡内芯片存储的身份证号作为患者的标识与中心端查询的依据。C卡由医院进行发放故存在患者没带身份证但迫切需要看诊的情况，该情况用“N”加医院编码加医院流水号共18位。例如南京妇幼保健院产生患者索引“N23214000000000001”，并把该号码写入C卡芯片。如果C卡办理时患者已携带身份证，把患者身份证号写入卡片芯片即可。 由于市民卡设计挂失处理，市民卡公司承诺会按照每天一次固定时间以FTP服务的形式向外界提供黑名单信息。卫生局数据中心服务同样会定时从市民卡中心获取该文件并发布于卫生局数据中心FTP供各医院进行黑名单的下载，医院对黑名单信息进行医院端本地存储，在市民卡的使用过程中自行进行比对。 2.2医