CGA系统接口联调失败怎么排查：脱敏记录与重试核对表
面向医院信息科的CGA接口联调记录方法：把接收响应、业务保存、结果回写及安全重试分别核对，附可复制的脱敏问题单。
锁定一次交换事件
用合成资料说明发送方、接收方、事件、时间、接口版本和预期状态。脱敏后记录必要的关联标识，不在公开工单粘贴患者字段、凭据或完整生产报文。
把返回成功和业务完成分开
按双方约定检查接收、校验、保存或后续处理各处状态。HTTP响应只能证明一层结果，是否完成业务回写仍需对端提供相应证据。
重试后核对重复与遗漏
先约定可安全重试的条件，再使用相同合成样例检查结果。记录实际次数、状态与证据位置，不把本文当成具体产品已具备重试或幂等能力的说明。
一个合成讨论示例
例如，合成事件A返回了接收成功，但对端尚未显示预期业务状态。双方应记录关联事件、发生时间与各层结果，再约定可验证的下一步，不直接把原因归为网络故障或盲目反复发送。
可复制的工作核对表
可复制下表结构形成机构内部记录。请填写合成事项或脱敏流程，不在公开网页填写个人身份、病历或评估答案。建议另留“待确认、负责人、复核结果、证据位置”四列，由参与方实际确认。
| 环节 | 准备与核对内容 | 证据及注意边界 |
|---|---|---|
| 事件定位 | 记录合成对象标识、业务事件、双方版本与时间；统一时区和关联编号。 | 双方能定位同一次交换，而不是各自拿一张无关截图。 |
| 返回与落库 | 分别查看接收结果和后续保存状态；没有对端证据就保持待核。 | HTTP成功不自动记作业务完成，避免遗漏异步处理。 |
| 安全重试 | 先确认重复请求如何识别及谁有权重试，再用同一合成事件复核。 | 不在真实患者数据上盲目反复发送，也不假定产品已实现幂等。 |
| 问题关闭 | 记录修改项、双方复验版本和结果；保留未通过项。 | 用实际复验记录关闭问题，不以单方口头回复代替。 |
双方怎样用同一条记录定位卡在哪一步？
问题单可增加“最后有证据的步骤”和“下一步由谁提供证据”两项。按项目约定的接口流程核对，缺少哪一层证据就先补哪一层，不直接猜测故障原因。
- 没有接收记录：发送方提供合成事件编号与发送时间，接收方按同一时间范围核查；同时注明双方时区。
- 有响应、无业务结果：保留响应摘要，由接收方核对校验、保存或后续处理状态。尚未取得证据时标为待查。
- 重试后出现疑似重复：先保留两次事件与结果的关联记录，暂停继续重试，由双方确认重复识别规则及处理责任。
复验时保留原失败记录，另记修正后的版本、同一合成样例和双方结果。若涉及访问条件或外部依赖，可结合院内部署依赖核对一起确认；咨询时只提供事件类型、卡住步骤和脱敏现象。
常见问题
公开页面可以提交完整报文吗？
不可以。先删除凭据及真实身份、病历和评估答案。项目联调资料应通过双方约定的受控渠道传递，公开咨询只说明机构、事件类型和现象。
接口文档能证明系统已经对接成功吗？
不能。接口说明、源码实现与现场联调是不同证据；以指定版本、指定机构和合成业务链路的验收结果为准。
带着机构任务继续交流
咨询前可以准备机构类型、参与岗位、现有做法以及希望核对的一条具体流程。此页是企业编辑的项目沟通资料，不是临床操作标准、采购法律意见或已实现功能清单；功能、版本、授权和交付范围以实际演示及双方确认文件为准。
本页只使用合成情境。请勿通过公开咨询提交患者资料、账号、密钥或完整生产报文；涉及专业判断和数据共享的事项，由具备相应职责的人员按机构有效制度处理。
