← 返回教程列表
消息与同步金蝶云星辰 / 精斗云云进销存

金蝶消息订阅收不到推送:接收、响应与补偿排查步骤

发布于 华远智联科技有限公司技术团队

接口字段、权限与调用限制可能随产品版本调整。本文用于说明对接与排查思路,实际接入请核对当前官方文档,并在测试环境验证。

消息不再到达时,先判断是“平台没有发送”“网络没有送达”,还是“已接收但业务没有处理”。这三个问题需要不同证据,不能仅凭业务结果没有变化,就认定应用被限制。

当前官方消息订阅文档列出的适用产品为金蝶云星辰、精斗云云进销存和金蝶 KIS 云旗舰版(私有云)。不要据此推断云会计也支持同样的消息能力。消息订阅开发

先固定一笔测试业务和时间范围

选一笔符合当前订阅类型的测试变更,记录账套、操作时间、业务标识和期望事件。正式环境操作需经业务负责人确认,避免为了测试而影响实际单据。

随后沿链路检查:

  1. 应用、环境和账套是否正确,所需消息类型是否已订阅。
  2. 当前接收地址是否仍然有效,网络入口、证书和转发配置是否正常。
  3. 访问日志是否收到该时间段的请求;若无记录,核对平台后台状态与地址检测结果。
  4. 已收到请求时,检查验签、解析、消息持久化与业务消费分别停在哪一层。

不要在仍有重复请求到达时直接开启批量补单,应先检查去重与业务写入结果。

检查响应内容,不只检查状态码

官方文档规定了回调响应的业务字段,并说明未及时响应会触发推送降级,持续失败可能导致应用无法继续接收消息。因此 HTTP 返回 200 不能单独证明业务响应符合要求。

建议完整检查响应体、响应耗时与异常分支。鉴权失败、解析失败、数据库写入失败时分别怎样返回,应与文档和接收服务的处理方式一致。

工程实现上,建议先完成验签与可靠保存,再交由后台任务处理耗时业务;只有消息已被可靠接收,才返回相应的成功响应。不要在消息还未落地时直接返回成功,从而丢失恢复依据。

恢复订阅后,还要处理遗漏和重复

恢复地址检测或订阅状态,只解决后续接收。中断期间是否缺少数据,需要另外核对。

建议采用以下恢复顺序:

  • 明确中断开始、修复完成时间与受影响的账套和业务类型。
  • 查询本地已接收及已处理记录,区分重复消息与真正遗漏。
  • 如果目标产品接口支持相应查询条件,再按可用条件设计补偿读取。
  • 根据当前业务状态补齐,逐笔记录结果;不要假设平台一定重放所有历史消息。

消息标识和业务单据标识应分别管理。消息去重与业务幂等是两道检查,避免同一业务在重试时形成多张单据。

验收应覆盖三种结果

一次正常消息能正确处理;重复消息不会重复生成业务结果;临时失败后能查询到失败记录并按计划恢复。还应检查平台状态、接收日志、消费结果与前台业务数据是否一致。

需要排查协助时,可提供脱敏回调样本、响应体、操作时间、平台后台提示与接收日志。不要发送包含真实凭证或客户完整资料的截图。

下一步:确认对接范围

需要将接口能力落地到业务系统?可先了解对应产品的实施范围与交付方式。

相关教程

需要专业的接口对接服务?

华远智联科技有限公司专注金蝶系列产品 API 对接,提供定制化开发方案,快速打通您的业务系统。

免费获取对接方案