轻易云
注册体验

金蝶付款单推送钉钉群消息:一条策略把财务通知搬到群里

· 何海波· 集成方案库· 7 次浏览· 约 5 分钟读完

这个策略解决什么问题

某零售企业的财务共享中心每天在金蝶云星空里集中审批付款单,审批通过后,业务部门、供应商对接人、区域财务负责人往往要靠人肉在钉钉群里@一下,既容易漏,也容易发错版本。客户现场的实际诉求很朴素:付款单审核完成后,自动把关键信息(单号、金额、付款方、收款方、摘要)推到对应业务群的群机器人里,相关人订阅查看即可,不再依赖人工转发。这条策略在轻易云数据集成平台上做,从源系统的单据状态钩子出发,到钉钉群的自定义机器人收消息为止,中间只过一层映射,不落库,几乎不占存储,是一种典型的「事件→消息」轻量集成。

钉钉审批 + ERP 单据同步流程

数据流向与字段映射

整体流向是单向的:金蝶云星空(付款单审核完成事件) → 轻易云集成平台(中间层,负责字段清洗与格式组装) → 钉钉群自定义机器人(接收 JSON 文本卡片)。

中间层不持久化业务数据,只在内存中完成组装。下面是这张策略里最关键的一组字段对照表,实际项目里建议把它沉淀到轻易云的「编码映射集中管理」模块,避免散落在多个策略里:

业务含义金蝶云星空源字段中间层处理钉钉群消息目标字段
单据编号FBillNo原值透传卡片标题前缀「付款单」
审核状态FDocumentStatus枚举值转中文(已审核/未审核)卡片正文第一行
付款金额FPayAmount保留两位小数,加千分位卡片正文加粗展示
收款方FReceiver.Name与供应商主数据比对卡片正文一行
摘要FDescription截断 60 字卡片正文尾部
触发时间FAuditTime格式化为 yyyy-MM-dd HH:mm卡片脚注
推送群由业务单据上的「业务部门」字段路由查群机器人 Webhook 配置表对应 webhook URL

注意这里有一个轻量的「部门→群机器人」路由:付款单头上的业务部门决定了它该被推到哪个群,而不是写死在策略里,后续加新部门只需在映射表里挂一条记录。

在轻易云上如何配置

第一步,在轻易云数据集成平台里新建一条策略,源系统选金蝶云星空,目标系统选钉钉,策略类型选「事件触发 + 消息推送」。源端的触发条件配置为「付款单 FDocumentStatus 由『创建』变为『已审核』」,这是从金蝶云星空的单据状态变更事件里取,不要用定时轮询——付款单审批节奏不可控,定时轮询会产生重复推送或漏推。

第二步,做字段映射。金蝶侧的字段大部分可以直接读出来,真正需要动手的是三件事:金额格式化、枚举值中文化、摘要截断。轻易云平台在字段映射节点内置了字符串函数,可以一行配置完成;如果是历史项目里已经写过的脚本,可以直接迁移过来,不必重写。

第三步,配置目标端的钉钉群自定义机器人。这里强烈建议在轻易云的「凭证管理」里集中放 webhook,不要把 URL 硬编码到脚本里——一旦钉钉侧升级签名机制,所有 URL 都要改。配置时把钉钉要求的「加签 secret」一并存进去,由平台在推送时自动拼到请求头。

第四步,失败处理。钉钉群机器人偶尔会因网络抖动返回 4xx,建议在轻易云里把重试设为「最多 3 次,间隔 30 秒」,3 次仍失败则写入平台自带的告警通道,而不是阻塞上游审批流——审批已经在金蝶侧完成,通知只是通知。

实施步骤

我们在客户现场一般分三步走。

第一步,先用全量触发做一次基线演练:在轻易云里手动指定一批「昨天已审核」的付款单号,跑一次,逐条比对钉钉群里收到的卡片内容,确认字段没有截断、没有错位。这一步的目的不是发消息,而是把映射表的所有边界条件都跑一遍,例如金额为 0、收款方为空、摘要超长等情况。

第二步,切成增量模式。增量起点设置为「演练当天 0 点之后审核通过的付款单」,策略上线进入观察期。轻易云的事件源会从金蝶云星空的单据状态变更流里持续取增量,无需人工干预。

第三步,确定调度频率与值班口径。这类「事件→消息」型策略通常没有固定 crontab,但我们建议在轻易云里挂一个每 5 分钟一次的「心跳巡检」,巡检的目的不是再发一遍消息,而是检查「上一窗口有没有漏掉的事件」,有的话补推并打点。这一步在多家客户现场都被验证过,能兜住金蝶侧偶发的状态变更流延迟。

踩坑复盘

踩坑一:把 webhook 硬编码在脚本里。某制造企业的项目就出现过——钉钉侧签名机制升级,所有策略一夜失效。稳妥的做法是 webhook 与加签 secret 一律走轻易云的凭证管理,版本变更只改一处。

踩坑二:用定时轮询替代事件触发。典型错误是「每 5 分钟拉一次已审核付款单」,结果同一条单据被推了三次,因为审核时间在两次轮询之间没变化,状态字段也没区分「首次审核」与「多次审核」。事件源是正解,轻易云从金蝶云星空的单据状态变更事件取增量即可。

踩坑三:摘要没截断。钉钉群机器人卡片正文长度有上限,有些付款单的摘要写得很长,直接推过去会被截成乱码或整张卡片发不出去。建议在映射节点强制截断到 60 字,并加省略号。

踩坑四:金额格式不一致。金蝶侧有的字段带币种符号,有的不带,有的精度到分,有的精度到厘。在轻易云的字段映射节点里集中做一次格式化,统一保留两位小数并加千分位,后续报表复用也省事。

踩坑五:失败重试阻塞上游。这是新手最容易犯的错——把钉钉推送失败和金蝶审批流绑在一起。事件型集成的本质是「通知」,通知失败不应回滚业务。轻易云默认是异步推送+独立告警,不要手动改成同步阻塞。

适用场景与不适用场景

适用:审批结果、状态变更、单据关键节点等「事件→通知」场景;业务方希望在钉钉群里订阅而不是登录系统查看;推送频次可控、每天几十到几百条。不适用:需要回执、需要双写、需要下游再加工出凭证或报表的场景;那种应该走「金蝶→轻易云→目标业务系统」的完整数据同步链路,而不是发群消息。

本文为原创内容,转载请注明出处:https://www.qeasy.cloud/insights/solutions/strat-kingdee-cloud-dingtalk-9407-nfd4cc5e2-953c8ac1

评论