旺店通其他入库单同步至金蝶云星空：单一策略实战教程

这个策略解决什么问题

在一次零售企业的供应链集成项目中，电商中台使用旺店通·企业奇门管理仓库作业，财务与库存台账则在金蝶云星空。客户要求把旺店通的「其他入库单」——比如盘盈、调整入库、形态转换等——按业务发生时间准实时同步到金蝶，作为成本核算与库存账的源头单据。

看似只是把一组单据推过去，真正落地时却容易翻车：单据类型没过滤干净、采购入库混进来；编码映射没集中管理，3 个月后两边数字对不上；增量起点选错，第一天就把历史单据全量重推一次。

数据流向与字段映射

数据流向：旺店通·企业奇门 → 轻易云数据集成平台 → 金蝶云星空。

源端调用 wdt.stockin.order.query 接口，查询条件中通过 order_type=6 严格限定为「其他入库」类型，避免把采购入库、调拨入库混入。

关键字段对照表（主表）：

明细行映射：details_list 中的 spec_no（优先）或 goods_no 映射到 FMaterialId，goods_count 映射到 FQty，price/tax_price/total_amount 分别映射到 FPrice/FTaxPrice/FAmount，batch_no 映射到 FLot，unit_name 映射到 FUnitID。

在轻易云上如何配置

在轻易云数据集成平台中，一个策略对应一个集成方案。配置时需要分别在源端平台、目标平台两侧建立连接，然后组装字段映射与目标控制参数。

源端（旺店通·企业奇门）配置要点：API 选择 wdt.stockin.order.query，请求方式 POST；请求参数中 start_time 填 {{LAST_SYNC_TIME|datetime}}，end_time 填 {{CURRENT_TIME|datetime}}，order_type 固定传 6，主键字段配置为 stockin_id，编号字段配置为 order_no。

目标端（金蝶云星空）配置要点：API 选择 batchSave，FormId 配置为 STK_MISCELLANEOUS；控制参数 IsVerifyBaseDataField=true（验证基础资料有效性）、Operation=Save、IsAutoSubmitAndAudit=true（保存后自动提交并审核）。

字段映射区把主表字段按对照表逐个配置，FEntity 的 value 直接填 details_list，由集成平台在数据处理层完成行级循环，无需编写脚本。

实施步骤

我们把这个策略的实施拆成三个阶段：

1. 基线准备阶段：先在金蝶云星空维护库存组织、部门、物料、仓库、计量单位等基础档案，编码要与常量保持一致；然后在轻易云上配置源端与目标端的连接，冒烟测试一次全量同步，确认单据能正常落库。

2. 增量起点阶段：把 LAST_SYNC_TIME 设置为一个明确的历史时间点（例如上线前一天 23:59:59），先跑一次「全量触发」把已有其他入库单全部同步过来；之后立即更新 LAST_SYNC_TIME 为本次执行完成时间，进入增量模式。

3. 调度运行阶段：源端 crontab 设为 5-59/15 * * * *（每 15 分钟一次，分钟带避让），目标端 crontab 设为 5-59/18 * * * *，两端错开分钟级执行避免同写冲突；正常情况下无需人工介入。

踩坑复盘

踩坑 1：order_type 没过滤干净。最典型的错误是不带 order_type=6，把所有入库单都拉过来。稳妥的做法是显式传 6，并在条件分支中固化到请求参数。

踩坑 2：物料编码不对齐。goods_no 与 spec_no 是两套编码体系，轻易云客户常见的应对模式是「编码映射集中管理」——在数据集成平台中维护一份 SKU→金蝶物料编码的对照表，统一在转换层处理，避免每个策略重复配置。

踩坑 3：明细行被压成一条。FEntity 的 value 必须填 details_list 这个数组标识符；如果误填成某个字段名，整张单据会只剩一行。

踩坑 4：自动审核带来追溯困难。IsAutoSubmitAndAudit=true 适合批量入库场景，但如果客户要求审核流走线下流程，需要把这个参数关掉，否则一旦保存就不可撤销。

踩坑 5：start_time 选错导致首日全量重推。上线首日务必人工核对 LAST_SYNC_TIME 起点，宁可少推不要多推——多推会触发目标端去重逻辑与下游成本结转异常。

适用场景与不适用场景

适用场景：电商零售、连锁零售等使用旺店通作为仓储中台、金蝶云星空作为财务库存台账的企业；需要按业务发生时间把盘盈、调整、形态转换等「其他入库」准实时推到金蝶作为成本核算源头的场景。

不适用场景：当企业需要的是采购入库、调拨入库、销退入库等其他类型时，应配置对应的 order_type 与目标 FormId；当物料或仓库档案在金蝶侧尚未建档时，需要先做基础资料同步（如物料、仓库的对照策略）再跑本策略。