Epic FHIR集成问题：Encounter API缺失Appointment类数据

我们通过Epic FHIR API开展集成工作，医疗机构借助Epic Connection Hub中的第三方应用共享FHIR数据。按实施指南配置后台用户并启用安全点列表后，多数集成成功，但部分场景下Encounter API未返回Encounter.class.display = "Appointment"的就诊数据（注：我们查询的是Encounter资源而非Appointment资源，能获取'Support OP Encounter'、'HOV'、'Admission'等其他类别的Encounter数据，但缺失Appointment类）。

已知Appointment类对应多数正式门诊（如Office Visit）的就诊类别，且其他集成场景可正常获取该类数据，因此判定为涉事医疗机构的特定配置问题。已有一家机构解决该问题但无法说明原因，推测可能与Cadence、Ambulatory安全点或服务区域相关，但当前合作机构称已反复检查并启用相关安全点，且确认Cadence在所有服务区域授权（含Service Area 10），重新查询已知为Appointment类的CSNs（Epic就诊ID）仍无法通过FHIR访问。

可调整的配置排查环节 #

• 检查Encounter资源的FHIR映射规则
  确认Epic中是否将Appointment类的就诊记录正确映射到FHIR Encounter资源的class字段。部分机构可能自定义了映射逻辑，导致该类别的数据未被纳入FHIR API的返回范围，可通过Epic Interoperability Tools验证映射规则是否覆盖Appointment类Encounter。

• 细化Cadence权限验证
  除启用“Cadence: 5056 - Future Appointments”和“Cadence: 5057 - Past Appointments”安全点外，需确认后台用户是否拥有Cadence Appointment的读取权限，以及是否授权访问对应门诊类型（如Office Visit）的Appointment数据。部分安全点仅控制整体访问，细分的门诊类型权限需单独配置。

• 启用Ambulatory核心安全点
  检查并启用以下Ambulatory相关安全点：

  • "Ambulatory: 1001 - View Office Visits"
  • "Ambulatory: 1002 - View Encounter Details"
    这些安全点直接控制门诊类Encounter数据的FHIR API访问权限，未启用可能导致Appointment类数据无法返回。

• 核实服务区域的就诊类型权限
  确认后台用户不仅被授权访问Service Area 10，还需检查该服务区域下的门诊服务类型权限。部分机构会按服务区域细分不同就诊类型的访问权限，需确保Appointment类对应的门诊类型在Service Area 10的授权列表中。

• 排查FHIR应用的资源过滤规则
  检查Epic Connection Hub中第三方应用的FHIR API配置，是否存在自定义过滤规则（如按Encounter类别过滤）导致Appointment类数据被排除。查看应用的FHIR资源访问策略，确认未对Encounter.class字段设置限制。

• 验证就诊状态的FHIR返回规则
  确认涉事的Appointment类就诊记录在Epic系统中的状态是否符合FHIR API的返回条件。部分机构可能将某些状态（如已取消但未归档）的Appointment排除在FHIR API返回范围外，需检查系统状态映射规则。

• 核对FHIR API版本兼容性
  确认当前使用的Epic FHIR API版本是否支持返回Appointment类的Encounter数据。部分旧版本API可能存在类别映射局限性，可核对Epic官方文档中对应版本的Encounter资源字段说明，或尝试升级到最新稳定版。

内容的提问来源于stack exchange，提问作者SaraOK