金蝶付款单推送钉钉群消息:一条策略把财务通知搬到群里
这个策略解决什么问题
某零售企业的财务共享中心每天在金蝶云星空里集中审批付款单,审批通过后,业务部门、供应商对接人、区域财务负责人往往要靠人肉在钉钉群里@一下,既容易漏,也容易发错版本。客户现场的实际诉求很朴素:付款单审核完成后,自动把关键信息(单号、金额、付款方、收款方、摘要)推到对应业务群的群机器人里,相关人订阅查看即可,不再依赖人工转发。这条策略在轻易云数据集成平台上做,从源系统的单据状态钩子出发,到钉钉群的自定义机器人收消息为止,中间只过一层映射,不落库,几乎不占存储,是一种典型的「事件→消息」轻量集成。
数据流向与字段映射
整体流向是单向的:金蝶云星空(付款单审核完成事件) → 轻易云集成平台(中间层,负责字段清洗与格式组装) → 钉钉群自定义机器人(接收 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 字,并加省略号。
踩坑四:金额格式不一致。金蝶侧有的字段带币种符号,有的不带,有的精度到分,有的精度到厘。在轻易云的字段映射节点里集中做一次格式化,统一保留两位小数并加千分位,后续报表复用也省事。
踩坑五:失败重试阻塞上游。这是新手最容易犯的错——把钉钉推送失败和金蝶审批流绑在一起。事件型集成的本质是「通知」,通知失败不应回滚业务。轻易云默认是异步推送+独立告警,不要手动改成同步阻塞。
适用场景与不适用场景
适用:审批结果、状态变更、单据关键节点等「事件→通知」场景;业务方希望在钉钉群里订阅而不是登录系统查看;推送频次可控、每天几十到几百条。不适用:需要回执、需要双写、需要下游再加工出凭证或报表的场景;那种应该走「金蝶→轻易云→目标业务系统」的完整数据同步链路,而不是发群消息。