廣東省醫學檢驗檢查結果互認共享平臺

接口規范（醫療機構）

廣東省衛生健康委

2023年09月

版本號版本日期修訂內容修訂人

VI.02023-08-08創建文檔周志鵬

VI.12023-08-23敏感信息加密規則，第三方依賴jar包(SMEnDe)周志鵬

升級為1.3版本

VI.22023-09-01補充完善第一章加密規則、入參以及示例等等。張英斌

目錄

第一章數據上傳接口..............................................................5

1.1.概述.....................................................................5

1.1.1.文檔說明...........................................................5

1.1.2,讀者對象...........................................................5

1.1.3.術語...............................................................5

1.2,接口約定.................................................................6

1.2.1.平臺接口...........................................................6

1.3.接口服務列表.............................................................8

1.3.1.用戶認證獲取token接口............................................8

1.3.2.檢驗數據實時上傳.................................................10

1.3.3,撤銷檢驗數據......................................................33

1.3.4,檢查數據實時上傳.................................................35

135.撤銷檢查數據.....................................................53

1.3.6.患者信息數據實時上傳.............................................55

1.3.7.檢驗檢查報告PDF文件實時上傳....................................63

1.3.8.醫院的科室字典數據實時上傳.......................................67

1.3.9.醫療機構人員字典數據實時上傳.....................................71

第二章互認服務接口...........................................................78

2.1.系統應用接口規范........................................................78

2.1.1.接口列表..........................................................78

2.1.2.業務流程.........................................................79

2.1.3.補充說明.........................................................115

第三章值域字典................................................................116

3.1.就診類型編碼...........................................................116

3.2.就診卡類型代碼表......................................................117

3.3.身份證件類別代碼.......................................................118

3.4.藥敏實驗結果代碼表....................................................118

3.5.麻醉方法代碼表........................................................118

3.6.操作部位代碼表........................................................120

第一章數據上傳接口

1.1.概述

1.1.1.文檔說明

本文詳細闡述了第三方與地市檢查檢驗結果共享互認平臺對接，進行相關業

務數據上傳的接口規范，調用該服務接口可將檢驗檢查結果互認報告相關數據進

行實時上傳。

1.1.2,讀者對象

本文檔的閱讀對象為需要與檢查檢驗結果共享互認平臺對接服務集成的相

關應用開發人員、測試人員，系統集成人員。

1.1.3.術語

縮寫、術語解釋

HTTP超文本傳傳輸協議

RESTful一種軟件架構風格、設計風格，提供了一組設計原則和約束

條件。它主要用于客戶端和服務器交互類的軟件。基于這個

風格設計的軟件可以更簡潔，更有層次，更易于實現緩存等

機制。

consumerld平臺給每個接入的第三方應用分配的唯一身份標識編碼

sm2公鑰平臺給第三方接入的應用分配的加密公鑰，用這個公鑰對“

消費者編號”進行加密

affairToken用于對調用對象進行身份辨識，affairToken有效期，默認6

小時。超時后,將無法繼續使用次affairToken調用服務。需

要再次調用接口獲得新的affairTokeno

12接口約定

121.平臺接口

1.2.1.1.接口協議

采用HTTP/HTTPS協議。

1.2.1.2.服務地址

聯調測試時由平臺提供。

1.2.1.3.報文格式約定

.L請求報文格式

JSON報文格式，報文結構如下:

}

.2,應答報文格式

JSON報文格式，報文結構如下:

)

12L33響應碼字典

code返回碼

編碼說明

0成功，無返回信息

1成功，有返回信息

-1失敗

1.2.1.4.敏感信息加密規則

針對接口服務列表相關接口請求入參相關字段涉及的敏感信息需要進行加

密傳輸，具體哪些字段需要進行加密傳輸，詳見對應接口的字段說明，加密方式

為SM4,加密秘鑰由平臺分配，具體的加密示例如下：

包

互聯互通互認平臺

跨市接口加解密工

相關第三方依賴包如下：

bcprov-jdk15on

-1.68.jar

SMEnDe-1.3jar

commons-codec

1.16.0.jar

1.3.接口服務列表

1.3.1.用戶認證獲取token接口

接口說明用戶認證并獲取token接口

請求方式POST

編碼方式UTF-8

URLhttp://ip:port/hrserver/identifyService/shakehands

1、token有效期，默認6小時。超時后，將無法繼續使用次token調用服

務。需要再次調用接口獲得新的token。

2、authcnticatcStr加密方式為國密2.

重點說明

consumerId和配套sm2公鑰，會以線下的方式，發放給每個市級單位。或

者省級醫院。

1.3.1.1.請求參數說明

參數名稱類型約束備注

消費者編號長

consumerld用戶IDStringNotnull度為8的字符

串

消費者編號加

密后的密文;平

臺會下發一個

authenticateSt

調閱密碼SiringNotnullSM2的公鑰,用

i

這個公鑰對

“消費者編

號”進行加密

dsqhdm地市區劃代碼StringNotnul1地市區劃代碼

說明：

1、token有效期，默認6小時。超時后，將無法繼續使用次token調用服

務。需要再次調用接口獲得新的token。

2、authenticateStr加密方式為國密2.

consumerld和配套sm2公鑰，會以線下的方式，發放給每個市級單位。

1.3.1.2.請求示例

請求方式:POST

"consumerld":"P97Q8T2X",

“authenticateStr”:〃

04e23e34e8167d00babccb5ffc071880e4906ed79b549aed44ed4dcd427bfcbc36bdl3ff8a69d

9e5c2cac8a4787ae862a61a22ae59b5f4babe806fdba39a559d8cfa6「3fa7f050elaf3fadaf51

8967e7aa9d4744bd6177efd3fddef699da80705”

)

1.3.1.3,應答參數說明

參數名稱類型約束備注

result結果StringNotnullsuccess、failure

result為success時返

affairToken令牌StringNotnull

回token

1.3.1.4,應答參數示例

result:success,

"affairToken":，，8a817a44723eez，

)

1.3.2.檢驗數據實時上傳

接口說明實時上傳檢驗數據

請求方式POST

編碼方式UTF-8

URLhttp://ip:port/hrserver/upload/rea1time/1isdata

1.3,2.1.請求參數說明

header

參數名稱類型約束備注

affairTokenTokenStringNotnull

body

參數名稱說明類型約束值說明

yljgdm醫療機構代碼StringNotnull

bgdh檢驗報告單號StringNotnull

bgrq報告日期StringNotnullyyyy-MM-dd

hh:nun:ss

jylx檢驗類型StringNotnull1：常規檢驗；

2:細菌培養

jzlsh就診流水號StringNotnull

mzzybz門診住院標志StringNotnull1門診，2住

院，3家床,4

體檢

jzlx就診類型StringNotnull見4.1就診類

型編碼

ksbm患者就診科室StringNotnull

編碼

ksmc患者就診科室StringNotnull

名稱

kh卡號StringNotnull

klx々類型StringNotnull見4.2就診卡

類型代碼表

dzjkk電子健康卡StringNotnull

ID

fileNumber患者檔案號StringNotnull

sfzjlbbm身份證件類別StringNotnull見4.3身份證

代碼件類別代碼

sfzh患者身份證號StringNotnull該字段需進行

加密處理

brxm病人姓名StringNotnull該字段需進行

加密處理

brxb病人性別StringNotnull0、未知的性別

1、男性2、女

性

csrq病人出生日期StringNotnullyyyy-MM-dd

hh:mm:ss

brdh病人電話StringNull該字段如果不

為空則需要進

行加密處理

xzdz現住地址StringNull該字段如果不

為空則需要進

行加密處理

sqrgh申請人工號StringNull

sqrxm申請人姓名StringNotnull

sqrsfz申請人身份證StringNull該字段如果不

號為空則需要進

行加密處理

bgrgh報告人工號StringNotnull

bgrxm報告人姓名StringNotnull

bgrsfz報告人身份證StringNull該字段如果不

號為空則需要進

行加密處理

shrgh審核人工號StringNotnull

shrxm審核人姓名StringNotnull

shrsfz審核人身份證StringNull該字段如果不

號為空則需要進

行加密處理

sqks申請科室編碼StringNotnul1院內科室編碼

sqksmc申請科室名稱StringNotnul1院內科室名稱

dzsqdbh電子申請單編StringNull

號

zyh住院號StringNull為住院時必填

mjzh門（急）診號StringNull為門診就診時

必填

bq病區StringNull

bqdm病區代碼StringNull院內代碼

bfh病房號StringNull

ch床號StringNull

dyrq打印日期StringNotnul1yyyy-MM-dd

hh:mm:ss

sqrq申請日期StringNotnullyyyy-MM-dd

hh:mm:ss

cjrq采集日期StringNotnullyyyy-MM-dd

hh:nun:ss

jyrq檢驗日期StringNotnullyyyy-MM-dd

hh:mm:ss

shsj審核日期時間StringNotnullyyyy-MM-dd

hh:mm:ss

bgjgdm報告機構代碼StringNotnull

bgjgmc報告機構名稱StringNotnull

bgbz報告備注StringNull

bbdm標本代碼StringNotnull醫療機構內標

本類型代碼

bbmc標本名稱StringNotnull醫療機構內標

本類型名稱

bbzt標本狀態的描StringNotnul1

述

bgd1bbm報告單類別編StringNotnull編碼。1=一般

碼臨床檢驗；2=

血液學檢查;3二

臨床化學檢查：

4=臨床免疫學

檢查；5=臨床

微生物學檢查6

=臨床寄生蟲

學檢查；7=分

子生物學檢查；

9999=其它

bgdlb報告單類別名StringNotnull

稱

jcmd檢查目的StringNotnull

tmh條碼號StringNotnull

ybh樣本號StringNotnull

jyksdm檢驗科室代碼StringNull

jyksmc檢驗科室名稱StringNull

sysmc實驗室名稱StringNull

sysdz實驗室地址StringNull該字段如果小

為空則需要進

行加密處理

syslxdh實驗室聯系電StringNull該字段如果不

話為空則需要進

行加密處理

ybjssj樣本接收口期StringNotnullyyyy-MM-dd

hh:mm:ss

cjbw采集部位StringNull采集部位，微

生物必填

sqdjmc申請單據名稱StringNull

jyfImc檢驗分類名稱StringNull

jybgjg檢驗報告結果StringNotnul1

jysqjgmc檢驗申請機構StringNotnull

名稱

jyjgmc檢驗機構名稱StringNotnul1

jyjsxm檢驗技師姓名StringNull

jyjsgh檢驗技師工號StringNull

sjysgh送檢醫師工號StringNull

sjysxm送檢醫師姓名StringNull

yyjybgwj是否提供電子StringNotnull1：無2：有

版檢驗報告文

件

wjlj檢驗報告的文StringNull當是否提供電

件鏈接地址子版檢驗報告

url文件為2時必

填

jbzdList疾病診斷列表Json數組

hrxmList檢驗互認項目Json數組

列表

indicatorsList檢驗結果指標Json數組

bacteriaResultList細菌結果Json數組

allergyResultList藥敏結果Json數組

jbzdList對象（疾病診斷列表）

參數名稱說明類型約束值說明

jbzddm疾病診斷代碼StringNotnull醫療機構內西

醫診斷編碼

jbzdmc疾病診斷名稱StringNotnul1醫療機構內西

醫診斷名稱

hrxmList對象（檢驗互認項目列表）

參數名稱說明類型約束值說明

hrhm檢驗互認項目StringNot.nul1互認項目標推

編碼編碼

hrmc檢驗互認項目StringNotnull互認項目標準

名稱名稱

jyxmbm檢驗項目編碼StringNull醫療機構內檢

驗項目代碼

jyxmmc檢驗項目名稱StringNotnull醫療機構內檢

驗項目名稱

indicatorsList對象（檢驗結果指標）

參數名稱說明類型約束值說明

jyzblsh檢驗指標流水StringNotnull

號

jyrq檢驗日期StringNotnullyyyy-MM-dd

hh:mni:ss

jcrgh檢測人工號StringNotnull

jcrxm檢測人姓名StringNotnull

shrgh審核人工號StringNotnull

shrxm審核人姓名StringNotnull

ybsfdm檢測收費代碼StringNotnull檢測收費代碼

填寫醫院內自

編的唯一標識

該收費的編

碼。若檢臉項

目沒有單獨的

收費代碼，則

應填寫該項目

的收費組套的

編碼。

ybsfdmyb項目標準代碼StringNotnul1醫保統一要求

的收費編碼

jcxmmc檢測項目名稱StringNotnull

jczbdm檢測指標代碼StringNotnull醫療機構內檢

測項目代碼

jczbmc檢測指標名稱StringNotnull醫療機構內檢

測項目名稱

jcff檢測方法StringNull

jczbjgdx檢測指標結果StringNull

定性

jczbjgdl檢測指標結果StringNull

定量

loincLOINC編碼StringNull

sbbm設備編碼StringNull

yqbh儀器編號StringNull

yqmc儀器名稱StringNull

ckzfwdx參考值范圍定StringNull

性

ckzfwxx參考值范圍下StringNull

限

ckzfwsx參考值范圍上StringNull

限

jldw計量單位StringNull

ycts異常提示StringNotnull1異常2正常

3不詳415-

6t7陰性8

陽性9可疑

yctssm異常提示說明StringNull異常提示說明

sfwjz是否危急值StringNull0：否1：是

wjzcz是否已及時處StringNull0：否1：是

置危急值

yzid相關醫囑IDStringNull

或處方項目明

細編號

xssh顯示順序StringNull

dyxh打印序號StringNull

jyxmdmhr檢驗互認項目StringNotnul1互認項目標準

編碼編碼

jyxmmchr檢驗互認項目StringNotnull互認項目標準

.名稱名稱

bacteriaResultList對象（細菌結果）

參數名稱說明類型約束值說明

xjjglsh細菌結果流水StringNotnull

號

jyrq檢驗日期StringNotnullyyyy-MM-dd

hh:nim:ss

xjdh細菌代號StringNotnul1

xjmc細菌名稱StringNotnul1

jljs菌落計數Stringnull

byj培養基StringNull

bysj培養時間StringNull

pytj培養條件StringNull

fxfs發現方式StringNull例如：“肉眼”

或“鏡檢”等

jcjgdm檢測結果代碼StringNull0：-1:+2:++

3：+++4:++++

jcjg檢測結果簡述StringNotnull

jcjgwz檢測結果文字StringNnll

描述

sbbm設備編碼StringNull

yqbh儀器編號StringNull

yqmc儀器名稱StringNull

sybxh試驗板序號StringNull

sybmc試驗板名稱StringNull

jyxmdmhr檢驗互認項目StringNotnull互認項目標準

編碼編碼

jyxmmchr檢驗互認項目StringNotnull互認項目標掂

名稱名稱

wjzzt危急值狀態StringNull0：無1：有

xjlb細菌類別StringNull衣原體、支原

體、細菌、真

菌

allergyResultList對象（藥敏結果）

參數名稱說明類型約束值說明

ymjglsh藥敏結果流水StringNotnull

號

xjdh細菌代號StringNotnull

xjjg細菌結果StringNotnull

jljs菌落計數StringNull

dyxh打印序號StringNull

ymdm藥敏代號StringNotnull

ymmc藥敏名稱StringNotnull

kyjgdm抗藥結果代碼StringNotnull見4.4藥敏實

驗結果代碼表

kyjgmc抗藥結果名稱StringNotnul1

jcjg檢測結果描述StringNotnull

zphyl紙片含藥量StringNull

zphyldw紙片含藥量單StringNull

位

yjnd抑菌濃度StringNull

yjhzj抑菌環直徑StringNull

jyxmdmhr檢驗互認項目StringNotnul1互認項目標準

編碼編碼

jyxmmchr檢驗互認項目StringNotnull互認項目標準

名稱名稱

wjzzt危急值狀態StringNull0：無1：有

jldw計量單位StringNull

kbjgKB結果StringNotnull

etestjgETEST結果StringNotnull

kssjcjgz抗生素檢測結StringNull

果值

sybxh試驗板序號StringNull

yfyl用法及用量StringNull

jcff檢測方法StringNull

kssckjlxx抗生素參考劑StringNull

量下限

kssckjlsx抗生素參考劑StringNull

量上限

1.3.2.2.請求示例

{

“yljgdm":"cloud-hosplial”,

"bgdh":"8。

"bgrq":"2023-07-2110:47:10\

jylx：1,

〃??,〃〃〃

jzlsh:,

mzzybz:1,

"jzlx”:〃01〃，

"ksbm":"OOI”,

"ksmc〃：〃綜合科〃，

〃kh":",

"klx”:T,

“dzjkk":"222222”,

"fileNumber":"333333”,

"sfzjlbbm":"01",

〃sfzh〃：〃密文'，

“brxm":"密文"，

brxb:1,

"csrq”:〃1960-03-2200:00:00〃,

〃brdh〃：〃密文”，

"xzdz":"密文*,

"sqrgh":"1001”,

"sqrxnT:"申請人姓名”，

“sqrsfz”:〃密文〃，

"bgrgh":"1002”,

"bgrxm”:〃報告人姓名”，

"bgrsfz":"密文"，

"shrgh”:〃1003〃，

"shrxm”:〃審核人姓名〃,

"shrsfz":"密文"，

〃sqks〃：〃001〃，

“sqksmc":"綜合科”，

“dzsqdbh":

"zyh":"住院號”,

mjzh:,

〃bq":"病區名稱〃，

"bqdm"："病區代碼”,

〃bfh〃：〃病房號〃，

〃ch":“病床號”，

"dyrq":"2023-07-2015:40:01”,

sqrq":"2023-07T915:40:01”,

"cjrq〃："2023-07-1916:40:02",

〃jyrq”:〃2023-07-1917:40:01〃，

"shsj":"2023-07-1918:40:01”,

“bgjgdm":"cloud-hosptial”,

“bgjgmc":"cloud-hosptial”,

"bgbz":"報告備注",

"bbdm":"123321”,

"bbmc":"標本名稱”,

"bbzt":"標本狀態”,

"bgdlbbm":"1",

〃bgdlb〃：〃一般臨床檢驗〃，

"jcmd":"檢查目的”，

〃t〃，

〃一〃〃〃

ybh:y,

"jyksdm":"001”,

"jyksmc":"綜合科”,

“sysmc":"實驗室名稱〃，

sysdz:能又，

"syslxdh":"密文"，

“ybjssj":"2023-07-1915:20:02”,

"cjb*〃：〃部位”，

〃sqdj川」：”申請單據名稱“，

"jyflmc":"患者檢驗項目所屬的類別詳細描述〃,

“jybgjg”:〃檢驗報告結果〃，

“jysqjgmc":"cloud-hosplial”,

“jyjgmc":"cloud-hosptial”,

“jyjsxm":"檢驗技師姓名”,

"jyjsgh"："j002”,

"sjysgh":"s008”,

“sjysxnT:〃送檢醫師姓名〃，

yyjybgwj：2,

WJ1J：,

“jbzdList”:[

(

"jbzddm":"AOI.000”,

"jbzdmc":"傷寒"

},

(

"jbzddm":"A09.901”,

"jbzdmc":"胃腸炎”