電子健康碼管理平臺醫(yī)療機構(gòu)受理環(huán)

境改造指引

文檔修改記錄

版本號版本描述責(zé)任人日期備注

目錄

I.概述......................................................................0

1.1適用范圍................................................................0

L2約束與限制...............................................................0

L3數(shù)據(jù)加密和簽名...........................................................0

L4數(shù)據(jù)元屬性規(guī)范...........................................................1

2.系統(tǒng)改造綜述.............................................................4

2.1系統(tǒng)結(jié)構(gòu)圖..............................................................4

2.2部署結(jié)構(gòu)圖..............................................................5

2.3改造目標(biāo)................................................................5

2.4改造范圍................................................................6

2.5改造內(nèi)容................................................................6

3.主要業(yè)務(wù)描述.............................................................7

3.1電子健康碼申領(lǐng)..........................................................7

3.2電子健康碼使用..........................................................7

4.主要業(yè)務(wù)場景的接口應(yīng)用.....................................................8

4.1人工窗口................................................................8

4.2自助設(shè)備................................................................8

4.3個人終端................................................................8

5.受理環(huán)境改造說明..........................................................10

5.1硬件設(shè)施...............................................................10

5.2網(wǎng)絡(luò)支持................................................................11

5.3應(yīng)用系統(tǒng)改造..........................................................11

5.4場地提供...............................................................12

5.5人員培訓(xùn)...............................................................13

6.接口規(guī)范..................................................................14

6.1電子健康碼注冊(createVmcardQRcode)................................14

6.1.1接口介紹............................................................14

6.1.2請求參數(shù)..........................................................14

6.1.3響應(yīng)參數(shù)............................................................17

6.2電子健康碼個人信息修改(modifyVmcardlnfo).......................................................18

6.2.1接口介紹............................................................18

6.2.2請求參數(shù)............................................................18

6.2.3響應(yīng)參數(shù)............................................................20

6.3電子健康碼個人信息查詢(getPersonlnfo)...............................................................21

6.3.1接口介紹............................................................21

6.3.2請求參數(shù)............................................................21

6.3.3響應(yīng)參數(shù)............................................................23

6.4電子健康碼二維碼獲取(getActiveQrCode)...............................................................24

6.4.1接口介紹............................................................24

6.4.2請求參數(shù)............................................................24

6.4.3響應(yīng)參數(shù)............................................................26

6.5電子卡二維碼驗證(getPersonlnfoByQrCode).........................................................27

6.5.1接口介紹............................................................27

6.5.2請求參數(shù)............................................................27

6.5.3響應(yīng)參數(shù)............................................................29

6.6查詢賬戶是否注冊(querylfHasRegistered).............................................................30

6.6.1接口介紹............................................................30

6.6.2請求參數(shù)............................................................30

6.6.3響應(yīng)參數(shù)............................................................32

6.7電子卡二維碼領(lǐng)碼/激活(activateVmcardQRcode).................................................32

6.7.1接口介紹............................................................32

6.7.2請求參數(shù)............................................................33

6.7.3響應(yīng)參數(shù)............................................................34

7.附錄1：簽名加密方法和常用代碼............................................36

7.1數(shù)據(jù)簽名方法............................................................36

7.2數(shù)據(jù)加密方法............................................................37

7.3身份證件類別代碼........................................................37

7.4診療環(huán)節(jié)代碼............................................................37

7.5標(biāo)準(zhǔn)科室代碼............................................................38

7.6性別編碼(GB2261)...................................................................................................42

7.7刷卡終端類型編碼......................................................43

7.8民族代碼..............................................................43

8.附錄2：前置機配置建議...................................................45

9.附錄3：識讀終端備案信息.................................................47

1.概述

本文檔作為各醫(yī)療機構(gòu)受理環(huán)境改造指引，編寫的目的是為了明確醫(yī)療機構(gòu)應(yīng)

用系統(tǒng)需要改造的業(yè)務(wù)節(jié)點、改造內(nèi)容和改造要求，以完成電子健康碼用碼環(huán)境改

造，確保電子健康碼在醫(yī)療機構(gòu)業(yè)務(wù)中正常應(yīng)用。

1.1適用范圍

本文僅適用于直接與省級電子健康碼管理平臺（以下簡稱碼管平臺）對接的醫(yī)

療機構(gòu)，已建立市級碼管平臺的地市屬地內(nèi)醫(yī)療機構(gòu)原則上與本市碼管平臺對接。

L2約束與限制

以《XX省電子健康碼管理平臺建設(shè)標(biāo)準(zhǔn)規(guī)范》（下文簡稱標(biāo)準(zhǔn)規(guī)范）為基礎(chǔ)，

在此文檔未盡描述的內(nèi)容以標(biāo)準(zhǔn)規(guī)范為準(zhǔn)。應(yīng)用系統(tǒng)按照指引中相關(guān)要求進行改造

完成電子健康碼業(yè)務(wù)應(yīng)用。

?電子健康碼識讀應(yīng)用時，系統(tǒng)需要調(diào)用電子健康碼接口進行二維碼的

識讀、解碼操作。

?居民線下申領(lǐng)、補領(lǐng)電子健康碼時，系統(tǒng)需要調(diào)用電子健康碼接口獲

得電子健康碼二維碼串或使用電子健康碼客尸端應(yīng)用軟件直接生成二

維碼操作。應(yīng)用系統(tǒng)生成電子健康碼應(yīng)符合接口數(shù)據(jù)格式和數(shù)據(jù)內(nèi)容

要求，打卬二維碼時應(yīng)符合電了健康碼格式和清晰度要求，滿足識讀

終端的識讀要求。

?居民線下窗口和自助設(shè)備申領(lǐng)電子健康碼二維碼時，醫(yī)療機構(gòu)需要進

行必要的實名制認(rèn)證，確保向電子健康碼管理平臺提供的居民信息是

真實有效的實名信息。

?醫(yī)療機構(gòu)在用碼、領(lǐng)碼時需要按照接口要求向電子健康碼管理平臺傳

送用碼相關(guān)信息。

L3數(shù)據(jù)加密和簽名

本文所用到的數(shù)據(jù)加密采用SM4加密算法，加密密鑰由電子健康碼管理平臺向

接入應(yīng)用分配。對于關(guān)鍵的隱私數(shù)據(jù)（例如身份證號碼、姓名、證件號碼等，詳見

0

接口參數(shù)備注中的描述），應(yīng)用系統(tǒng)使用分配的密鑰進行加密后傳輸數(shù)據(jù)，電子健

康碼管理平臺收到數(shù)據(jù)后使用相同的密鑰進行解密；反之電干健康碼管理平臺向應(yīng)

用系統(tǒng)返回數(shù)據(jù)時使用同樣的方法加密。

數(shù)據(jù)簽名使用SM3散列算法，簽名分為請求頭部信息簽名和上傳信息簽名。系

統(tǒng)在不同場景下依據(jù)安全級別選擇不同的驗簽級別。

注：

1、接口中的加解密、簽名可由應(yīng)用系統(tǒng)自行完成或通過碼管平臺的前置系統(tǒng)完

成。

2、應(yīng)用系統(tǒng)自行完成時使用的SM4和SM3為標(biāo)準(zhǔn)算法，應(yīng)用開發(fā)人員依個人

方式實現(xiàn)即可；此時前置系統(tǒng)模式配置為透傳模式，僅做請求轉(zhuǎn)發(fā)不做數(shù)據(jù)處理。

3、當(dāng)前置服務(wù)器部署在機構(gòu)內(nèi)部，可確保應(yīng)用系統(tǒng)到前置服務(wù)器之間的通信安

全時，可采用前置系統(tǒng)加密模式。此時前置系統(tǒng)模式配置為加密模式，應(yīng)用系統(tǒng)請

求時接口中標(biāo)注為加密的字段均直接傳輸明文，簽名參數(shù)（頭部信息簽名、上傳信

息簽名）、簽名模式、加密模式均傳“none”，由前置系統(tǒng)代為完成加密、解密、

簽名。

L4數(shù)據(jù)元屬性規(guī)范

內(nèi)部標(biāo)識符：指數(shù)據(jù)元在某特定數(shù)據(jù)集中的唯一標(biāo)識代碼。

數(shù)據(jù)元名稱：數(shù)據(jù)元名稱應(yīng)當(dāng)是唯一的，并且以字母、漢字、數(shù)字式的字

符串形式表示。數(shù)據(jù)元的命名應(yīng)使用一定的邏輯結(jié)構(gòu)和通用的術(shù)語。

數(shù)據(jù)類型：數(shù)據(jù)類型描述規(guī)則見表1。本文件將字符型（S）分為三種形式，

S1

表示不可枚舉的，且以字符描述的形式；S2表示枚舉型，且列舉值不超過3個；

S3表示代碼表的形式。

表1:數(shù)據(jù)類型描述規(guī)則

數(shù)據(jù)類型表示符描述

通過字符形式表達(dá)的值的類型?？砂?/p>

字符型(string)S母字符（a—z,A?Z）、數(shù)字字符等。（默認(rèn)

GB2312）

又稱邏輯型，采用0（False）或1（True）

布爾型（boolean）L

形式表示的邏輯值的類型

通過“0”到“9”數(shù)字形式表示的值的類

數(shù)值型(number)N

型

采用GB用7408中規(guī)定的YY用MMDD格式

日期型（date）D

表示的值的類型

日期時間型

采用YYYYMMDDhhmmss格式表示的值的類型。

（datetime）

DT（日期和時間中使用1位空格作為時間的標(biāo)志

符）

采用GB/T7408中規(guī)定的hhmmss格式表

時間型（time）T

示的值的類型

二進制(binary)

上述無法表示的其他數(shù)據(jù)類型，如圖像、音頻、

BY

視頻等二進制流文件格式

表示格式：表示格式見表2和表3o

表2數(shù)據(jù)元值的表示格式中字符含義描述規(guī)則

字符含義

A字母字符

N數(shù)字字符

AN字母或（和）數(shù)字字符

采用YYYYMMDD的格式表示，其中，“YYYY”表示年份，

D8

表示月份，“DD”表示日期'

采用hhmmss的格式表示，其中“hh表示小時，“mm”表示分鐘

T6

“SS”表示秒

采用YYYYMMDDhhmmss格式表示的值的類型。（日期和時間中使用1位

空螺4%塘莞’皆豺表示格式中字符長度描述規(guī)則

DT15

類別表示方法

固定長度在數(shù)據(jù)類型表示符后直接給出字符長度的數(shù)目，如N4

1、可變長度不超過定義的最大字符數(shù)在數(shù)據(jù)類型表示符后加”

后給出數(shù)據(jù)元最大字符數(shù)目，如AN..10

可變長度

2、可變長度在定義的最小和最大字符數(shù)之間在數(shù)據(jù)類型表示符后給出

最小字符長度數(shù)后加“?2”后再給出最大字符數(shù)

有若干字符行按固定長度或可變長度的規(guī)定給出每行的字符長度數(shù)后加“X后，再

表示的長度給出最大行數(shù),如AN..40X3

按固定長度或可變長度的規(guī)定給出字符長度數(shù)后，在“，”后給出小

有小數(shù)位數(shù)位數(shù)，字符長度數(shù)包含整數(shù)位數(shù)、小數(shù)點位數(shù)和小數(shù)位數(shù)，如N6,

2

應(yīng)用示例：示例1:S字符型

AN10固定為10個字符（相當(dāng)于5個漢字）長度的字符。

AN..10可變長度，最大為10個字符長度的字符。

AN4..10可變長度，最小為4個最大為10個字符長度的字符。

AN..20X3可變長度，最多3行，每行最大長度為20個字符長度的字符。

示例2:N數(shù)字型

N4固定長度為4位的數(shù)字。

N..4最大長度為4位的數(shù)字。

N6,2最大長度為6位的十進制小數(shù)格式（包括小數(shù)點），小數(shù)點后保留

2位數(shù)字。

示例3:T口期時間型

T8采用YYYYMMDD格式（8位定長）表示年月口。

DT15采用YYYYMMDDhhmmss格式表示的值的類型。（15位定長）表示

年月日時分秒。時分秒之前加1位空格。如2010年1月5日8時10分9秒為

20100105081009o

允許值：本文件數(shù)據(jù)元值域有兩種類型

（a）可枚舉值域：由允許值列表規(guī)定的值域，每個允許值的值和值含義均應(yīng)成

對表示。其中：

一一可選值較少的（如3個或以下），在“數(shù)據(jù)元允許值〃屬性中直接列舉。

一一可選值較多的（如3個以上），在“數(shù)據(jù)元允許值"屬性中寫出值域代碼表

名稱。如代碼表屬引用標(biāo)準(zhǔn)的，則須注明標(biāo)準(zhǔn)號。

（b）不可枚舉值域：由描述規(guī)定的值域，在“數(shù)據(jù)元允許值〃屬性中須準(zhǔn)確描述

該值域的允許值。

定義：本文件中數(shù)據(jù)元定義以字母、漢字、數(shù)字式的字符串形式表示。

3

2.系統(tǒng)改造綜述

電子健康碼應(yīng)用的整體結(jié)構(gòu)分為三部分，核心服務(wù)（指后臺服務(wù)系統(tǒng)）部

署在省政務(wù)云機房，提供整個系統(tǒng)的所有服務(wù)；前置系統(tǒng)部署在應(yīng)用機構(gòu)和核

心服務(wù)之間提供統(tǒng)一接口和通信加密等服務(wù)；應(yīng)用系統(tǒng)是操作人員接觸的前端

應(yīng)用，通過調(diào)用前置系統(tǒng)的API接口實現(xiàn)具體業(yè)務(wù)功能。

2.1系統(tǒng)結(jié)構(gòu)圖

電子健康卡管理可擴展

核心服務(wù)系統(tǒng)痣域主索引系統(tǒng)

系統(tǒng)其它核心服務(wù)系統(tǒng)

應(yīng)用接入認(rèn)證功陞電子電*卡'二，務(wù)4球.絞卜引業(yè)務(wù)功噩

前置服務(wù)系統(tǒng)

通信報文加密功能服務(wù)踣由功能其它可獷展功能

應(yīng)用系統(tǒng)

系統(tǒng)結(jié)構(gòu)圖

4

2.2部署結(jié)構(gòu)圖

核心服務(wù)系統(tǒng)網(wǎng)絡(luò)

部署結(jié)構(gòu)圖

注：上圖部署結(jié)構(gòu)前置系統(tǒng)的位置可隨實際情況酌情調(diào)整，前置系統(tǒng)應(yīng)置于

機構(gòu)內(nèi)部網(wǎng)絡(luò)內(nèi)或內(nèi)部網(wǎng)絡(luò)可安全訪問的網(wǎng)絡(luò)環(huán)境內(nèi)。

2.3改造目標(biāo)

完成電子健康碼用碼的軟件、硬件、網(wǎng)絡(luò)環(huán)境的改造，對使用維護人員進行

培訓(xùn)、部署電子健康碼識讀終端、線下申領(lǐng)打碼設(shè)備等工作，實現(xiàn)患者持電子健

5

康碼就診的全流程支撐；實現(xiàn)線下電子健康碼二維碼的申領(lǐng)打印、丟失補打等碼

應(yīng)用支撐。

2.4改造范圍

電子健康碼實現(xiàn)居民身份識別和就診支付功能，應(yīng)用范圍可支持醫(yī)療機構(gòu)內(nèi)

全流程需要識別患者身份的各個環(huán)節(jié)，改造涉及院內(nèi)就診卡系統(tǒng)、HIS系統(tǒng)、掛號

分診系統(tǒng)、住院系統(tǒng)、網(wǎng)絡(luò)鏈路等與卡應(yīng)用有關(guān)的各個系統(tǒng)。

2.5改造內(nèi)容

改造內(nèi)容包括硬件設(shè)施、網(wǎng)絡(luò)改造、自助醫(yī)療機構(gòu)設(shè)備及信息系統(tǒng)改造、相

關(guān)場地和推廣宣傳材料、操作和運維人員培訓(xùn)。

6

3.主要業(yè)務(wù)描述

3.1電子健康碼申領(lǐng)

居民通過個人移動終端或機構(gòu)終端向系統(tǒng)提交實名制信息進行注冊。個人信

息的實名制認(rèn)證分為線下和線上兩種方式，線下采用身份證讀卡器讀取身份證或

其它實名制證件（例如社?？ǎ┳x卡器讀取居民證件信息。

電子健康碼管理平臺接受注冊信息后，查詢是否存在該居民信息，如存在將

電子健康碼ID和主索引ID等返回；如不存在電子健康碼管理平臺生成主索引和電

子健康碼ID,使用用戶身份信息完成用戶注冊，并返回上述信息。

機構(gòu)終端接收到電子健康碼信息需要打印靜態(tài)碼時，將二維碼字符串轉(zhuǎn)換為

二維碼圖片打印出來交給居民，完成電子健康碼申領(lǐng)；個人移動終端需要顯示二

維碼時，通過電子健康碼ID向電子健康碼管理平臺申請動態(tài)二維碼。

居民在自助設(shè)備或者個人移動終端需要查詢個人的信息時，應(yīng)用系統(tǒng)通過電

子健康碼ID向電子健康碼管理平臺中請個人信息查詢。居民發(fā)現(xiàn)填寫信息有誤或

者發(fā)生變更時，可操作修改非關(guān)鍵信息（已經(jīng)實名認(rèn)證的姓名和證件信息不允許

個人修改）。

3.2電子健康碼使用

居民出示靜態(tài)二維碼或個人移動終端上的動態(tài)二維碼，識讀終端讀出二維碼

通過調(diào)用接口上傳到電子健康碼管理平臺進行解碼驗證，驗證通過后返回驗證結(jié)

果和居民身份信息。

居民可以在人工窗口（包含掛號、門診醫(yī)生、門診護士站、藥房、住院護士

站等）、自助設(shè)備、移動應(yīng)用等場景下使用電子健康碼進行身份識別。

7

4.主要業(yè)務(wù)場景的接口應(yīng)用

4.1人工窗口

1、用碼機構(gòu)改造在人二窗口發(fā)放電子健康碼靜態(tài)二維碼，建議使用如下接

口：

電子健康碼注冊(createVmcardQRcode)-----必選(未注冊過居民首次注冊)

電子健康碼個人信息修改(modifyVmcardlnfo)-----必選

電子健康碼個人信息查詢(getPersonInfo)-----推薦

查詢賬戶是否注冊(querylfHasRegistered)-----必選

電子卡二維碼領(lǐng)碼/激活(activateVmcardQRcode)-----必選(已注冊居民領(lǐng)

碼)

2、用碼機構(gòu)改造人工飭'口受理電子健康碼實現(xiàn)身份識別，使用如下接口：

電子健康碼二維碼驗證(getPersonlnfoByQrCode)-----必選

4.2自助設(shè)備

1、自助設(shè)備發(fā)放電子健康碼靜態(tài)二維碼，建議使用如下接口：

電子健康碼注冊(createVmcardQRcode)-----必選(未注冊過居民首次注冊)

電:健康碼個人信息修改(modifyVmcardlnfo)-----推薦

電子健康碼個人信息查詢(gctPcrsonlnf。)一一推薦(不建議提供通過靜態(tài)碼

查詢個人信息功能)

查詢賬戶是否注冊(querylfHasRegistered)-----必選

電子卡二維碼領(lǐng)碼/激活(activateVmcardQRcode)一—必選(己注冊居民領(lǐng)

碼)

2、自助設(shè)備使用電子健康碼實現(xiàn)身份識別，使用如下接口：

電子健康碼二維碼驗證(getPersonlnfoByQrCode)-----必選

4.3個人終端

1、個人移動終端發(fā)放電子健康碼動態(tài)二維碼時，建議使用如下接口：

電子健康碼注冊(createVmcardQRcode)-----必選

8

電子健康碼個人信息修改(modityVmcardlnto)-----必選

電子健康碼二維碼獲取(getActiveQrCode)-----必選

電子健康碼個人信息查詢(getPersonlnfo)-----必選

2、個人移動端或智能終端掃碼實現(xiàn)身份識別時，使用如下接口:

電子健康碼一維碼驗證(getPersonlnfoByQrCode)-----必選

9

5.受理環(huán)境改造說明

5.1硬件設(shè)施

硬件設(shè)備改造包括：

i＞識讀終端：為各應(yīng)用窗口安裝二維碼掃碼設(shè)備，可使用掃描槍、坐式掃碼

墩等設(shè)名O識讀終端應(yīng)符合國家居民健康碼識讀終端相關(guān)標(biāo)準(zhǔn)及國家金融行業(yè)相

關(guān)標(biāo)準(zhǔn)。本地區(qū)電子健康碼二維碼使用標(biāo)準(zhǔn)QR碼，識讀終端需支持QR碼和其它常

用碼制的識讀，識讀終端向后臺傳輸?shù)男畔⒅袘?yīng)包含終端自身的相關(guān)信息。注：

識讀終端布放后需要將終端安裝信息以EXCEL格式線下報送到省級碼管平臺進行備

案，業(yè)務(wù)系統(tǒng)在用碼驗證時需向電子健康碼管理平臺傳送有效的終端備案號。

安裝的識讀終端需通過國家衛(wèi)生健康委統(tǒng)計信息中心許可的檢測機構(gòu)檢測，

在國家卡管系統(tǒng)的設(shè)備備案中已備案；采購未通過檢測和備案的設(shè)備時，需要求

供貨商完成檢測備案后方可使用。已備案設(shè)備詳見附錄3。

2、自助機：依據(jù)機構(gòu)業(yè)務(wù)需要，升級原有自助設(shè)備或新增布放適量的自助終

端設(shè)備，包括但不僅限于自助領(lǐng)碼機、自助掛號機、自助打單機、自助檢驗報告

領(lǐng)取機、自助取藥機、自助繳費機、綜合自助服務(wù)機等，自助設(shè)備需增加二維碼

掃碼設(shè)備，通過院內(nèi)業(yè)務(wù)系統(tǒng)或前置服務(wù)與電子健康碼管理平臺聯(lián)通，支持掃描

電子健康碼進行身份識別完成掛號、打印單據(jù)、打印收費收據(jù)、打印檢查檢驗報

告等便民服務(wù)，無碼人員可在自助設(shè)備t■.中領(lǐng)打印靜態(tài)二維碼。

3、前置機：醫(yī)療機構(gòu)醫(yī)療機構(gòu)根據(jù)網(wǎng)絡(luò)規(guī)劃需求配備前置機搭建醫(yī)療機構(gòu)前

置系統(tǒng)。前置機需根據(jù)醫(yī)療機構(gòu)醫(yī)療機構(gòu)業(yè)務(wù)量評估合理配置，確保滿足本機構(gòu)

醫(yī)療機構(gòu)的業(yè)務(wù)需求。前置機需要能夠通過安全網(wǎng)絡(luò)訪M電子健康碼管理平臺，

并能夠被醫(yī)療機構(gòu)內(nèi)部網(wǎng)絡(luò)訪問。

前置機支持Windows2012server及以上版本、CentOS6.9及以上版本、國產(chǎn)操

作系統(tǒng)與軟件。

數(shù)據(jù)庫支持Mysql8.0及以上版本。

4、條碼打印機：設(shè)立線下申領(lǐng)補辦電子健康碼窗口的醫(yī)療機構(gòu)依據(jù)規(guī)劃數(shù)量

配備條碼打印機，用于電子健康碼靜態(tài)碼打印。

打印機需支持熱轉(zhuǎn)印打印方式，依據(jù)選用的打印紙選擇適配的耗材（碳帶

等），例如選用亞銀打印紙，需要選用適用于光滑材質(zhì)打印的蠟基碳帶。打印規(guī)

范如下：

（1）打印的二維碼需要能夠被識讀終端準(zhǔn)確識讀；

（2）條碼打印機打印精度2300dpi時,建議打印尺寸為20mmX20mm（打印

標(biāo)簽紙尺寸為30mmX25mm）；條碼打印機打印精度低于300dpi時，建議打印尺

寸為30mmX30mm（打印標(biāo)笠紙尺寸為40mmX35mm）；

（3）打印標(biāo)簽紙材質(zhì)：建議選用亞銀樹脂不干膠打印紙；

（4）二維碼上方顯示“電子健康碼字樣”（字體為微軟雅黑10號），二維碼

下方顯示持卡人姓名（字體為微軟雅黑10號），打印樣式如下：

電子健康碼

張斌梨

5、VPN設(shè)備：醫(yī)療機構(gòu)醫(yī)療機構(gòu)到電子健康碼管理平臺無專網(wǎng)或其它安全網(wǎng)

絡(luò)時，需使用VPN設(shè)備基于公網(wǎng)搭建虛擬專用網(wǎng)絡(luò)提升數(shù)據(jù)傳輸安全。

5.2網(wǎng)絡(luò)支持

1、醫(yī)療機構(gòu)內(nèi)所有識讀終端要和計算機連接，并與院內(nèi)網(wǎng)絡(luò)連接。

2、院內(nèi)所有電子健康俏自助機（包括各類型的便民自助機）要與前置機連接

（或通過應(yīng)用系統(tǒng)連接），并與院內(nèi)網(wǎng)絡(luò)聯(lián)通。

3、醫(yī)療機構(gòu)前置機與院內(nèi)網(wǎng)絡(luò)連接，所有院內(nèi)系統(tǒng)訪問電子健康碼管理平臺

均需要通過前置機中轉(zhuǎn)。

5.3應(yīng)用系統(tǒng)改造

圍繞居民到醫(yī)療機構(gòu)就關(guān)構(gòu)建應(yīng)用場景，體現(xiàn)電子居民健康碼為居民和患者

帶來的就醫(yī)便捷性，同時依托電子健康碼的應(yīng)用提升醫(yī)療機構(gòu)的服務(wù)效率。

識讀應(yīng)用場景包括：掛號、就醫(yī)、繳費、檢查檢驗、查詢、檢驗檢查結(jié)果打

Eh其它醫(yī)療服務(wù)；

自助終端應(yīng)用場景包括：二維碼申領(lǐng)、二維碼打印、掛號、繳費、查詢、自

助打印、其它醫(yī)療服務(wù)。

1!

主要業(yè)務(wù)場景：

1、掛號/預(yù)約掛號：患者到醫(yī)療機構(gòu)就診，持電子健康碼在門診掛號處或自助

機進行掛號。掛號處或自助機讀取電子健康碼，獲取患者姓名、證件號、等個人

信息；患者也可以通個人移動端使用電子健康碼進行預(yù)約掛號。

2、就醫(yī)：患者掛號后，根據(jù)醫(yī)療機構(gòu)導(dǎo)診到醫(yī)生診室，醫(yī)生通過識讀終端讀

取電子健康碼識別患者身份。

3、門診收費/診間支付：患者就診后，在收費處或自助機通過識讀終端讀取電

子健康碼識別患者身份進行線下繳費；也可在個人移動終端進行線上自助繳費。

4、藥房取藥：患者繳費后，根據(jù)指引到藥房通過識讀終端讀取電子健康碼識

別患者身份進行發(fā)藥。

5、檢查檢驗：患者繳費后，根據(jù)指引到檢查檢驗室，通過識讀終端讀取電子

健康碼識別患者身份進行登記，分診檢杳檢驗。

6、報告杳詢/打?。夯颊邫z置檢驗后，可以在自助終端或者科室通過識讀終端

讀取電子健康碼識別患者身份，查詢或者打印檢杳檢驗報告。

7、電/病歷查詢：患者就醫(yī)結(jié)束后，可以在自助終端通過識讀終端讀取電;

健康碼識別患者身份查詢電F病歷。

8、住院登記：患者到醫(yī)療機構(gòu)住院，在住院登記處通過識讀終端讀取電子健

康碼識別患者身份進行入院登記，無需再錄入患者基本信息。

9、住院護士站：患者登記入院后，根據(jù)指引到住院處，護士通過識讀終端讀

取電子健康碼識別患者身份，進行床位安排和其它醫(yī)療服務(wù)。

10、住院醫(yī)生站：患者在院期間，醫(yī)生巡查病房時通過識讀終端讀取電子健

康碼識別患者身份快速查詢患者病歷信息。

11、住院收費處：患者出院時，收費處通過識讀終端讀取電子健康碼識別患

者身份，進行費用結(jié)算和出院手續(xù)辦理

5.4場地提供

提供用于線下申領(lǐng)、補打電子健康碼的業(yè)務(wù)窗口。

在窗口工位上提供條碼打印機擺放位置。

提供自助設(shè)備擺放位置。

12

在醫(yī)療機構(gòu)明顯位置向公眾（患者）宣傳推廣電子健康碼，包括線上申領(lǐng)、

自助申領(lǐng)、窗口申領(lǐng)的流程簡介、電子健康碼簡介等宣傳條幅、易拉寶、貼紙、

海報等。

5.5人員培訓(xùn)

1、在醫(yī)療機構(gòu)信息系統(tǒng)改造中，相關(guān)廠商（系統(tǒng)服務(wù)商、自助設(shè)備廠商等）

需要對醫(yī)療機構(gòu)技術(shù)人員進行運維培訓(xùn)，保證院內(nèi)技術(shù)人員能夠獨立承擔(dān)運維任

務(wù)，出現(xiàn)故障時能夠快速判斷故障歸屬單位。

2、在醫(yī)療機構(gòu)信息系統(tǒng)改造中，相關(guān)廠商（系統(tǒng)服務(wù)商、自助設(shè)備廠商等）

需要對醫(yī)療機構(gòu)醫(yī)務(wù)人員（收費結(jié)算人員、醫(yī)生、護士等）進行使用培訓(xùn)，保證

醫(yī)務(wù)人員能夠熟練掌握電子健康碼在院內(nèi)醫(yī)療業(yè)務(wù)中的應(yīng)用。

6.接口規(guī)范

統(tǒng)一規(guī)則描述：

1、下文接口地址描述中均使用協(xié)議，實際生產(chǎn)環(huán)境中多數(shù)情況使用s安全

協(xié)議，請對接時注意支持和S協(xié)議。

2、下文接口描述均以應(yīng)用系統(tǒng)自行進行加解密、簽名的方式描述，如使用前

置系統(tǒng)加解密、簽名的方式參看L3小節(jié)的描述。

3、所有接口備注欄標(biāo)“Y”的為必填項，未標(biāo)注的為選填項。

4、所有接口備注欄標(biāo)注為傳輸代碼的需要按照備注說明或數(shù)據(jù)字典傳輸代

碼，其它未標(biāo)注的默認(rèn)直接傳輸對應(yīng)字段的內(nèi)容。

5、所有接口備注欄標(biāo)“加密”字樣的均需加密后傳輸，未標(biāo)注的直接明文傳

輸。

6、所有接口備注欄標(biāo)“不簽名”字樣的參數(shù)不參與簽名，未標(biāo)注的均需要參

與簽名。

7、注冊人員類型(persormelType)為無證件兒童時，證件號碼傳空，由碼

管平臺生成9001開頭的18位系統(tǒng)自編號，即查詢時如接收到的證件號碼為9001開

頭則是系統(tǒng)自編號，僅供參考使用。。

8、系統(tǒng)調(diào)試時使用的測試地址為：:〃58.62.175.49:8098/api/d。

9、系統(tǒng)改造在測試環(huán)境調(diào)試通過后發(fā)放正式環(huán)境地址。

6.1電子健康碼注冊(createVmcardQRcode)

6.1.1接口介紹

接口地址://ip:port/api/do

接口方法接口POST方法

接口描述上傳個人信息完成賬戶注冊，獲取電子健康碼和主索引。

接口提供者XX省電子健康碼管理平臺

6.1.2請求參數(shù)

數(shù)據(jù)類型及

名稱說明長度備注(Y-必填)

14

appld應(yīng)用唯一識別碼AN..367由卡管系統(tǒng)分配

Y加密

timestamp請求時間戳AN..32

當(dāng)前秒數(shù)，與標(biāo)準(zhǔn)時間一致

nonceStr隨機數(shù)血.32Y小于16位的整數(shù)

version接口版本號AN..10Y同文檔版本,例VL0.6

Y不簽名

nethod方法名稱AN..50列createVmcardQRcode

Y不簽名

headSign頭部信息簽名AN..32

詳見數(shù)據(jù)簽名方法

Y不簽名

bodySign上傳信息簽名AN..32

詳見數(shù)據(jù)簽名方法

7不簽名

signMode數(shù)據(jù)簽名模式AN..32

詳見數(shù)據(jù)簽名方法

Y不簽名

encryptMode數(shù)據(jù)加密模式AN..32

詳見數(shù)據(jù)加密方法

上傳數(shù)據(jù)

name姓名AN..32Y加密

7personnelType為2時可為

idCode證件號碼AN..32空。

加密

YpersonnelType為2時可為

idCardTypeCode證件類別AN..2空。

見附錄《身份證件類別代碼》

validStartdate證件有效期開始時間T8YYYYMMDD

validEnddate證件有效期結(jié)束時間T8YYYYMMDD

idlnst發(fā)證機關(guān)AN..128

見附錄7.5性別編碼

AN..2

sex性別(GB2261)

nation民族AN..20Y見附錄7.7民族代碼

birthday出生日期T8YYYYMMDD

birthplace出生地AN..200

phone本人手機號AN..11不為空時需加密處理，加密

linkman聯(lián)系人姓名AN..50不為空時需加密處理，加密

telephone聯(lián)系人電話AN..11不為空時需加密處理，加密

GBT2261-2003婚姻狀況代

maritalstatuscode婚姻狀態(tài)AN..2

碼

address戶籍地址AN..128司身份證地址

currentAddress居住地址AN..128現(xiàn)住地址

idPhoto證件照片CLOB轉(zhuǎn)為base64

scenePhoto頭像照片CLOB轉(zhuǎn)為base64

15

根留字段，默認(rèn)中國，可

AN..50

nationality國籍空。

預(yù)留字段，默認(rèn)漢語，可

AN..50

language語言空。

Y

1:普通2:無證件兒童

personnelTypc人員類型AN..2

僅無身份證件時按2傳參，

有身份證件時均按1傳參。

人員類型為2時必填

multifetalMark多胎標(biāo)記AN..2傳輸代碼：

0（單胎）1（多胎）

多胎標(biāo)記為1時必填

AN..2

multpripleBirths多胎產(chǎn)次產(chǎn)次順序號：例次2、3

motherName母親姓名AN..50加密人員類型為2時必填

motherIclCode母親身份證號AN..32加密人員類型為2時必填

人員類型為2時，與身份證號

母親主索引IDAN..64

motherEmpi二選一填寫。

'，傳輸代碼

1、APP在線申請

2、醫(yī)療衛(wèi)生機構(gòu)自助機申

請

3、醫(yī)療衛(wèi)生機構(gòu)窗口申請

appModc操作方式AN..24、批量預(yù)生成

5、微信服務(wù)號

6、微信小程序

7、支付寶生活號

8、支付寶小程序

9、其他

偵留字段默認(rèn)為0

無

【、微信

2、支付寶

3、銀聯(lián)

綁定的或者支持的支付

payAccTypeAN..34、銀行

賬戶類型

5、統(tǒng)一支付平臺

9、其他

可多選，格式如下舉例1：

1*2

舉例2：『2例

orgCode機構(gòu)唯一識別碼AN..36'，由應(yīng)用機構(gòu)注冊備案過的

機構(gòu)唯一識別碼

appRecordNo應(yīng)用各案號AN..17'，由應(yīng)用注冊備案過的應(yīng)用

唯一識別碼

16

{

“method":"createVmcardQRcode”.

"headSigrT:"639f0d6b537f979dl0dca5ba3cd4902b058f72

ed43973bb4de8a5d2bfdf57IfT,

"bodySign":"a9ce8abebf266f3225e6dbec8221da472b9c22

7fa7f7d83d75f3452eac849df2w,

“appId":"60C90F3B796B4】878B8D9C393E2B6329”,

“version":"V2.0.0",

"nonceStr”<1234567890”,

"timestamp":"60c90F3B796B41878B8D9c393E2B6329”,

"signMude":"SMS"?

*encryptMode*:*SM4/ECB/ZeroBytePadding*?

“signature”:

*304502201368C6FF4A228EBFBE22741EBBE71D27D32DBA9E7

9291E99D03B12E2BC3553FD022100EBF0559D4C40D05651D01

請求格式

5C7EE04756C1E999D2727DD86757C3775FFB5762912”,

"body":{

"idCardTypeCode":"01",

"idCode":"E61C81386935441E6B12D4A91E3E45DE45FE7443

2A7141A4381FCCFB21AB9c35”,

“birthday":"19950401”,

"name":"E467EDEC2E69cl9c257A7EC44A9732B0”,

wvalidStartdate":z，2018010r,

"appMode":"2",

nation:01,

sex:1，

*org€ode*:"KGA00020100000014*,

*appRecordNo*/1301A0002QTIIX0001”

)

}

6.1.3響應(yīng)參數(shù)

屬性名稱中文名稱備注說明

交易結(jié)果

returnCode

3：成功非0：不成功

對錯誤或異常的描述信

returnDesc

息