社会保障卡及身份证读卡接口安装及配置说明
一、 安装
1、Win7以上操作系统鼠标右键“以管理员权限运行安装”,WindowsXP系统双击安装SCardHLJ_C安装包。

2、

提示:如机器已经安装过.NET Framework 可直接将图片2上的对号取消,点击“完成”跳过安装.NET。
3、

4、

5、默认路径为图片路径无需修改

6、

7、出现如下两种形式之一的提示为安装成功。


8、

完成安装。
二、修改
安装结束后桌面会自动生成两个快捷方式“读卡器类型修改”和“服务设置”。
1)读卡器类型修改: 不同品牌的读卡器需在此项内进行设置。

2)密码键盘设置(如果键盘支持的话)

3) 后台服务地址设置

医保端服务地址为http://200.200.1.4:56789/ (需要专线支撑)
人社端服务地址:http://10.64.255.60:56789/ (需要人社内网或者VPN)
根据使用情况进行配置
三、服务形式调用操作指南
本次安装文件默认只安装激活COM组件方式的调用,调用者需要通过classid引用。
如果涉及到跨浏览器,使用Google Chrome或者火狐、360极速浏览器的开发商则可以使用服务版本完成开发工作。同时服务版本支持身份证调用。
1、 服务方式的激活
打开D:\ScardHLJ_C文件夹下 找到SCardHLJService安装.bat文件。鼠标选中后,右键“以管理员身份运行”。运行完成后服务模式开启。

2、 服务方式的启动和终止
服务模式启动后,如果需要更改任意硬件类型,需要将服务终止之后进行配置修改,修改完成后在重新启动服务。
服务“终止”和“启用”操作方法为: 在桌面找到服务工具的快捷方式

右键“以管理员身份运行”。打开如下界面

点击“停止”按钮,在状态栏显示为“stopped”时修改硬件设备的具体配置。

修改完成后,在进行服务的启动。
服务启动后,状态显示为如下界面

3、 身份证功能的设置
身份证调用的型号设置需要在D:\ScardHLJ_C文件夹下目录下,找到如下提示文件,

用记事本打开后进行编辑如下选项

身份证设备类型
标准身份证:Apparatus_StandardIDReader_Lib.dll
德卡多合一读卡器:Apparatus_DC3In1_Lib.dll
天梦者多合一读卡器:Apparatus_TMZ_Lib.dll
首云多合一读卡器:Apparatus_CommonReader_Lib.dll
无身份证读卡器:Apparatus_Null_Lib.dll
三、测试地址
1、COM组件的社保卡读卡测试页面

浏览器输入以下地址,选对应的读卡器读卡,可以读出信息证明成功。http://10.64.255.60:56789/DKCS.html(人社端测试地址)
http://200.200.1.4:56789/DKCS.html(医保专线测试地址)
2、服务形式的测试界面
在电脑D:\ScardHLJ_C文件夹下目录下,找到“SSCardDriverHLJ_WS读卡.html”文件,双击打开。界面如下

红框位置为参数输入框
参数示例:WebSocket地址为:ws://127.0.0.1:56700/FUNC
发送命令格式
类名.函数名,参数1,参数2,…参数n
函数名和参数、参数和参数之间以 ‘,’ 分割
字符串类型的参数不需要两边加双引号。
①如调用SCard.ConnectAPI()
发送的格式为:
SCard.ConnectAPI
②如调用SCard.iReadCardBas(1,wdbh)
发送的格式为:
SCard.iReadCardBas,1, wdbh
③如调用SCard.iVerifyPIN (1,123456|123456,wdbh)
发送的格式为:
SCard.iVerifyPIN,1,123456|123456.wdbh
④复合读卡
复合读卡的类名为SCardID(可以不用区分是社保卡还是身份证,程序自动寻找介质类型,读到什么返回什么)
函数:string ReadCardInfo(string wdbh)
返回值:
1开头的为身份证
2开头的为社保卡基本信息
其它时为出错信息
返回身份证的格式
1, 身份证号码|姓名|性别(格式:代码#中文)|民族(格式:代码#中文)|出生日期|户籍地址|有效期起始日期|有效期截止日期|签发机关|照片(BASE64编码)|
返回社保卡的格式
2, 发卡地区行政区划代码(卡识别码前6位)|社会保障号码|卡号|卡识别码|姓名|卡复位信息(仅取历史字节)|规范版本|发卡日期|卡有效期|终端机编号|终端设备号|
发送的格式:
SCardID.ReadCardInfo,wdbh