广东省医学检验检查结果互认共享平台接口规范医疗机构.docx

广东省医学检验检查结果互认共享平台接口规范（医疗机构）广东省卫生健康委2023年09月版本号版本日期修订内容修订人VI.O2023-08-08创建文档周志鹏VI.12023-08-23敏感信息加密规则,第三方依赖jar包(SMEnDC)升级为L3版本周志鹏VI.22023-09-01补充完善第一章加密规则、入参以及示例等等。张英斌目录第一章数据上传接口51.1. 概述51.1.1. 文档说明51.1.2. 读者对象51.1.3. 术语51.2. 接口约定61.2.1. 平台接口61.3. 接口服务列表81.3.1. 用户认证获取token接口81.3.2. 检验数据实时上传101.3.3. 撤销检验数据331.3.4. 检查数据实时上传351.3.5. 撤销检查数据531.3.6. 患者信息数据实时上传551.3.7. 检验检查报告PDF文件实时上传631.3.8. 医院的科室字典数据实时上传671.3.9. 医疗机构人员字典数据实时上传71第二章互认服务接口782.1. 系统应用接口规范782.1.1. 接口列表782.1.2. 1.2.业务流程792.1.3. 补充说明115第三章值域字典1163.1. 就诊类型编码1163.2. 就诊卡类型代码表1173.3. 身份证件类别代码1183.4. 药敏实验结果代码表1183.5. 麻醉方法代码表1183.6. 操作部位代码表120第一章数据上传接口1.1 .概述1.1.1. 文档说明本文详细阐述了第三方与地市检查检验结果共享互认平台对接，进行相关业务数据上传的接口规范，调用该服务接口可将检验检查结果互认报告相关数据进行实时上传。1.1.2. 读者对象本文档的阅读对象为需要与检查检验结果共享互认平台对接服务集成的相关应用开发人员、测试人员，系统集成人员。1.1.3. 术语缩写、术语解释HTTP超文本传传输协议RESTfuI一种软件架构风格、设计风格，提供了一组设计原则和约束条件。它主要用于客户端和服务器交互类的软件。基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存等机制。Consumerld平台给每个接入的第三方应用分配的唯一身份标识编码sm2公钥平台给第三方接入的应用分配的加密公钥，用这个公钥对“消费者编号”进行加密affairToken用于对调用对象进行身份辨识，affairToken有效期，默认6小时0超时后，将无法继续使用次affairToken调用服务°需要再次调用接口获得新的affairToken01.2 .接口约定1.3 .平台接口1.2.1.1. 接口协议采用HTTP/HTTPS协议。1.2.1.2. 服务地址联调测试时由平台提供。1.2.1.3. 报文格式约定1.2.1.3.1. 请求报文格式JSON报文格式，报文结构如下:()1.2.1.3.2. 应答报文格式JSON报文格式，报文结构如下:12133.响应码字典code返回码编码说明0成功，无返回信息1成功，有返回信息-1失败1.2.1.4.敏感信息加密规则针对接口服务列表相关接口请求入参相关字段涉及的敏感信息需要进行加密传输，具体哪些字段需要进行加密传输，详见对应接口的字段说明，加密方式为SM4,加密秘钥由平台分配，具体的加密示例如下：W互联互通互认平台跨市接口加解密工相关第三方依赖包如下：bcprov-jdk15on-1.68.jarSMEnDe-13Jarcommons-codec-1.16.O.jar1.3. 接口服务列表1.3.1. 用户认证获取token接口接口说明用户认证并获取token接口请求方式POST编码方式UTF-8URLhttp:/ip:port/hrserver/identifyService/shakehands重点说明1、token有效期，默认6小时。超时后，将无法继续使用次token调用服务。需要再次调用接口获得新的token。2、authenticateStr加密方式为国密2.COnSUmerId和配套sm2公钥，会以线下的方式，发放给每个市级单位。或者省级医院。1.3.1.1. 请求参数说明参数名称类型约束备注ConsumerId用户IDStringNotnull消费者编号长度为8的字符串authenticateStr调阅密码StringNotnull消费者编号加密后的密文;平台会下发一个SM2的公钥，用这个公钥对“消费者编号”进行加密dsqhdm地市区划代码StringNotnull地市区划代码说明：Ktoken有效期，默认6小时。超时后，将无法继续使用次token调用服务。需要再次调用接口获得新的token。2、authenticateStr加密方式为国密2.COnSUmerId和配套sm2公钥，会以线下的方式，发放给每个市级单位。1.3.1.2. 请求示例请求方式：POST"consumerld"P97Q8T2XauthenticateStr:"04e23e34e8167d00babccb5ffc071880e4906ed79b549aed44ed4dcd427bfcbc36bdl3ff8a69d9e5c2cac8a4787ae862a61a22ae59b5f4babe806fdba39a559d8cfa6f3fa7f050elaf3fadaf518967e7aa9d4744bd6177efd3fddef699da807051.3.1.3. 应答参数说明参数名称类型约束备注result结果StringNotnullsuccess、failureaffairToken令牌StringNotnullresult为SUCCeSS时返回token1.3.1.4. 应答参数示例result":"success”,affairToken,z:"8a817a44723ee,z1.3.2. 检验数据实时上传接口说明实时上传检验数据请求方式POST编码方式UTF-8URLhttp:/ip:porthrserverupload/realtime/lisdata1.3.2.1. 请求参数说明header参数名称类型约束备注affairTokenTokenStringNotnullbody参数名称说明类型约束值说明yljgdm医疗机构代码StringNotnullbgdh检验报告单号StringNotnullbgrq报告H期StringNotnullyyyy-MM-ddhh:mm:ssjyi检验类型StringNotnull1:常规检验；2:细菌培养jzlsh就诊流水号StringNotnullmzzybz门诊住院标志StringNotnull1门诊，2住院，3家床,4体检jzlx就诊类型StringNotnull见4.1就诊类型编码ksbm患者就诊科室编码StringNotnul1ksmc患者就诊科室名称StringNotnullkh卡号StringNotnullklx卡类型StringNotnull见4.2就诊卡类型代码表dzjkk电子健康卡IDStringNotnul1fiIeNumber患者档案号StringNotnullsfzjlbbm身份证件类别代码StringNotnul1见4.3身份证件类别代码sfzh患者身份证号StringNotnull该字段需进行加密处理brxm病人姓名StringNotnull该字段需进行加密处理brxb病人性别StringNotnul10、未知的性别1、男性2、女性csrq病人出生日期StringNotnullyyyy-MM-ddhh:nun:ssbrdh病人电话StringNull该字段如果不为空则需要进行加密处理xzdz现住地址StringNull该字段如果不为空则需要进行加密处理sqrgh申请人工号StringNullsqrxm申请人姓名StringNotnullsqrsfz申请人身份证StringNull该字段如果不号为空则需要进行加密处理bgrgh报告人工号StringNotnul1bgrxm报告人姓名StringNotnullbgrsfz报告人身份证号StringNull该字段如果不为空则需要进行加密处理shrgh审核人工号StringNotnullshrxm审核人姓名StringNotnullshrsfz审核人身份证号StringNull该字段如果不为空则需要进行加密处理sqks申请科室编码StringNotnull院内科室编码sqksmc申请科室名称StringNotnull院内科室名称dzsqdbh电子申请单编号StringNullzyh住院号SiringNull为住院时必填mjzh门（急）诊号StringNull为门诊就诊时必填bq病区SiringNullbqdm病区代码StringNull院内代码bfh病房号StringNullch床号StringNulldyrq打印日期StringNotnullyyyy-MM-ddhh:mm:sssqrq申请日期StringNotnullyyyy-MM-ddhh:mm:SScjrq采集日期StringNotnul1yyyy-MM-ddhh:mm:ssjyrq检验日期StringNotnullyyyy-MM-ddhh:mm:ssshsj审核日期时间StringNotnullyyyy-MM-ddhh:mm:ssbgjgdm报告机构代码StringNotnul1bgjgmc报告机构名称StringNotnullbgbz报告备注StringNullbbdm标本代码StringNotnul1医疗机构内标本类型代码bbmc标本名称StringNotnull医疗机构内标本类型名称bbzt标本状态的描述StringNotnullbgdlbbm报告单类别编码StringNotnul1编码。I=一般临床检验；2=血液学检查;3=临床化学检查；4:临床免疫学检查；5二临床微生物学检查6=临床寄生虫学检查；7=分子生物学检查；9999=其它bgdlb报告单类别名称StringNotnulljcmd检查目的StringNotnulltmh条码号StringNotnullybh样本号StringNotnulljyksdm检验科室代码StringNulljyksmc检验科室名称StringNullsysmc实验室名称StringNullsysdz实验室地址StringNull该字段如果不为空则需要进行加密处理syslxdh实验室联系电话StringNull该字段如果不为空则需要进行加密处理ybjssj样本接收日期StringNotnullyyyy-MM-ddhh:mm:sscjbw采集部位StringNull采集部位，微生物必填sqdjmc申请单据名称StringNulljyflmc检验分类名称StringNulljybgjg检验报告结果StringNotnulljysqjgmc检验申请机构名称StringNotnul1jyjgmc检验机构名称StringNotnulljyjsxm检验技师姓名StringNulljyjsgh检验技师工号StringNullsjysgh送检医师工号StringNullsjysxm送检医师姓名StringNullyyjybgwj是否提供电子版检验报告文件StringNotnullL无2：有wjlj检验报告的文件链接地址urlStringNull当是否提供电子版检验报告文件为2时必填jbzdList疾病诊断列表JSon数组hrxmList检验互认项目列表Json数组indicatorsList检验结果指标Json数组BacteriaResultList细菌结果Json数组alIergyRcsultList药敏结果JSon数组jbzdList对象（疾病诊断列表）参数名称说明类型约束值说明jbzddm疾病诊断代码StringNotnul1医疗机构内西医诊断编码jbzdmc疾病诊断名称StringNotnull医疗机构内西医诊断名称hrxmList对象（检验互认项目列表）参数名称说明类型约束值说明hrbm检验互认项目编码StringNotnull互认项目标准编码hrmc检验互认项目名称StringNotnull互认项目标准名称jyxmbm检验项目编码StringNull医疗机构内检验项目代码jyxmmc检验项目名称StringNotnul1医疗机构内检验项目名称indiCatorsList对象（检验结果指标）参数名称说明类型约束值说明jyzblsh检验指标流水号StringNotnulljyrq检验日期StringNotnullyyyy-MM-ddhh:nun:ssjcrgh检测人工号StringNotnulljcrxm检测人姓名StringNotnullshrgh审核人工号StringNotnullshrxm审核人姓名StringNotnul1ybsfdm检测收费代码StringNotnull检测收费代码填写医院内自编的唯一标识该收费的编码。若检验项目没有单独的收费代码，则应填写该项目的收费组套的编码。ybsfdmyb项目标准代码StringNotnull医保统一要求的收费编码jcxmmc检测项目名称StringNotnul1jczbdm检测指标代码StringNotnull医疗机构内检测项目代码jczbmc检测指标名称StringNotnul1医疗机构内检测项目名称jcff检测方法StringNulljczbjgdx检测指标结果定性StringNulljczbjgdl检测指标结果足里StringNullIoincLOINC编码StringNullsbbm设备编码StringNullyqbh仪器编号StringNullyqmc仪器名称StringNullckzfwdx参考值范围定性StringNullckzfwxx参考值范围下限StringNullckzfwsx参考值范围上限StringNulljldw计量单位StringNullycts异常提示StringNotnull1异常2正常3不详4I5-617阴性8阳性9可疑yctssm异常提示说明StringNull异常提示说明sfwjz是否危急值StringNull0：否1：是wjzcz是否已及时处置危急值StringNull0：否1：是yzid相关医嘱ID或处方项目明细编号StringNullxssh显示顺序StringNulldyxh打印序号StringNulljyxmdmhr检验互认项目编码StringNotnull互认项目标准编码jyxmmchr检验互认项目名称StringNotnull互认项目标准名称bacteriaResultList对象（细菌结果）参数名称说明类型约束值说明xjjglsh细菌结果流水号StringNotnulljyrq检验日期StringNotnullyyyy-MM-ddhh:mm:SSxjdh细菌代号StringNotnul1xjmc细菌名称StringNotnullJljs菌落计数Stringnul1byj培养基StringNullbysj培养时间StringNullpytj培养条件StringNullfxfs发现方式StringNull例如：“肉眼”或“镜检”等jcjgdm检测结果代码StringNull0：-1:+2:+3:+4:+jcjg检测结果简述StringNotnulljcjgwz检测结果文字描述StringNnllsbbm设备编码StringNullyqbh仪器编号StringNullyqmc仪器名称StringNullsybxh试验板序号StringNullsybmc试验板名称StringNulljyxmdmhr检验互认项目编码StringNotnull互认项目标准编码jyxmmchr检验互认项目名称StringNotnull互认项目标准名称wjzzt危急值状态StringNull0：无1：有xjlb细菌类别StringNull衣原体、支原体、细菌、真菌HllergyResultList对象（药敏结果）参数名称说明类型约束值说明ymjglsh药敏结果流水号StringNotnullxjdh细菌代号StringNotnulljjg细菌结果StringNotnulljljs菌落计数StringNulldyxh打印序号StringNullymdm药敏代号StringNotnullymmc药敏名称StringNotnul1kyjgdm抗药结果代码StringNotnull见4.4药敏实验结果代码表kyjgmc抗药结果名称StringNotnulljcjg检测结果描述StringNotnullzphyl纸片含药量StringNullzphyldw纸片含药量单位StringNullyjnd抑菌浓度StringNullyjhzj抑菌环直径StringNulljyxmdmhr检验互认项目编码StringNotnull互认项目标准编码jyxmmchr检验互认项目名称StringNotnull互认项目标准名称WjZZt危急值状态StringNull0：无L有jldw计量单位StringNullkbjgKB结果StringNotnul1etestjgETEST结果StringNotnullkssjcjgz抗生素检测结StringNull果值sybxh试验板序号StringNullyfyi用法及用量StringNulljcff检测方法StringNullkssckjlxx抗生素参考剂量下限StringNullkssckjlsx抗生素参考剂量上限StringNull1.3.2.2.请求示例“yljgd:“cloud-hosptial”,"bgdh":"8",bgrq":"2023-07-2110:47:10*,jylx:1,Jzlsh:,mzzybz:1,"jzlx"：01",ksbm"："oor,ksmc：综合科”，kh":"，"klx”:T,“dzjkk":"222222”,"fiIeNumber”:"333333”,*sfzjlbbm*:"01”,“sfzh":"密文","brxm":"密文"，brxb:1,"csrq":"1960-03-2200:00:00","brdh":"密文"，"xzdz":"密文","sqrgh":"IOo1","sqrxm":"申请人姓名”，“sqrsfz”:密文"，*bgrgh*:"1002”,“bgrx:"报告人姓名，*bgrsfz*:"密文”,"shrgh":"1003”,“shrxm":"审核人姓名”，"shrsfz":"密文"，"sqks":"Oo1","sqksmc":"综合科”，"dzsqdbh":”，"zyh":"住院号"，“I”mjzn:,bq”：病区名称“，"bqd11:"病区代码"，"bfh":"病房号"，"ch":"病床号"，"dyrq":"2023-07-2015:40:01","sqrq":"2023-07-1915:40:01*,"cjrq”:,2023-07-1916:40:02，"jyrq":"2023-07-1917:40:01","shsj":"2023-07-1918:40:01",“bgjgdm”:,cloud-hosptialz,“bgjgc”:z,cloud-hosptialyz,"bgbz”:报告备注，bbdm：“123321”,bbmc：”标本名称，"bbzt":标本状态，“bgdlbbn:"1",bgdlb：一般临床检验”，"jcmd”:检查目的，tmh：t，I1yb11：y,"jyksdm":"001","jyksmc":"综合科”,"sysmc”:实验室名称，"sysdz":"密文"，“syslxdh":"密文","ybjssj":"2023-07-1915:20:02”,"cjbw”:部位，"sqdjmc":申请单据名称，"jyfhnc：患者检验项目所属的类别详细描述,"jybgjg”:检验报告结果”，“jysqjgmc":"cloud-hosptial",“jyjgmc”:cloud-hosptiaK,"jyjsxm”:检验技师姓名，"jyjsgh"："j002","sjysgh":"s008","sjysx:“送检医师姓名，yyjybgwj:2,Wjlj：,*jbzdList*:(“jbzdd:"AOL000”,"jbzdmc":"伤寒",("jbzddm”:*A09.901*,“jbzdmc":"胃肠炎"),“hrxmList”:(nrbm:,"hrmc":"尿常规"，"jyxmb:医疗机构内检验项目代码1”,“jyx三:"医疗机构内检验项目名称1,(nrbm:,hrmc:尿素，jyxmbm：”医疗机构内检验项目代码2”,"jyxmmc”:医疗机构内检验项目名称2”,indicatorsList*:(“jyzblsh":"JY2”,"jyrq":"2023-07-1917:55:03”,"jcrgh":"JCOo3，“jcrxm：”检测人姓名”，"shrgh":"SHoO3","shrxm”:审核人姓名，“ybsfd:医院内自编的唯一标识该收费的编码,"ybsfdmyb":“由医保统一要求的收费编码，“jcxmmc”:医疗机构内检测项目名称，jczbdm："指标代码，“jczbmc：指标名称，"jcff":"检测方法”,Tczbjgdx”:检测指标结果定性”，"jczbjgdl":"检测指标结果定量”，"loinc":"LOINC编码，“sbb:设备编码”，"yqbh”:仪器编号”，yqmc：仪器名称，“ckzfwdx”:参考值范围定性，"ckzfwxx":"参考值范围下限，ckzfwsx：参考值范围上限”，计量单位”，yctssm：异常，r八SIWjz:O,Wjzcz:O,”.ZZ"yzd:,xssh:1,dyxh:1,Jyxmdmhr:,Tyxmmchr”:尿常规“jyzblsh":"JY33","jyrq":"2023-07-1918:35:03”,"jcrgh”:JCOo3，“jcrx:检测人姓名，"shrgh":"SHoO3",“shc:审核人姓名，“ybsfd:医院内自编的唯一标识该收费的编码,“ybsfdmyb":“由医保统一要求的收费编码，“jcxmmc：”医疗机构内检测项目名称，TczbdnT:指标代码”，"jczbmc：指标名称，jcff：检测方法，Tczbjgdx”:检测指标结果定性，"jczbjgd":"检测指标结果定量”，"loinc”:LolNC编码”，“sbb:设备编码”，"yqbh":"仪器编号",yqmc：仪器名称，“ckzfwdx”:参考值范围定性，"ckzfwxx":"参考值范围下限”，ckzfwsx：参考值范围上限”，"jldw":"计量单位",ycts:1,"yctssm":"异常"，一八Stwjz:O,Wjzcz:O,”.1Z“yz:,Xssh:1,dyxh:1,Jyxmdmhr:,“jyxmmchr：尿素),bacteriaResultList*:(XJJglsh:XJ,"jyrq":"2023-07-1918:35:03”,"xjdh":"YLJYXJjVFX","-T-"Xjmc:尢，大于10万"，byj”:巧克力平板，"bysj":"72小时”，"pytjz,:35±2;5就02”,"fxfs":肉眼”，1八"JCjgdm:O,jcjg：检测结果简述”，“jcjgwz：检测结果文字描述，“sbbn:设备编码，yqbh”：仪器编号”，"yqmc":"仪器名称"，“sybxh":试验板序号”，“sybmc：试验板名称“，"jyxmdmhr":"互认项目标准编码”,"jyxmmchr":"互认项目标准名称”,八wjzzt:O,"xjlb":"衣原体),“alIergyResultList”:"ymjglsh":"YM2。"xjdh":"YLJYXJjVFX",-TaXjjg:尢，"jljs":"大于10万”,dyxh:1,"ymdn:"AMX",“ymc”:阿莫西林”，yjgdm:1,"kyjgmc":"耐药"，"jcjg":"中度敏感”,"zphyl”:纸片含药量，“zphyldw”:纸片含药量单位”,"yjnd”:0.01gml”,"yjhzj":"O.OImn,"jyxmdmhr":"互认项目标准编码”，Tyxmmchr":"互认项目标准名称，wjzzt:O,“11”“I0JldW:g/ml,"kbjg":"KB结果。“etestjg":ETEST结果"，kssjcjgz：抗生素检测结果值，“kssckjlxx”:抗生素参考剂量下限,"kssckjlsx":"抗生素参考剂量上限”,"sybxh”:试验板序号，“yfyl":用法及用量，"jcff”:检测方法”1.3.2.3.应答参数说明参数名称类型约束备注code返回码IntNotnull见补充说明返回码msg信息描述StringNotnulldata返回数据JSOn对象Code为O时没有data1.3.2.4.应答参数示例"code”:0,“message":"success”,"data”:nul11.3.2.5.Postman请求示例ParamsAuthorizationHeadersBodyPre-requestScriptTestsSettingsHeaderso8hiddenKEYVALUEDESCRIPQaffairToken041996ad4396702d0aa6f103bffd9dfd62fea1b08dc240d3b7437b6d.CookiesBeautify今 Status 2 OK Dmq： 394 ms Size： 284 B Save Response Dt QPafamsAuthoclMttonHeddefS例BoOyPgYeqUeStScriptTestsSengsnoneIormYaux-www*form*ucieodedrawbinaryGrephOLJSONV2yl"8:医疗机构代玛，3bgdh:222weeee,",4t>grq:2622iel16：38：W,j15h:“像诊水号6 wybza:lr7 k:"-,BodyCookiMHeaders()TestResuIUPrettyRawPreviewVisuilczeJSONv三5c<xJe:明"«sg"："data"：null1.3.3.撤销检验数据接口说明撤销上传的检验数据请求方式POST编码方式UTF-8URLhttp:/ip:porthrserverupload/realtime/cancelIisdata1.3.3.1. 请求参数说明header参数名称类型约束备注affairTokenTokenStringNotnullbody参数名称说明类型约束值说明yljgdm医疗机构代码StringNotnullbgdh检验报告单号StringNotnullbgrq报告日期StringNotnullyyyy-MM-ddhh:mm:ss1.3.3.2. 请求示例“yljgdm":"cl。UeHIoSPtia1”,bgdh：2”,"bgrq":"2023-07-2110:47:101.3.3.3. 应答参数说明参数名称类型约束备注code返回码IntNotnull见补充说明返回码msg信息描述StringNotnulldata返回数据JSOn对象Code为0时没有data1.3.3.4. 应答参数示例"code”:0,message:success,"data":null1.3.3.5. Postman请求示例ParamsAuthorizationHeadersBodyPre-requestScriptTestsSettingsHeaders8hiddenDESCRIHKEYVALUEaffairToken041996ad4396702d0aa6f103bffd9dfd62fea1b08dc240d3b7437b6d.POSThttp:/127.0.0.1:8090/hrserver/upload/realtime/cancellisdata发送HeaderQueryBody认证硒亍脚本后执本一键压测A可视化结构Onone。form-data。×-www-form-urlencoded。rawjsonV色提取字段和描述户美化昆点击更