金蝶消息订阅收不到推送:接收、响应与补偿排查步骤
接口字段、权限与调用限制可能随产品版本调整。本文用于说明对接与排查思路,实际接入请核对当前官方文档,并在测试环境验证。
消息不再到达时,先判断是“平台没有发送”“网络没有送达”,还是“已接收但业务没有处理”。这三个问题需要不同证据,不能仅凭业务结果没有变化,就认定应用被限制。
当前官方消息订阅文档列出的适用产品为金蝶云星辰、精斗云云进销存和金蝶 KIS 云旗舰版(私有云)。不要据此推断云会计也支持同样的消息能力。消息订阅开发
先固定一笔测试业务和时间范围
选一笔符合当前订阅类型的测试变更,记录账套、操作时间、业务标识和期望事件。正式环境操作需经业务负责人确认,避免为了测试而影响实际单据。
随后沿链路检查:
- 应用、环境和账套是否正确,所需消息类型是否已订阅。
- 当前接收地址是否仍然有效,网络入口、证书和转发配置是否正常。
- 访问日志是否收到该时间段的请求;若无记录,核对平台后台状态与地址检测结果。
- 已收到请求时,检查验签、解析、消息持久化与业务消费分别停在哪一层。
不要在仍有重复请求到达时直接开启批量补单,应先检查去重与业务写入结果。
检查响应内容,不只检查状态码
官方文档规定了回调响应的业务字段,并说明未及时响应会触发推送降级,持续失败可能导致应用无法继续接收消息。因此 HTTP 返回 200 不能单独证明业务响应符合要求。
建议完整检查响应体、响应耗时与异常分支。鉴权失败、解析失败、数据库写入失败时分别怎样返回,应与文档和接收服务的处理方式一致。
工程实现上,建议先完成验签与可靠保存,再交由后台任务处理耗时业务;只有消息已被可靠接收,才返回相应的成功响应。不要在消息还未落地时直接返回成功,从而丢失恢复依据。
恢复订阅后,还要处理遗漏和重复
恢复地址检测或订阅状态,只解决后续接收。中断期间是否缺少数据,需要另外核对。
建议采用以下恢复顺序:
- 明确中断开始、修复完成时间与受影响的账套和业务类型。
- 查询本地已接收及已处理记录,区分重复消息与真正遗漏。
- 如果目标产品接口支持相应查询条件,再按可用条件设计补偿读取。
- 根据当前业务状态补齐,逐笔记录结果;不要假设平台一定重放所有历史消息。
消息标识和业务单据标识应分别管理。消息去重与业务幂等是两道检查,避免同一业务在重试时形成多张单据。
验收应覆盖三种结果
一次正常消息能正确处理;重复消息不会重复生成业务结果;临时失败后能查询到失败记录并按计划恢复。还应检查平台状态、接收日志、消费结果与前台业务数据是否一致。
需要排查协助时,可提供脱敏回调样本、响应体、操作时间、平台后台提示与接收日志。不要发送包含真实凭证或客户完整资料的截图。
下一步:确认对接范围
需要将接口能力落地到业务系统?可先了解对应产品的实施范围与交付方式。