福建省社會(huì)保障卡就診一卡通接口

1、福建省社會(huì)保障卡就診一卡通接口(測(cè)試版 )2010-2福建省社會(huì)保障卡一卡通接口（測(cè)試版）對(duì)外服務(wù)接口通過(guò)動(dòng)態(tài)庫(kù) fzyktclient.dll 提供，相關(guān)單位可利用本接口進(jìn)行醫(yī)院系統(tǒng)一卡通改造測(cè)試工作。整套接口包含以下文件，需同時(shí)放在系統(tǒng)路徑目錄下： fzyktclient.dll desalgo.dllfjinterface.dlldcic32.dllposdot.libvcic32.dllylziccard.dll根據(jù)實(shí)際情況，接口有可能調(diào)整，應(yīng)用系統(tǒng)應(yīng)提供升級(jí)的功能，以便自動(dòng)部署新的接口。 接口分為脫機(jī)接口和聯(lián)機(jī)接口兩個(gè)部分， 脫機(jī)接口開(kāi)發(fā)測(cè)試工作現(xiàn)在就可以進(jìn)行， 聯(lián)機(jī)接口先進(jìn)行開(kāi)發(fā)工

2、作， 開(kāi)發(fā)完成后，如需進(jìn)行聯(lián)機(jī)接口調(diào)試，請(qǐng)和省醫(yī)保聯(lián)系具體測(cè)試時(shí)間。一、 脫機(jī)接口初始化讀卡器函數(shù)聲明intykt_opendevice (int nDeviceType,intnCom,int nBaud,char *pRegion,char*pWarnmsg,char *pErrmsg)用途說(shuō)明用于打開(kāi)讀寫(xiě)卡設(shè)備。參數(shù)說(shuō)明名稱類型長(zhǎng)度說(shuō)明備注nDeviceTypeInt設(shè)備類型 (10 或 12)舊款 YKT讀卡器類型為 10，新款為12nComInt端口（ 0-9）0 - com1 1 - com2 第1頁(yè)共10頁(yè)返回值函數(shù)聲明用途說(shuō)明參數(shù)說(shuō)明返回值9 usbnBaudInt波特率（ 1

3、-4）1 - 96002 - 192003 288004 57600建議用 3或者 2pRegionChar(4)地區(qū)編號(hào)3500 代表省本級(jí)pWarnmsgChar(1024)警告信息pErrmsgChar(1024)錯(cuò)誤信息0成功<>0錯(cuò)誤，詳見(jiàn) pErrmsg脫機(jī)讀取卡號(hào)intykt_readopencardno_local (char *pRegion, char *pDeptid,char*pDeptKey,char * pCardtype,char * pCardno, char *pWarnmsg,char *pErrmsg)用于脫機(jī)讀取當(dāng)前卡具內(nèi)的卡片卡號(hào)和卡類型，

4、用于安全性要求不高的場(chǎng)合。名稱類型長(zhǎng)度說(shuō)明備 注pRegionChar(4)地區(qū)編號(hào)3500 代表省本級(jí)pDeptIDChar(4)網(wǎng)點(diǎn)編號(hào)醫(yī)院在醫(yī)保中心的編號(hào)，詳見(jiàn)附表pDeptKeyChar(512)網(wǎng)點(diǎn)密鑰暫不使用，醫(yī)院系統(tǒng)改造時(shí)應(yīng)為可設(shè)置參數(shù)pCardtypeChar(2)卡類型返回 2 表示社會(huì)保障卡pCardnoChar(20)卡號(hào)可包含字母或數(shù)字pWarnmsgChar(1024)警告信息pErrmsgChar(1024)錯(cuò)誤信息0成功<>0錯(cuò)誤，詳見(jiàn) pErrmsg脫機(jī)讀取卡信息函數(shù)聲明intykt_readopencardinfo_local (char *pRe

5、gion, 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)用途說(shuō)明用于脫機(jī)讀取當(dāng)前卡具內(nèi)的卡片卡號(hào)和卡類型，用于安全性要求不高的場(chǎng)合。參數(shù)說(shuō)明名稱類型長(zhǎng)度說(shuō)明備 注pRegionChar(4)地

6、區(qū)編號(hào)3500 代表省本級(jí)pDeptIDChar(4)網(wǎng)點(diǎn)編號(hào)醫(yī)院在醫(yī)保中心的編號(hào)pDeptKeyChar(512)網(wǎng)點(diǎn)密鑰暫不使用，醫(yī)院系統(tǒng)改造時(shí)應(yīng)為可設(shè)置參數(shù)pIssuedeptidChar(24)發(fā)卡機(jī)構(gòu)編號(hào)pIssuedateChar(8)發(fā)卡日期pCardtypeChar(2)卡類型返回 2 表示社會(huì)保障卡pCardnoChar(20)卡號(hào)可包含字母或數(shù)字第2頁(yè)共10頁(yè)pIdtypeChar(2)證件類型01 代表身份證pIdChar(20)身份證號(hào)15或18位pNameChar(12)姓名pSexChar(1)性別1男 2女3 未定義pBirthDateChar(8)出生日期pCo

7、mpanyChar(70)單位名稱pAddressChar(80)通訊地址pTelephoneChar(20)聯(lián)系電話pWarnmsgChar(1024)警告信息pErrmsgChar(1024)錯(cuò)誤信息返回值0成功<>0錯(cuò)誤，詳見(jiàn) pErrmsg說(shuō)明：此接口用于醫(yī)院系統(tǒng)初診注冊(cè)功能的開(kāi)發(fā)測(cè)試，以后聯(lián)機(jī)接口啟用后，應(yīng)使用聯(lián)機(jī)接口。脫機(jī)讀取磁條卡信息函數(shù)聲明intykt_readmagicopencard_local(char*pRegion,char*pDeptid,char*pDeptKey,unsignedint Delay,unsigned char * pTrack2Inf

8、o,unsigned char *pTrack2Len,unsignedchar *pTrack3Info,unsigned char* pTrack3Len,char*pWarnmsg,char *pErrmsg)用途說(shuō)明用于脫機(jī)讀取當(dāng)前卡具內(nèi)的卡片卡號(hào)和卡類型，用于安全性要求不高的場(chǎng)合。參數(shù)說(shuō)明名稱類型長(zhǎng)度說(shuō)明備 注pRegionChar(4)地區(qū)編號(hào)3500 代表省本級(jí)pDeptIDChar(4)網(wǎng)點(diǎn)編號(hào)醫(yī)院在醫(yī)保中心的編號(hào)pDeptKeyChar(512)網(wǎng)點(diǎn)密鑰暫不使用，醫(yī)院系統(tǒng)改造時(shí)應(yīng)為可設(shè)置參數(shù)DelayUnsigned延遲時(shí)間以秒為單位intpTrack2InfoChar(10

9、0)磁道 2信息pTrack2LenChar(1)磁道 2 信息長(zhǎng)度pTrack3InfoChar(100)磁道 3信息pTrack3LenChar(1)磁道 3 信息長(zhǎng)度pWarnmsgChar(1024)警告信息pErrmsgChar(1024)錯(cuò)誤信息返回值0成功<>0錯(cuò)誤，詳見(jiàn) pErrmsg說(shuō)明：此接口用于醫(yī)院系統(tǒng)讀取原來(lái)的磁條就診卡（新款 YKT讀卡器無(wú)需調(diào)用本接口即可直接刷磁條卡）。第3頁(yè)共10頁(yè)脫機(jī)讀取 Memory 4428 IC 卡信息函數(shù)聲明intykt_readopencard4428_local(intoffset,intlength, char *pDa

10、ta,char*pWarnmsg,char *pErrmsg)用途說(shuō)明用于脫機(jī)讀取當(dāng)前卡具內(nèi)的卡片卡號(hào)和卡類型，用于安全性要求不高的場(chǎng)合。參數(shù)說(shuō)明名稱類型長(zhǎng)度說(shuō)明備 注offsetInt偏移量從 0開(kāi)始lengthint讀取字節(jié)長(zhǎng)度pDataChar(1024)讀取數(shù)據(jù)緩沖區(qū)以 16 進(jìn)制存儲(chǔ)pWarnmsgChar(1024)警告信息pErrmsgChar(1024)錯(cuò)誤信息返回值0成功<>0錯(cuò)誤，詳見(jiàn) pErrmsg說(shuō)明：此接口用于醫(yī)院系統(tǒng)讀取原來(lái)的4428 就診 IC 卡。脫機(jī)讀取 Memory 4442 IC 卡信息函數(shù)聲明intykt_readopencard4442_l

11、ocal(intoffset,intlength, char *pData,char*pWarnmsg,char *pErrmsg)用途說(shuō)明用于脫機(jī)讀取當(dāng)前卡具內(nèi)的卡片卡號(hào)和卡類型，用于安全性要求不高的場(chǎng)合。參數(shù)說(shuō)明名稱類型長(zhǎng)度說(shuō)明備 注offsetInt偏移量從 0開(kāi)始lengthint讀取字節(jié)長(zhǎng)度pDataChar(1024)讀取數(shù)據(jù)緩沖區(qū)以 16 進(jìn)制存儲(chǔ)pWarnmsgChar(1024)警告信息pErrmsgChar(1024)錯(cuò)誤信息返回值0成功<>0錯(cuò)誤，詳見(jiàn) pErrmsg說(shuō)明：此接口用于醫(yī)院系統(tǒng)讀取原來(lái)的4428 就診 IC 卡。脫機(jī)讀取磁條卡信息函數(shù)聲明inty

12、kt_readmagicopencard_local(char*pRegion, char *pDeptid,char*pDeptKey,unsignedint Delay,unsigned char*pTrack2Info,unsigned char *pTrack2Len,unsignedchar *pTrack3Info,unsigned char *pTrack3Len,char*pWarnmsg,char *pErrmsg)用途說(shuō)明用于脫機(jī)讀取當(dāng)前卡具內(nèi)的卡片卡號(hào)和卡類型，用于安全性要求不高的場(chǎng)合。參數(shù)說(shuō)明名稱類型長(zhǎng)度說(shuō)明備 注pRegionChar(4)地區(qū)編號(hào)3500 代表省本級(jí)

13、pDeptIDChar(4)網(wǎng)點(diǎn)編號(hào)醫(yī)院在醫(yī)保中心的編號(hào)pDeptKeyChar(512)網(wǎng)點(diǎn)密鑰暫不使用，醫(yī)院系統(tǒng)改造時(shí)應(yīng)為可設(shè)置參數(shù)第4頁(yè)共10頁(yè)DelayUnsigned延遲時(shí)間以秒為單位intpTrack2InfoChar(100)磁道 2信息pTrack2LenChar(1)磁道 2 信息長(zhǎng)度pTrack3InfoChar(100)磁道 3信息pTrack3LenChar(1)磁道 3信息長(zhǎng)度pWarnmsgChar(1024)警告信息pErrmsgChar(1024)錯(cuò)誤信息返回值0成功<>0錯(cuò)誤，詳見(jiàn) pErrmsg說(shuō)明：此接口用于醫(yī)院系統(tǒng)讀取原來(lái)的磁條就診卡（新款

14、YKT讀卡器無(wú)需調(diào)用本接口即可直接刷磁條卡）。關(guān)閉讀卡器函數(shù)聲明intykt_closedevice (char *pWarnmsg,char *pErrmsg)用途說(shuō)明用于關(guān)閉讀寫(xiě)卡設(shè)備。參數(shù)說(shuō)明名稱類型長(zhǎng)度說(shuō)明備注pWarnmsgChar(1024)警告信息pErrmsgChar(1024)錯(cuò)誤信息返回值0成功<>0錯(cuò)誤，詳見(jiàn) pErrmsg二、 聯(lián)機(jī)接口登錄路由服務(wù)intykt_route(char *pListenerIP,char*pListenerPort,char*pRegion,char函數(shù)聲明*pDeptID,char*pDeptKey,char*pUserID,

15、char*pUserPass,char*pServerIPList,char *pServerPortList,char *pWarnmsg,char *pErrmsg)用途說(shuō)明用于取得系統(tǒng)登錄服務(wù)路由。名稱類型長(zhǎng)度說(shuō)明備 注pListenerIPChar(16)公布的路由服務(wù)地址pListenerPortChar(6)公布的路由服務(wù)端口pRegionChar(4)地區(qū)編號(hào)參數(shù)說(shuō)明pDeptIDChar(4)網(wǎng)點(diǎn)編號(hào)pDeptKeyChar(512)網(wǎng)點(diǎn)密鑰不定時(shí)變化，需可設(shè)置pUserIDChar(20)用戶編號(hào)pUserPassChar(20)用戶密碼pServerIPListChar(2

16、56)一卡通服務(wù)地址列表以逗號(hào)分隔pServerPortLiChar(256)一卡通服務(wù)端口列表以逗號(hào)分隔第5頁(yè)共10頁(yè)stpWarnmsgChar(1024)警告信息如果不為空，前臺(tái)程序應(yīng)顯示出來(lái)pErrmsgChar(1024)錯(cuò)誤信息返回值 <>0 時(shí)有信息返回值0成功<>0錯(cuò)誤，詳見(jiàn) pErrmsg系統(tǒng)登錄服務(wù)函數(shù)聲明intykt_login(char*pServerIP,char *pServerPort,char *pRegion,char*pDeptID,char*pDeptKey,char*pUserID,char*pUserPass,char*pWar

17、nmsg,char *pErrmsg)用途說(shuō)明用于進(jìn)行系統(tǒng)登錄。參數(shù)說(shuō)明名稱類型長(zhǎng)度說(shuō)明備 注pServerIPChar(16)一卡通服務(wù)地址pServerPortChar(6)一卡通服務(wù)端口pRegionChar(4)地區(qū)編號(hào)pDeptIDChar(4)網(wǎng)點(diǎn)編號(hào)pDeptKeyChar(512)網(wǎng)點(diǎn)密鑰pUserNameChar(20)用戶名pUserPassChar(20)用戶密碼pWarnmsgChar(1024)警告信息pErrmsgChar(1024)錯(cuò)誤信息返回值0成功<>0錯(cuò)誤，詳見(jiàn) pErrmsg退出系統(tǒng)登錄服務(wù)函數(shù)聲明intykt_logout (char *pW

18、arnmsg,char *pErrmsg)用途說(shuō)明用于退出系統(tǒng)登錄狀態(tài)。參數(shù)說(shuō)明名稱類型長(zhǎng)度說(shuō)明備注pWarnmsgChar(1024)警告信息pErrmsgChar(1024)錯(cuò)誤信息返回值0成功<>0錯(cuò)誤，詳見(jiàn) pErrmsg聯(lián)機(jī)讀取卡號(hào)服務(wù)函數(shù)聲明intykt_readcardno(char*pRegion,char*pDeptid,char*pDeptKey,char*pCardtype,char *pCardno, char *pWarnmsg,char *pErrmsg)用途說(shuō)明用于聯(lián)機(jī)讀取當(dāng)前卡具內(nèi)的卡片的卡號(hào)及類型。參數(shù)說(shuō)明名稱類型長(zhǎng)度說(shuō)明備注pRegionChar

19、(4)地區(qū)編號(hào)pDeptIDChar(4)網(wǎng)點(diǎn)編號(hào)pDeptKeyChar(512)網(wǎng)點(diǎn)密鑰pCardtypeChar(2)卡類型返回 2 表示社會(huì)保障卡第6頁(yè)共10頁(yè)pCardnoChar(20)卡號(hào)可包含字母或數(shù)字pWarnmsgChar(1024)警告信息pErrmsgChar(1024)錯(cuò)誤信息返回值0成功<>0錯(cuò)誤，詳見(jiàn) pErrmsg聯(lián)機(jī)讀取公共信息服務(wù)函數(shù)聲明intykt_readopencardinfo(char*pRegion, char *pDeptid,char*pDeptKey, char*pIssuedeptid,char *pIssuedate, cha

20、r *pCardtype,char *pCardno,char *pIdtype,char *pId,char *pName, char *pSex,char *pBirthDate,char *pComany,char *pAddress,char *pTelephone, char *pWarnmsg,char *pErrmsg)用途說(shuō)明用于聯(lián)機(jī)讀取當(dāng)前卡具內(nèi)的卡片持卡人的公共信息。參數(shù)說(shuō)明名稱類型長(zhǎng)度說(shuō)明備 注pRegionChar(4)地區(qū)編號(hào)pDeptIDChar(4)網(wǎng)點(diǎn)編號(hào)pDeptKeyChar(512)網(wǎng)點(diǎn)密鑰pIssuedeptidChar(24)發(fā)卡機(jī)構(gòu)編號(hào)pIssued

21、ateChar(8)發(fā)卡日期pCardtypeChar(2)卡類型返回 2 表示社會(huì)保障卡pCardnoChar(20)卡號(hào)可包含字母或數(shù)字pIdtypeChar(2)證件類型01 代表身份證pIdChar(20)身份證號(hào)15或18位pNameChar(12)姓名pSexChar(1)性別1男 2女 3 未定義pBirthDateChar(8)出生日期pCompanyChar(70)單位名稱pAddressChar(80)通訊地址pTelephoneChar(20)聯(lián)系電話pWarnmsgChar(1024)警告信息pErrmsgChar(1024)錯(cuò)誤信息返回值0成功<>0錯(cuò)誤，

22、詳見(jiàn) pErrmsg聯(lián)機(jī)讀取照片信息服務(wù)函數(shù)聲明intykt_readcardphoto(char *pRegion,char *pDeptid,char*pDeptKey,char*pPhototype,char *pPhotoFileName, char *pWarnmsg,char *pErrmsg)用途說(shuō)明用于讀取持卡人的數(shù)字照片（卡必須在卡具內(nèi)）。參數(shù)說(shuō)明名稱類型長(zhǎng)度說(shuō)明備注pRegionChar(4)地區(qū)編號(hào)pDeptIDChar(4)網(wǎng)點(diǎn)編號(hào)pDeptKeyChar(512)網(wǎng)點(diǎn)密鑰pPhototypeChar(3)照片類型pPhotoFileNameChar(100)照片文件名

23、第7頁(yè)共10頁(yè)pWarnmsgChar(1024)警告信息pErrmsgChar(1024)錯(cuò)誤信息返回值0成功<>0錯(cuò)誤，詳見(jiàn) pErrmsg持卡人建檔服務(wù)函數(shù)聲明Intykt_register (char*pRegion, char*pDeptid,char *pDeptKey,char*pCardtype,char*pCardno,char *pDeptID,char*pHisID, char *pWarnmsg,char*pErrmsg)用途說(shuō)明網(wǎng)點(diǎn)完成持卡人的建檔工作后，使用本服務(wù)提交信息，提交后，方能對(duì)持卡人提供掛失、解除掛失等管理服務(wù)。參數(shù)說(shuō)明名稱類型長(zhǎng)度說(shuō)明備 注p

24、RegionChar(4)地區(qū)編號(hào)pDeptIDChar(4)網(wǎng)點(diǎn)編號(hào)pDeptKeyChar(512)網(wǎng)點(diǎn)密鑰pCardtypeChar(2)卡類型返回 2 表示社會(huì)保障卡pCardnoChar(20)卡號(hào)可包含字母或數(shù)字pHisIDChar(20)持卡人在醫(yī)院的ID可包含字母或數(shù)字pWarnmsgChar(1024)警告信息pErrmsgChar(1024)錯(cuò)誤信息返回值0成功<>0錯(cuò)誤，詳見(jiàn) pErrmsg社?？⊕焓暾?qǐng)服務(wù)函數(shù)聲明Intykt_loseservice(char*pRegion,char*pDeptid,char*pDeptKey,char*pCardtype

25、,char *pCardno,char *pHisID, char *pServiceID,char *pWarnmsg,char *pErrmsg)用途說(shuō)明用于提交社?？⊕焓暾?qǐng)。參數(shù)說(shuō)明名稱類型長(zhǎng)度說(shuō)明備注pRegionChar(4)地區(qū)編號(hào)pDeptIDChar(4)網(wǎng)點(diǎn)編號(hào)pDeptKeyChar(512)網(wǎng)點(diǎn)密鑰pCardtypeChar(2)卡類型返回 2 表示社會(huì)保障卡pCardnoChar(20)卡號(hào)可包含字母或數(shù)字pHisIDChar(20)持卡人在醫(yī)院的IDpServiceIDChar(20)返回的服務(wù)號(hào)pWarnmsgChar(1024)警告信息pErrmsgChar(1024)錯(cuò)誤信息返回值0成功<>0錯(cuò)誤，詳見(jiàn) pErrmsg社?？ń獬龗焓暾?qǐng)服務(wù)函數(shù)聲明intykt_unloseservice(char*pRegion,char*pDeptid,char*pDeptKey,char第8頁(yè)共10頁(yè)*pCardtype,char *pCardno,char *pHisID, char *pServiceID,char *pWarnmsg,char*pErrmsg)用途說(shuō)明用于解除社保卡的掛失申請(qǐng)。參數(shù)說(shuō)明名稱類型長(zhǎng)度說(shuō)明備 注pRegionChar(4)地區(qū)編號(hào)pDeptIDChar(4)網(wǎng)點(diǎn)編號(hào)pDeptKeyChar(512)網(wǎng)點(diǎn)密鑰p