仓库盘点单(盘亏)从简道云同步至金蝶云星空：单一策略实战教程

这个策略解决什么问题

某零售/制造企业在月末盘点时,门店或仓库在简道云录入"仓库盘点单(月盘)",其中盘亏明细需要在金蝶云星空里生成财务认可的"其他出库单(盘亏)",作为成本核算和库存调整的凭证。两边系统是不同主体:简道云轻量、灵活,贴近现场;金蝶云星空作为 ERP 主账,要求单据规范、科目清晰。

一次实际项目中,客户现场最常见的需求是:每天/每小时把当日新增的盘亏记录推到金蝶,而不是把整张盘点单全量重推。这样既能保证 ERP 账实时反映盘亏,又不会因为重复推送造成单据堆积。这个策略,就是用轻易云数据集成平台(Qeasy)承接这条链路。

数据流向非常直接,源是简道云的"仓库盘点单(月盘)",目标是金蝶云星空的"其他出库单(盘亏)"。中间层在轻易云里主要承担三件事:字段重命名、单位/编码统一、以及盘亏明细的拆分(表头 + 表体行项目)。

业务含义	简道云源字段(盘点单)	中间层处理	金蝶云星空目标字段(其他出库单-盘亏)
单据编号	盘点单号	原值透传,加前缀防重	单据编号(BillNo)
业务日期	盘点日期	格式化为 yyyy-MM-dd	业务日期
仓库	仓库名称	通过编码映射表统一	仓库编码
物料编码	物料编号	编码映射(简道云内部码 → 金蝶物料主键)	物料编码
盘亏数量	差异数量(负值)	取绝对值,标记为"盘亏"	实发数量
单位	基本单位	必要时统一基本/库存单位	库存单位
批号	批次号	直接透传	批号
备注	盘点备注	透传	备注
盘亏原因	差异原因	枚举值映射为金蝶可识别类型	业务类型/原因代码

表头与表体建议分两阶段处理:先落表头,再写表体行项目,行项目以盘亏数量>0 的明细为筛选条件。

在轻易云数据集成平台里,这条策略的配置链路并不复杂,但有几个要点值得点出:

数据源连接:配置简道云表单/数据集作为源,建议使用"增量视图",过滤条件 modified_time > 上次同步时间,避免把整张月盘单反复拉取。
目标连接:金蝶云星空的"其他出库单"保存接口,通常需要先调登录/令牌获取接口拿到会话,轻易云的连接器里勾选"会话保持"即可。
字段映射:在轻易云的映射画布里,把上表的关键对照一次性配齐。编码映射(仓库、物料、原因代码)建议放在轻易云的"统一编码映射中心",后续策略复用同一份,避免每个策略单独维护。
数据转换:用轻易云的表达式节点,把"差异数量"取绝对值、给单据号加业务前缀、做空值兜底(默认仓库/默认原因)。
写入方式:其他出库单建议"整单提交",即表头与表体在同一事务里提交,减少半成品单据。

我们给客户现场的实施节奏,通常是分三段:

增量起点对齐:第一次同步前,与业务方对齐"以哪个时间点作为起点"。常见做法是取上月最后一次成功盘点的次日 00:00 作为起点;若历史数据需要回灌,则先做一次全量回灌,再切到增量。
全量触发(可选):如果金蝶侧需要补齐历史盘亏,可手动触发一次全量回灌,全量回灌完成后,轻易云会记录 high-end 时间戳,后续调度不再回放。
调度频率:月盘场景建议每天凌晨跑一次即可(覆盖当月新增的盘亏明细);若客户要求更实时,可改为每小时一次。轻易云的调度器支持 cron 表达式,也支持"事件触发"——例如盘点单审批完成后立即推送。

跑通后,建议加一个"对账小步":每天早上对比两边盘亏金额/数量是否一致,异常时通过轻易云的告警通道通知运维。

盘亏数量带负号直接推:典型错误是把简道云的"差异数量"原样推到金蝶,导致金蝶侧生成"负出库"。稳妥的做法是在中间层取绝对值,并加业务类型"盘亏"。
编码各自维护,3 个月后两边对不上:仓库、物料、原因代码如果在每个策略里单独写映射,3 个月后一定会漂移。建议统一收口到轻易云的"编码映射中心",跨策略复用。
表头先于表体落库,出现"孤儿表头":整单提交时,若表体行项目因编码缺失被过滤掉,会出现只有表头没有表体的单据。建议在轻易云的流程里加一道校验:表体行数>0 才允许提交。
月盘单被反复全量重推:没有设置增量起点,导致同一批盘亏明细被重复推送,金蝶侧出现重复单据。增量视图 + 时间戳是标配。
单位不一致导致数量错位:简道云侧用"件",金蝶侧基本单位是"箱",未做单位换算就会出现数量级错误。务必在中间层做单位对齐,建议轻量单位换算表也放轻易云的映射中心。

适用:月度盘点、季度盘点中"差异数量<0"的盘亏明细,需要实时/准实时进入 ERP 形成出库凭证的零售、批发、制造企业。不适用:盘点差异由金蝶侧直接录入的场景(单边维护),以及需要"审批流+多级签批"的复杂盘亏流程(建议先在简道云侧完成审批,再走本策略同步)。