销售出库单从电商ERP推入金蝶云星空:单一策略实战教程
这个策略解决什么问题
电商业务跑在旺店通上、核算与库存账跑在金蝶云星空,是某零售企业很常见的形态:前端接单、审单、打单发货都在旺店通里跑,但财务核算、库存账、成本归集必须落到金蝶。销售出库单是这条链路上的关键单据——什么时候出库、出多少、发给哪个客户、走哪个仓库,都要原样落进金蝶。我们这次要解决的就是:把旺店通销售出库单,按业务规则原样写入金蝶云星空,并尽量做到免人工干预。
数据流向与字段映射
数据流向可以简化为三段:源系统(旺店通·旗舰奇门)→ 轻易云中间层(负责查询、转换、联查、构建请求体)→ 目标系统(金蝶云星空)。
源端接口是 wdt.wms.stockout.sales.querywithdetail,主表关键字段包括 order_no(出库单号)、consign_time(出库时间)、shop_no(店铺编号)、warehouse_name(仓库名)、trade_no(订单号)、src_trade_no(原始单号)、goods_total_cost(总成本价);明细通过 details_list 数组下传,包含 spec_no/goods_no(商家编码/货品编号)、goods_count(数量)、sell_price(单价)、total_amount(金额)、tax_rate(税率)、gift_type(赠品标记)、remark 等。
目标端调用金蝶 batchSave,FormId 为 SAL_OUTSTOCK,主表接收 FBillNo、FDate、FCustomerID 等,分录通过 FEntity 数组承载。下面是核心字段对照:
| 源字段 | 目标字段 | 映射类型 | 转换规则 | 业务说明 |
|---|---|---|---|---|
| order_no | FBillNo | DIRECT | {{order_no}} | 单据编号 |
| consign_time | FDate | TRANSFORM | `{{consign_time | datetime}}` |
| shop_no | FCustomerID | COLLECTION | _findCollection 联查 | 店铺→客户映射 |
| remark | FNote | DIRECT | {{remark}} | 单据备注 |
| trade_no | F_UBGN_LargeText1 | DIRECT | {{trade_no}} | 订单编码 |
| src_trade_no | F_UBGN_LargeText | DIRECT | {{src_trade_no}} | 原始单号 |
| details_list | FEntity | COLLECTION | value=details_list | 明细数组整体引用 |
明细行典型对照:spec_no/goods_no → FMaterialId(优先商家编码)、goods_count → FQty、sell_price → FPrice、total_amount → FAmount、tax_rate → FTaxRate(0~1 转百分比)、gift_type → FGiftType(0 非赠品,1/2 赠品)。组织类常量如 FSaleOrgId、FStockOrgId、FOwnerIdHead 全部固定为 100,FBillTypeID 固定为 XSCKD01_SYS。
在轻易云上如何配置
在轻易云数据集成平台里,一个策略对应一条完整链路,配置时按"源 → 映射 → 目标"三步走。
源端新建数据源,平台选择"旺店通·旗舰奇门",接口选 wdt.wms.stockout.sales.querywithdetail,主键字段 order_no,ID 字段 stockout_id,开启 idCheck=true 和 buildModel=true。增量起点建议先以最近一次完整出库时间为锚点,再用 consign_time 做增量过滤。
目标端新建金蝶云星空数据源,接口选 batchSave,FormId SAL_OUTSTOCK,Operation Save,并打开 IsAutoSubmitAndAudit=true、IsVerifyBaseDataField=true,SubSystemId 写 21。
映射层是这次的关键。客户字段不要硬编码,靠 _findCollection 联查:从店铺同步客户方案中,用 F_UBGN_Text_qtr={{shop_no}} 查出 FNumber 写入金蝶 FCustomerID。条件之间用空格分隔,语法上不能漏,否则整条都会查空。组织类常量在策略里直接写常量即可,无需脚本。成本字段注意源端主表是 goods_total_cost,目标如果引用了 goods_cost,需要在策略里补一条同名字段或脚本别名,否则会出现字段取空。
实施步骤
我们一般把上线分成三段调度,避免一上来就高频全量把两边都跑糊。
第一阶段:增量起点对齐。 先在源端跑一次按 consign_time >= 上一次同步截止时间 的查询,确认两边起始数据一致;金蝶端把 FBillNo 和源端 order_no 拉通校验,避免重复或缺失。
第二阶段:全量触发。 在业务低峰期(比如凌晨 02:00 之后)跑一次全量回灌,把历史销售出库单一次性补齐。这次目标端可以临时关掉自动审核,等全量核对无误后再打开。
第三阶段:常态调度。 源端按 */40 * * * *(每 40 分钟)拉取增量,目标端按 16 2 * * *(每日 02:16)汇总执行,配合 idCheck 去重。运行一周观察漏单、重复单和审核失败情况,再按需收紧或放宽频率。
踩坑复盘
- 联查语法空格丢了。
_findCollection各段之间必须是单个英文空格,少一个空格整条查询就返回空,客户编码写入失败,单据保存直接报错。稳妥的做法是配置完先用一个真实店铺号做联调,确认能取到FNumber。 - 店铺→客户档案未先同步。 这个策略强依赖"店铺同步客户"先跑通。如果客户档案里没有
F_UBGN_Text_qtr,联查就查不到值,FCustomerID 写空。要把店铺同步客户作为前置依赖,跑完并核对再开本策略。 - 赠品税率处理不一致。 旺店通
gift_type=1/2时单价可能是 0,但税率仍要带;金蝶侧若按 0 税率会让单据保存失败。建议在策略里把赠品行单独打标,避免和正常销售行混在一起。 - 成本字段名错位。 目标映射里如果写的是
{{goods_cost}},而源端只有goods_total_cost,平台不会自动做同名处理,结果就是成本字段一直为空。这条要么改字段名,要么加一段轻量脚本做别名。 - 明细数组引用方式不对。
FEntity的 value 必须指向details_list这个数组整体,而不是数组里的某个字段;否则平台只会取第一行,其他行全丢。
适用场景与不适用场景
适用:电商前端在旺店通、核算与库存账在金蝶云星空,且组织、客户、物料主数据已通过其他策略同步到金蝶的零售/分销场景。不适用:跨境多币种结算、需要按批次/保质期强校验的医药或食品行业,以及金蝶侧要求手工确认或走复杂审批流的场景——这类建议走接口中转而不是直推。