四川省居民健康卡

U!川省居民健康卡

應(yīng)用接口規(guī)范

(V1.0)

四川省衛(wèi)生信息中心

2014年09月

為了使各市州發(fā)放的居民健康卡在四川省能夠跨地區(qū)、跨機(jī)構(gòu)正常使

用，依據(jù)國家衛(wèi)生計(jì)生委相關(guān)標(biāo)準(zhǔn)和規(guī)范制定本應(yīng)用接口規(guī)范。

本規(guī)范基于符合規(guī)范的設(shè)備（讀寫機(jī)具、SAM卡、居民健康卡）以及

《居民健康卡應(yīng)用規(guī)范》中定義的居民健康卡特定數(shù)據(jù)項(xiàng)，依據(jù)居民健康

卡在醫(yī)療衛(wèi)生行業(yè)中的業(yè)務(wù)應(yīng)用，以及居民健康卡管理流程等要求，描述

定義所需接口函數(shù)、參數(shù)數(shù)據(jù)類型、以及接口的調(diào)用方式。

各級醫(yī)療衛(wèi)生機(jī)構(gòu)應(yīng)當(dāng)嚴(yán)格遵循本規(guī)范，結(jié)合自己的業(yè)務(wù)流程，協(xié)調(diào)

本機(jī)構(gòu)的業(yè)務(wù)管理信息系統(tǒng)開發(fā)商進(jìn)行軟件功能調(diào)整和改造，實(shí)現(xiàn)居民健

康卡在機(jī)構(gòu)內(nèi)的讀寫、應(yīng)用和與市級居民健康卡注冊管理系統(tǒng)的數(shù)據(jù)傳輸。

不得任意修改本規(guī)范，影響居民健康卡的全國通用。

本規(guī)范的適用對象為，全省各醫(yī)療衛(wèi)生機(jī)構(gòu)業(yè)務(wù)系統(tǒng)提供商、全省各

市州、各級醫(yī)療機(jī)構(gòu)居民健康卡注冊管理系統(tǒng)提供商的管理人員、開發(fā)人

員、維護(hù)人員。

技術(shù)咨詢電話：劉仁/p>

省衛(wèi)生信息中心/p>

四川省居民健康卡應(yīng)用接口規(guī)范(VI.0)

歷史修訂記錄

編號修訂日期版本號修訂人說明

012013.07.100.8初稿

022014.01.030.9針對BS方式獲取數(shù)據(jù)項(xiàng)修訂

032014.06.011.0增加JSon數(shù)據(jù)獲取與發(fā)送存方式與五合

一讀卡器支持

042014.7.141.0表里標(biāo)注了必填與可選；增加了斷網(wǎng)說明；

增加了認(rèn)證說明

四川省居民健康卡應(yīng)用接口規(guī)范（VI.0）

目錄

1.前言.................................................................................1

2.應(yīng)用背景.............................................................................1

2.1.概述........................................................................1

2.2.適用范圍.....................................................................1

2.3.適用對象.....................................................................1

3.術(shù)語及參考資料......................................................................2

3.1.專業(yè)術(shù)語.....................................................................2

3.2.參考資料.....................................................................2

4.應(yīng)用模型.............................................................................3

5,實(shí)現(xiàn)原理.............................................................................4

6.實(shí)現(xiàn)方式.............................................................................5

7.接口方式描述.........................................................................5

8.接口函數(shù)列表.........................................................................5

9.接口函數(shù)描述.........................................................................6

9.1.初始化函數(shù)描述...............................................................6

9.2.取消初始化函數(shù)描述...........................................................7

9.3.居民健康卡讀寫操作描述.......................................................7

9.3.1.讀卡操作描述..................................................................................................................................7

9.3.2.寫卡操作描述..................................................................................................................................8

9.4.居民身份證讀取操作（具有身份證讀取功能的設(shè)備使用）..........................9

9.5.磁條讀取操作（具有磁條卡讀取功能的設(shè)備使用）................................10

9.6.液晶屏顯示操作（具有顯示屏的設(shè)備使用）......................................11

9.7.語音播報(bào)操作（具有語音播報(bào)的設(shè)備使用）......................................12

10.交互數(shù)據(jù)項(xiàng).........................................................................12

10.1.函數(shù)返回信息................................................................12

10.2.服務(wù)器連接基本數(shù)據(jù)項(xiàng)........................................................12

10.3.居民健康卡基本信息數(shù)據(jù)項(xiàng)....................................................13

10.4.持卡人基本信息數(shù)據(jù)項(xiàng)........................................................13

10.5.照片流信息數(shù)據(jù)項(xiàng)............................................................13

10.6.照片地址信息數(shù)據(jù)項(xiàng)..........................................................13

10.7.持卡人支付信息數(shù)據(jù)項(xiàng)........................................................13

10.8.持卡人地址數(shù)據(jù)項(xiàng)............................................................14

10.9.聯(lián)系人信息數(shù)據(jù)項(xiàng)............................................................14

10.10.職業(yè)婚姻數(shù)據(jù)項(xiàng)..............................................................14

10.11.醫(yī)學(xué)標(biāo)志信息數(shù)據(jù)項(xiàng)..........................................................14

10.12.精神病標(biāo)志數(shù)據(jù)項(xiàng)............................................................15

10.13.證件信息數(shù)據(jù)項(xiàng)..............................................................15

四川省居民健康卡應(yīng)用接口規(guī)范(VI.0)

10.14.過敏信息數(shù)據(jù)項(xiàng)..............................................................15

10.15.免疫接種數(shù)據(jù)項(xiàng)..............................................................15

10.16.住院有效標(biāo)識數(shù)據(jù)項(xiàng)..........................................................16

10.17.住院信息數(shù)據(jù)項(xiàng)..............................................................16

10.18.門診有效標(biāo)識數(shù)據(jù)項(xiàng)..........................................................20

10.19.門診信息數(shù)據(jù)項(xiàng)..............................................................21

10.20.身份證信息數(shù)據(jù)項(xiàng)............................................................26

11.數(shù)據(jù)字典...................................................................26

11.1.居民健康卡數(shù)據(jù)項(xiàng)對應(yīng)表......................................................26

11.2.語音數(shù)據(jù)對應(yīng)表..............................................................27

11.3.居民健康卡類別(居民健康卡技術(shù)規(guī)范).......................................27

11.4.性別(GB/T2261.1)............................................................................................................................28

11.5.民族(GB/T3304)..............................................................................................................................28

11.6.出生日期....................................................................29

11.7.本人電話....................................................................29

11.8.醫(yī)療費(fèi)用支付方式(CV07.10.003)...............................................................................................30

11.9.ABO血型(CV04.50.005)...............................................................................................................30

11.10.RH血型代碼(健康卡技術(shù)規(guī)范)..............................................30

11.11.身份證件類別(CV02.0L101)..............................................................................................................31

11.12.婚姻狀況(GB/T2261.2).......................................................................................................................31

11.13.與持卡人的關(guān)系(GB/T4761)........................................................................................................31

11.14.文化程度(GB/T4658).......................................................................................................................32

11.15.藥物劑型代碼(CV08.50.002)..............................................................................................................32

11.16.用藥途徑代碼(CV06.00.102)..............................................................................................................34

11.17.門診費(fèi)用分類代碼(CV07.10.001)......................................................................................................35

11.18.出院診斷-主要診斷入院病情代碼(CV05.01.100)..........................................................................35

11.19.血清學(xué)檢查項(xiàng)目代碼(CV04.50.000).................................................................................................36

11.20.診斷符合情況代碼(CV05.10.100)......................................................................................................36

11.21.疾病診斷類別代碼(CV05.0L101).....................................................................................................36

11.22.病情轉(zhuǎn)歸代碼(CV05.10.010)..............................................................................................................37

11.23.麻醉方法代碼(CV06.00.103)..............................................................................................................37

11.24.手術(shù)切口愈合等級代碼(CV05.10.023).............................................................................................38

11.25.住院期間輸血品種代碼(CV08.50.004).............................................................................................38

11.26.住院費(fèi)用類別代碼(CV07.10.002)......................................................................................................39

四川省居民健康卡應(yīng)用接口規(guī)范(VL0)

1.前言

本規(guī)范涉及的數(shù)據(jù)項(xiàng)定義、命令數(shù)據(jù)符合衛(wèi)計(jì)委定義的居民健康卡系列規(guī)范。

本規(guī)范涉及的密碼算法按照國家密碼管理部門的要求使用。

本規(guī)范依據(jù)《居民健康卡技術(shù)規(guī)范》、《居民健康卡應(yīng)用規(guī)范》、《居民健康卡安全存取模塊

(SAM)卡規(guī)范》、《居民健康卡用戶卡命令集》，結(jié)合醫(yī)療服務(wù)和用戶管理業(yè)務(wù)流程，描述定義

居民健康卡中數(shù)據(jù)存取訪問接口。

2.應(yīng)用背景

2.1.概述

四川省居民健康卡注冊管理系統(tǒng)(以下簡稱卡管系統(tǒng))是在國家衛(wèi)計(jì)委關(guān)心和指導(dǎo)、四

川省人民政府領(lǐng)導(dǎo)和監(jiān)督下，遵循衛(wèi)計(jì)委關(guān)于居民健康卡相關(guān)規(guī)范基礎(chǔ)上，由四川省衛(wèi)生廳主

持建設(shè)的一個綜合信息系統(tǒng)。

在各市、州及部署大型醫(yī)療機(jī)構(gòu)建立自己的卡管系統(tǒng)并發(fā)卡后，為了使各地發(fā)放的居民健

康卡在四川省內(nèi)所有醫(yī)療衛(wèi)生機(jī)構(gòu)中正常使用，制定四川省居民健康卡應(yīng)用接口規(guī)范，通過統(tǒng)

一的接口標(biāo)準(zhǔn)來規(guī)范全省居民健康卡醫(yī)療數(shù)據(jù)的讀寫。

2.2.適用范圍

本文確定居民健康卡中數(shù)據(jù)存取的應(yīng)用編程接口?；诜弦?guī)范的設(shè)備(讀寫機(jī)具、SAM

卡、居民健康卡)以及《居民健康卡應(yīng)用規(guī)范》中的定義的居民健康卡特定數(shù)據(jù)項(xiàng)，依據(jù)居民

健康卡在醫(yī)療衛(wèi)生行業(yè)中的業(yè)務(wù)應(yīng)用，以及居民健康卡管理流程等要求，描述定義所需接口函

數(shù)、參數(shù)數(shù)據(jù)類型以及接口的調(diào)用方式。

2.3.適用對象

本規(guī)范的預(yù)期讀者為全省各醫(yī)療衛(wèi)生機(jī)構(gòu)業(yè)務(wù)系統(tǒng)提供商，全省各市、州及部署大型醫(yī)療

機(jī)構(gòu)居民健康卡注冊管理系統(tǒng)提供商的管理人員、開發(fā)人員、維護(hù)人員。

1

四川省居民健康卡應(yīng)用接口規(guī)范(VI.0)

3.術(shù)語及參考資料

3.1.專業(yè)術(shù)語

居民健康卡ResidentsHealthCard

居民健康卡是中華人民共和國居民擁有的，在醫(yī)療衛(wèi)生服務(wù)活動中用于身份識別，滿足健

康信息存儲，實(shí)現(xiàn)跨地區(qū)和跨機(jī)構(gòu)就醫(yī)、數(shù)據(jù)交換和費(fèi)用結(jié)算的基礎(chǔ)載體，是計(jì)算機(jī)可識別的

CPU卡。

CPU卡

帶有中央處理器(CPU)、存儲單元以及卡片操作系統(tǒng)的集成電路卡。

卡片操作系統(tǒng)(COS)CardOperatingSystem

CPU卡芯片中存儲和運(yùn)行的，以保護(hù)應(yīng)用數(shù)據(jù)和程序的機(jī)密性和完整性，控制CPU卡芯

片與外界信息交換為目的的嵌入式軟件。

加密算法CryptographicAlgorithm

為了隱藏或顯現(xiàn)數(shù)據(jù)信息內(nèi)容的變換算法。

3.2.參考資料

《居民健康卡技術(shù)規(guī)范》

《居民健康卡應(yīng)用規(guī)范》

《居民健康卡安全存取模塊(SAM)卡技術(shù)規(guī)范》

《居民健康卡用戶卡命令集》

2

四川省居民健康卡應(yīng)用接口規(guī)范(VL0)

4.應(yīng)用模型

,4

/用戶k

SAM卡

卡基本信息用戶個人信息

用戶但戰(zhàn)后息

公私鑰對用戶住靛信息

算法服務(wù)用戶門論佶息

根據(jù)居民健康卡應(yīng)用規(guī)范，卡中存放了卡片基本信息、用戶個人基本信息、聯(lián)系人信息、

醫(yī)學(xué)警示生物標(biāo)識信息、住院信息、門診記錄信息以及相應(yīng)的證書簽名信息?？偣灿涗浀臄?shù)據(jù)

項(xiàng)有380多個類別，這些數(shù)據(jù)項(xiàng)分布在卡中不同目錄下的不同文件中。卡中不同的數(shù)據(jù)文件，

根據(jù)其存放數(shù)據(jù)的不同，具有不同的讀寫權(quán)限。具體請參見《居民健康卡安全存取模塊(SAM)

卡技術(shù)規(guī)范》附錄表A4密鑰配置表。

要讀寫居民健康卡，需要使用符合衛(wèi)計(jì)委相關(guān)規(guī)范的讀寫機(jī)具和SAM卡來完成讀寫數(shù)據(jù)

所需要的權(quán)限控制。在讀取特定數(shù)據(jù)前，需要根據(jù)其所在文件不同，依據(jù)密鑰配置表去獲取外

部認(rèn)證所需要的密鑰標(biāo)識用途、密鑰版本等信息，然后通過發(fā)送指令到SAM卡進(jìn)行密鑰分散,

使用SM1算法加密數(shù)據(jù)取得SAM卡計(jì)算外部認(rèn)證需要的認(rèn)證數(shù)據(jù)，再發(fā)送給用戶卡完成外

部認(rèn)證以取得相應(yīng)的權(quán)限，再根據(jù)所讀取的字段所在文件、記錄號等信息進(jìn)行數(shù)據(jù)讀寫。

為了簡化上層應(yīng)用的開發(fā)，讀寫接口將這一過程進(jìn)行了封裝，應(yīng)用開發(fā)者只需要通過接口

規(guī)范提供的讀寫函數(shù)，設(shè)置所需讀寫居民健康卡中的單個或多個數(shù)據(jù)項(xiàng)，就可以完成數(shù)據(jù)的讀

寫操作。這樣應(yīng)用層就可以不需要關(guān)心讀寫機(jī)具、用戶卡、SAM卡之間的交互，只需要針對

所需要數(shù)據(jù)完成業(yè)務(wù)流程的設(shè)計(jì)開發(fā)。

3

四川省居民健康卡應(yīng)用接口規(guī)范(VI.0)

5.實(shí)現(xiàn)原理

1.醫(yī)療衛(wèi)生機(jī)構(gòu)業(yè)務(wù)系統(tǒng)調(diào)用接口讀取居民健康卡信息；

2.居民健康卡接口讀取居民健康卡信息后，調(diào)用卡管系統(tǒng)接口服務(wù)，包括用戶卡的黑名

單驗(yàn)證、SAM卡的黑名單驗(yàn)證、用卡記錄等；

3.居民健康卡在醫(yī)療衛(wèi)生機(jī)構(gòu)一卡通中的注冊、使用等

網(wǎng)格架構(gòu)如下(以HIS系統(tǒng)為例):

4

四川省居民健康卡應(yīng)用接口規(guī)范(VL0)

6.實(shí)現(xiàn)方式

1、醫(yī)療衛(wèi)生機(jī)構(gòu)業(yè)務(wù)系統(tǒng)向應(yīng)用接口發(fā)出讀卡、寫卡命令

2、應(yīng)用接口讀取居民健康卡與SAM卡識別標(biāo)識

3、應(yīng)用接口自動向卡管平臺接口服務(wù)發(fā)送識別標(biāo)識

4、應(yīng)用服務(wù)器通過連接池進(jìn)行居民健康卡與SAM卡黑名單檢查

5、校檢通過后應(yīng)用接口根據(jù)要求讀取居民健康卡數(shù)據(jù)信息，未通過終止操作，并顯示終

止原因。

6、讀取完成后自動記錄居民健康卡與SAM卡使用記錄。

7.接口方式描述

為統(tǒng)一和便于各個應(yīng)用開發(fā)商的軟件和數(shù)據(jù)接入，我們采用標(biāo)準(zhǔn)的DLL作為接口程序載

體，以COM對象的函數(shù)和屬性形式提供對各種數(shù)據(jù)的操作和讀取。

在收到醫(yī)療端接口定義后請先對DLL進(jìn)行RegSvr32動態(tài)庫注冊，如：

regsvr32HealthCardlntf.dll

注冊成功后將會加載HealthCardlntf控件。

classid=nclsid:EA3386EE-2321-4761-A4C5-720202D88D44no

8.接口函數(shù)列表

函數(shù)名功能備注

連接讀卡器時的首步操作，只

InitlntfTS接口初始化有此函數(shù)調(diào)用成功后，才能繼

續(xù)以下的函數(shù)操作

Unlnitlntf接口取消初始化斷開讀卡器與電腦的連接

ReadHealthlnfo獲取居民健康卡信息獲取持卡的卡片基本信息

WriteHealthlnfo寫入居民健康卡信息寫入持卡的人員基本信息

Readldcardlnfo讀取人員身份證讀取人員身份證

ReadMagStlnfo讀取持卡人磁條讀取持卡人磁條

Displayinfo液晶屏顯示液晶屏顯示

DispSound播放已存在的語音數(shù)據(jù)播放已存在的語音數(shù)據(jù)

5

四川省居民健康卡應(yīng)用接口規(guī)范（VL0）

9.接口函數(shù)描述

>總體業(yè)務(wù)操作步驟：

1、接口初始化連接設(shè)備；

2、調(diào)用讀卡函數(shù)讀取想要的數(shù)據(jù)項(xiàng)；

3、根據(jù)要求寫數(shù)據(jù)項(xiàng)；

4、相關(guān)設(shè)備的其它操作（讀身份證、磁條卡等，語音及顯示功能等）

5、斷開設(shè)備連接

本接口支持多種開發(fā)語言接入（如.NET、JAVA、PB、Delphi、VB等等HIS開發(fā)語言）,

其函數(shù)的調(diào)用等操作方式統(tǒng)一，數(shù)據(jù)傳輸統(tǒng)一采用JSON格式。

9.1.初始化函數(shù)描述

>函數(shù)說明：

連接讀卡器時的首步操作，只有此函數(shù)調(diào)用成功后，才能繼續(xù)以下的函數(shù)操作。

>函數(shù)描述：

初始化成功后，多次進(jìn)行讀、寫卡操作無需再次初始化，只有當(dāng)設(shè)備連接斷開或是調(diào)

用了取消初始化操作后，需再次進(jìn)行初始化連接；

>函數(shù)定義：

functionInitlntfTS（InitStr:BSTR）:int;

>傳入?yún)?shù)：

以JSon格式傳遞傳入的數(shù)據(jù)值。

AReaderType:

0：華大讀卡器；

1：同方讀卡器；

2:德卡讀卡器；

3：四川省專用華大五合一讀卡器

4:四川省專用德卡五合一讀卡器

>返回值。

1:正常

0：失敗，調(diào)用PropertyStr（10.1函數(shù)返回信息），以JSON方式獲取錯誤信息。

>例：

傳入?yún)?shù)見10.2服務(wù)器連接基本信息。

（

"AReaderType":"3",

"Loginfo":

{

"ServerIP":"",

"ServerPort":"211",

"UserCode":

6

四川省居民健康卡應(yīng)用接口規(guī)范(VI.0)

"UserPass":""

}

}

執(zhí)行成功，返回值1；

執(zhí)行失敗，返回值0。調(diào)用PropertyStr(10.1函數(shù)返回信息)，以JS0N方式獲取錯

誤信息。

(

"error":"讀卡器開啟失敗”

9.2.取消初始化函數(shù)描述

>函數(shù)說明：

完成讀卡操作的，調(diào)用此函數(shù)斷開讀卡器與電腦的連接。

>函數(shù)定義：

procedureUnlnitlntf;

>傳入?yún)?shù)：

無

>傳出參數(shù)：

無。

9.3.居民健康卡讀寫操作描述

>函數(shù)描述：

在讀、寫卡之前，接口會自動向初始化時傳入的服務(wù)器IP地址與端口號相對應(yīng)的服

務(wù)中心發(fā)起卡認(rèn)證(即卡黑名單等相關(guān)認(rèn)證)，認(rèn)證未通過的卡不能進(jìn)行下一步操作。注

意：初即化時未傳入認(rèn)證服務(wù)器的IP或端口號，將不進(jìn)行認(rèn)證操作，只能完成當(dāng)前卡的

讀、寫操作；

同時也支持?jǐn)嗑W(wǎng)模式，在斷網(wǎng)后，接口會提示此操作未經(jīng)過中心認(rèn)證，需要當(dāng)前業(yè)務(wù)

操作員加強(qiáng)人工認(rèn)證，只能完成當(dāng)前卡的讀、寫操作；

9.3.1.讀卡操作描述

>函數(shù)說明：

讀取持卡人居民健康卡卡內(nèi)數(shù)據(jù)信息說明。

>函數(shù)定義：

functionReadHealthlnfo(InfoNo:int):int;

>傳入?yún)?shù)

卡內(nèi)數(shù)據(jù)項(xiàng)對應(yīng)累計(jì)值(見11.Do

7

四川省居民健康卡應(yīng)用接口規(guī)范（VI.0）

>返回值

1：正常，調(diào)用PropertyStr（10.1函數(shù)返回信息），以JS0N方式獲取相卡內(nèi)數(shù)據(jù)

信息

0：失敗，調(diào)用PropertyStr（10.1函數(shù)返回信息），以JS0N方式獲取錯誤信息。

>說明：

卡內(nèi)數(shù)據(jù)項(xiàng)對應(yīng)表見1L1。獲取持卡人基本信息與持卡人支付信息,對應(yīng)值:6（2+4）。

>照片信息提供兩種數(shù)據(jù)交互方式。

1、以Base64編碼方式進(jìn)行數(shù)據(jù)交互；

2、以文件方式進(jìn)行數(shù)據(jù)交互，文件地址為DLL文件所在地址。如：

"D:\\123WZP.JPG",分隔符以“\\”顯示。

>例：

（

“PsnBaselnfo”:

（

“PsnName":"張三"，

〃PnsnG八en〃:〃1〃,

"NationCode":"1",

"BirthDay":"19800302”,

"PsnlD":

},

“PayTypelnfo”:

（

"ValidDate":"20250403〃，

〃PhoneNol〃：，

〃PhoneNo2〃：〃〃，

〃PayTypel〃：〃01〃，

〃PayType2〃：〃02〃，

〃CPaylType3C〃:〃〃

函數(shù)成功，返回值1。調(diào)用PropertyStr（10.1函數(shù)返回信息），以JS0N方式讀取信

息（數(shù)據(jù)項(xiàng)見10.交互數(shù)據(jù)項(xiàng)描述）。

函數(shù)失敗，返回值0,調(diào)用PropertyStr（10.1函數(shù)返回信息），以JS0N方式獲取錯

誤信息。

（

"error":"讀卡器開啟失敗”

）

9.3.2.寫卡操作描述

>函數(shù)說明：

讀取持卡人居民健康卡卡內(nèi)數(shù)據(jù)信息說明。

8

四川省居民健康卡應(yīng)用接口規(guī)范（VI.0）

>函數(shù)定義：

functionWriteHealthlnfo（InfoStr:BSTR）:int;

A傳入?yún)?shù)

以JSon格式傳遞傳入的數(shù)據(jù)值。

>傳出參數(shù)

以JSon格式返回執(zhí)行結(jié)果。正常：返回值1；失?。悍祷刂??調(diào)用PropertyStr

返回錯誤原因（10.1函數(shù)返回信息）。

>說明：

照片信息提供兩種數(shù)據(jù)交互方式：

1、以Base64編碼方式進(jìn)行數(shù)據(jù)交互；

2、以文件方式進(jìn)行數(shù)據(jù)交互。

>例：

傳入數(shù)據(jù)信息（空值寫入時自動跳過，不予改寫）。

（

〃Marrylnfo〃：

]

，zMarrylnfo〃：〃1〃，

/71r〃〃〃

Marry:,

〃Job〃：〃〃

},

z，PayTypeInfo，z:

]

〃ValidDate〃：〃〃，

〃PhoneNol〃：〃〃，

〃PhoneNo2〃：〃〃，

〃PayTypel〃：〃03〃，

〃PayType2〃：〃02〃，

〃PCaylType3C〃:〃〃

函數(shù)執(zhí)行成功，返回值1。

函數(shù)執(zhí)行失敗，返回錯誤信息。

"error":"讀卡器開啟失敗”

9.4.居民身份證讀取操作（具有身份證讀取功能的設(shè)備使用）

>函數(shù)說明：

讀取人員身份證信息。

>函數(shù)定義：

functionReadldcardlnfo:int;

9

四川省居民健康卡應(yīng)用接口規(guī)范(VI.0)

>傳入?yún)?shù)

無。

>返回值

1:正常，調(diào)用PropertyStr以JS0N方式獲取相卡內(nèi)數(shù)據(jù)信息

0:失敗，調(diào)用PropertyStr以JS0N方式獲取錯誤信息。

A說明：

函數(shù)成功，返回讀取身份證信息(數(shù)據(jù)項(xiàng)見10.19身份證信息數(shù)據(jù)項(xiàng))。身份證中照

片信息提供兩種數(shù)據(jù)交互方式。

1、以Base64編碼方式進(jìn)行數(shù)據(jù)交互；

2、以文件方式進(jìn)行數(shù)據(jù)交互，文件地址為DLL文件所在地址。如：

"D:\\123WZP.JPG”,分隔符以“\\”顯示。

>例：

以下示例照片數(shù)據(jù)以路徑方式提供

(

"IDCardlnfo”:{

“PsnName":〃張三”,

rsnSex:1,

"Nation":"01",

"BirthDay":"20130203”,

"Address":"四川省成都市綿江區(qū)XX街道”，

"CardNo":,

"IssuedAt":"四川省成都市綿江區(qū)公安分區(qū)”，

"ValidBegin":"20130301”,

"ValidEnd":"20330301"

“PhotoFile"："D:\\idcard\\zp.jpg”

)

)

函數(shù)失敗，返回錯誤信息。

]

"error":"讀卡器開啟失敗”

9.5.磁條讀取操作(具有磁條卡讀取功能的設(shè)備使用)

>函數(shù)說明：

讀取持卡人磁條內(nèi)數(shù)據(jù)信息說明。

>函數(shù)定義：

functionReadMagStlnfo(InfoNo:int):int;

A傳入?yún)?shù)

磁條磁道號(1-3),實(shí)際情況與讀卡器安裝磁頭個數(shù)有關(guān)。

>返回值

1:正常。

0：失敗，調(diào)用PropertyStr以JSON方式獲取錯誤信息。

10

四川省居民健康卡應(yīng)用接口規(guī)范(VI.0)

>例：

函數(shù)成功，返回1。因各磁條中存儲信息格式不同，需要自行對獲取數(shù)據(jù)進(jìn)行截取。

{

"Mag":,

)

函數(shù)失敗，返回0,以JSON顯示錯誤信息。

(

"error":"錯誤原因"

9.6.液晶屏顯示操作(具有顯示屏的設(shè)備使用)

>函數(shù)說明：

通過液晶屏顯示內(nèi)容信息。

>函數(shù)定義：

functionDisplayinfo(InfoStr:BSTR):int;

A傳入?yún)?shù)

以JSon格式傳遞傳入的數(shù)據(jù)值。

>返回值

1:正常。

0：失敗，調(diào)用PropertyStr以JSON方式獲取錯誤信息。

>說明：

共計(jì)允許顯示共4行數(shù)據(jù)(行號：1-4)。

每行共允許顯示10個字符。

傳入數(shù)數(shù)據(jù)允許插入空格。

OperNo:1為顯示。

OperNo:0為清屏。

>例：

顯示數(shù)據(jù)信息(傳入)。

(

"OperNo":"1",

"DipDatal":"四川省"，

"DipData2":"衛(wèi)生廳”，

"DipData3":"四川省”，

"DipData4":"衛(wèi)生廳"

顯示清屏

(

“OperNo":"0"

函數(shù)執(zhí)行成功，返回1

11

四川省居民健康卡應(yīng)用接口規(guī)范（VI.0）

函數(shù)執(zhí)行失敗，返回0,調(diào)用PropertyStr以JS0N方式顯示錯誤信息。

（

"error":"錯誤原因"

）

9.7.語音播報(bào)操作（具有語音播報(bào)的設(shè)備使用）

>函數(shù)說明：

播放已存在的語音數(shù)據(jù)。

>函數(shù)定義：

procedureDispSound（InfoNo:int）:int;

>傳入?yún)?shù)

語音數(shù)據(jù)項(xiàng)對應(yīng)表（見H.2）。

>返回值

1:正常。

0：失敗，調(diào)用PropertyStr以JS0N方式獲取錯誤信息。

>例：

函數(shù)執(zhí)行成功，返回1

函數(shù)執(zhí)行失敗，返回0,調(diào)用PropertyStr以JSON方式顯示錯誤信息。

（

"error":"錯誤原因"

}

10.交互數(shù)據(jù)項(xiàng)

10.1.函數(shù)返回信息

屬性說明：

當(dāng)在調(diào)用接口中函數(shù)后，調(diào)用此函數(shù)獲取調(diào)用函數(shù)后的返回信息。

屬性定義：

propertyPropertyStr:BSTR;

10.2.服務(wù)器連接基本數(shù)據(jù)項(xiàng)

對象名順序?qū)傩悦f明描述

1ServerIP服務(wù)器IP

Loginfo2ServerPort服務(wù)器端口

3UserCode用戶編號

12

四川省居民健康卡應(yīng)用接口規(guī)范(VLO)

4UserPass用戶口令

10.3.居民健康卡基本信息數(shù)據(jù)項(xiàng)

對象名順序?qū)傩悦f明描述

1CardTyp卡的類別只讀

2StdVer規(guī)范版本只讀

3OrgName發(fā)卡機(jī)構(gòu)名稱只讀

4OrgCode發(fā)卡機(jī)構(gòu)代碼只讀

Cardinfo5PublishDT發(fā)卡時間只讀

6CardNo卡號只讀

7CardID發(fā)卡序列號只讀

8CityNo應(yīng)用城市代碼只讀

9CityName應(yīng)用城市名稱只讀

10.4.持卡人基本信息數(shù)據(jù)項(xiàng)

對象名順序?qū)傩悦f明描述

1PsnName姓名只讀

2PsnGen性別只讀

PsnBaselnfo3NationCode民族代碼只讀

4BirthDay出生日期只讀

5PsnID身份證號碼只讀

10.5.照片流信息數(shù)據(jù)項(xiàng)

對象名順序?qū)傩悦f明描述

1PhotoStr照片數(shù)據(jù)可選

PhotoInfo

10.6.照片地址信息數(shù)據(jù)項(xiàng)

對象名順序?qū)傩悦f明描述

1PhotoAdd照片地址可選

PhotoFileinfo

10.7.持卡人支付信息數(shù)據(jù)項(xiàng)

對象名順序?qū)傩悦f明描述

PayTypelnfo1ValidDate卡有效期只讀

13

四川省居民健康卡應(yīng)用接口規(guī)范(VLO)

2PhoneNol本人電話1必填

3PhoneNo2本人電話2可選

4PayTypel醫(yī)療費(fèi)用支付方式1必填

5PayType2醫(yī)療費(fèi)用支付方式2可選

6PayType3醫(yī)療費(fèi)用支付方式3可選

10.8.持卡人地址數(shù)據(jù)項(xiàng)

對象名順序?qū)傩悦f明描述

1AddrTypel地址類別1可選

2Addressl地址信息1可選

Addressinfo

3AddrType2地址類別2可選

4Address2地址信息2可選

10.9.聯(lián)系人信息數(shù)據(jù)項(xiàng)

對象名順序?qū)傩悦f明描述

1PsnNamel聯(lián)系人1姓名可選

2PsnRell聯(lián)系人1關(guān)系可選

3PsnPhonel聯(lián)系人1電話可選

4PsnName2聯(lián)系人2姓名可選

RelPsnlnfo5PsnRel2聯(lián)系人2關(guān)系可選

6PsnPhone2聯(lián)系人2電話可選

7PsnName3聯(lián)系人3姓名可選

8PsnRel3聯(lián)系人3關(guān)系可選

9PsnPhone3聯(lián)系人3電話可選

10.10.職業(yè)婚姻數(shù)據(jù)項(xiàng)

對象名順序?qū)傩悦f明描述

1Degree文化程度代碼可選

Marrylnfo2Marry婚姻狀況代碼可選

3Job職業(yè)代碼可選

10.11.醫(yī)學(xué)標(biāo)志信息數(shù)據(jù)項(xiàng)

對象名順序?qū)傩悦f明描述

1AB0AB0血型代碼可選

MedicalFlags2RHRH血型代碼可選

3XCBZ哮喘標(biāo)志可選

14

四川省居民健康卡應(yīng)用接口規(guī)范(VLO)

4XZBBZ心臟病標(biāo)志可選

5XNXGBBZ心腦血管病標(biāo)志可選

6NXWLBZ凝血紊亂標(biāo)志可選

7TNBBZ糖尿病標(biāo)志可選

8QGYBZ青光眼標(biāo)志可選

9TXBZ透析標(biāo)志