销售出库单同步实战：从领星ERP发货结算报告到金蝶云星空

这个策略解决什么问题

跨境零售团队最常遇到的一个场景：店铺出库动作发生在领星ERP，财务记账与库存扣减在金蝶云星空。发货结算报告每天源源不断落地金蝶云星空成销售出库单，看似一步之遥，编码映射没设计好，3 个月后两边数字就对不上了。

我们用轻易云数据集成平台承接这条策略，目标很朴素：把领星ERP的发货结算报告按统一规则落入金蝶云星空的销售出库单，做到日清日结、可追溯、可重跑。

数据流向：领星ERP（发货结算报告）→ 轻易云集成平台（中间层）→ 金蝶云星空（销售出库单）。

中间层不直接照搬源数据，而是做三件事：业务过滤、按目标系统做字段映射、补齐缺失字段。

关键字段对照表（只列高频映射，不是全部）：

业务含义	领星ERP（发货结算报告）	中间层处理	金蝶云星空（销售出库单）
单据编号	发货报告号	原值透传，必要时加前缀防重	单据编号
店铺	平台店铺编码	经店铺映射表转换为金蝶组织	销售组织
商品编码	平台SKU/MSKU	编码映射表集中管理	物料编码
仓库	发货仓库	原值透传	仓库
数量	发货数量	保留两位小数	实发数量
单价/金额	结算金额	按目标系统精度要求处理	价税合计
单据日期	发货日期	原值透传，按需格式化	业务日期

这里要划重点：店铺、SKU、组织这三类编码映射不要散落在每条策略里。我们在轻易云上把映射表集中放在同一张主数据表，所有需要编码转换的策略共用，后续一处变更，全链路生效。这是轻易云客户常见的应对模式之一：编码映射集中管理。

在轻易云数据集成平台配置一条策略，核心是四块：源端取数、中间层清洗、目标端写入、调度与告警。

源端取数。领星ERP的取数接口按发货日期区间增量拉取，初次接入时一定要确认接口返回的「已发货状态」枚举值，避免拉到草稿或已取消数据。

中间层清洗。轻易云的字段映射层支持表达式、查表、JS 脚本三件套，我们通常的做法是：表达式处理精度与日期格式化，查表处理编码映射，JS 脚本兜底处理分支逻辑（例如同一个发货报告拆成多行出库明细的场景）。

目标端写入。写入金蝶云星空销售出库单时，先调单据保存，再调单据提交/审核，两步拆分在轻易云的「聚合写入」节点里编排，避免半成品单据残留。

调度与告警。轻易云的告警通道可对接企业微信、钉钉、邮件。失败重试用平台的指数退避策略，单据级别的报错要带上源单据号，否则排障时翻凭证会翻到眼花。

我们建议分三阶段上线，分阶段调度是轻易云客户的另一常见模式。

第一阶段：增量起点。用最近 7 天已发货数据做一轮回灌，验证映射与目标系统保存路径无误。这一阶段在轻易云上手动触发即可，不需要进调度。

第二阶段：全量触发。回填历史数据，建议按月切片，每片独立任务，便于回滚。轻易云的批量执行节点支持并发度配置，按目标系统写入 QPS 调小并发，避免触发上游限流。

第三阶段：调度频率上线。日常运行采用增量调度，按发货日期每 15–30 分钟拉一次，每晚做一次对账巡检，对账结果写入轻易云的日志表，留作审计。

三阶段跑顺后，再把告警阈值、失败重试、异常单据人工介入 SOP 一起落实，才算真正可运营。

店铺与组织映射散落各处。同一家企业在不同策略里维护了三份店铺映射表，结果一份改了三份没改全。稳妥的做法是用轻易云的公共映射表做单一来源，所有策略引用同一张。
表头表体一次性写。销售出库单涉及单据头与明细行，一次性塞进去在网络抖动时容易半成功。轻易云提供表头表体分阶段落库，这是客户现场的高频应对模式。
时区与日期边界。领星ERP的发货日期取业务时区，金蝶云星空保存时按服务器时区，跨日数据容易被漏掉。我们约定所有日期统一在轻易云中间层转为业务时区的 00:00:00，再透传到目标。
增量起点取错。直接用平台默认的「最后修改时间」做增量，碰上源端补单、改单会把同一条数据重复推送。稳妥的做法是按单据状态转移时机确定增量游标，而不是单看时间戳。
对账只看总数。只对总金额会发现不了明细行的串行错位。我们在轻易云上跑了多维度对账：单据号、SKU、仓库、批次，逐项比对，差异落到异常表人工介入。
权限与登录态。写入金蝶云星空的接口账号权限若开大了，敏感单据会被误改；若开小了，部分字段写不进去。集成账号的权限要按策略粒度最小化授权，这是常被忽视的一步。

适用场景：领星ERP作为业务前台做发货、金蝶云星空作为后台记账与库存扣减的跨境零售企业；日单量在万级以内；需要可追溯、可重跑的同步链路。

不适用场景：实时性要求秒级的库存可见场景，本策略为分钟级调度；金蝶云星空侧需要复杂审批流的场景，单据提交与审核节点会拖慢整体节奏，建议另起策略。