福建省社会保障卡就诊一卡通接口.docx
《福建省社会保障卡就诊一卡通接口.docx》由会员分享，可在线阅读，更多相关《福建省社会保障卡就诊一卡通接口.docx（19页珍藏版）》请在冰点文库上搜索。
福建省社会保障卡就诊一卡通接口
福建省社会保障卡就诊一卡通接口（测试版）
2010-2
福建省社会保障卡一卡通接口（测试版）对外服务接口通过动态库fzyktclient.dll提供，相关单位可利用本接口进行医院系统一卡通改造测试工作。
整套接口包含以下文件，需同时放在系统路径目录下：
1．fzyktclient.dll
2．desalgo.dll
3．fjinterface.dll
4．dcic32.dll
5．posdot.lib
6．vcic32.dll
7．ylziccard.dll
根据实际情况，接口有可能调整，应用系统应提供升级的功能，以便自动部署新的接口。
接口分为脱机接口和联机接口两个部分，脱机接口开发测试工作现在就可以进行，联机接口先进行开发工作，开发完成后，如需进行联机接口调试，请和省医保联系具体测试时间。
一、脱机接口
1．初始化读卡器
函数声明
intykt_opendevice（intnDeviceType,intnCom,intnBaud,char*pRegion,char*pWarnmsg,char*pErrmsg）
用途说明
用于打开读写卡设备。
参数说明
名称
类型长度
说明
备 注
nDeviceType
Int
设备类型（10或12）
旧款YKT读卡器类型为10，新款为12
nCom
Int
端口（0-9）
0-com11-com2…
9–usb
nBaud
Int
波特率（1-4）
1-96002-19200
3–288004–57600
建议用3或者2
pRegion
Char（4）
地区编号
3500代表省本级
pWarnmsg
Char（1024）
警告信息
pErrmsg
Char（1024）
错误信息
返回值
0
成功
<>0
错误，详见pErrmsg
2．脱机读取卡号
函数声明
intykt_readopencardno_local（char*pRegion,char*pDeptid,char*pDeptKey,char*pCardtype,char*pCardno,char*pWarnmsg,char*pErrmsg）
用途说明
用于脱机读取当前卡具内的卡片卡号和卡类型，用于安全性要求不高的场合。
参数说明
名称
类型长度
说明
备 注
pRegion
Char（4）
地区编号
3500代表省本级
pDeptID
Char（4）
网点编号
医院在医保中心的编号，详见附表
pDeptKey
Char（512）
网点密钥
暂不使用，医院系统改造时应为可设置参数
pCardtype
Char
（2）
卡类型
返回2表示社会保障卡
pCardno
Char（20）
卡号
可包含字母或数字
pWarnmsg
Char（1024）
警告信息
pErrmsg
Char（1024）
错误信息
返回值
0
成功
<>0
错误，详见pErrmsg
3．脱机读取卡信息
函数声明
intykt_readopencardinfo_local（char*pRegion,char*pDeptid,char*pDeptKey,char*pIssuedeptid,char*pIssuedate,char*pCardtype,char*pCardno,char*pIdtype,char*pId,char*pName,char*pSex,char*pBirthDate,char*pCompany,char*pAddress,char*pTelephone,char*pWarnmsg,char*pErrmsg）
用途说明
用于脱机读取当前卡具内的卡片卡号和卡类型，用于安全性要求不高的场合。
参数说明
名称
类型长度
说明
备 注
pRegion
Char（4）
地区编号
3500代表省本级
pDeptID
Char（4）
网点编号
医院在医保中心的编号
pDeptKey
Char（512）
网点密钥
暂不使用，医院系统改造时应为可设置参数
pIssuedeptid
Char（24）
发卡机构编号
pIssuedate
Char（8）
发卡日期
pCardtype
Char
（2）
卡类型
返回2表示社会保障卡
pCardno
Char（20）
卡号
可包含字母或数字
pIdtype
Char
（2）
证件类型
01代表身份证
pId
Char（20）
身份证号
15或18位
pName
Char（12）
姓名
pSex
Char
（1）
性别
1男 2女 3未定义
pBirthDate
Char（8）
出生日期
pCompany
Char（70）
单位名称
pAddress
Char（80）
通讯地址
pTelephone
Char（20）
联系电话
pWarnmsg
Char（1024）
警告信息
pErrmsg
Char（1024）
错误信息
返回值
0
成功
<>0
错误，详见pErrmsg
说明：
此接口用于医院系统初诊注册功能的开发测试，以后联机接口启用后，应使用联机接口。
4．脱机读取磁条卡信息
函数声明
intykt_readmagicopencard_local（char*pRegion,char*pDeptid,char*pDeptKey,unsignedintDelay,unsignedchar*pTrack2Info,unsignedchar*pTrack2Len,unsignedchar*pTrack3Info,unsignedchar*pTrack3Len,char*pWarnmsg,char*pErrmsg）
用途说明
用于脱机读取当前卡具内的卡片卡号和卡类型，用于安全性要求不高的场合。
参数说明
名称
类型长度
说明
备 注
pRegion
Char（4）
地区编号
3500代表省本级
pDeptID
Char（4）
网点编号
医院在医保中心的编号
pDeptKey
Char（512）
网点密钥
暂不使用，医院系统改造时应为可设置参数
Delay
Unsignedint
延迟时间
以秒为单位
pTrack2Info
Char（100）
磁道2信息
pTrack2Len
Char
（1）
磁道2信息长度
pTrack3Info
Char（100）
磁道3信息
pTrack3Len
Char
（1）
磁道3信息长度
pWarnmsg
Char（1024）
警告信息
pErrmsg
Char（1024）
错误信息
返回值
0
成功
<>0
错误，详见pErrmsg
说明：
此接口用于医院系统读取原来的磁条就诊卡（新款YKT读卡器无需调用本接口即可直接刷磁条卡）。
5．脱机读取Memory4428IC卡信息
函数声明
intykt_readopencard4428_local（intoffset,intlength,char*pData,char*pWarnmsg,char*pErrmsg）
用途说明
用于脱机读取当前卡具内的卡片卡号和卡类型，用于安全性要求不高的场合。
参数说明
名称
类型长度
说明
备 注
offset
Int
偏移量
从0开始
length
int
读取字节长度
pData
Char（1024）
读取数据缓冲区
以16进制存储
pWarnmsg
Char（1024）
警告信息
pErrmsg
Char（1024）
错误信息
返回值
0
成功
<>0
错误，详见pErrmsg
说明：
此接口用于医院系统读取原来的4428就诊IC卡。
6．脱机读取Memory4442IC卡信息
函数声明
intykt_readopencard4442_local（intoffset,intlength,char*pData,char*pWarnmsg,char*pErrmsg）
用途说明
用于脱机读取当前卡具内的卡片卡号和卡类型，用于安全性要求不高的场合。
参数说明
名称
类型长度
说明
备 注
offset
Int
偏移量
从0开始
length
int
读取字节长度
pData
Char（1024）
读取数据缓冲区
以16进制存储
pWarnmsg
Char（1024）
警告信息
pErrmsg
Char（1024）
错误信息
返回值
0
成功
<>0
错误，详见pErrmsg
说明：
此接口用于医院系统读取原来的4428就诊IC卡。
7．脱机读取磁条卡信息
函数声明
intykt_readmagicopencard_local（char*pRegion,char*pDeptid,char*pDeptKey,unsignedintDelay,unsignedchar*pTrack2Info,unsignedchar*pTrack2Len,unsignedchar*pTrack3Info,unsignedchar*pTrack3Len,char*pWarnmsg,char*pErrmsg）
用途说明
用于脱机读取当前卡具内的卡片卡号和卡类型，用于安全性要求不高的场合。
参数说明
名称
类型长度
说明
备 注
pRegion
Char（4）
地区编号
3500代表省本级
pDeptID
Char（4）
网点编号
医院在医保中心的编号
pDeptKey
Char（512）
网点密钥
暂不使用，医院系统改造时应为可设置参数
Delay
Unsignedint
延迟时间
以秒为单位
pTrack2Info
Char（100）
磁道2信息
pTrack2Len
Char
（1）
磁道2信息长度
pTrack3Info
Char（100）
磁道3信息
pTrack3Len
Char
（1）
磁道3信息长度
pWarnmsg
Char（1024）
警告信息
pErrmsg
Char（1024）
错误信息
返回值
0
成功
<>0
错误，详见pErrmsg
说明：
此接口用于医院系统读取原来的磁条就诊卡（新款YKT读卡器无需调用本接口即可直接刷磁条卡）。
8．关闭读卡器
函数声明
intykt_closedevice（char*pWarnmsg,char*pErrmsg）
用途说明
用于关闭读写卡设备。
参数说明
名称
类型长度
说明
备 注
pWarnmsg
Char（1024）
警告信息
pErrmsg
Char（1024）
错误信息
返回值
0
成功
<>0
错误，详见pErrmsg
二、联机接口
1．登录路由服务
函数声明
intykt_route（char*pListenerIP,char*pListenerPort,char*pRegion,char*pDeptID,char*pDeptKey,char*pUserID,char*pUserPass,char*pServerIPList,char*pServerPortList,char*pWarnmsg,char*pErrmsg）
用途说明
用于取得系统登录服务路由。
参数说明
名称
类型长度
说明
备 注
pListenerIP
Char（16）
公布的路由服务地址
pListenerPort
Char（6）
公布的路由服务端口
pRegion
Char（4）
地区编号
pDeptID
Char（4）
网点编号
pDeptKey
Char（512）
网点密钥
不定时变化，需可设置
pUserID
Char（20）
用户编号
pUserPass
Char（20）
用户密码
pServerIPList
Char（256）
一卡通服务地址列表
以逗号分隔
pServerPortList
Char（256）
一卡通服务端口列表
以逗号分隔
pWarnmsg
Char（1024）
警告信息
如果不为空，前台程序应显示出来
pErrmsg
Char（1024）
错误信息
返回值<>0时有信息
返回值
0
成功
<>0
错误，详见pErrmsg
2．系统登录服务
函数声明
intykt_login（char*pServerIP,char*pServerPort,char*pRegion,char*pDeptID,char*pDeptKey,char*pUserID,char*pUserPass,char*pWarnmsg,char*pErrmsg）
用途说明
用于进行系统登录。
参数说明
名称
类型长度
说明
备 注
pServerIP
Char（16）
一卡通服务地址
pServerPort
Char（6）
一卡通服务端口
pRegion
Char（4）
地区编号
pDeptID
Char（4）
网点编号
pDeptKey
Char（512）
网点密钥
pUserName
Char（20）
用户名
pUserPass
Char（20）
用户密码
pWarnmsg
Char（1024）
警告信息
pErrmsg
Char（1024）
错误信息
返回值
0
成功
<>0
错误，详见pErrmsg
3．退出系统登录服务
函数声明
intykt_logout（char*pWarnmsg,char*pErrmsg）
用途说明
用于退出系统登录状态。
参数说明
名称
类型长度
说明
备 注
pWarnmsg
Char（1024）
警告信息
pErrmsg
Char（1024）
错误信息
返回值
0
成功
<>0
错误，详见pErrmsg
4．联机读取卡号服务
函数声明
intykt_readcardno（char*pRegion,char*pDeptid,char*pDeptKey,char*pCardtype,char*pCardno,char*pWarnmsg,char*pErrmsg）
用途说明
用于联机读取当前卡具内的卡片的卡号及类型。
参数说明
名称
类型长度
说明
备 注
pRegion
Char（4）
地区编号
pDeptID
Char（4）
网点编号
pDeptKey
Char（512）
网点密钥
pCardtype
Char
（2）
卡类型
返回2表示社会保障卡
pCardno
Char（20）
卡号
可包含字母或数字
pWarnmsg
Char（1024）
警告信息
pErrmsg
Char（1024）
错误信息
返回值
0
成功
<>0
错误，详见pErrmsg
5．联机读取公共信息服务
函数声明
intykt_readopencardinfo（char*pRegion,char*pDeptid,char*pDeptKey,char*pIssuedeptid,char*pIssuedate,char*pCardtype,char*pCardno,char*pIdtype,char*pId,char*pName,char*pSex,char*pBirthDate,char*pComany,char*pAddress,char*pTelephone,char*pWarnmsg,char*pErrmsg）
用途说明
用于联机读取当前卡具内的卡片持卡人的公共信息。
参数说明
名称
类型长度
说明
备 注
pRegion
Char（4）
地区编号
pDeptID
Char（4）
网点编号
pDeptKey
Char（512）
网点密钥
pIssuedeptid
Char（24）
发卡机构编号
pIssuedate
Char（8）
发卡日期
pCardtype
Char
（2）
卡类型
返回2表示社会保障卡
pCardno
Char（20）
卡号
可包含字母或数字
pIdtype
Char
（2）
证件类型
01代表身份证
pId
Char（20）
身份证号
15或18位
pName
Char（12）
姓名
pSex
Char
（1）
性别
1男 2女 3未定义
pBirthDate
Char（8）
出生日期
pCompany
Char（70）
单位名称
pAddress
Char（80）
通讯地址
pTelephone
Char（20）
联系电话
pWarnmsg
Char（1024）
警告信息
pErrmsg
Char（1024）
错误信息
返回值
0
成功
<>0
错误，详见pErrmsg
6．联机读取照片信息服务
函数声明
intykt_readcardphoto（char*pRegion,char*pDeptid,char*pDeptKey,char*pPhototype,char*pPhotoFileName,char*pWarnmsg,char*pErrmsg）
用途说明
用于读取持卡人的数字照片（卡必须在卡具内）。
参数说明
名称
类型长度
说明
备 注
pRegion
Char（4）
地区编号
pDeptID
Char（4）
网点编号
pDeptKey
Char（512）
网点密钥
pPhototype
Char（3）
照片类型
pPhotoFileName
Char（100）
照片文件名
pWarnmsg
Char（1024）
警告信息
pErrmsg
Char（1024）
错误信息
返回值
0
成功
<>0
错误，详见pErrmsg
7．持卡人建档服务
函数声明
Intykt_register（char*pRegion,char*pDeptid,char*pDeptKey,char*pCardtype,char*pCardno,char*pDeptID,char*pHisID,char*pWarnmsg,char*pErrmsg）
用途说明
网点完成持卡人的建档工作后，使用本服务提交信息，提交后，方能对持卡人提供挂失、解除挂失等管理服务。
参数说明
名称
类型长度
说明
备 注
pRegion
Char（4）
地区编号
pDeptID
Char（4）
网点编号
pDeptKey
Char（512）
网点密钥
pCardtype
Char
（2）
卡类型
返回2表示社会保障卡
pCardno
Char（20）
卡号
可包含字母或数字
pHisID
Char（20）
持卡人在医院的ID
可包含字母或数字
pWarnmsg
Char（1024）
警告信息
pErrmsg
Char（1024）
错误信息
返回值
0
成功
<>0
错误，详见pErrmsg
8．社保卡挂失申请服务
函数声明
Intykt_loseservice（char*pRegion,char*pDeptid,char*pDeptKey,char*pCardtype,char*pCardno,char*pHisID,char*pServiceID,char*pWarnmsg,char*pErrmsg）
用途说明
用于提交社保卡挂失申请。
参数说明
名称
类型长度
说明
备 注
pRegion
Char（4）
地区编号
pDeptID
Char（4）
网点编号
pDeptKey
Char（512）
网点密钥
pCardtype
Char
（2）
卡类型
返回2表示社会保障卡
pCardno
Char（20）
卡号
可包含字母或数字
pHisID
Char（20）
持卡人在医院的ID
pServiceID
Char（20）
返回的服务号
pWarnmsg
Char（1024）
警告信息
pErrmsg
Char（1024）
错误信息
返回值
0
成功
<>0
错误，详见pErrmsg
9．社保卡解除挂失申请服务
函数声明
intykt_unloseservice（char*pRegion,char*pDeptid,char*pDeptKey,char*pCardtype,char*pCardno,char*pHisID,char*pServiceID,char*pWarnmsg,char*pErrmsg）
用途说明
用于解除社保卡的挂失申请。
参数说明
名称
类型长度
说明
备 注
pRegion
Char（4）
地区编号
pDeptID
Char（4）
网点编号
pDeptKey
Char（512）
网点密钥
pCardtype
Char
（2）
卡类型
返回2表示社会保障卡
pCardno
Char（20）
卡号
可包含字母或数字
pHisID
Char（20）
持卡人在医院的ID
pServiceID
Char（20）
服务号
pWarnmsg
Char（1024）
警告信息
pErrmsg
Char（1024）
错误信息
返回值
0
成功
<>0
错误，详见pErrmsg
10．黑名单下载服务
函数声明
intykt_downloadblack（char*pRegion,char*pDeptid,char*pDeptKey,char*pBeginDate,char*pEndDate,char*pBlackFileName,char*pCount,char*pWarnmsg,char*pErrmsg）
用途说明
用于下载一段时间
升级会员 