别再事后补单了：金蝶其他出库单同步钉钉方案

一、先说清楚这张单据是什么

在金蝶云星空的库存单据体系里，出库单据按业务来源分得很细：销售出库对应客户和订单，生产领料出库对应工单，委外出库对应委外加工单。这三类之外的出库，全部收进一张单据——其他出库单。

金蝶官方对它的定义是：处理非销售出库、生产领料、委外出库业务类型的出库单据。系统路径是【供应链】→【库存管理】→【杂收杂发】→【其他出库单】。

它底下实际装的业务，比名字听起来复杂得多：

 这张单据的本质，是"非主营业务的出库收容站"。它承接的是所有不属于标准业务流程的物料流出——正因为"不属于标准流程"，它也是最容易脱管的地方。

二、为什么这类单据最容易失守

其他出库单有一个和销售出库、采购入库完全不同的特征：它没有外部压力。

销售出库晚一天，客户会催；采购入库晚一天，采购会催；生产领料晚一天，产线会停。但赠品出库、样品出库、报废出库，没有人等，也没有人催。没有外部推动力，流程就会自然滑向"先干了再说，单子回头补"。

1. 事后补单，是账实不符最大的来源

仓库人员把样品给了业务员，业务员当天就拿走了。仓库想的是"明天一起录"。等到月底盘点，发现有差异，才回头翻记录、回忆、补单——这时候补出来的数量、日期、领用人，有多少是准确的？

行业里有一句说得很实在的话："系统多、实物少"的差异，通常指向未走系统出库的样品领用、借出未归还、报废未过账。这就是其他出库单的失守现场。

2. 出库类型选错，成本就归错了科目

赠品和报废，在金蝶里都走其他出库单，但成本去向完全不同：赠品计入销售费用，报废计入营业外支出，研发领用计入研发支出。

补单的时候，录单人只关心"数量对不对"，很少关心"类型选得对不对"。一旦选错，库存数量是对的，成本归集是错的，利润结构跟着失真。而这种错误，月底对账时几乎发现不了——因为库存数量是平的。

3. 审批资料和单据脱节

规范的做法是：样品、报废、盘亏这几类业务，出库单背后必须有对应的审批单、质检单或盘点表。但现实里，审批在钉钉或纸面上走完了，出库单在金蝶里录完了，两个东西各自存在，谁也没关联到谁。

真出事要追溯的时候，只能靠翻聊天记录找"当时是谁同意的"。

4. 领用部门填不全，责任落不到人

其他出库单上有领用部门、经办人这些字段，但补单时这些字段经常是空的，或者统一填成"行政部""综合部"。

结果是：这笔物料出去了，但不知道是谁用的、为什么用的。责任分散到"大家"，等于没有人负责。

5. 发现得太晚，损失已经扩大

赠品被超额赠送、报废被随意处理、样品被私人使用——这些问题的共同点是单次金额不大，累积金额惊人。等到季度复盘或年度审计才发现，已经过去几个月，责任人、原始凭证、当时的情境都模糊了。

三、方案概述：把"事后补单"变成"当场认领"

安捷云 AgileFlow 的做法，是把金蝶云星空里已经审核的其他出库单，定时同步到钉钉的自定义表单，让这笔出库在发生的当期就出现在相关人员的手机上。

需要说清楚一点：同步不是为了让数据"多一个地方看"，而是为了给它加上责任人。

一句话：把非主营出库从"仓库的内部事务"，变成"业务部门的公开记录"。

四、数据是怎么流的

① 定时取数

金蝶云星空「其他出库单」(STK_MisDelivery)

按审核日期滚动查询，只取已审核、库存方向=普通

↓

② 过滤与归类

按单据类型/业务类型分流（赠品 / 样品 / 报废 / 盘亏 / 研发 / 福利…）

剔除退货方向、作废、未审核单据

↓

③ 字段映射

表头 + 明细行一并映射，按单号幂等判重

↓

④ 写入钉钉表单

按业务类型写入对应表单，或写入同一表单的"出库类型"字段

↓

⑤ 通知与回写

推送给领用部门负责人 / 仓库群

同步结果回写日志，失败告警

五、字段映射示例

以下是典型的字段对应关系，实际配置以贵司其他出库单的单据模板为准。

表头字段

明细行字段

六、定时同步的四个关键机制

这一节是整套方案里最容易做错的部分。其他出库单有几个别的单据没有的特殊性，必须单独处理。

1. 增量字段只能用审核日期，不能用业务日期

这是其他出库单特有的陷阱。

其他出库单大量存在"事后补录"的情况——物料是上周三领走的，单子是本周一才录进系统的。这种单据的业务日期是上周三，审核日期是本周一。

如果增量取数用业务日期 FDate 做条件，会发生什么？

· 周一跑同步，条件是"业务日期 ≥ 周一"，这张单被漏掉；

· 周二跑同步，条件是"业务日期 ≥ 周二"，这张单还是被漏掉。

它永远不会被同步到。而且漏得毫无痕迹——日志里没有任何报错。

正确做法是以审核日期 FApproveDate 为增量基准。审核日期只会在单据真正进入系统那一刻产生，不存在"倒填到过去"的问题。

再叠加一个"单据状态 = 已审核"的条件，把暂存、未审核的草稿挡在外面。

2. 必须处理「库存方向」，否则钉钉里会出现反常识的数据

金蝶的其他出库单有一个容易被忽略的设计：它有库存方向。

· 普通（GENERAL）：正常的出库，扣减即时库存

· 退货：实质上相当于入库，保存或审核时增加库存量

这意味着，如果不过滤库存方向，钉钉表单里会出现这样一条记录：单子叫"其他出库单"，数量是正数，但它在金蝶里实际是让库存增加了。

仓库人员看到一个"出库"却增加了库存，第一反应是系统出错了，然后是再也不敢信这张表。

三种处理方式，按推荐度排：

如果贵司确实有退货类其他出库单，建议单独走一张表单，标题就叫"其他出库退回"，别和正常出库混在一起。

3. 时间窗口要往前偏移

定时任务从启动到跑完需要时间。假设任务 8:00 启动、8:30 跑完，那 8:05 审核的单据就可能落在两个窗口之间——8:00 那次任务没抓到（当时还没审核），9:00 那次任务的窗口从 8:30 开始（如果按"上次结束时间"算），也漏掉了。

做法是让窗口往前重叠，比如往前偏移 20 分钟到 1 小时。

原则很简单：宁可重复抓一次，不能漏掉一张。重复的由幂等逻辑挡掉，漏掉的没有任何机制能补回来。

4. 幂等键怎么定

用金蝶单据内码 FID 判重。已存在的做更新，不存在的做新增。

其他出库单有一个特殊之处：单据审核之后仍然可能被修改。补录时填错数量、填错仓库、事后改领用部门，都是常见操作，业务方还会要求"把单子改一下"。

所以钉钉侧的处理应该是：已存在的记录，以金蝶最新状态为准覆盖，而不是"存在就跳过"。跳过的话，客户在 ERP 里改了数量，钉钉里还是老的。

七、业务类型决定钉钉里给谁看

这是本方案真正决定效果的一环，也是很多同步项目做完了却"没人看"的原因。

其他出库单下面挂了六七种业务类型，如果全部塞进一张表单、推给同一批人，结果是所有人都觉得"跟我没关系"，然后集体忽略。

建议按类型分派：

金蝶在这一点上也有明确的管控要求：样品、报废、盘亏这几类业务，出库单背后应有对应的审批单、质检单或盘点表；报废物料需要技术部门确认。同步到钉钉之后，这些资料终于有了一个可以挂在单据旁边的位置。

一个实操建议：如果贵司的单据类型编码本身就能区分业务类型（FBillTypeID_FNumber 通常按业务类型配置），直接用编码做分派条件，比用名称匹配稳定得多——名称可能被改，编码不会。

八、上线之后的实际变化

最直接的一条：盘点时"系统多、实物少"的差异项会明显减少，因为那些悄悄流出去的物料，现在每一笔都有人在钉钉里认领过。

九、适用场景

这套方案对以下几类企业价值最明显：

1. 有大量赠品、样品流转的贸易、快消、制造企业——赠品成本归集和去向追踪是刚需

2. 多仓库、多组织运营的企业——需要按库存组织隔离数据，让各仓各看各的

3. 有严格审计或税务合规要求的企业——报废、盘亏必须有完整留痕

4. 使用批次管理、序列号管理的企业——需要追溯到具体批次

5. 仓管人员分散在多个现场的企业——没有条件天天登录 ERP，但天天用钉钉

十、为什么用 AgileFlow 做这条链路

1. 预置模板，不用从零配置

AgileFlow 的模板中心里已经有「星空【其他出库单】→钉钉【X表单】-定时」这类成熟模板。字段映射、增量逻辑、幂等判重的骨架已经搭好，实施时主要工作是按贵司的单据类型和钉钉表单做适配，而不是从接口文档开始写代码。

2. 可视化配置，改字段不用改代码

业务变了要加一个字段、钉钉表单改了一个控件，在界面上调整映射即可，不需要发版、不需要重启。

3. 已处理金蝶的字段细节

嵌套字段取数（FMaterialId.FNumber）、表头表体一起取、行级内码（FEntity_FEntryID）、多货主字段（FOwnerTypeIdHead）——这些金蝶接口的常规坑，模板里已经处理过。自己开发的话，往往要踩一遍才知道。

4. 可扩展

AgileFlow 在钉钉、宜搭、飞书、企业微信与 T+、好业财、金蝶云星空之间，有大量成熟的连接模板。今天只同步其他出库单，明天要加其他入库单、调拨单，用的是同一套机制，不需要换平台。

安捷云 AgileFlow 属安捷AI（天智鲲鹏）体系，产品在业财一体连接方向持续投入，模板库和运行监控都在同一个控制台里。

十一、接入路径

多数企业从授权到跑通在一天内可以完成，因为模板已经把接口和字段的难点消化掉了。真正花时间的是第 3 步和第 4 步——确认业务类型的范围、确认领用部门在钉钉侧对应哪个字段。

关于频率怎么定，给一个判断依据：其他出库单不是高频业务，很多企业一天也就几笔到几十笔。先从每天一次、在仓库上班前跑完开始，跑一周看看数据量和使用反馈，再决定要不要加密。不要一上来就设成每分钟跑一次——对 ERP 是无谓的压力，对你也没有额外价值。

十二、常见问题

Q1：其他出库单会不会和销售出库单、其他入库单重复？

不会。它们是金蝶里独立的单据类型（其他出库单的 FormId 是 STK_MisDelivery），接口层面就是分开查询的。配置时把查询范围锁定在其他出库单，不会带出销售出库或调拨单。

Q2：为什么不能用业务日期做增量？

因为其他出库单存在大量"事后补录"。业务日期可以倒填到过去，审核日期不会。用业务日期做增量，补录的单据会永久漏掉，而且不报错。这是本方案里最重要的一条配置规则。

Q3：退货类型的其他出库单要不要同步？

取决于业务需要。如果贵司有退货类其他出库业务，建议单独建一张表单（如"其他出库退回"），不要和正常出库混在一起。混在一起会有两个问题：一是数量方向反直觉，二是统计时容易把退回当发出。

Q4：金蝶"分仓"功能生成的单据会不会漏？

不会。分仓的机制是：表体仓库不同时，系统按仓库自动拆成多张单据，每张单据仓库相同。拆出来的每张都是独立单据，有各自的单号，按单号同步即可。只需要注意：钉钉一张表单可能对应金蝶多张单据，如果贵司的钉钉表单设计成"一张表单=一个出库事实"，需要提前想好怎么合并。

Q5：同步频率设多少合适？

建议每天一次起步，调度时刻放在仓库上班前（比如早上 7:30）。其他出库单不是时效敏感业务，"多久跑一次"不如"什么时候跑完"重要。

Q6：能在钉钉里审批后回写金蝶吗？

本模板的主方向是金蝶→钉钉的单向同步，目的是把已审核的出库事实推到业务现场。如果需要在钉钉发起、审批后生成金蝶单据，那属于反向链路，AgileFlow 有对应的模板可以承接，但那是另一套配置。

Q7：报废出库需要关联质检单或技术确认吗？

金蝶的管控要求是报废物料需技术部门确认，样品、报废、盘亏业务需对应审批单、质检单、盘点表。建议把这类资料放在钉钉表单的附件字段里，或作为流程节点收集——比事后翻找可靠得多。

Q8：需要开放金蝶的写权限吗？

单向同步只需要查询权限，不需要写入权限。这也是这类方案在安全审查上比较容易被接受的原因：ERP 侧只读，数据流出方向唯一。

如果贵司的其他出库业务有特殊类型（比如寄售出库、试用转销售、工程领用），或者需要在钉钉里按部门做数据权限隔离，可以在接入前跟实施顾问说明，这部分通常通过字段映射和表单权限配置解决，不需要改代码。

本文中的金蝶云星空单据逻辑、字段含义、接口约束均基于公开的产品文档与实施实践整理；具体字段名、单据类型编码、业务类型范围以贵司实际系统配置为准。