FBA成本计价流水接入金蝶云星空分步式调入单：单策略实战教程

这个策略解决什么问题

跨境业务里，FBA补货入库是亚马逊卖家把头程货物推进FBA仓的入口动作。这类单据的「成本计价流水」决定了库存价值，后续做毛利、对账、税务口径都要回到它。但源头在ERP（领星），核算口径在财务系统（金蝶云星空），两边不在同一张表上。我们做这条策略，本质是把领星侧按亚马逊库存动作日切出来的成本流水，按补货入库这一种业务类型，落到金蝶的分步式调入单，让财务侧有可追溯的入库凭证。

数据流向与字段映射

整体流向是 领星ERP（成本计价流水源） → 轻易云中间层（做编码/日期/单据号转换） → 金蝶云星空（分步式调入单）。源端是按月切的查询窗口，目标端是按单据写入，轻易云在中间承担过滤、计算与组装。

在轻易云上如何配置

在轻易云数据集成平台里，这条策略就是一条标准的「源查询 → 目标写入」链路，配置要点落在四个地方：

1. 源端数据源：选领星ERP平台，API 用 /cost/center/api/cost/stream，方法 POST，请求体按上面表格组装。business_types 固定写 10，query_type 固定写 01，时间窗口用 _function 表达式拿上月整月。
2. 目标端数据源：选金蝶云星空平台，API 走 batchSave，方法 POST。这里关键不是字段一一映射，而是单据号生成规则——_function concat('FBA补货入库','-',RIGHT(unique_key,12))，源头唯一键的右12位既保证唯一，又保留追溯链路。
3. 中间层字段映射：仓库/货主走 _findCollection 按名称查组织编码，这是轻易云客户常见的「编码映射集中管理」做法，避免在每个字段里硬编码wid。
4. 空值与异常：源端 origin_accounts 允许为空，但传空时轻易云侧要明确「整批跳过」还是「按字段级空值处理」，这里建议在策略里加一道前置过滤，把空源头单据号直接丢弃。

实施步骤

这条策略上线我们分三段跑：

• 增量起点（第1次运行）：先按上月整月拉一次全量，作为基线。源端日期窗口用 _function 表达式自动算上月首末日，轻易云的源查询配置里直接绑定即可。
• 全量触发：第一次跑完后，立刻在金蝶侧人工核对单据编号、库存组织和金额三栏，确认无误再放开定时。
• 调度频率：素材里 crontab 是 1 1 1 1 1，那只是占位。实际落地我们建议每月1日凌晨跑一次——因为窗口被严格限制在「不跨月」，跨月要么查不到数据，要么漏掉边界日，这是典型的「增量与全量双轨」里偏向全量的打法。

踩坑复盘

1. 跨月查询会丢数据。源端明确禁止 start_date/end_date 跨月，所以函数里要先 DATE_SUB 到上月第一天，再用 LAST_DAY(DATE_SUB(CURDATE(), INTERVAL 1 MONTH)) 拿上月最后一天，顺序别写反。
2. 单据号拼接要稳定。_function concat('FBA补货入库','-',RIGHT(unique_key,12)) 里 RIGHT 的位数不要随便改，否则历史单据号规则变化，金蝶侧按单据号做幂等的逻辑会失效。
3. 组织编码靠名称查。_findCollection find wid from … where name={{wh_name}} 看似稳，但金蝶侧组织更名后整条链路会断。稳妥做法是把组织 wid 维护在轻易云的「编码映射」表里，名称只做展示用。
4. 空源头单据号要早过滤。FBA补货入库场景下偶发会出现没有 origin_accounts 的记录，若放任流入，目标端 FBillNo 拼接会变成 FBA补货入库-，触发金蝶的重复校验。在轻易云源查询后加一道过滤，把 unique_key 为空的行直接拦掉。
5. 不要把同步策略当事务用。FBA成本流水月底才稳定，如果月初就跑，可能补录单据还没回流，目标端就已经生成调入单，造成金额对不上。业务侧的口径是「次月初跑上月」，轻易云侧只需要把调度时间卡在月初即可，不要试图在平台内做复杂补偿。

适用场景与不适用场景

适用：跨境卖家，FBA补货入库走亚马逊物流，需要把领星侧按亚马逊库存动作日切出来的成本流水落到金蝶做财务核算，单据体量按月结算。不适用：FBA销售出库、盘点、尾差调整等其他业务类型——它们的单据形态、成本口径和单据号规则都不一样，要单独建策略；也不适用需要实时反映FBA在途库存变化的场景，本策略是月度批处理，不是实时同步。