名称

技术参数及要求

1.概述

为需要接入省级卡管平台交互的系统提供接入，规范封装接口的定义、调用参数说明，以及相关数据的格式

2.适用范围及对象

规范确定电子健康卡中数据存取的应用编程接口。基于符合规范《居民健康卡应用规范》中的定义的居民健康卡特定数据项，依据居民健康卡在医疗卫生行业中的业务应用，以及居民健康卡管理流程等要求，描述定义所需接口函数、参数数据类型以及接口的调用方式。

3.返回码表接口功能接入

返回码10000，返回码描述成功
返回码10110，返回码描述WebService返回参数错误
返回码10109，返回码描述WebService返回卡不存在
返回码1010，返回码描述WebService返回卡已挂失
返回码1020，返回码描述WebService返回卡已注销
返回码1040，返回码描述WebService返回卡已作废
返回码10101，返回码描述WebService返回机构代码错误
返回码10103，返回码描述WebService返回密码错误
返回码10112，返回码描述WebService返回错误的操作代码
返回码10105，返回码描述WebService认证字符串失效,请重新操作本操作
返回码10102，返回码描述WebService用户名错误
返回码10108，返回码描述身份证未办卡
返回码10109，返回码描述卡号不存在
返回码10110，返回码描述参数错误or校验失败
返回码10111，返回码描述身份证号码不正确
返回码10113，返回码描述错误的性别代码
返回码10114，返回码描述姓名不能为空
返回码10115，返回码描述身份证已经办理过
返回码10116，返回码描述卡号已经存在
返回码10117，返回码描述只有正常和挂失的卡才能进行补换卡
返回码10118，返回码描述卡关联的居民信息不存在
返回码10119，返回码描述只有正常状态的才能挂失
返回码10121，返回码描述只有挂失状态的才能解挂失
返回码10122，返回码描述补换卡时必需提供身份证或者原卡号
返回码10123，返回码描述民族代码不正确
返回码10124，返回码描述出生日期格式不正确
返回码10125，返回码描述卡已被使用
返回码10126，返回码描述消费类型不正确
返回码10127，返回码描述旧卡已经在黑名单中
返回码10128，返回码描述发卡时间格式不正确
返回码10129，返回码描述网络异常
返回码10130，返回码描述卡号和身份证号码关联不上
返回码10131，返回码描述医疗费用支付方式不正确
返回码10132，返回码描述婚姻状况代码不正确

4.调用接口规范实现如下功能

4.1居民健康卡信息数据传输接入

卡的类别
居民居民健康卡标准规范的版本编号。
发卡机构代码
发卡时间
卡号
安全码
发卡序列号
应用城市代码（机构所在行政区代码）
芯片序列号/电子健康卡号
银行卡号
健康卡状态
发卡方式
银行代码
居民信息
是否实名标识
终端类型
二维码类型
工作站名称
工作站ip
读证终端编号
支付账户类型
注册途径

4.1.1居民信息数据接入

姓名
性别
民族
出生日期
居民身份证号码
证件类别
证件号码
健康档案号
工作单位
新农合卡号或社保卡号
婚姻状况代码(GB/T 2261.2)
文化程度代码(GB/T 4658)
职业类别代码GB/T 6565
地址类别
完整地址
本人电话号码
医疗费用支付方式
参照数据字典
出生地
户籍所在地址
居民签约代扣标志
就诊卡卡号

4.1.2卡信息接入

虚拟电子卡号
主索引 ID
电子健康卡 ID
健康卡签发机构代码
健康卡签发机构名称
健康卡失效日期
居民信息

4.1.3用卡信息接入

就诊类型
刷卡科室代码
诊疗环节代码
用卡渠道
终端类型
终端编号
机具号

4.1.4绑卡信息接入

绑卡信息
绑卡人员信息
子卡卡号
卡类型参照数据字典
子卡发卡机构代码
子卡发卡机构名称
应用城市代码
操作时间
卡状态，挂失，注销状态不可操作
操作类型 1：绑定 2：换绑 3：解绑

4.1.5绑卡人员信息接入

电子健康卡 ID
姓名
证件类别
证件号码

4.2接入机构身份认证接口

功能说明
说明：接入机构必需先在卡管平台注册，得到机构代码、用户名、密码。
接入机构调用认证接口，获取认证字符串可凭借其调用其它接口，只需获取一次，在失效前无需重复获取。

4.3发卡同步接口接入

功能说明
说明：发卡模式下使用。接入机构发卡，并将居民健康卡数据同步到卡管平台。
电子健康卡发卡接口参数说明：能获取到的参数都传，只要接口不返回错误码即可。

4.4信息更新接口

功能说明
电子健康卡信息更新主要用于对居民个人基本信息的更新。

4.5电子卡静态二维码下载

函数说明
用于居民电子健康卡静态二维码下载打印，一般用于静态二维码标签
补打印。

4.6 电子健康卡身份验证

功能说明
电子健康卡二维码身份验证包括静态二维码和动态二维码的身份验证，
电子健康卡二维码通过扫码设备读取内容后，将该二维码内容发送到服务平台验
证，验证通过时，则一并返回个人基本信息。

4.7 获取中心端系统时间接口

功能说明
提供中心端系统时间查询接口