金华检查检验互认平台标准接口规范

金华检查检验互认平台标准接口规范

版本变更记录

版本号更改条款及内容更改人审批人更改日期

1.0标准功能接口编写2021.09.26

4.2.2接口人参中‘主诉'，’临床

1.1表现'、‘收缩压'、'舒张压'

必传改为非必传

4.2.3接口出参去掉’检验结果数

1.2

值，

4.2.4接口出参增加'是否互认'、

1.3

'不互认理由'

4.2.1及4.2.2接口入参增加'请

求MAC地址'

4.2.2接口描述中去掉“检查及检

1.4

验列表必须传入其中一种”的说明

4.2.2项目金额字段，4.2.1和

4.2.2的MAC地址字段改为必填

增加4.2.5接口：查询互认是否完

1.52021.11.24

成

4.2.4接口出参增加“是否预约开

单”

1.62021.12.28

4.2.5接口出参增加“是否预约开

单”

1范围及背景

本规范功能及接口遵循浙江省标准，并参考《浙江省检查检验结果互认共享

平台总体建设方案vl.O》、《浙江省检查检验结果互认共享平台-智能提示客户

端页面与功能规范VI0》、《浙江省检验检查结果互认共享平台-智能提示客户

端与HIS系统交互接口规范(VI.0)》等文件进行设计。

平台搭建仝市统一的检查检睑互认平台，包括前端提醒操作模块和后端互认

支撑服务。前端提供统一的互认H5页面；后台包括全市统一的互认规则引擎，

提供统一的互认提醒服务。

2业务场景描述

流程说明：撰写病历路径

1.患者院内进行就诊；

2.医生在医生工作站撰写病历；

3.病历中的辅助检查（或其他类似的段落）中进行“引用”操作，调用发起（检查、检验）

结果导入申请接口自动判断是否存在可引用的项目；

4.如不存在，提示不存在可引用项目：

5.如存在，平台返回导入（检查/检验）提示窗口，供医生选择项目导入至病历中的辅助

检查中（可调阅检验报告和影像资料）；

6.医生选择后，工作站系统通过查询所选（检查、检验）结果导入数据—接口获取医生选

择的数据进行导入；

7.医生继续后续接诊流程。

医院检查检验互认平台

流程说明：医生接诊路径

1.医生接诊，通过刷卡患者授权；

2.调用发起（检查、检验开单）互认申请接口，自动判断患者是否存在可互认项目；

3.如不存在，医生继续后续接诊流程；

4.如存在，显示30天内报告提示，医生可选择是否调阅；

5.如调阅，平台返回互认提示窗口，提供医生该患者规则内可互认项目，医生可根据患者

情况选择互认或不互认操作（不互认需填写理由），可调阅检验报告和影像资料；

6.选择后点击【确认】，生成业务号（相关系统可以通过业务号查询互认详情完成业务闭

环），关闭弹窗；

7.医生继续后续接诊流程。

医院检查检验互认平台

流程说明：检查检验开单互认路径

8.患者院内进行就诊；

9.医生在医生工作站进入患者检查开单页面；

10.开单页面中医生选择新增检查项目，保存检查项FI前调用发起（检查、检验开单）互认

申请接口，自动判断人参项目中是否存在可互认项目；

11.如不存在，保存申请单，继续后续接诊流程；

12.如存在，平台返回互认提示窗口，提供医生该患者开单项目规则内可互认项目，医生可

根据患者情况选择互认或不互认操作（不互认需填写理由）。可调阅检验报告和影像

资料：

13.选择后点击【确认】，激活业务号（相关系统可以通过业务号查询互认详情完成业务闭

环），关闭弹窗，HIS调用查询（检查、检验开单）互认数据接口，根据互认业务序号，

查询互认情况；

14.判断业务中是否互认，如存在互认，取消重复申请的项目，提交申请单;

15.医生继续后续接诊流程。

3接口协议

3.1调用方式

所有接口都是以POST方式调用。

3.2报文格式

所有数据均是以JSON格式作为接口报文进行接口交互。

数据类型描述说明

Object对象标准JSON格式

范例：{“keyl“：”valuel"，“key2"：”

value2”}

List集合标准JSON格式

范例：[{"keyl":"valuelw,nkey2"：”value'")]

String字符串标准JSON格式

范例："valuel”

3.3公共响应参数

数据类型描述说明

code响应码10000：成功;10001：失败

message响应描述消息描述

errorCode具体错误异常码见附录

result响应结果json字符串

4接口

4.1基础接口

4.1.1获取令牌信息（token）

接口描述：

对于接入平台的医院，平台将分配给医院一个医院编码，同时分配一组授权

编码及授权秘钥。调用此接口时通过医院编码、授权编码及授权秘钥获取调用其

他接口的令牌（token）信息。令牌失效时间为7天，失效后应重新调用该接口

获取新的令牌。

访问地址：

/api/getToken

请求方式：

POST

接口入参:

数据项类型必需默认值说明

hosCodeString是医院编码

grantCodeString是授权编码

grantKeyString是授权密钥

入参示例

{

args:{

"grantCode":"string",〃授权编码

“grantKey":"string”,〃授权密钥

"hosCode":"string”〃医院编码

)

)

接口出参:

数据项类型说明

code10000：成功;10001：失败

message消息描述

errorCode错误异常编码

resultjson

tokenString令牌信息，失效时间为7天，失效后应重新调用该接口

获取新的令牌。

出参示例

"code":"10000〃，

errorCode:string,

“message":"成功"，

“result”:（

“loken":"string"〃令牌信息，失效时间为7天

）

4.2互认平台提供接口

4.2.1发起（检查、检验）结果导入申请

接口描述：

此接11用于发起互认申请，平台返回可■操作页面，用户在页面完成互认确认

后相关系统可以通过业务号查询互认详情完成业务闭环。

此接口适用于场景：

导入相关检查、检验结果：传入患者身份信息和就诊信息，平台默认查询患者是否存在

报告。如果存在，可用浏览器弹出url对应的页面（此页面由平台提供），页面会显示最近

的检查、检验结果，可以随着页面滚动操作流畅持续加我更早的报告。

访问地址：

/mutualRccognition/importApply

请求方式：

POST

接口入参：

请求header类型必需默认值说明

Access-TokenString是请求令牌

数据项类型必需默认值说明

visitinfojson是就诊信息

visitNoString是HIS就诊号

clinicClassCodcString是就诊类型代码：1门诊，2急诊，3

住院

deptCodeString是就诊科室代码

deptNameString是就诊科室名称

visitDateString是就诊日期，yyyy-MM-ddHH:mm:ss

gbDeptCodeString国标科室代码

BbDeptNameString国标科室名称

doctorNoString是医生工号

doctorNameString是医生姓名

doctorldNoString是医生身份证，AES加密，详见附录二：

AES加密

complainString主诉

manifestationString临床表现

spString收缩压

dpString舒张压

patientinfojson是患者信息

patientNamcString是患者姓名

patientSexString是性别类型：1男，2女

identityCodeString是患者身份证AES加密，附录二：AES

加密

macAddressString是请求方MAC地址

入参示例

{

args:[

“visitinfo”:{

“visitNo":"String",//HIS就诊号

"clinicClassCode":"String”,〃就诊类型代码：1门诊，2急

诊，3住院

"dep(Code":"S1ring”,〃就诊科室代码

"deptName":"String”,〃就诊科室名称

"visitDate":"2020-01-0110:01:01",〃就诊日期，

yyyy-MM-ddHH:mm:ss

"gbDcptCodc":"String",〃国标科室代码

"gbDeptName":"String”,〃国标科室名称

"doctorNo":"String”,〃医生工号

"doclorName":"String”,〃医生姓名

"doctorldNo":"String”,〃医生身份证，AES加密

"complain":"String",〃主诉

"manifestation”「'String”,〃临床表现

〃sp":"String”,〃收缩压

〃dp":"String”〃舒张压

),

"patientinfo”:{〃患者信息

"patientName":"String”,〃患者姓名

"palienlSex":"String“〃性别类型：1男，2女

"identityCode":"String”〃患者身份证AES加密

),

“macAddress":"String”〃请求方mac地址

)

)

接口出参:

数据项类型说明

codeString10000：成功；10001：失败

messageString消息描述

errorCodeSiring错误异常编码

resultjson格式：{}

flagboolean是否存在互认的项目，若为false,可忽略url。若为true,

用浏览器弹出url对应的页面（此页面由平台提供），由医

生进行互认相关操作，然后再通过businessld调用4.2.3查

询互认项目信息接口获得互认结果。

businessldString此次操作的业务号,标识码

urlString平台的页面url

出参示例

（

"code":"10000”,

crroi'Code:.

“message":"操作成功”，

“result”:{

“flag":true,〃是否存在互认的项目

"businessld"J'xxxxx",〃此次操作的业务号，标识码

"url":"www.baidu.com”〃平台的页面url

）

）

4.2.2发起（检查、检验开单）互认申请

接口描述：

此接口用于发起互认申请，平台返回可操作页面，用户在页面完成互认确认

后相关系统可以通过业务号查询互认详情完成业务闭环。

此接口适用于场景：

开检查、检验申请单传入患者身份信息和就诊信息examList和labList对应的List

可以传入一个项目，也可以同时传入多个项目。平台会根据传入的检食、检验项目查询患者

是否存在可互认的检查检验报告（互认规则由平台统一管理）：如果存在可互认的报告，用

浏览器弹出url对应的页面（此页面由平台提供），由医生进行互认相关操作，然后再通过

businessID调用4.2.4查询互认项目信息接口获得互认结果。

注意：由于为了适配不同his的情况，此接口限制仅进行检查开单或检验开单，若his

流程有需求，请自行进行组合。

访问地址:

/mutualRecognition/checkApply

请求方式：

POST

接口入参：

请求header类型必需默认值说明

Access-TokenString是请求令牌

数据项类型必需默认值说明

visitinfojson是就诊信息

visitNoString是HIS就诊号

c1inicClassCodeString是就诊类型代码：1门诊，2急诊，3

住院

deptCodeString是就诊科室代码

deptNameString是就诊科室名称

visitDateString是就诊日期,yyyy-MM-ddHH:mm:ss

gbDeptCodeString国标科室代码

gbDcptNamoString国标科室名称

doctorNoString是医生工号

doctorNameString是医生姓名

doctorldNoString是医生身份证，AES加密

complainString主诉

manifestationString临床表现

spString收缩压

dpString舒张压

patientinfojson是患者信息

patientNameString是患者姓名

patientSexString是性别类型：1男，2女

identityCodeString是患者身份证,AES加密

examListList检查列表，可为空

examClassCodoString检查类别代码

examUlassNameString检查类别名称

examSubClassCodeString检查子类代码

examSubClassNameString检查子类名称

examltemCodeString是检查项目代码

examItemNameString是检查项目名称

positionCodeString检查部位代码

positionNameString是检查部位名称

deviceCodoString检查设备编码

deviceNameString检查设备名称

modelCodeString型号编码

modelNameString型号名称

priceString是检查价格

labListList检验列表，可为空

subjectCodeString是检验主题代码

subjectNameString是检验主题名称

samplcClassCodcString标本种类代码

samp1eClassNameString标本种类名称

testTubeCodeString试管种类代码

testTubeNameString试管种类名称例如：红管、灰管

labTestTypcCodcString检验类别代码

labTestTypeNameString检验类别名称例如：生化组

testModeCodeString检测方式代码

testModeNameString检测方式名称

priceString是检验价格

macAddressString是请求方MAC地址

入参示例

（

args:{

"visitinfo":{〃就诊信息

"visitNo":"String",//HIS就诊号

“clinicClassCode":"String”,〃就诊类型代码：1门诊，2

急诊，3住院

“deplCode":"Siring”,〃就诊科室代码

"deptName":"String”,〃就诊科室名称

"visitDatez，＜2020-01-0110:01:01",〃就诊日期，

yyyy-MM-ddHH:mm:ss

“gbDeptCode":"String”,〃国标科室代码

“gbDeptName":"Siring”,〃国标科室名称

"doctorNo":"String”,〃医生工号

"doctorName":"String",〃医生姓名

"doctorldNo":"String”,〃医生身份证，AES加密

“complain":"String",〃主诉

“manifestation":"String”,//临床表现

"String”,〃收缩压

〃dp〃：“String”〃舒张压

},

"patientinfo":{〃患者信息

"patientName":"String”,〃患者姓名

〃patientSex”:〃String〃〃性别类型：1男，2女

"identityCode":"String"〃患者身份证,AES加密

）.

"examList”:[〃检查列表，可为空

（

“examClassCode":"String”,〃检查类别代码

“examClassName":"String〃，〃检查类别名称

“examSubClassCode":"String",〃检查子类代码

“cxamSubClass'amc":"String”,//检查子类名称

“examltemCode":"String”,〃检查项目代码

“cxamltcmNam。"："String”,〃检查项目名称

positlonCode:String,〃检查部位代码

“positionName":"String”,〃检查部位名称

deviceCode:String,〃检查设备编码

“deviceName":"String”,〃检查设备名称

“modclCod。"："String”,〃型号编码

“modelName":"String”,〃型号名称

“price〃：“21.01"〃检查价格

"labList”:[〃检验列表，可为空

(

“subjectCode":"String”,〃检验主题代码

“subjectNanie”「String”,//检验主题名称

"samp1eC1assCode*:“String”,〃标本种类代码

，zsamp1cC1assNamcz，:“String”,//标本种类名称

“testTubeCode":"String”,〃试管种类代码

“testTubeNamc":"String”,〃试管种类名称例如：红

管、灰管

“labTestTypeCode":"String”,〃检验类别代码

w1abTestTypeName":"String”,〃检验类别名称例如生化

组

wtestModcCodcw："String",〃检测方式代码

"testModeName":"String",〃检测方式名称

"price":"21.01"〃检验价格

}],

"macAddress":"String”〃请求方mac地址

)

接口出参:

数据项类型说明

codeString10000：成功；10001：失败

messcigeString消息描述

errorCodeString错误异常编码

resultjson格式：0

flagboolean是否存在互认的项目，若为false,可忽略url。若为true,

用浏检器弹出url对应的页面（此页面由平台提供）.由医

生进行互认相关操作，然后再通过businessld调用4.2.4查

询互认项目信息接口获得互认结果。

businessldString此次操作的业务号,标识码

urlString平台的页面url

出参示例

（

"code”<10000”,

crroi'Code:.

“message"操作成功”，

“result”:{

“flag":true,〃是否存在互认的项目

"businessld":"xxxxx",〃此次操作的业务号，标识码

"url":"www.baidu.com”〃平台的页面url

）

}

4.2.3查询所选（检查、检验）结果导入数据

接口描述：

此接口根据1.2.1返回的某次导入操作业务序号businessld，查询该次导入

申请操作已经选择的项目，其中检验项目支持到子项指标项目

此接口适用于场景：导入检查检验结果时。

访问地址：

/mutualRecognition/gctImportInfo

请求方式：

POST

接口入参:

请求header类型必需默认说明

值

Access-TokenString是请求令牌

数据项类型必需默认说明

值

businessldString是业务序号，在4.2.1接口中由平台返回,

需要医院系统自行保存以保证业务闭环

入参示例

（

args:{

“businessld":Till"//业务序号

}

)

接口出参:

数据项类型说明

codeString10000：成功；10001：失败

messageString消息描述

errorCodeString错误异常编码

resultjson

examResultString用于导入电子病历的检查结果长文木

labResultString用于导入电子病历的检验结果长文本

examListList检查结果集（返回用户选中的项目，如有需要医

生工作站可以根据这些内容另行组织文本）

examldLong检查项目id,用于关联详情

orgCodeString机构代码

orgNameString机构名称

branchllospCodeString院区编码

branchHospNameString院区名称

visitNoStringHIS就诊号

encounterNoString接诊号

clinicClassCodeString就诊类型代码：1门诊，2急诊，3住院

examNoString检查序号

examReqNoString检查申请号

examClassCodeString检查类别代码

examClassNameString检查类别名称

examSubC1assCodeSiring检查子类代码

examSubClassNameString检查子类名称

examltemCodeString检查项目代码

examltcmNamoString检查项目名称

examModeCodeString检查方式代码

examModeNameString检查方式名称

positionCodeString检查部位代码

positionNamoString检查部位名称

deviceCodeString检查设备编码

deviceNameString检查设备名称

modelCodeString型号编码

modelNameString型号名称

reqDateTimeString申请日期及时间

reqDeptCodeString申请科室代码

reqDeptNameString申请科室名称

reqPhysicianCodeString申请医生代码

reqPhysicianNameString申请医生姓名

docGroupCodeString申请诊疗组代码

docGroupNameString申请诊疗组名称

rcqMcmoString申请备注

relevantDiagString其他诊断,依靠其他检查手段得到的有关诊断

clincDiagNameString临床诊断

clincSympString临床症状，症状是患者主观表达

examReasonString检查目的

physSignString体征

noticeString注意事项

executeDeptCodeString执行科室代码

executeDeptNameString执行科室名称

executeDateTimeString实际执行检验的日期及时间

technicianCodeString操作人员代码

technicianNameString操作人员姓名

reporterCodeString报告者代码

rcporterNameString报告者名称

verifyCodeString审核者代码

verifyNameString审核者名称

reportDateString报告日期及时间

resultStatusCodeString检查结果状态代码1收到申请、2已执行、3初

步报告、4确认报告等

resultStatusNameString检查结果状态名称，如：收到申请、已执行、初

步报告、确认报告等

imageIndicatorString影像标志。当产生影像时，为1,否则0

reportUrlString报告文件url

imageUrlString影像文件url路径

examltemString检查项目明细信息，json格式：口

examitemIdLong检查项目明细信息id

examParamString检查参数。检查过程中记录的有关内容

descriptionString检查所见

impressionString检查印象

isAbnorStringmalString是否异常

memoString备注

criticalFlagString危急值标志

infoctionFlagString传染病标识

labListList检验结果集（返回用户选中的项目，如有需要医

生工作站可以根据这些内容另行组织文本）

labldLong检验项目id用于关联详情

orgCodeString机构代码

orgNameString机构名称

branchHospCodeString院区编码

branchHospNameString院区名称

visitNoStringHIS就诊号

encounterNoString接诊号

clinicClassCodeString就诊类型代码：1门诊，2急诊，3住院

testRcqNoString检验申请单号

subjectCodoString检验主题代码

subjectNameString检验主题名称

testCauseString检验目的

relevantClinicDiagString临床诊断

samplcClassCodcString标本种类代码

sampledassNameString标本种类名称例如：血清

testTubeCodeString试管种类代码

testTubeNameString试管种类名称例如：红管、灰管

labTestTypeCodeString检验类别代码

labTestTypeNameString检验类别名称例如：生化组

testModeCodeString检测方式代码

testModeNameString检测方式名称

itemNumString子项数量

reqDateTimeString申请日期及时间

reqDeptCodeString申请科室代码

reqDeptNameString申请科室名称

reqPhysicianCodeString申请医生代码

reqPhysicianNameString申请医生姓名

docGroupCodeString申请诊疗组代码

docGroupNameString申请诊疗组名称

rcqMcmoString申请备注

samp1eNoString关联标本记录标本序列号

executeDeptCodeString执行科室代码

executeDeptNameString执行科室名称

executeDateTimcString实际执行检验的日期及时间

technicianCodeString检验操作人员代码

technicianNameString检验操作人员姓名

resultStatusCodeString结果状态代码

resultStatusNameString结果状态名称

resultsRptDateTimeString报告日期及时间

transcriptionistString报告者代码

transcriptionistNameString报告者姓名

reportUrlString报告url

verifiedDateTimeString审核日期及时间

verifiedByString审核人员代码

verifiedByNameString审核人员姓名

spcmReceivedDoctotCodeString采集样本医生代码

spcmReceivedDoctotNameString采集样本医生姓名

spcmReceivedDateString采集样本时间

spcmSamp1eDoctotCodeString送检样本医生代码

spcmSampleDoctotNameString送检样本医生姓名

spcmSampleDateString送检样本时间

isMicrobcString是否微生物（1是，。否）

bacteriumCodoString细菌检验，细菌代号

bacteriumNameString细菌检验，细菌名称

bacteriumResultString细菌检验，细菌结果

drugSensitivityCodeString药敏检验，药敏代码

drugScnsitivityNameString药敏检验，药敏名称

drugSensitivityResultString药敏检验，药敏结果

labitemString检验项目明细信息，json格式：口

labltemldLong检验项目明细信息Id

testItemCodeString检验明细项目代码

testltemNameString检验明细项目名称

resultString检验结果值

unitsCodeString检验结果单位代码

unitsNamcString检验结果单位名称

abnormalIndicatorString结果正常与否标志，N-正常L-低11-高

resultDateTimeString结果产生的日期和时间

resultReferenceString结果参考值

upperLimitString参考值上限

lowerLimitString参考值下限

resultMemString结果备注

crisisValueString危急值标志

出参示例

(

“code":"10000”,

errorCodc:,

"message":〃操作成功”，

“result”:(

"examResult":"String”,〃用于导入电子病历的检查结果长文本

"examResult":"String”,〃用于导入电子病历的检验结果长文本

"examList":[〃检查结果集

|

〃cxamld":1,//检查项目id,用于关联详情

"orgCode”:〃Slring〃，//机构代码

“orgNam。"："String”,//机构名称

“branchHospCode":"String",//院区编码

“branchHospName":"String",//院区名称

“visitNo":"String",//HIS就诊号

“encounterNo":"String”,//接诊号

*clinicClassCode*:"String",//就诊类型代码：1门诊，2急诊,3

住院

examNo:String,//检查序号

examReqNo:String,//检查申请号

“examClassCode":"String”,//检查类别代码

“examClassName":"String”,//检查类别名称

“examSubClassCodc":"String”,//检查子类代码

“examSubClassName":"String”,〃检查子类名称

“examltemCode":"String”,//检查项目代码

“oxamltomMam。"："String”,〃检查项目名称

“examModeCode":"String”,//检查方式代码

“cxamModcNamc":"String”,//检查方式名称

positionCode:String,//检查部位代码

positionName:String,//检查部位名称

deviceCode:String,//检查设备编码

deviceName:String,〃检查设备名称

“modelCode":"String”,〃型号编码

“mode1Name":"String”,〃型号名称

“reqDateTimc":"2021030120;：00:00\〃申请口期及时间

“reqDeplCode":"Siring”,//申请科室代码

“reqDeptName":"String”,//申请科室名称

“reqPhysicianCode":"Siring”,//申请医生代码

“reqPhysicianName":"String”,//申请医生姓名

，，docGroupCode，":“String”,〃申请诊疗组代码

“docGroupMame":"String”,〃申请诊疗组名称