轻易云
注册体验

销售出库单从电商ERP推入金蝶云星空:单一策略实战教程

· 集成方案库· 40 次浏览· 约 4 分钟读完

这个策略解决什么问题

电商业务跑在旺店通上、核算与库存账跑在金蝶云星空,是某零售企业很常见的形态:前端接单、审单、打单发货都在旺店通里跑,但财务核算、库存账、成本归集必须落到金蝶。销售出库单是这条链路上的关键单据——什么时候出库、出多少、发给哪个客户、走哪个仓库,都要原样落进金蝶。我们这次要解决的就是:把旺店通销售出库单,按业务规则原样写入金蝶云星空,并尽量做到免人工干预。

销售订单业务贯通:从平台到 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_noFBillNoDIRECT{{order_no}}单据编号
consign_timeFDateTRANSFORM`{{consign_timedatetime}}`
shop_noFCustomerIDCOLLECTION_findCollection 联查店铺→客户映射
remarkFNoteDIRECT{{remark}}单据备注
trade_noF_UBGN_LargeText1DIRECT{{trade_no}}订单编码
src_trade_noF_UBGN_LargeTextDIRECT{{src_trade_no}}原始单号
details_listFEntityCOLLECTIONvalue=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 去重。运行一周观察漏单、重复单和审核失败情况,再按需收紧或放宽频率。

踩坑复盘

  1. 联查语法空格丢了。 _findCollection 各段之间必须是单个英文空格,少一个空格整条查询就返回空,客户编码写入失败,单据保存直接报错。稳妥的做法是配置完先用一个真实店铺号做联调,确认能取到 FNumber。
  2. 店铺→客户档案未先同步。 这个策略强依赖"店铺同步客户"先跑通。如果客户档案里没有 F_UBGN_Text_qtr,联查就查不到值,FCustomerID 写空。要把店铺同步客户作为前置依赖,跑完并核对再开本策略。
  3. 赠品税率处理不一致。 旺店通 gift_type=1/2 时单价可能是 0,但税率仍要带;金蝶侧若按 0 税率会让单据保存失败。建议在策略里把赠品行单独打标,避免和正常销售行混在一起。
  4. 成本字段名错位。 目标映射里如果写的是 {{goods_cost}},而源端只有 goods_total_cost,平台不会自动做同名处理,结果就是成本字段一直为空。这条要么改字段名,要么加一段轻量脚本做别名。
  5. 明细数组引用方式不对。 FEntity 的 value 必须指向 details_list 这个数组整体,而不是数组里的某个字段;否则平台只会取第一行,其他行全丢。

适用场景与不适用场景

适用:电商前端在旺店通、核算与库存账在金蝶云星空,且组织、客户、物料主数据已通过其他策略同步到金蝶的零售/分销场景。不适用:跨境多币种结算、需要按批次/保质期强校验的医药或食品行业,以及金蝶侧要求手工确认或走复杂审批流的场景——这类建议走接口中转而不是直推。

本文为原创内容,转载请注明出处:https://www.qeasy.cloud/insights/solutions/strat-wdt-kingdee-cloud-2161-n263874da-a4ea58d8

评论