HL7中国FHIR Connectathon测试实施指南
2024.5.5 - release
HL7中国FHIR Connectathon测试实施指南
2024.5.5 - release
本指南适用于HL7中国的FHIR Connectathon测试。
2020年2月，国家卫生健康委等六部委印发的 《关于加强医疗机构药事管理促进合理用药的意见》(国卫医发〔2020〕2 号)提出规范“互联网+药学服务” ，部分省份制定了《互联网医院处方流转平台规范化管理专家共识》，规范管理互联网医院、药店(社会药店或医院实体药房)和患者三者数据对接，在医生、药师和患者之间实现处方和药品信息互联互通。
本测试针对独立药房系统角色和医院端的电子病历系统角色涉及处方信息交互场景。
测试仅覆盖处方流转相关的核心资源（Patient，AllergyIntolerance，Condition，Observation、MedicationRequest等），不涉及相关流程和扩展资源，引用的相应FHIR资源不进行扩展性验证。
测试采用基于HTTP协议的RESTful API方式，现场点对点联接客户端和服务器端测试。
在本文档中包括如下角色：
电子病历系统将患者刘康的处方信息、诊断信息、过敏信息等产生消息，发送给药房系统，药房系统对相关信息进行解析和存储。
药房系统需要向电子病历系统检索患者刘康的诊断信息、过敏信息、检验报告和处方信息等相关信息；电子病历系统接收到检索请求后，获取相关信息并生成应答消息返回。
下图描述了角色以及角色之间的交易服务：
交易如下表所示：
| 角色 | 标识 | 交易描述 | 可选性 |
|---|---|---|---|
| 药房系统 | SMT-FHIR-001 | 推送处方信息 | R |
| SMT-FHIR-002 | 查询患者相关信息 | O | |
| 电子病历 | SMT-FHIR-001 | 推送处方信息 | R |
| SMT-FHIR-002 | 查询患者相关信息 | R |
处方流转的流程交互图如下:
本交互规范中涉及2个交易。
本交易由电子病历系统和药房系统角色使用。推送处方信息（SMT-FHIR-001）交易用于电子病历系统向药房系统主动推送一个患者的处方信息。
调用地址：
POST http://[ip]:[port]/fhir/$process-message
此消息使用POST方法将消息作为Bundle资源进行传输。
请求消息体的Content-Type应为application/fhir+json 或者 application/fhir+xml。
消息体定义参见推送处方请求消息结构定义。
消息体示例参见推送处方请求消息示例页面。
请求消息体应遵循如下约束条件：
type取值应为messageMessageHeader资源（eventCode=push），且应是元素entry列表的首个资源Patient资源，用以表示处方所对应的患者信息MedicationRequest资源，用以表示处方中的药物请求信息Organization资源，用以表示电子病历系统所处的机构信息（处方源）Practitioner资源，用以表示开立处方的医生。响应消息返回恰当的HTTP状态代码，应遵循如下约束条件：
200 OK表示整个请求处理成功OperationOutcome来代替Bundle来描述失败原因。本交易由药房系统和电子病历系统角色使用。查询患者相关信息（SMT-FHIR-002）交易用于药房系统向电子病历系统传输一个检索消息，包含检索参数、患者、药房等，用于获取与处方相关的症状、诊断、过敏等信息。
调用地址：
POST http://[ip]:[port]/fhir/$process-message
此消息使用POST方法将消息作为Bundle资源进行传输。
消息体的Content-Type应为application/fhir+json 或者 application/fhir+xml。
消息体定义参见查询患者相关信息请求消息结构定义。
消息体示例参见查询患者相关信息请求消息示例页面。
请求消息体应遵循如下约束条件：
type取值应为messageMessageHeader资源（eventCode=query），且应是元素entry列表的首个资源Parameters资源，用以表示检索条件Patient资源，用以表示处方所对应的患者信息Organization资源，用以表示药房系统所处的机构信息Practitioner资源，用以表示药房的卫生服务人员消息体的Content-Type应为application/fhir+json 或者 application/fhir+xml。
消息体定义参见查询患者相关信息响应消息结构定义。
消息体示例参见查询患者相关信息响应消息示例页面。
响应消息返回恰当的HTTP状态代码。
200 OK表示整个请求处理成功，且消息体应为Bundle资源MessageHeader资源（eventCode=query-response），且应是元素entry列表的首个资源Parameters资源，与请求消息中保持一致Patient资源，与请求消息中保持一致Bundle资源，用以记录检索结果集（type取值应为searchset）OperationOutcome来描述失败原因。