← 返回教程列表
消息与同步金蝶云星辰

金蝶云星辰消息订阅配置后没有推送:从接收地址到事件范围逐层定位

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

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

适用于刚配置消息订阅、尚未成功收到业务事件的接入阶段。排查应先确定请求有没有到达接收系统,再看订阅配置与事件是否匹配;不要直接把没有消息归结为平台停推。

第一步:确认接收端可到达

核对公开回调地址的域名、端口、路径及证书配置。查看入口代理与应用两层日志,确认平台地址检测请求能否到达。有代理、网关或负载均衡时,还要检查路径重写、跳转与超时。协议、签名、响应体和签收时限均以当前产品推送文档为准,不能照搬其他产品的秒数或返回格式。

第二步:确认正在产生已订阅事件

记录应用、账套、订阅实体及操作类型。在目标账套中执行一个文档支持的测试动作,例如对已订阅对象进行一次允许的变更,并记下操作时间及对象标识。只订阅授权类通知,不能据此判断一定会收到所有业务单据通知。

第三步:检查消息如何被处理

如果入口日志已有请求,继续核对验签、解析、持久化和后续消费记录。如果入口完全没有请求,收集订阅截图、测试动作及时间范围,向平台查询投递情况。不要为了让测试通过,直接关闭验签或无条件返回成功。

验收标准

一次真实事件能够从业务操作追踪到接收、可靠存储与消费结果;重复通知不会重复写入单据。地址检测成功只作为连通性证据,不能替代完整业务事件验收。异常日志应保留错误类别和关联标识,避免记录完整密钥或敏感业务报文。

已核对的官方依据

官方消息订阅说明分别给出沙箱与企业授权的配置位置。应首先确认使用了目标环境的接收地址,再核对所选消息类型;接收端响应也需要符合文档的业务JSON结构,不能只返回空的HTTP成功状态。

查看对应官方说明。本次核对日期为2026-11-04;其他段落中的排查与验收步骤属于集成设计建议。

参考与适用边界

本文提供问题排查与集成设计建议;具体字段、权限和业务限制需按当前文档在授权测试环境验证。

下一步:确认对接范围

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

相关教程

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

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

免费获取对接方案